Materials for the Dask tutorial at ODSC West 2018.
The tutorial is split in two parts. For the first part, we'll use the environment you created ahead of time on your laptop (see below). Assuming the WiFi is working, for the second part everyone will use their own Dask Cluster we set up ahead of time.
If you stumbled across this repository and would like to work through the materials on your own, consider the official Dask Tutorial.
If you don't have git
installed, you can download a ZIP copy of the repository using the green button
("Clone or Download"->"Download ZIP") above.
In this case the file will be called dask-tutorial-odsc-2018-master
, instead of dask-tutorial-odsc-2018
.
Adjust the commands below accordingly.
Install Miniconda or ensure you have Python 3.6+ installed on your system.
# Update conda
conda update conda
# Clone the repository, or download the ZIP and decompress
git clone https://github.com/TomAugspurger/dask-tutorial-odsc-2018
# Enter the repository
cd dask-tutorial-odsc-2018
# Create the environment
conda env create
# Activate the environment
conda activate dask-odsc
# Install the dask-labextension
jupyter labextension install dask-labextension
# Download data
# Note: This will download ~40MB of data, and generate ~7GB of data on disk
# If you're low on disk space, run
# python prep_data.py --small
python prep_data.py
# Start jupyterlab
jupyter lab
# or
jupyter-lab
# or Jupyter notebook
jupyter notebook
Using python / virtualenv instead of conda. Note that you're required to already
have python3
installed and on your PATH before running this. If you want the
full experience, you should also install graphviz documentation
and nodejs, but those are optional. Don't worry if you can't
get them installed.
# Clone the repository, or download the ZIP and decompress
git clone https://github.com/TomAugspurger/dask-tutorial-odsc-2018
# Enter the repository
cd dask-tutorial-odsc-2018
# Create a virtualenv
python3 -m venv .env
# Activate the env
# See https://docs.python.org/3/library/venv.html#creating-virtual-environments
# For bash it's
source .env/bin/activate
# Install the dependencies
python -m pip install -r requirements.txt
# Install the dask-labextension
# Note: this requires npm to be on your PATH
# just ignore it if this doesn't work
jupyter labextension install dask-labextension
# Download data
# Note: This will download ~40MB of data, and generate ~7GB of data on disk
# If you're low on disk space, run
# python prep_data.py --small
python prep_data.py
# Start jupyterlab
jupyter lab
# or Jupyter notebook
jupyter notebook
We have a pangeo deployment running that'll provide everyone with their own cluster to try out Dask on some larger problems.
If you are actively in the tutorial and ready to use your cluster, press this button: