Page History

...

As the ECDS portal shares similar infrastructure as the Copernicus Climate Data Store, the existing user tokens (CDS-API keys) can be reused in ECDS. After first log in, a user must accept the ECDS terms and conditions and TIGGE/S2S licence to get the access to the data.

Be aware that currently to access different data stores (cds.ecmwf.int, ecds.ecmwf.int, etc.) the user must have separate .cdsapirc files with the correct URL for given data store (this can change in near future).

Alternatively the URL and user token can be part of the Python client definition as per Examples below.

Users are asked to pay attention to state correctly details about Affiliation, Thematic activities and Activity sectors during the registration as that information helps to understand users needs and interests, which can trigger future changes of TIGGE or S2S datasets.

...

example MARS language current WEB-API new CDS-API (MARS like) new CDS-API ("beautified" - generated by ECDS) ^*

request

retrieve,
class=ti,
date=2024-02-01/to/2024-02-03,
expver=prod,
grid=0.5/0.5,
levtype=sfc,
origin=ecmf,
param=121/122,
step=6/to/24/by/6,
time=00:00:00,
type=cf,
target="output"

#!/usr/bin/env python
from ecmwfapi import ECMWFDataServer
server = ECMWFDataServer()

server.retrieve({
    "dataset": "tigge",
    "date": "2024-02-01/to/2024-02-03",
    "expver": "prod",
    "grid": "0.5/0.5",
    "levtype": "sfc",
    "origin": "ecmf",
    "param": "121/122",
    "step": "6/to/24/by/6",
    "time": "00:00:00",
    "type": "cf",
    "target": "output"
})

#!/usr/bin/env python
import cdsapi
client = cdsapi.Client()
            
dataset = "tigge-forecasts"

request = {
    "class": "ti",
    "date": "2024-02-01/2024-02-03",
    "expver": "prod",
    "grid": "0.5/0.5",
    "levtype": "sfc",
    "origin": "ecmf",
    "param": "121/122",
    "step": "6/to/24/by/6",
    "time": "00:00:00",
    "type": "cf"
}


target = "output"
client.retrieve(dataset, request, target)

#!/usr/bin/env python
import cdsapi
client = cdsapi.Client()

dataset = "tigge-forecasts"

request = {
    "year": ["2024"],
    "month": ["02"],
    "day": ["01", "02", "03"],
    "grid": "0.5/0.5",
    "level_type": "single_level",
    "origin": "ecmf",
    "variable": ["maximum_2m2_m_temperature_in_the_last_6_hours",
       "minimum_2_2mm_temperature_in_the_last_6_hours"],
    "leadtime_hour": "6/to/24/by/6",
    "time": "00:00:00",
    "forecast_type": "control_forecast",
    "data_format": "grib"
}

target = "output"
client.retrieve(dataset, request, target)

API key

Direct access to MARS database needed

(not publicly available)

--> cat ~/.ecmwfapirc
{
    "url"   : "https://api.ecmwf.int/v1",
    "key"   : "<personal token>",
    "email" : "<personal email>"
}

--> cat $HOME/.cdsapirc
url: https://ecds.ecmwf.int/api
key: <personal token>

--> cat $HOME/.cdsapirc
url: https://ecds.ecmwf.int/api
key: <personal token>

Alternatively the url and token can be part of the Python client definition:

client = cdsapi.Client(url="https://ecds.ecmwf.int/api", 
key="<personal token>")

Alternatively the url and token can be part of the Python client definition:

client = cdsapi.Client(url="https://ecds.ecmwf.int/api", 
key="<personal token>")

...

Page tree

Versions Compared

Old Version 20

New Version Current

Key