gforsyth / Numba_tutorial_scipy2017
Labels
Projects that are alternatives of or similar to Numba tutorial scipy2017
Numba: Tell those C++ bullies to get lost
This is the repository for the Scipy 2017 tutorial. The tutorial will be presented as a set of Jupyter notebooks with exercises sprinkled throughout.
Installation Instructions
We strongly, strongly, strongly encourage you to use conda to install
the required packages for this tutorial. There are non-Python dependencies
required that make manual installation or installing with pip very involved.
Note also that this tutorial is written for Python 3.6. Most things will still work on Python 3.4+.
No guarantees of any kind are made that it will be compatible with Python 2.
Installing with conda
Option a) Create a new environment
Download the environment.yml file in the root of this repository, e.g.
wget https://raw.githubusercontent.com/gforsyth/numba_tutorial_scipy2017/master/environment.yml
and then create the environment with
conda env create -f environment.yml
This will create a conda environment named numbatutorial with all of the required packages.
You can activate the environment with
source activate numbatutorial
or on Windows:
activate numbatutorial
Option b) Install the required packages
conda install jupyter ipython numpy numba line_profiler matplotlib
Optional extras
No hands-on work requires these, but if you want to play with some of the
examples. If you installed using either environments.yml or requirements.txt
these are already installed.
conda install cython
pip install cython
We recommend you also install the Jupyter notebook extensions.
conda install -c conda-forge jupyter_contrib_nbextensions
Once they are installed, start a notebook server
jupyter notebook
and (assuming port 8888) navigate to http://localhost:8888/nbextensions where
you can choose which extensions to enable. One that is helpful (for us!) when
using Numba in the notebook is the Skip-Traceback extension. You're welcome to
enable whichever extensions you like (we're also fans of Codefolding and the
Comment/Uncomment Hotkey).
Check Installation
Once you have downloaded all of the requires libraries/packages, you can run the
check_install.py script to confirm that everything is working as expected.
Either download the file directly or clone this repository and then run
python check_install.py