Introduction
This is a brief introduction of the main request parameter syntax.
We recommend that you get familiar with datasets and their availability using http://apps.ecmwf.int/datasets/
You can also get the request syntax using "View MARS request" feature.
Syntax
verb, keyword1 = value1, ... = value2, keywordN = valueN
- verb: action to be taken (e.g. retrieve, list, read)
- keyword: a known MARS variable, e.g. type or date
- value: value assigned to the keyword, e.g. Analysis or temperature
Retrieve example from "View MARS request":
MARS request retrieve, stream=oper, levtype=sfc, param=165.128/41.128, "dataset"=interim, step=0, grid=0.75/0.75, time=00, date=2013-09-01/to/2013-09-30, type=an, class=ei | Python equivalence #!/usr/bin/env python from ecmwfapi import ECMWFDataServer server = ECMWFDataServer() server.retrieve({ 'dataset' : "interim", 'time' : "00", 'date' : "2013-09-01/to/2013-09-30", 'step' : "0", 'type' : "an", 'levtype' : "sfc", 'param' : "165.128/41.128", 'grid' : "0.75/0.75", 'target' : "interim201309.grib" }) |
Keyword
Keyword | definition |
---|---|
dataset | See Dataset section below. |
Date & Time | |
time | Base time (00, 06, 12 and 18) Observation time (HHMM or HH:MM: ie 09:30) |
date | Specifies the Analysis date, the Forecast base date or Observations date. Formats
|
step | Specifies the forecast time step from forecast base time. Valid values are hours (HH) |
Fields | |
type | Determines the type of field to be retrieved: This keyword makes the selection between observations, images or fields, and it determines some of the valid remaining keywords of the request.
|
levtype | Denotes type of level:
|
param | Meteorological parameter. (t, temprerature, 130, 30.128, ...) |
grid | Output grid mesh
|
Storage | |
target | specifies a Unix file into which data is to be written after retrieval or manipulation. Path names should always be enclosed in double quotes: target = "analysis.grb" |
Datasets
To access these datasets, you need to agree on the corresponding terms and conditions that can be found under the "Licence" link in the table below.
Catalogues can be found in http://apps.ecmwf.int/datasets
Dataset | Description | Licence | Catalogue |
---|---|---|---|
era15 | ECMWF Global Reanalysis Data - ERA-15 (Jan 1979 - Dec 1993) | general | http://apps.ecmwf.int/datasets/data/era15 |
era20c | Reanalysis of the 20th-century using surface observations only (Jan 1900 - Dec 2010): | general | http://apps.ecmwf.int/datasets/data/era20c_daily |
era20cmv0 | ERA-20CM: Ensemble of climate model integrations (Experimental version) | general | http://apps.ecmwf.int/datasets/data/era20cmv0_edmm |
era40 | ECMWF Global Reanalysis Data - ERA-40 (Sep 1957 - Aug 2002) | general | http://apps.ecmwf.int/datasets/data/era40_daily |
eraclim | ERA-20CM: Ensemble of climate model integrations | general | Coming soon... |
icoads | ICOADS v2.5.1 with interpolated 20CR feedback | general | http://apps.ecmwf.int/datasets/data/icoads |
interim | ECMWF Global Reanalysis Data - ERA Interim (Jan 1979 - present) | general | http://apps.ecmwf.int/datasets/data/interim_full_daily |
ispd | ISPD v2.2 | general | http://apps.ecmwf.int/datasets/data/ispd |
macc | MACC | macc | http://apps.ecmwf.int/datasets/data/macc_reanalysis |
macc_nrealtime | MACC Near Real-time | macc_nrealtime | http://apps.ecmwf.int/datasets/data/macc_nrealtime/ |
tigge | TIGGE (THORPEX Interactive Grand Global Ensemble) | tigge | http://apps.ecmwf.int/datasets/data/tigge |
yotc | YOTC (Year of Tropical Convection) | general | http://apps.ecmwf.int/datasets/data/yotc_od |