## 2.1 Service Description¶

MARS is ECMWF's Meteorological Archival and Retrieval System. The MARS archive is the world's largest archive of meteorological data with more than 130 PB of data. Every day, ECMWF produces various global Analyses and Forecasts and archives them in MARS. A comprehensive list of what data MARS contains, can be found here.

MARS contains a wide range of public datasets that can be accessed via two ways:

• the Dataset Web Interface, which is an interface that helps you to navigate through the data in a dynamic and user-friendly way, and
• the Web-API, which is a programmatic way via e.g. Python to download data.

Further, a selection of various different freely available data sets of ECMWF/Copernicus is given. Practical examples show how datasets can be downloaded and retrieved in a programmatic way.

## 2.2 Available datasets¶

NOTE: We subsequently present you a selection of data sets we think that can be of most interest. Our MARS archive contains many more data of meteorological parameters. A full overview of all parameters available can be found under the respecitve web access links of the different data set groups.

### Global reanalysis + Deterministic and probabilistic forecasts¶

Web access: http://apps.ecmwf.int/datasets/data/interim-full-daily/levtype=sfc/
License: The Licensee is authorised to use on a non-exclusive basis the Archive Products for its own purposes, including research, education and activities for commercial gain (http://apps.ecmwf.int/datasets/data/interim-full-daily/licence/)
Data set: interim

Level type: Surface (sfc)

Field types:
- Daily - stream: oper,
- Monthly Means of Daily means - stream: moda

MARS request example
"class": "ei",
"dataset": "interim",
"date": "2016-12-01/to/2016-12-31",
"expver": "1"
"grid": "0.75/0.75",
"levtype": "sfc",
"param": "167.128",
"step": "0",
"stream": "oper",
"time": "00:00:00",
"type": "an",
"target": "CHANGEME",

Dataset Param Type Level type Spatial resolution Temporal resolution Time Step Format
2 metre temperature 167.128 - Analysis (an)
- Forecast (fc)
Surface Global 1 Jan 1979 - 31 Oct 2016 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3 hours up to step 12
GRIB, netCDF
10 metre wind
- U component
- V component
165.128
166
- Analysis (an)
- Forecast (fc)
Surface Global 1 Jan 1979 - 31 Oct 2016 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3 hours up to step 12
GRIB, netCDF
10 metre wind gust 49.128 - Forecast (fc) Surface Global 1 Jan 1979 - 31 Oct 2016 - 00 / 12 - 3 hours up to step 12 GRIB, netCDF
Convective available potential energy 59.128 - Forecast (fc) Surface Global 1 Jan 1979 - 31 Oct 2016 - 00 / 12 - 3 hours up to step 12 GRIB, netCDF
Mean sea level pressure 151.128 - Analysis (an)
- Forecast (fc)
Surface Global 1 Jan 1979 - 31 Oct 2016 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3 hours up to step 12
GRIB, netCDF
Sea surface temperature 34.128 - Analysis (an)
- Forecast (fc)
Surface Global 1 Jan 1979 - 31 Oct 2016 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3 hours up to step 12
GRIB, netCDF
Runoff 205.128 - Forecast (fc) Surface Global 1 Jan 1979 - 31 Oct 2016 - 00 / 12 - 3 hours up to step 12 GRIB, netCDF
Snowfall 144.128 - Forecast (fc) Surface Global 1 Jan 1979 - 31 Oct 2016 - 00 / 12 - 3 hours up to step 12 GRIB, netCDF
Surface pressure 134.128 - Analysis (an)
- Forecast (fc)
Surface Global 1 Jan 1979 - 31 Oct 2016 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3 hours up to step 12
GRIB, netCDF
Surface solar radiation downwards 169.128 - Forecast (fc) Surface Global 1 Jan 1979 - 31 Oct 2016 - 00 / 12 - 3 hours up to step 12 GRIB, netCDF
Sunshine duration 189.128 - Forecast (fc) Surface Global 1 Jan 1979 - 31 Oct 2016 - 00 / 12 - 3 hours up to step 12 GRIB, netCDF
Evaporation 182.128 - Forecast (fc) Surface Global 1 Jan 1979 - 31 Oct 2016 - 00 / 12 - 3 hours up to step 12 GRIB, netCDF
Surface thermal radiation downwards 175.128 - Forecast (fc) Surface Global 1 Jan 1979 - 31 Oct 2016 - 00 / 12 - 3 hours up to step 12 GRIB, netCDF
Surface net solar radiation 176.128 - Forecast (fc) Surface Global 1 Jan 1979 - 31 Oct 2016 - 00 / 12 - 3 hours up to step 12 GRIB, netCDF
Surface net thermal radiation 177.128 - Forecast (fc) Surface Global 1 Jan 1979 - 31 Oct 2016 - 00 / 12 - 3 hours up to step 12 GRIB, netCDF
Total precipitation 228.128 - Forecast (fc) Surface Global 1 Jan 1979 - 31 Oct 2016 - 00 / 12 - 3 hours up to step 12 GRIB, netCDF
Total column ozone 206.128 - Analysis (an)
- Forecast (fc)
Surface Global 1 Jan 1979 - 31 Oct 2016 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3 hours up to step 12
GRIB, netCDF

Level type: Pressure level in hPa (pl)
1000 / 925 / 850 / 700 / 500 / 400 / 300 / 250 / 200 / 150 / 100 / 70 / 50 / 30 / 20 / 10 / 7 / 5 / 3 / 2 / 1

MARS request example
"class": "ei",
"dataset": "interim",
"date": "2016-12-01/to/2016-12-31",
"expver": "1",
"grid": "0.75/0.75",
"levelist": "800/900/975/1000",
"levtype": "pl",
"param": "155.128",
"step": "0",
"stream": "oper",
"time": "00:00:00/06:00:00",
"type": "an",
"target": "CHANGEME",

Dataset Param Type Level type Spatial resolution Temporal resolution Time Format
Divergence 155.128 Analysis (an) Pressure levels Global 1 Jan 1979 - 31 Oct 2016 00 / 06 / 12 / 18 GRIB, netCDF
Fraction of cloud cover 123.210 Analysis (an) Pressure levels Global 1 Jan 1979 - 31 Oct 2016 00 / 06 / 12 / 18 GRIB, netCDF
Geopotential 129.128 Analysis (an) Pressure levels Global 1 Jan 1979 - 31 Oct 2016 00 / 06 / 12 / 18 GRIB, netCDF
Ozone mass mixing ratio 203.128 Analysis (an) Pressure levels Global 1 Jan 1979 - 31 Oct 2016 00 / 06 / 12 / 18 GRIB, netCDF
Potential vorticity 248.128 Analysis (an) Pressure levels Global 1 Jan 1979 - 31 Oct 2016 00 / 06 / 12 / 18 GRIB, netCDF
Relative humidity 130.128 Analysis (an) Pressure levels Global 1 Jan 1979 - 31 Oct 2016 00 / 06 / 12 / 18 GRIB, netCDF
Specific humidity 133.128 Analysis (an) Pressure levels Global 1 Jan 1979 - 31 Oct 2016 00 / 06 / 12 / 18 GRIB, netCDF
Temperature 157.128 Analysis (an) Pressure levels Global 1 Jan 1979 - 31 Oct 2016 00 / 06 / 12 / 18 GRIB, netCDF
Wind
- U component
- V component

- 131.128
- 132.128
Analysis (an) Pressure levels Global 1 Jan 1979 - 31 Oct 2016 00 / 06 / 12 / 18 GRIB, netCDF
Vertical velocity 135.128 Analysis (an) Pressure levels Global 1 Jan 1979 - 31 Oct 2016 00 / 06 / 12 / 18 GRIB, netCDF
Vorticity (relative) 138.128 Analysis (an) Pressure levels Global 1 Jan 1979 - 31 Oct 2016 00 / 06 / 12 / 18 GRIB, netCDF

### Atmospheric composition¶

#### CAMS Near-real-time¶

Web access: http://apps.ecmwf.int/datasets/data/cams-nrealtime/levtype=sfc/
License: This License is free of charge, worldwide, non-exclusive, royalty free and perpetual. Access to CAMS Information is given for the purpose of the following use in so far as it is lawful: reproduction; distribution; communication to the public; adaptation, modification and combination with other data and information; any combination of points (1) to (4) (http://apps.ecmwf.int/datasets/data/cams-nrealtime/licence/).
Data set: cams_nrealtime

Level Type: Surface (sfc)

MARS request example
"class": "mc",
"dataset": "cams_nrealtime",
"date": "2012-07-05/to/2012-07-31",
"expver": "0001",
"levtype": "sfc",
"param": "167.128",
"step": "0/3",
"stream": "oper",
"time": "00:00:00/12:00:00",
"type": "fc",
"target": "CHANGEME",

Dataset Param Type Level type Spatial resolution Temporal resolution Time Step Format
2 metre dewpoint temperature 168.128 - Analysis (an)
- Forecast (fc)
Surface Global 1 Jul 2012 - 31 Jan 2017 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 120
GRIB, netCDF
2 metre temperature 167.128 - Analysis (an)
- Forecast (fc)
Surface Global 1 Jul 2012 - 31 Jan 2017 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 120
GRIB, netCDF
10 metre
- U wind component
- V wind component

165.128
166.128
- Analysis (an)
- Forecast (fc)
Surface Global 1 Jul 2012 - 31 Jan 2017 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 120
GRIB, netCDF
- UV biologically effective dose
- UV biologically effective dose clear-sky
2.214
3.214
- Forecast (fc) Surface Global 1 Jun 2016 - 31 Jan 2017 - 00 / 12 - 3-hours up to step 120 GRIB, netCDF
Albedo 174.128 - Analysis (an) Surface Global 1 Jul 2012 - 31 Jan 2017 - 00 / 06 / 12 / 18 - 0 GRIB, netCDF
Black Carbon Aerosol Optical Depth at 550 nm 211.210 - Forecast (fc) Surface Global 1 Jul 2012 - 31 Jan 2017 - 00 / 12 - 3-hours up to step 120 GRIB, netCDF
Convective Precipitation 143.128 - Forecast (fc) Surface Global 1 Jul 2012 - 31 Jan 2017 - 00 / 12 - 3-hours up to step 120 GRIB, netCDF
Dust emission potential 52.210 - Analysis (an)
- Forecast (fc)
Surface Global 1 Jul 2012 - 31 Jan 2017 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 120
GRIB, netCDF
Forecast Albedo 243.128 - Forecast (fc) Surface Global 1 Jul 2012 - 31 Jan 2017 - 00 / 12 - 3-hours up to step 120 GRIB, netCDF
GEMS Total column ozone 206.210 - Analysis (an)
- Forecast (fc)
Surface Global 1 Jul 2012 - 31 Jan 2017 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 120
GRIB, netCDF
Geopotential 129.128 - Analysis (an) Surface Global 1 Jul 2012 - 31 Jan 2017 - 00 / 06 / 12 / 18 - 0 GRIB, netCDF
Cloud cover
- high
- medium
- low

188.128
187.128
186.128
- Analysis (an)
- Forecast (fc)
Surface Global 1 Jul 2012 - 31 Jan 2017 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 120
GRIB, netCDF
Land-sea mask 172.128 - Analysis (an)
- Forecast (fc)
Surface Global 1 Jul 2012 - 31 Jan 2017 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 120
GRIB, netCDF
Large scale precipitation 142.128 - Forecast (fc) Surface Global 1 Jul 2012 - 31 Jan 2017 - 00 / 12 - 3-hours up to step 120 GRIB, netCDF
Particulate matter
- d < 1um
- d < 2.5 um
- d < 10 um

72.210
73.210
74.210
- Forecast (fc) Surface Global 1 Jul 2014 - 31 Jan 2017 - 00 / 12 - 3-hours up to step 120 GRIB, netCDF
Sea surface temperature 34.128 - Analysis (an)
- Forecast (fc)
Surface Global 1 Jul 2012 - 31 Jan 2017 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 120
GRIB, netCDF
Snowfall 144.128 - Forecast (fc) Surface Global 1 Jul 2012 - 31 Jan 2017 - 00 / 12 - 3-hours up to step 120 GRIB, netCDF
Aerosol Optical Depth at 550 nm
- Dust
- Organic Matter
- Sulphate
- Sea Salt

209.210
208.210
210.210
212.210
- Forecast (fc) Surface Global 1 Jul 2012 - 31 Jan 2017 - 00 / 12 - 3-hours up to step 120 GRIB, netCDF
Total Aerosol Optical Depth at
- 469 nm
- 550 nm
- 670 nm
- 865 nm
- 1240 nm

207.210
213.210
214.210
215.210
216.210
- Forecast (fc) Surface Global 1 Jul 2012 - 31 Jan 2017 - 00 / 12 - 3-hours up to step 120 GRIB, netCDF
Total cloud cover 164.128 - Analysis (an)
- Forecast (fc)
Surface Global 1 Jul 2012 - 31 Jan 2017 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 120
GRIB, netCDF
Total column
- Nitrogen Oxides
- ethane
- isoprene
- peroxyacetyl nitrate
- Carbon monoxide
- Formaldehyde
- Nitrogen dioxide
- Sulphur dioxide
- methane
- nitric acid
- nitrogen monoxide
- propane
- water vapour

130.210
16.218
45.218
13.218
127.210
125.210
128.210
30.218
126.210
4.218
6.218
27.218
47.218
137.128
- Analysis (an)
- Forecast (fc)
Surface Global 1 Sep 2014 - 31 Jan 2017 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 120
GRIB, netCDF

Level Type: pressure level in hPa (pl)
1000 / 925 / 850 / 700 / 500 / 400 / 300 / 250 / 200 / 150 / 100 / 70 / 50 / 30 / 20 / 10 / 7 / 5 / 3 / 2 / 1

MARS request example
"class": "mc",
"dataset": "cams_nrealtime",
"date": "2017-02-01/to/2017-02-26",
"expver": "0001",
"levelist": "500/850/1000",
"levtype": "pl",
"param": "123.210",
"step": "3",
"stream": "oper",
"time": "00:00:00",
"type": "fc",
"target": "CHANGEME",

Dataset Param Type Level type Spatial resolution Temporal resolution Time Step Format
Carbon monoxide 123.210 - Analysis (an)
- Forecast (fc)
Pressure levels Global 1 Jul 2012 - 31 Jan 2017 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 120
GRIB, netCDF
Divergence 155.128 - Analysis (an)
- Forecast (fc)
Pressure levels Global 1 Jul 2012 - 31 Jan 2017 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 120
GRIB, netCDF
Dust Aerosol Mixing Ration
- 0.03 - 0.55 um
- 0.55 - 0.9 um
- 0.9 - 20 um

4.210
5.210
6.210
- Analysis (an)
- Forecast (fc)
Pressure levels Global 1 Jul 2012 - 31 Jan 2017 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 120
GRIB, netCDF
Ethane 45.217 - Analysis (an)
- Forecast (fc)
Pressure levels Global 1 Jul 2012 - 31 Jan 2017 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 120
GRIB, netCDF
Formaldehyde 124.210 - Analysis (an)
- Forecast (fc)
Pressure levels Global 1 Jul 2012 - 31 Jan 2017 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 120
GRIB, netCDF
GEMS Ozone 203.210 - Analysis (an)
- Forecast (fc)
Pressure levels Global 1 Jul 2012 - 31 Jan 2017 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 120
GRIB, netCDF
Geopotential 129.128 - Analysis (an)
- Forecast (fc)
Pressure levels Global 1 Jul 2012 - 31 Jan 2017 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 120
GRIB, netCDF
Hydrophilic Aerosol Mixing Ratio
- Black Carbon
- Organic Matter

7.210
8.210
- Analysis (an)
- Forecast (fc)
Pressure levels Global 1 Jul 2012 - 31 Jan 2017 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 120
GRIB, netCDF
Hydrophobic Aerosol Mixing Ratio
- Black Carbon
- Organic Matter

9.210
10.210
- Analysis (an)
- Forecast (fc)
Pressure levels Global 1 Jul 2012 - 31 Jan 2017 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 120
GRIB, netCDF
Hydroxyl radical 4.217 - Analysis (an)
- Forecast (fc)
Pressure levels Global 1 Jul 2012 - 31 Jan 2017 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 120
GRIB, netCDF
Isoprene 6.217 - Analysis (an)
- Forecast (fc)
Pressure levels Global 1 Jul 2012 - 31 Jan 2017 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 120
GRIB, netCDF
Methane 16.217 - Analysis (an)
- Forecast (fc)
Pressure levels Global 1 Jul 2012 - 31 Jan 2017 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 120
GRIB, netCDF
Nitric acid 30.217 - Analysis (an)
- Forecast (fc)
Pressure levels Global 1 Jul 2012 - 31 Jan 2017 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 120
GRIB, netCDF
Nitrogen
- Oxides
- Dioxide
- Monoxide

27.217
121.210
129.210
- Analysis (an)
- Forecast (fc)
Pressure levels Global 1 Jul 2012 - 31 Jan 2017 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 120
GRIB, netCDF
Peroxyacetyl nitrate 13.217 - Analysis (an)
- Forecast (fc)
Pressure levels Global 1 Jul 2012 - 31 Jan 2017 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 120
GRIB, netCDF
Potential vorticity 60.128 - Analysis (an) Pressure levels Global 1 Jul 2014 - 31 Jan 2017 - 00 / 06 / 12 / 18 - 0 GRIB, netCDF
Propane 48.217 - Analysis (an)
- Forecast (fc)
Pressure levels Global 1 Jul 2012 - 31 Jan 2017 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 120
GRIB, netCDF
Relative humidity 157.128 - Analysis (an)
- Forecast (fc)
Pressure levels Global 1 Jul 2012 - 31 Jan 2017 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 120
GRIB, netCDF
Sea Salt Aerosol Mixing Ratio
- 0.03 -0.5 um
- 0.5 - 5 um
- 5 - 20 um

1.210
2.210
3.210
- Analysis (an)
- Forecast (fc)
Pressure levels Global 1 Jul 2012 - 31 Jan 2017 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 120
GRIB, netCDF
Specific humidity 133.128 - Analysis (an) Pressure levels Global 1 Jul 2012 - 31 Jan 2017 - 00 / 06 / 12 / 18 - 0 GRIB, netCDF
Sulphate Aerosol Mixing Ratio 11.210 - Analysis (an)
- Forecast (fc)
Pressure levels Global 1 Jul 2012 - 31 Jan 2017 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 120
GRIB, netCDF
Sulphur dioxide 122.210 - Analysis (an)
- Forecast (fc)
Pressure levels Global 1 Jul 2012 - 31 Jan 2017 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 120
GRIB, netCDF
Temperature 130.128 - Analysis (an)
- Forecast (fc)
Pressure levels Global 1 Jul 2012 - 31 Jan 2017 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 120
GRIB, netCDF
Vorticity 138.128 - Analysis (an)
- Forecast (fc)
Pressure levels Global 1 Jul 2012 - 31 Jan 2017 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 120
GRIB, netCDF

#### CAMS Global Fire Assimilation System¶

Web access: http://apps.ecmwf.int/datasets/data/cams-gfas/
License: This License is free of charge, worldwide, non-exclusive, royalty free and perpetual. Access to CAMS Information is given for the purpose of the following use in so far as it is lawful: reproduction; distribution; communication to the public; adaptation, modification and combination with other data and information; any combination of points (1) to (4) (http://apps.ecmwf.int/datasets/data/cams-gfas/licence/).
Dataset: cams_gfas

MARS request example
"class": "mc",
"dataset": "cams_gfas",
"date": "2003-01-01/to/2003-01-31",
"expver": "0001",
"levtype": "sfc",
"param": "120.210",
"step": "0-24",
"stream": "gfas",
"time": "00:00:00",
"type": "ga",
"target": "CHANGEME"

Dataset Param Type Spatial resolution Temporal resolution Frequency Format
Altitude of plume top 120.210 Reanalysis (ga) Global 1 Jan 2003 - 31 Jan 2017 daily (step: 0-24) GRIB, netCDF
Mean altitude of maximum injection 119.210 Reanalysis (ga) Global 1 Jan 2003 - 31 Jan 2017 daily (step: 0-24) GRIB, netCDF
Wildfire Flux of
- Acetaldehyde (C2H4O)
- Acetone (C3H6O)
- Ammonia (NH3)
- Benzene (C6H6)
- Butanes (C4H10)
- Butenes (C4H8)
- Dimethyl Sulfide (DMS) (C2H6S)
- Ethane (C2H6)
- Ethanol (C2H5OH)
- Ethene (C2H4)
- Formaldehyde (CH2O)
- Heptane (C7H16)
- Hexanes (C6H14)
- Hexene (C6H12)
- Higher Alkanes (CnH2n+2, C>=4)
- Higher Alkenes (CnH2n, C>=4)
- Isoprene (C5H8)
- Methanol (CH3OH)
- Octene (C8H16)
- Pentanes (C5H12)
- Pentenes (C5H10)
- Propane (C3H8)
- Propene (C3H6)
- Terpenes (C5H8)
- Toluene (C7H8)
- Toluene_lump (C7H8+ C6H6+ C8H10)
- Xylene (C8H10)

- 114.201
- 115.210
- 116.210
- 232.210
- 234.210
- 238.210
- 117.210
- 118.210
- 104.201
- 106.210
- 113.210
- 241.210
- 236.210
- 240.210
- 111.210
- 112.210
- 103.210
- 108.210
- 237.210
- 239.210
- 105.210
- 235.210
- 107.210
- 109.210
- 110.210
- 231.210
- 233.210
Reanalysis (ga) Global 1 Jan 2003 - 31 Jan 2017 daily (step: 0-24) GRIB, netCDF
Wildfire flux of
- Black Carbon
- Carbon Dioxide
- Carbon Monoxide
- Hydrogen
- Methane
- Nitrogen Oxides NOx
- Nitrous Oxide
- Non-Methane Hydro-Carbons
- Organic Carbon
- Particulate Matter PM2.5
- Sulfur Dioxide
- Total Carbon in Aerosols
- Total Particulate Matter

- 80.210
- 91.210
- 81.210
- 84.210
- 82.210
- 85.210
- 83.210
- 86.210
- 87.210
- 90.210
- 89.210
- 102.210
- 88.210
Reanalysis (ga) Global 1 Jan 2003 - 31 Jan 2017 daily (step: 0-24) GRIB, netCDF
Wildfire fraction of area observed 97.210 Reanalysis (ga) Global 1 Jan 2003 - 31 Jan 2017 daily (step: 0-24) GRIB, netCDF
Wildfire overall flux of burnt Carbon 92.210 Reanalysis (ga) Global 1 Jan 2003 - 31 Jan 2017 daily (step: 0-24) GRIB, netCDF
Wildfire radiative power 99.210 Reanalysis (ga) Global 1 Jan 2003 - 31 Jan 2017 daily (step: 0-24) GRIB, netCDF
Wildfire combustion rate 100.210 Reanalysis (ga) Global 1 Jan 2003 - 31 Jan 2017 daily (step: 0-24) GRIB, netCDF

#### CAMS GHG flux inversions¶

Web access: http://apps.ecmwf.int/datasets/data/cams-ghg-inversions/
License: This License is free of charge, worldwide, non-exclusive, royalty free and perpetual. Access to CAMS Information is given for the purpose of the following use in so far as it is lawful: reproduction; distribution; communication to the public; adaptation, modification and combination with other data and information; any combination of points (1) to (4) (http://apps.ecmwf.int/datasets/data/cams-ghg-inversions/licence/).
Dataset: cams_ghg_inversions

MARS request example
"dataset": "cams_ghg_inversions",
"datatype": "ra",
"date": "2015-06-01/to/2015-12-31",
"frequency": "mm",
"param": "co2",
"quantity": "surface_flux",
"version": "v15r2",
"target": "CHANGEME",

Dataset Param Type Version Spatial resolution Temporal resolution Frequency Quantity Format
Carbon Dioxide co2 Reanalysis v15r2 Global Jan 1979 - Dec 2015 - 3 hourly
- monthly average
- Concentration / Surface flux / Total column
- Surface flux
GRIB, netCDF
Nitrous oxide n2o Reanalysis v14r1 Global Jan 1996 - Dec 2014 - 3 hourly
- monthly average
- Concentration
- Surface flux
GRIB, netCDF

#### MACC Reanalysis¶

Web access: http://apps.ecmwf.int/datasets/data/macc-reanalysis/levtype=sfc/
License: The Licensee is authorised to use on a non-exclusive basis the MACC-II Products for its own purposes, including research, education and activities for commercial gain. (http://apps.ecmwf.int/datasets/data/macc-reanalysis/licence/)
Data set: macc

Level Type: Surface (sfc)

MARS request example
"class": "mc",
"dataset": "macc",
"date": "2012-12-01/to/2012-12-31",
"expver": "rean",
"grid": "0.75/0.75",
"levtype": "sfc",
"param": "167.128",
"step": "0",
"stream": "oper",
"time": "00:00:00",
"type": "an",
"target": "CHANGEME",

Dataset Param Type Level type Spatial resolution Temporal resolution Time Step Format
2 metre temperature 167.128 - Analysis (an)
- Forecast (fc)
Surface Global 1 Jan 2003 - 31 Dec 2012 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 24
GRIB, netCDF
10 metre wind
- U component
- V component

165.128
166.128
- Analysis (an)
- Forecast (fc)
Surface Global 1 Jan 2003 - 31 Dec 2012 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 24
GRIB, netCDF
Aerosol Optical Depth at 550 nm
- Black Carbon
- Dust
- Organic Matter
- Sea Salt
- Sulphate

211.210
209.210
210.210
208.210
212.210
- Forecast (fc) Surface Global 1 Jan 2003 - 31 Dec 2012 - 00 / 12 - 3-hours up to step 24 GRIB, netCDF
Total Aerosol Optical Depth
- at 469 nm
- at 550 nm
- at 670 nm
- at 865 nm
- at 1240 nm

207.210
213.210
214.210
215.210
216.210
- Forecast (fc) Surface Global 1 Jan 2003 - 31 Dec 2012 - 00 / 12 - 3-hours up to step 24 GRIB, netCDF
Total column
- Carbon monoxide
- Formaldehyde
- Methane
- Sulphur dioxide

65.210
126.210
127.210
128.210
- Analysis (an)
- Forecast (fc)
Surface Global 1 Jan 2003 - 31 Dec 2012 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 24
GRIB, netCDF
Evaporation 182.128 - Forecast (fc) Surface Global 1 Jan 2003 - 31 Dec 2012 - 00 / 12 - 3-hours up to step 24 GRIB, netCDF
Runoff 205.128 - Forecast (fc) Surface Global 1 Jan 2003 - 31 Dec 2012 - 00 / 12 - 3-hours up to step 24 GRIB, netCDF
Sea surface temperature 34.128 - Analysis (an)
- Forecast (fc)
Surface Global 1 Jan 2003 - 31 Dec 2012 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 24
GRIB, netCDF
Mean sea level pressure 151.128 - Analysis (an)
- Forecast (fc)
Surface Global 1 Jan 2003 - 31 Dec 2012 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 24
GRIB, netCDF
GEMS Total column ozone 206.210 - Analysis (an)
- Forecast (fc)
Surface Global 1 Jan 2003 - 31 Dec 2012 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 24
GRIB, netCDF
Surface net radiation 176.128 - Forecast (fc) Surface Global 1 Jan 2003 - 31 Dec 2012 - 00 / 12 - 3-hours up to step 24 GRIB, netCDF
Surface net thermal radiation 177.128 - Forecast (fc) Surface Global 1 Jan 2003 - 31 Dec 2012 - 00 / 12 - 3-hours up to step 24 GRIB, netCDF

Level Type: pressure level in hPa (pl)
1000 / 925 / 850 / 700 / 500 / 400 / 300 / 250 / 200 / 150 / 100 / 70 / 50 / 30 / 20 / 10 / 7 / 5 / 3 / 2 / 1

MARS request example
"class": "mc",
"dataset": "macc",
"date": "2012-12-01/to/2012-12-31",
"expver": "rean",
"grid": "0.75/0.75",
"levelist": "600/850/1000",
"levtype": "pl",
"param": "123.210",
"step": "3/6",
"stream": "oper",
"time": "00:00:00",
"type": "fc",
"target": "CHANGEME",

Dataset Param Type Level type Spatial resolution Temporal resolution Time Step Format
Carbon monoxide 123.210 - Analysis (an)
- Forecast (fc)
Pressure levels Global 1 Jan 2003 - 31 Dec 2012 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 24
GRIB, netCDF
Divergence 155.128 - Analysis (an)
- Forecast (fc)
Pressure levels Global 1 Jan 2003 - 31 Dec 2012 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 24
GRIB, netCDF
Formaldehyde 124.210 - Analysis (an)
- Forecast (fc)
Pressure levels Global 1 Jan 2003 - 31 Dec 2012 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 24
GRIB, netCDF
GEMS Ozone 203.210 - Analysis (an)
- Forecast (fc)
Pressure levels Global 1 Jan 2003 - 31 Dec 2012 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 24
GRIB, netCDF
Geopotential 129.128 - Analysis (an)
- Forecast (fc)
Pressure levels Global 1 Jan 2003 - 31 Dec 2012 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 24
GRIB, netCDF
Methane 62.210 - Analysis (an)
- Forecast (fc)
Pressure levels Global 1 Jan 2003 - 31 Dec 2012 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 24
GRIB, netCDF
Nitrogen Oxide 129.210 - Analysis (an)
- Forecast (fc)
Pressure levels Global 1 Jan 2003 - 31 Dec 2012 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 24
GRIB, netCDF
Humidity
- relative
specific

157.128
133.210
- Analysis (an)
- Forecast (fc)
Pressure levels Global 1 Jan 2003 - 31 Dec 2012 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 24
GRIB, netCDF
Sulphur dioxide 122.210 - Analysis (an)
- Forecast (fc)
Pressure levels Global 1 Jan 2003 - 31 Dec 2012 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 24
GRIB, netCDF
Temperature 130.128 - Analysis (an)
- Forecast (fc)
Pressure levels Global 1 Jan 2003 - 31 Dec 2012 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 24
GRIB, netCDF
Wind
- U component
- V component

131.128
132.128
- Analysis (an)
- Forecast (fc)
Pressure levels Global 1 Jan 2003 - 31 Dec 2012 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 24
GRIB, netCDF
Vertical velocity 135.128 - Analysis (an)
- Forecast (fc)
Pressure levels Global 1 Jan 2003 - 31 Dec 2012 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 24
GRIB, netCDF
Vorticity (relative) 138.128 - Analysis (an)
- Forecast (fc)
Pressure levels Global 1 Jan 2003 - 31 Dec 2012 - 00 / 06 / 12 / 18
- 00 / 12
- 0
- 3-hours up to step 24
GRIB, netCDF

#### MACC GHG flux inversions¶

Web access: http://apps.ecmwf.int/datasets/data/macc-ghg-inversions/
License: The Licensee is authorised to use on a non-exclusive basis the MACC-II Products for its own purposes, including research, education and activities for commercial gain. http://apps.ecmwf.int/datasets/data/macc-ghg-inversions/licence/
Dataset: macc_ghg_inversions

MARS request example
"dataset": "macc_ghg_inversions",
"datatype": "ra",
"date": "2013-07-01/to/2013-12-31",
"frequency": "3h",
"param": "co2",
"quantity": "concentration",
"version": "v14r2",
"target": "CHANGEME",

Dataset Param Type Version Spatial resolution Temporal resolution Frequency Quantity Format
Carbon Dioxide co2 Reanalysis (ra) v13r1, v14r2 Global Jan 1979 - Dec 2014 - 3 hourly (3h)
- monthly average (mm)
- Concentration
- Surface flux
GRIB, netCDF
Methane ch4 - Delayed-mode analysis
- Reanalysis (ra)
v10 Global - Jan 2012 - Jun 2014
- Jan 2000 - Dec 2012
- daily average (dm)
- monthly average (mm)
- Concentration
- Surface flux
GRIB, netCDF
Nitrous oxide n2o Reanalysis (ra) v12r1, v11r1 Global Jan 1996 - Dec 2012 - 3 hourly (3h)
- monthly average (mm)
- Concentration
- Surface flux
GRIB, netCDF

### Fire forecast¶

#### GEFF reanalysis¶

Web access: http://apps.ecmwf.int/datasets/data/geff-reanalysis/
License: This License is free of charge, worldwide, non-exclusive, royalty free and perpetual. Access to GEFF Information is given for the purpose of the following use in so far as it is lawful: reproduction; distribution; communication to the public; adaptation, modification and combination with other data and information; any combination of points (1) to (4) (http://apps.ecmwf.int/datasets/data/geff-reanalysis/licence/).
Dataset: geff_reanalysis

Level type: surface

MARS request example
"dataset": "geff_reanalysis",
"datatype": "ra",
"date": "2015-12-01/to/2015-12-31",
"origin": "fwis",
"param": "fwi",
"step": "00",
"time": "0000",
"type": "an",
"target": "CHANGEME",

Origin Variable Param Type Level Spatial resolution Temporal resolution Time step Format
FWIS (Canadian Rating System) Fine Fuel Moisture Code ffmc an surface global 1980-2016 12:00 Netcdf
FWIS (Canadian Rating System) Duff Moisture Code dmc an surface global 1980-2016 12:00 Netcdf
FWIS (Canadian Rating System) Drought Code dc an surface global 1980-2016 12:00 Netcdf
FWIS (Canadian Rating System) Initial spread index isi an surface global 1980-2016 12:00 Netcdf
FWIS (Canadian Rating System) Built-up Index bui an surface global 1980-2016 12:00 Netcdf
FWIS (Canadian Rating System) Fire Weather Index fwi an surface global 1980-2016 12:00 Netcdf
FWIS (Canadian Rating System) Danger Rating dr an surface global 1980-2016 12:00 Netcdf
FWIS (Canadian Rating System) Daily Severity Index dsr an surface global 1980-2016 12:00 Netcdf
NFDRS (A US rating system) Ignition component ic an surface global 1980-2016 12:00 Netcdf
NFDRS (A US rating system) Rate of spread ros an surface global 1980-2016 12:00 Netcdf
NFDRS (A US rating system) Spread component sc an surface global 1980-2016 12:00 Netcdf
NFDRS (A US rating system) Energy release component erc an surface global 1980-2016 12:00 Netcdf
Mark-5 (Australian rating system) Keetch-Byram Drought index kbdi an surface global 1980-2016 12:00 Netcdf
Mark-5 (Australian rating system) Fire danger Index fdi an surface global 1980-2016 12:00 Netcdf
Mark-5 (Australian rating system) Rate of spread kbdi an surface global 1980-2016 12:00 Netcdf

## 2.3 How to access the service¶

### Example in Python¶

Subsequently, an example is shown how a MARS request can be executed within Python and data in either GRIB or netCDF can be downloaded on-demand. A further example is shown how either GRIB or netCDF data can be read and accessed with Python and dynamically stored into a numpy array.
Further information and data request examples can be found here.

#### Install the ecmwfapi python library¶

If you cannot run the pip commands, just download the ecmwf-api-client-python.tgz library. Extract its content and copy the module ecmwfapi to a directory pointed by the environment variable PYTHONPATH

#### Execute a MARS request and download data either as GRIB or netCDF¶

NOTE: per default, ECMWF data are on a gaussian grid with longitudes going from 0 to 360 degrees. It can be reprojected to a regular geographic latitude-longitude grid. If a reprojection is wished, the key 'grid' with the respective latitude and longitude resolution has to be specified.
The same applies for specifying a longitude range of -180 to 180. The key area can be set.

Retrieve data in GRIB format

In [26]:
#!/usr/bin/env python
from ecmwfapi import ECMWFDataServer
server = ECMWFDataServer(url="https://api.ecmwf.int/v1", key="xxxxxxxxxxxxxxxxxxxxxxxxxx", email="[email protected]")

# Retrieve data in GRIB format
server.retrieve({
'stream': "oper",
'levtype': "sfc",
'param': "167",
'dataset': "interim",
'step': "0",
'grid': "0.5/0.5",
'area': "90/-180/-90/179.5",
'time': "00/06/12/18",
'date': "2014-07-01/to/2014-07-31",
'type': "an",
'class': "ei",
'target': "test.grib"
})

2017-01-23 17:05:08 ECMWF API python library 1.4.1
2017-01-23 17:05:08 ECMWF API at https://api.ecmwf.int/v1

---------------------------------------------------------------------------
APIException                              Traceback (most recent call last)
<ipython-input-26-412f5f7d87c0> in <module>()
16         'type': "an",
17         'class': "ei",
---> 18         'target': "test.grib"
19     })

/home/ma/majw/.virtualenvs/mypython/lib/python2.7/site-packages/ecmwfapi/api.pyc in retrieve(self, req)
487         target = req.get("target")
488         dataset = req.get("dataset")
--> 489         c = APIRequest(self.url, "datasets/%s" % (dataset,), self.email, self.key, self.trace, verbose=self.verbose)
490         c.execute(req, target)
491

/home/ma/majw/.virtualenvs/mypython/lib/python2.7/site-packages/ecmwfapi/api.pyc in __init__(self, url, service, email, key, log, quiet, verbose, news)
367         self.log("ECMWF API python library %s" % (VERSION,))
368         self.log("ECMWF API at %s" % (self.url,))
--> 369         user = self.connection.call("%s/%s" % (self.url, "who-am-i"))
370         self.log("Welcome %s" % (user["full_name"] or "user '%s'" % user["uid"],))
371         if news:

/home/ma/majw/.virtualenvs/mypython/lib/python2.7/site-packages/ecmwfapi/api.pyc in wrapped(self, *args, **kwargs)
134         while tries > 0:
135             try:
--> 136                 return func(self, *args, **kwargs)
137             except HTTPError as e:
138                 if self.verbose:

/home/ma/majw/.virtualenvs/mypython/lib/python2.7/site-packages/ecmwfapi/api.pyc in call(self, url, payload, method)
317         if "error" in self.last:
318             #self.done   = True
--> 319             raise APIException("ecmwf.API error 1: %s" % (self.last["error"],))
320
321         if error:

APIException: u'ecmwf.API error 1: Invalid or missing key or token'

Retrieve data in netCDF format

In [ ]:
#!/usr/bin/env python
from ecmwfapi import ECMWFDataServer
server = ECMWFDataServer(url="https://api.ecmwf.int/v1", key="1aa4666437d4e32d0c1d8a2c560a0639", email="[email protected]")

# Retrieve data in netCDF format
server.retrieve({
'stream': "oper",
'levtype': "sfc",
'param': "167",
'dataset': "interim",
'step': "0",
'grid': "0.5/0.5",
'area': "90/-180/-90/179.5",
'time': "00/06/12/18",
'date': "2014-07-01/to/2014-07-31",
'type': "an",
'class': "ei",
'format': "netcdf",
'target': "test.nc"
})


In [25]:
import pygrib
grib = 'test.grb'
grbs = pygrib.open(grib)

---------------------------------------------------------------------------
ImportError                               Traceback (most recent call last)
<ipython-input-25-2f57373c8211> in <module>()
----> 1 import pygrib
2 grib = 'test.grb'
3 grbs = pygrib.open(grib)

ImportError: libgrib_api.so: cannot open shared object file: No such file or directory

In [24]:
%matplotlib inline
import netCDF4 as nc
import numpy as np
from matplotlib import pyplot as plt

ncdata = nc.Dataset("./test.nc","a", format="NETCDF4")
data = ncdata.variables['t2m'][1,:,:]

plt.figure(figsize=(40,20))
plt.imshow(data)

Out[24]:
<matplotlib.image.AxesImage at 0x7f379e8fc450>