Installing Jupyter and Python

We recommend installing Miniconda, a mini version of Anaconda which conveniently installs:

  • Python
  • Jupyter Notebook
  • Other commonly used packages for scientific computing and data science

Miniconda includes only conda and its dependencies. If you would like to have conda plus over 720 open source packages, install Anaconda.

Installing Miniconda on macOS

  1. Download the installers
  2. Install
    • Miniconda via terminal:

      $ cd ~/Downloads
      
      $ bash Miniconda3-latest-MacOSX-x86_64.sh
      
  3. Close and re-open your terminal window.

  4. To test that the installation was successful, run the following command:

    $ conda list
    

Setting up virtual environment

Let’s first set up a virtual environment to work in where we can install all the required modules for the tutorials:

$ conda create -n GSKY python=3.6

Now let’s activate our virtual environment:

$ source activate GSKY

Installing Jupyter

Run the following command to install Jupyter:

$ conda install jupyter

Clone GSKY Jupyter notebooks

Open up or create a working directory where we can clone the GSKY Jupyter notebooks:

$ git clone https://github.com/nci-training/gsky-demos.git

$ cd gsky-demos

For these tutorials we will need to install ipyleaflet, ipywidgets, owslib, matplotlib, gdal, PIL, netCDF4, and Bokeh

$ conda install -c conda-forge ipyleaflet ipywidgets owslib matplotlib

$ conda install gdal pillow netcdf4

$ conda install -c bokeh bokeh

Running notebooks

We should now be ready to run the Jupyter notebook tutorials. To launch the notebooks:

$ jupyter notebook < notebook.ipynb >

For example, to launch Notebook_GSKY_WMS_ipyleaflet.ipynb:

$ jupyter notebook Notebook_GSKY_WMS_ipyleaflet.ipynb