• Polytope Examples for DT Data Access
  • Access using your Destination Earth Service Platform credentials
  • Installation
  • Climate-DT Examples
  • Extremes-DT Examples
  • On-Demand Extremes-DT Examples
  • NextGEMS Examples
  • Polytope Quota Limits for DestinE

Polytope Examples for DT Data Access

Access using your Destination Earth Service Platform credentials

This repository describes the process for accessing Destination Earth DT data via the Polytope web service hosted on the LUMI Databridge.

1. Install polytope-client from PyPI:

pip install --upgrade polytope-client

2. Retrieve a token from the Destination Earth Service Platform (DESP) by running the script included in this repository:

python desp-authentication.py -u <username> -p <password>
# see --help for more options

Or you can run the script without arguments

python desp-authentication.py 
# see --help for more options

You will then be prompted to enter your username and password if no credentials are found in a config or through environment variables.

You will need some dependencies to run the script, which can be installed using pip:

pip install --upgrade lxml conflator

The script automatically places your token in ~/.polytopeapirc where the client will pick it up. The token is a long-lived ("offline_access") token.

3. Run the example scripts in this repostory to download data, and customise them as you wish.

Installation

To run the notebooks you can use the environment.yml file provided to create a conda environment that can run the notebooks. The following commands create the environment and also create an ipykernel called earthkit than can be used in notebooks if selected.

envname=earthkit
conda create -n $envname -c conda-forge -y python=3.10
conda env update -n $envname -f environment.yml
conda activate $envname

# set earthkit environment to the default used by ipykernels
python3 -m ipykernel install --user --name=$envname

Data Locations

Data can be found on both LUMI and MN5, to access data on either change the address argument in earthkit.data.from_source() to either polytope.mn5.apps.dte.destination-earth.eu for MN5 or polytope.lumi.apps.dte.destination-earth.eu for LUMI.

Climate-DT Examples

• Climate DT Example Directory
  • Climate DT python Script
  • Climate DT notebook example
  • Climate DT notebook domain example
  • Climate DT notebook healpix regrid
  • Climate DT notebook healpix ocean
  • Climate DT notebook feature extraction timeseries
  • Climate DT MN5 notebook example
  • Climate DT MN5 monthly means notebook example

Extremes-DT Examples

• Extremes DT Example Directory
  • Extremes DT python Script
  • Extremes DT notebook example
  • Extremes DT notebook domain example
  • Extremes DT notebook regrid example
  • Extremes DT notebook feature extraction timeseries example
  • Extremes DT notebook feature extraction using H3 example

On-Demand Extremes-DT Examples

• On-Demand Extremes DT Example Directory
  • On-Demand Extremes DT python Script
  • On-Demand Extremes DT notebook example

NextGEMS Examples

• NextGEMS Example Directory
  • NextGEMS historical 1990-2020 Notebook
  • NextGEMS scenario 2020-2050 Notebook

Polytope Quota Limits for DestinE

To ensure system stability and fair usage, the following operational limits are enforced:

• API Rate Limit: Up to 50 requests per second. This limit may be adjusted based on system usage.
• Concurrent Operations Limit: A maximum of 5 download requests can be active at the same time.

Please plan your usage accordingly to avoid interruptions.