README.md

DestinE Jupyter Notebook Tutorials for the Insula's Code Lab

Welcome to the repository for DestinE Platform Jupyter Notebook Tutorials!

This repository is designed to guide users through the DestinE Platform Services, exploiting DestinE Digital Twin data as well as data from many other data sources within the Insula Code Lab Service interactive Jupyter environment.

➡️ Register on the Destination Earth Platform and start using Jupyter Notebooks on Insula Code Lab! Example notebooks are seamlessly integrated into the default Python environment for all registered users.

⚠️ To start exploiting DestinE Digital Twin data please make sure to request the upgraded access permission by visiting this link.

Jupyter Notebooks Examples

All examples are written in Python and are designed to work seamlessly with any DestinE Platform Data Access service.

• Access DestinE Climate Adaptation Digital Twin data on the cacheb ➡️ upgraded access required.
• Access DestinE Climate Adaptation and Weather Extremes Digital Twin data from Polytope and visualize it ➡️ upgraded access required.
• Discover DestinE Climate Adaptation Digital Twin Data Streams on DestinEStreamer ➡️ upgraded access required.
• Discover and access Copernicus ERA5 data with Earth Data Hub Service examples.
• Access data on the Data Lake via EDEN Service example.
• Compute the Standard Evapotranspiration variable from ERA5 data using the Drought Assessment example.
• Search and download Copernicus Sentinels data via STAC on the cachea example.
• Create a DEA data story on Jupyter Notebook using dea Service example.

Notebook templates are all a quickstart to DestinE Platform services, including also ECMWF's Polytope and EUMETSAT's HDA.

Stay tuned for more contents and feel free to contribute!

Credits

• Earth Data Hub tutorials and Cache-B original content created by nicolamasotti from B-Open.
• EDEN notebooks original content created by MEEO.
• DestineStreamer examples created by SamCarraro from GeoVille.
• DEA and Cache-A tutorials created by Alia Space Systems.
• Insula contributions by Bea07 from CGI.
• Polytope example is a slightly modified version of the examples available at ECMWF's Destination Earth Digital Twins's polytope examples.

Installation

The CodeLab environment includes some Python packages pre-installed in the user's environment. The overall list of dependencies is provided in the file requirements.txt.

Note: Pre-installed Python packages listed in this file provide a snapshot of dependencies needed to run the example notebooks provided in this repository.

To install new packages persistently in the coding environment, users can create their own virtual environment in Insula Code Lab by following the guidelines below.

How to create a virtual environment

Open a Terminal window and create a virtual environment named my_env:

python -m venv /home/jovyan/my_env

Activate it:

source /home/jovyan/my_env/bin/activate

Install dependencies

Install Python dependencies in the virtual environment as follows.

• Open a terminal window and install a single module singularly:

pip install <package>

Or install modules in batch by means of a requirements file:

• Open a terminal window and type:

pip install -r requirements.txt

Install the kernel

Install the Jupyter kernel my_env:

ipython kernel install --user --name=my_env

Note: Do not forget to change the kernel to my_env using the upper-right button within the Jupyter user interface every time you want to run your code. Occasionally, a stop/start of the service is required to apply environment changes. Users can manage the server stop/start commands via the File dropdown menu under Hub Control Panel.

Contact

If you have questions or need support with these examples contact the ➡️ DestinE support.