Versions Compared

Old Version 7

changes.mady.by.user Unknown User (uscs)

Saved on

compared with

New Version 8

changes.mady.by.user Unknown User (uscs)

Saved on

Key

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

...

Retrieve example from "View MARS request":

Code Block
languagebash
titleMARS request
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,
 type=an,
 classtarget=ei

Keyword

You can find advance keywords in our MARS Documentation page:

Mars Keywords

"ei_sfc_165_41.grib"
No Format
titleMARS request explanation
#action
retrieve,

##IDENTIFICATION KEYWORDS
https://software.ecmwf.int/wiki/display/UDOC/Identification+keywords

   #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

   #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

   #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

   #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 user within MARS Service that does not appear in the MARS Documentation:

Keyworddefinition
Keyworddefinition
class

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

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.
Full list of stream definitions
expver
Is the version of the data
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

  • 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.
stepSpecifies 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.
  • Analysis (an)
  • Forecast (fc)
  • Perturbed Forecast (pf)
  • Control Forecast (cf)

Full list of type definitions

levtype

Denotes type of level:

  • Model level (ml)
  • Pressure level (pl)
  • Surface (sfc)
  • Potential vorticity (pv)
  • Potential temperature (pt)
  • Depth (dp)
param

Meteorological parameter. (t, temprerature, 130, 30.128, ...)

grid

Output grid mesh

  • Latitude/longitude increments in degrees (2.5/2.5)
  • Number of latitude lines from Pole to Equator (160)
Storage
formatYou can add format = "netcdf" to retrieve the data in NetCDF format.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"