| example | MARS language | current WEB-API | new CDS-API (MARS like) | new CDS-API ("beautified" - generated by ECDS) * |
|---|---|---|---|---|
TIGGE Ensemble Control Forecast Single level | retrieve, class=ti, date=2024-02-01/to/2024-02-03, expver=prod, grid=0.5/0.5, levtype=sfc, model=glob, 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/24/by/6",
"time": "00:00:00",
"forecast_type": "control_forecast",
"data_format": "grib"
}
target = "output"
client.retrieve(dataset, request, target)
|
S2S Ensemble Control Forecast Single level | retrieve, class=s2, date=2024-02-02, expver=prod, grid=0.5/0.5, levtype=sfc, model=glob, origin=ecmf, param=165/166, step=6/to/24/by/6, stream=enfo, time=00:00:00, type=cf, target="output" | #!/usr/bin/env python
from ecmwfapi import ECMWFDataServer
server = ECMWFDataServer()
server.retrieve(
{
"dataset": "s2s",
"class": "s2",
"date": "2022-05-02",
"expver": "prod",
"grid": "0.5/0.5",
"levtype": "sfc",
"origin": "ecmf",
"param": "165/166",
"step": "6/to/24/by/6",
"time": "00:00:00",
"stream": "enfo",
"type": "cf",
"target": "output"
})
| #!/usr/bin/env python
import cdsapi
client = cdsapi.Client()
dataset = "s2s-forecasts"
request = {
"dataset": "s2s",
"class": "s2",
"date": "2022-05-02",
"expver": "prod",
"grid": "0.5/0.5",
"levtype": "sfc",
"origin": "ecmf",
"param": "165/166",
"step": "6/to/24/by/6",
"time": "00:00:00",
"stream": "enfo",
"type": "cf"
}
target = "output"
client.retrieve(dataset, request, target)
| #!/usr/bin/env python
import cdsapi
client = cdsapi.Client()
dataset = "s2s-forecasts"
request = {
"origin": "ecmwf",
"forecast_type": "control_forecast",
"level_type": "single_level",
"variable": [
"10m_u_component_of_wind",
"10m_v_component_of_wind"
],
"year": "2022",
"month": "05",
"day": "02",
"leadtime_hour": [
"6",
"12",
"18",
"24"
],
"time": "00:00",
"grid": "0.5/0.5",
"data_format": "grib"
}
target = "output"
client.retrieve(dataset, request, target)
|
S2S Ensemble Control Re-Forecast Single level | retrieve, class=s2, hdate=2022-05-02, date=2024-05-02, expver=prod, grid=0.5/0.5, levtype=sfc, model=glob, origin=ecmf, param=165/166, step=6/to/24/by/6, stream=enfh, time=00:00:00, type=cf, target="output" | #!/usr/bin/env python
from ecmwfapi import ECMWFDataServer
server = ECMWFDataServer()
server.retrieve(
{
"dataset": "s2s",
"class": "s2",
"hdate": "2022-05-02",
"date": "2024-05-02",
"expver": "prod",
"grid": "0.5/0.5",
"levtype": "sfc",
"origin": "ecmf",
"param": "165/166",
"step": "6/to/24/by/6",
"time": "00:00:00",
"stream": "enfh",
"type": "cf",
"target": "output"
})
| #!/usr/bin/env python
import cdsapi
client = cdsapi.Client()
dataset = "s2s-reforecasts"
request = {
"dataset": "s2s",
"class": "s2",
"hdate": "2022-05-02",
"date": "2024-05-02",
"expver": "prod",
"grid": "0.5/0.5",
"levtype": "sfc",
"origin": "ecmf",
"param": "165/166",
"step": "6/to/24/by/6",
"time": "00:00:00",
"stream": "enfh",
"type": "cf"
}
target = "output"
client.retrieve(dataset, request, target)
| #!/usr/bin/env python
import cdsapi
client = cdsapi.Client()
dataset = "s2s-reforecasts"
request = {
"origin": "ecmwf",
"forecast_type": "control_forecast",
"level_type": "single_level",
"variable": [
"10m_u_component_of_wind",
"10m_v_component_of_wind"
],
"hyear": ["2022"],
"hmonth": ["05"],
"hday": ["02"],
"leadtime_hour": [
"6",
"12",
"18",
"24"
],
"time": "00:00",
"year": "2024",
"month": "05",
"day": "02",
"grid": "0.5/0.5",
"data_format": "grib"
}
target = "output"
client.retrieve(dataset, request, target)
|
TIGGE Ensemble Perturbed Forecast Single level
| retrieve, class=ti, date=2024-02-02, expver=prod, grid=0.5/0.5, levtype=sfc, model=glob, origin=ecmf, param=121/122, step=6/to/24/by/6, time=00:00:00, type= pf, number=35/to/40/by/1, target="output" | #!/usr/bin/env python
from ecmwfapi import ECMWFDataServer
server = ECMWFDataServer()
server.retrieve(
{
"dataset": "tigge",
"date": "2024-02-02",
"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": "pf",
"number": "1/to/50/by/1",
"target": "output"
})
| #!/usr/bin/env python
import cdsapi
client = cdsapi.Client()
dataset = "tigge-forecasts"
request = {
"class": "ti",
"date": "2024-02-02",
"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": "pf"
}
target = "output"
client.retrieve(dataset, request, target)
| #!/usr/bin/env python
import cdsapi
client = cdsapi.Client()
dataset = "tigge-reforecasts"
request = {
"forecast_type": "perturbed_forecast",
"origin": "ecmwf",
"level_type": "single_level",
"year": "2024",
"month": "02",
"day": "02",
"time": "00:00",
"leadtime_hour": [
"6",
"12",
"18",
"24"
],
"variable": [
"maximum_2m_temperature_last_6_hours",
"minimum_2m_temperature_last_6_hours"
],
"grid": "0.5/0.5",
"data_format": "grib"
}
target = "output"
client.retrieve(dataset, request, target)
|
S2S Ensemble Perturbed Forecast Single level
| retrieve, class=s2, date=2022-02-03, expver=prod, grid=0.5/0.5, levtype=sfc, model=glob, origin=ecmf, param=165/166, step=6/to/24/by/6, stream=enfo, time=00:00:00, type=pf, number=1/10/50, target="output" | #!/usr/bin/env python
from ecmwfapi import ECMWFDataServer
server = ECMWFDataServer()
server.retrieve(
{
"dataset": "s2s",
"class": "s2",
"date": "2022-02-03",
"expver": "prod",
"grid": "0.5/0.5",
"levtype": "sfc",
"origin": "ecmf",
"param": "165/166",
"step": "6/to/24/by/6",
"time": "00:00:00",
"stream": "enfo",
"type": "pf",
"number": "1/10/50",
"target": "output"
})
| #!/usr/bin/env python
import cdsapi
client = cdsapi.Client()
dataset = "s2s-forecasts"
request = {
"dataset": "s2s",
"class": "s2",
"date": "2022-02-03",
"expver": "prod",
"grid": "0.5/0.5",
"levtype": "sfc",
"origin": "ecmf",
"param": "165/166",
"step": "6/to/24/by/6",
"time": "00:00:00",
"stream": "enfo",
"type": "pf"
}
target = "output"
client.retrieve(dataset, request, target)
| #!/usr/bin/env python
import cdsapi
client = cdsapi.Client()
dataset = "s2s-reforecasts"
request = {
"origin": "ecmwf",
"forecast_type": "perturbed_forecast",
"level_type": "single_level",
"variable": [
"10m_u_component_of_wind",
"10m_v_component_of_wind"
],
"year": "2022",
"month": "02",
"day": "03",
"leadtime_hour": [
"6",
"12",
"18",
"24"
],
"time": "00:00",
"grid": "0.5/0.5",
"data_format": "grib"
}
target = "output"
client.retrieve(dataset, request, target)
|
S2S Ensemble Perturbed Re-Forecast Single level
| retrieve, class=s2, hdate=2022-05-02, date=2024-05-02, expver=prod, grid=0.5/0.5, levtype=sfc, model=glob, origin=ecmf, param=165/166, step=6/to/24/by/6, stream=enfh, time=00:00:00, type=pf, number=1/to/10, area=70/-10/25/50, target="output" | #!/usr/bin/env python
from ecmwfapi import ECMWFDataServer
server = ECMWFDataServer()
server.retrieve(
{
"dataset": "s2s",
"class": "s2",
"hdate": "2022-05-02",
"date": "2024-05-02",
"expver": "prod",
"grid": "0.5/0.5",
"levtype": "sfc",
"origin": "ecmf",
"param": "165/166",
"step": "6/to/24/by/6",
"time": "00:00:00",
"stream": "enfh",
"type": "pf",
"number": "1/to/10",
"area": "70/-10/25/50",
"target": "output"
})
| #!/usr/bin/env python
import cdsapi
client = cdsapi.Client()
dataset = "s2s-reforecasts"
request = {
"dataset": "s2s",
"class": "s2",
"hdate": "2022-05-02",
"date": "2024-05-02",
"expver": "prod",
"grid": "0.5/0.5",
"levtype": "sfc",
"origin": "ecmf",
"param": "165/166",
"step": "6/to/24/by/6",
"time": "00:00:00",
"stream": "enfh",
"type": "pf",
"area": "70/-10/25/50"
}
target = "output"
client.retrieve(dataset, request, target)
| #!/usr/bin/env python
import cdsapi
client = cdsapi.Client()
dataset = "s2s-reforecasts"
request = {
"origin": "ecmwf",
"forecast_type": "perturbed_forecast",
"level_type": "single_level",
"variable": [
"10m_u_component_of_wind",
"10m_v_component_of_wind"
],
"hyear": ["2022"],
"hmonth": ["05"],
"hday": ["02"],
"leadtime_hour": [
"6",
"12",
"18",
"24"
],
"time": "00:00",
"year": "2024",
"month": "05",
"day": "02",
"data_format": "grib",
"area": [70, -10, 25, 50],
"grid": "0.5/0.5",
"data_format": "grib"
}
target = "output"
client.retrieve(dataset, request, target)
|
Notes
For S2S and TIGGE perturbed forecast (type=pf) webAPI offers "number" keyword for selection of ensemble members, ECDS doesn't offer this and one is forced to download all ens members.