Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

exampleMARS languagecurrent  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_2m_temperature_last_6_hours",
     "minimum_2m_temperature_last_6_hours"],
  "leadtime_hour": "6/to/36024/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>")

...