Context
The WEkEO DIAS provides not only a single place to download and visualize Copernicus data, it also proposes a full gallery of Jupyter notebooks located in its cloud-based infrastructure. Every user can access to the Jupyter catalogue, you only need to create an account for free.
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, 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 for the purpose of this article that we are interested in an introductory notebook about how to access OLCI instrument data. We can select the OLCI parameter in the Sensor section:
As you will see, when you select a parameter in a section, some of them disappear and others remain. It is due to the fact that behind the scene, there is an AND operator
displaying the only parameters left when applying an intersection with the selected ones. The result of the next operation is visible in parenthesis.
In other words, in our example, there would be only one notebook left if we'd click on MSI, but now there are 13 notebooks listed on the right.
We will take for our example the notebook OLCI data access via the WEkEO HDA adaptor. Click on the notebook 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.