This repository describes the process for accessing Destination Earth DT data via the Polytope web service hosted on the LUMI Databridge.
- Install polytope-client from PyPI:
pip install --upgrade polytope-client
- 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.
- Run the example scripts in this repostory to download data, and customise them as you wish.
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