| Table of Contents | ||
|---|---|---|
|
Introduction
This is a brief introduction of the main request parameter syntax.
| Note |
|---|
We recommend that you get familiar with archive the data and their its availability using MARS catalogueCatalogue You can also get the request syntax using " View MARS request " feature. |
Syntax
| Code Block | ||
|---|---|---|
| ||
verb,
keyword1 = value1,
... = value2,
keywordN = valueN |
...
Retrieve example from "View MARS request":
| Code Block | ||||
|---|---|---|---|---|
| ||||
retrieve, class=ei, stream=oper, expver=1, levtype=sfc, param=165.128/41.128, step=0, grid=0.75/0.75, time=00, date=2013-09-01/to/2013-09-30, area=75/-15/30/42.5, type=an, classtarget=ei |
Keyword
You can find advance keywords in our MARS Documentation page:
"ei_sfc_165_41.grib" |
MARS Request explanation
Identification Keywords
https://software.ecmwf.int/wiki/display/UDOC/Identification+keywords
| No Format |
|---|
#Specifies the ECMWF classification given to the data
class=ei,
#Identifies the forecasting system used to generated the data when the same meteorological types are archived
stream=oper,
#Is the version of the data, 1 is OPERATIONAL
expver=1,
#Denotes type of level
levtype=sfc,
#Meteorological parameter
param=165.128/41.128,
#Determines the type of field to be retrieved:
type=an, |
Date and Time Keywords
https://software.ecmwf.int/wiki/display/UDOC/Date+and+time+keywords
| No Format |
|---|
#Specifies the forecast time step from forecast base time
step=0,
#Base time
time=00,
#Specifies the Analysis date, the Forecast base date or Observations date
date=2013-09-01/to/2013-09-30, |
Post Processing Keywords
https://software.ecmwf.int/wiki/display/UDOC/Post-processing+keywords
| No Format |
|---|
#Output grid mesh
grid=0.75/0.75,
#Area
area=75/-15/30/42.5, |
Data Storage Keywords
https://software.ecmwf.int/wiki/display/UDOC/Data+storage+keywords
| No Format |
|---|
#specifies a Unix file into which data is to be written after retrieval
target="ei_sfc_165_41.grib",
##OPTIONAL MARS SERVICE KEYWORD
#(Optional) argument to retrieve NetCDF format
format=netcdf,
|
Keywords
You can find all the keyword explanation in our Mars Keywords page.
There is an extra keyword that you can use in Access MARS that does not appear in the MARS Documentation:
| Keyword | definition |
|---|---|
| format | You can add format = netcdf to retrieve the data in NetCDF format. |
Specifies the ECMWF classification given to the data
- Operations (od)
- Research experiments (rd)
- Re-Analysis datasets (e4 for ERA-40, er for ERA-15)
- European Climate Network Support (cs)
- DEMETER project (dm)
Full list of class definitions
Base time (00, 06, 12 and 18)
Observation time (HHMM or HH:MM: ie 09:30)
Specifies the Analysis date, the Forecast base date or Observations date. Formats
- Absolute as YYYY-MM-DD, YYYYMMDD. The day of the year can also be used: YYYY-DDD
- Relative as -n ; n is the number of days before today (i.e., -1 = yesterday )
- Name of month (e.g. january for Climatology data)
- Operational monthly means are retrieved by setting day (DD) to 00.
Determines the type of field to be retrieved:
- Analysis (an)
- Forecast (fc)
- Perturbed Forecast (pf)
- Control Forecast (cf)
Full list of type definitions
Denotes type of level:
- Model level (ml)
- Pressure level (pl)
- Surface (sfc)
- Potential vorticity (pv)
- Potential temperature (pt)
- Depth (dp)
Meteorological parameter. (t, temprerature, 130, 30.128, ...)
Output grid mesh
- Latitude/longitude increments in degrees (2.5/2.5)
- Number of latitude lines from Pole to Equator (160)