...
| Note |
|---|
We recommend that you get familiar with datasets archive data and their availability using http://apps.ecmwf.int/datasets/ MARS catalogue You can also get the request syntax using "View MARS request" feature. |
...
| Code Block | ||
|---|---|---|
| ||
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":
| Code Block | ||
|---|---|---|
| ||
retrieve,
stream=oper,
levtype=sfc,
param=165.128/41.128 |
...
,
step=0,
grid=0.75/0.75,
time=00,
date=2013-09-01/to/2013-09-30,
type=an,
class=ei
|
...
Keyword
language
py
title Python equivalence
| Keyword |
|---|
| definition |
|---|
#!/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
| class | Specifies the ECMWF classification given to the data
|
| stream | Identifies the forecasting system used to generated the data when the same meteorological types are archived For example, oper is used for the Operational Atmospheric model and wave for the Wave model. Both models produce Analysis and Forecast data types. |
| expver | Is the version of the data |
| 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" |
...
" |
...
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 |