Context
The WEkEO DIAS provides not only a single place to access, download and visualize Copernicus data, it also proposes a full gallery of Jupyter notebooks located in its cloud-based infrastructure showing how to download and use data accessible through WEkEO, and also how to use various tools like EOCanvas or Earthkit.
You can run the notebooks in your own WEkEO JupyterHub Workspace, accessible from your dashboard MyWEkEO (you need to log in first) and then click on Open:
To find a specific notebook, you can look into the public directory on your WEkEO JupyterHub, or you can search directly in the Jupyter Catalogue using the filters, as we will show in this article.
Without any further ado, let's dive into the Jupyter Catalogue! 😃
Explore the Jupyter Catalogue
Search for a notebook
On the Jupyter Catalogue page, all notebooks are listed on the right. In order to search for a specific notebook, you can use some filters on the left sidebar:
You can also click on one item of the header, for example ATMOSPHERE, and it will show the sidebar with your item already selected.
📌 Note: if the sidebar doesn't appear on your screen, zoom out and try again.
Let's say we are looking for an introductory notebook on how to access OLCI data. In the Sensor section, select OLCI:
The filters are cumulative: each selection narrows down the list, and the options that no longer match are hidden. The number in brackets next to each option shows how many notebooks it would give. Here, 13 notebooks match OLCI.
We will open the notebook OLCI data access via the WEkEO HDA adaptor. Click on it to open it in a new page.
On this page there are:
A short description of the notebook.
Clickable tags that will open the catalogue anew with selected tag as filter.
Two options to open the notebook (cf. sections below).
An overview of the notebook.
Open the notebook in WEkEO JupyterHub
Click on Open in Jupyter to open the notebook in your WEkEO JupyterHub environment (you only need an account). If you're not logged in yet, sign in to your WEkEO account in the new opened window.
Choose one of the proposed server (see differences between server options) and click on Start:
You should arrive on your JupyterHub environment with the notebook opened:
💡WEkEO Pro Tip: if the notebook didn't open, refresh the JupyterHub page.
You can now run the cells but not modify directly this notebook because it is located in the public directory.
⚠️ To be able to modify the notebook, you need first to copy/paste it into your working directory:
Manually: right click on the notebook, click on Copy, go to your own working directory and right click>Paste
Command Line Interface: run this command in a terminal:
cp public/wekeo4oceans/learn-olci/1_OLCI_introductory/1_1b_OLCI_data_access_HDA.ipynb <OUTPUT_DIR>
where
<OUTPUT_DIR>is the target directory.
Open the notebook in Github
You have also the possibility to open the notebook in the WEkEO GitHub repository. Simply click on Open in GitHub to reach the corresponding page of the notebook.
It will show the notebook as an overview. From this page, you can use the GitHub functionalities such as clone, etc.
Once in GitHub, you can always browse through the different folders of the wekeo repository. For example, you will find more information about the OLCI notebooks in the wekeo/learn-olci path:
What's next?
These articles might be of interest for you:
Additional resources can be found in our Help Center. Should you require further assistance or wish to provide feedback, feel free to contact us through a chat session available in the bottom right corner of the page.