Jupyter Guide to Climate Data#

Jupyter Books with notebook examples for using climate data

Documentation written with Jupyter Book: https://jupyterbook.org/en/stable/intro.html

Other book examples: https://github.com/bvanderlei/jupyter-guide-to-linear-algebra

Chat: https://gitter.im/ENES-CDI/enes-summer-school

Discussions: https://github.com/IS-ENES-Data/summer-school-2022/discussions/

Material on GitHub: https://github.com/IS-ENES-Data/summer-school-2022

Build from Source#

Get Source:

git clone https://github.com/cehbrecht/jupyter-guide-to-climate-data.git

cd jupyter-guide-to-climate-data

Make conda env:

mamba env create
conda activate climate-guide

Build book:

jupyter-book build --all .

… or use make:

make clean build

Show build pages:

firefox _build/html/index.html

Publish book to gh-pages#

https://jupyterbook.org/en/stable/publish/gh-pages.html

ghp-import -n -p -f _build/html

… or use make:

make publish

Freeze conda environment#

Update conda spec list on levante:

conda list -n summerschool_2022 --explicit > spec-list.txt

You can use this spec-list.txt to create a new environment:

conda env create -f spec-list.txt

Working on Levante at DKRZ#

Get source:

git clone https://github.com/cehbrecht/jupyter-guide-to-climate-data.git

cd jupyter-guide-to-climate-data

To use the jupyter kernel we provide, create a link as follows:

ln -s /work/bm0021/conda-envs-public/kernels/share/jupyter/kernels/summerschool_2022 ${HOME}/.local/share/jupyter/kernels/summerschool_2022

Then, open notebooks in Jupyter and choose kernel “summerschool_2022”

Alternatively, to create your own conda environment and jupyter kernel, follow the steps below:

Init conda:

conda init bash
source ~/.bashrc

Create conda env:

mamba env create

conda activate summerschool_2022

Make kernel:

python -m ipykernel install --user --name="summerschool_2022" --display-name="summerschool_2022"

Set environment variables using one of the following options:

Option 1) Always add and execute a cell at the top of the current jupyter notebook containing the following code:

# Set necessary environment variables:
import conda, os
conda_file_dir = conda.__file__
conda_dir = conda_file_dir.split('lib')[0]
proj_lib = os.path.join(os.path.join(conda_dir, 'share'), 'proj')
os.environ["PROJ_LIB"] = proj_lib
os.environ['PATH'] += os.pathsep + os.path.join(conda_dir, 'bin')

Option 2) Preferably, add the environment variable definition to the kernel.json of your just created jupyter kernel: kernel.json per default located at $HOME/.local/share/jupyter/kernels/summerschool_2022/kernel.json Add the "env" section below:
```
{
 "argv": [
  ...
 ],
 "env":
 {
  "PATH":"${PATH}:${HOME}/.conda/envs/summerschool_2022/bin",
  "PROJ_LIB":"${HOME}/.conda/envs/summerschool_2022/share/proj"
 },
 "display_name": "summerschool_2022",
 ...
}
```

Open notebooks in Jupyter and choose kernel “summerschool_2022”

Jupyter Guide to Climate Data