During Geohackweek 2019 we used a common computational environment running on Amazon Web Services: https://nasa.pangeo.io. This is a JupyterHub with a common Python environment to facilitate running tutorial contents. This repository has some information about the Hub, and a copy of the Python environment file in case you want to run things on your personal computer.
nasa.pangeo.io is running in the AWS region us-east-1. It is maintained by the Pangeo project and is supported by NASA Grant #17-ACCESS17-0003 and cloud credits from Amazon. Access is currently limited to the Geohackweek GitHub Organization.
The Jupyter project has instructions for capturing the full Python environment from a Hub for re-use. See: https://mybinder.readthedocs.io/en/latest/tutorials/reproducibility.html
Run the following code to re-create the environment locally:
1) Install miniconda if you don't have it already
https://docs.conda.io/en/latest/miniconda.html
2) Create a conda environment
conda env create -f environment.yml
3) Activate the environment and install JupyterLab extensions
conda activate geohackweek2019
jupyter labextension install @jupyter-widgets/jupyterlab-manager \
@jupyterlab/geojson-extension \
@pyviz/jupyterlab_pyviz \
jupyter-matplotlib \
jupyter-leaflet \
dask-labextension
4) Launch JupyterLab
jupyter lab
There are some big advantages to using a common JupyterHub. Everyone has access to ephemeral computational resources, so you are not limited by your laptop CPU and RAM. We can also easily share large amounts of data. For example, everyone on the hub has read-write access to s3://geohackweek.
There are sometimes incompatibilities with conda packages on linux versus osx.
For example, the following are linux-specific and therefore won't install on a mac
ResolvePackageNotFound:
- libgfortran-ng=7.3.0
- libstdcxx-ng=7.3.0
- libgcc-ng=7.3.0
Solution: Comment out those lines in environment.yml with the # character.
Instead of installing miniconda and creating a new conda environment, you can use a Docker image that has everything pre-installed. This is helpful for running the hub in a different Cloud provider region. See https://cloud.docker.com/u/scottyhq/repository/docker/scottyhq/geohackweek2019
docker pull scottyhq/geohackweek2019:2019-08-01
Yes! The buttons below will pull the docker image and spin up an environment where you can run tutorials (WARNING: your home directory will not persist)
