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:
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.
Access Point: http://apps.ecmwf.int/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.
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 | |
---|---|---|---|---|---|---|---|---|
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 | |
---|---|---|---|---|---|---|---|
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 |
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 | |
---|---|---|---|---|---|---|---|---|
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 - hydroxyl radical - 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 | |
---|---|---|---|---|---|---|---|---|
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 |
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 |
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 | |
---|---|---|---|---|---|---|---|---|
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 |
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 | |
---|---|---|---|---|---|---|---|---|
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 | |
---|---|---|---|---|---|---|---|---|
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 |
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 | |
---|---|---|---|---|---|---|---|---|
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 |
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 |
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.
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
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
#!/usr/bin/env python
from ecmwfapi import ECMWFDataServer
server = ECMWFDataServer(url="https://api.ecmwf.int/v1", key="xxxxxxxxxxxxxxxxxxxxxxxxxx", email="userid@userid.com")
# 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
#!/usr/bin/env python
from ecmwfapi import ECMWFDataServer
server = ECMWFDataServer(url="https://api.ecmwf.int/v1", key="1aa4666437d4e32d0c1d8a2c560a0639", email="julia.wagemann@ecmwf.int")
# 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"
})
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
%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)
<matplotlib.image.AxesImage at 0x7f379e8fc450>
library(ncdf)
library(raster)
library(MASS)
setwd('/home/ma/majw/Notebooks/data_service_catalog/')
# open the netcdf file
tmp <- open.ncdf('test.nc',write=FALSE)
# get information about the content
tmp
#retrieve latitude and longitude information
lon <- tmp$dim$lon$vals
lat <- tmp$dim$lat$vals
#retrieve data values based on the variable name
parName <- names(tmp$var)
#retrieve data values of a specific variable in the netcdf file
tempRaster <- get.var.ncdf(tmp,parName)
# create a raster object of a data values layer
z <- raster(tempRaster[,,4])
# get the missing value information of the netcdf file
NA_val <- tmp$var[[1]]$missval
# set the missing values to NaN
z[z==NA_val] <- NA
# close the netcdf file
close(tmp)
library(raster)
# turn information of a netcdf file dynamically into a raster brick object
tmp <- brick('./test.nc', nlev=3)
© 2017 ECMWF
This software is licensed under the terms of the Apache Licence Version 2.0 which can be obtained at http://www.apache.org/licenses/LICENSE-2.0. In applying this licence, ECMWF does not waive the privileges and immunities granted to it by virtue of its status as an intergovernmental organisation nor does it submit to any jurisdiction.