Jupyter Notebook Guide

Each dataset in THREDDS contains a Jupyter Notebook viewer. We do not currently provide a JupyterLab server. You will need to install it on your computer in order to use it.

The easier way to install JupyterLab is with Docker.

NOTE: If you follow the Docker installation steps bellow, you will not need to install any additional Python libraries.

Docker

1. Install docker and docker-compose
2. Download the JupyterLab docker archive containing the docker-compose.yml file and the Dockerfile
3. Extract the docker-compose.yml file and the Dockerfile in a folder. Note that both files need to be in the same folder.
4. Start the docker container by running docker compose up
5. When the server is ready, docker compose logs will display instructions To access the server. Copy the URL from the logs http://127.0.0.1:8888/lab?token=... and load it in a web browser.

Local install

If you prefer to install JupyterLab locally, follow this online JupyterLab installation guide.

Note that if you decide to install JupyterLab locally, you will also need to install additional Python libraries. The steps to install those libraries are defined in the Dependencies section of every AIMS eReefs Jupyter Notebook.

1. Navigate through THREDDS structure to find a dataset that you are interested in. It can be either a File download dataset or a Virtual dataset. For example: GBR4 daily data for January 2023.
2. Click the Preview tab
3. Click the default_viewer.ipynb link to download the Jupyter Notebook JSON file for this dataset.
4. Drag n drop the downloaded default_viewer.ipynb file into JupyterLab's workspace.
5. Double-click the file from JupyterLab's workspace to load the Notebook.