#!/usr/bin/env python
# coding: utf-8

# <img style="float: right;" src="./img/ODW_banner_devpost.jpg"></img>

# <hr>

# <a href="./index.ipynb"><< Index</a>&nbsp;<space>&nbsp;<space>&nbsp;<space>&nbsp;<space>&nbsp;<space>&nbsp;<space>&nbsp;<space>&nbsp;<space>&nbsp;<space>&nbsp;<space> <a href="./ecmwf_web_mapping_service.ipynb">02-ECMWF Web Mapping Service (WMS) >></a>

# ## <center><h2>1. ECMWF MARS archive - Web-API</h2></center>

# - [2.1 Service Description](#service-description) 
# - [2.2 Available datasets](#datasets) 
# - [2.3 How to access the service](#service-example)

# <hr>

# ## <a id='service-description'></a> 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](https://software.ecmwf.int/wiki/display/UDOC/MARS+content). <br>
# 
# MARS contains a wide range of public datasets that can be accessed via two ways: <br>
# - the **Dataset Web Interface**, which is an interface that helps you to navigate through the data in a dynamic and user-friendly way, and <br>
# - 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. 

# <hr>

# ## <a id='datasets'></a> 2.2 Available datasets

# Access Point: http://apps.ecmwf.int/datasets/

# - [Global reanalysis + Deterministic and probabilistic forecasts](#era-interim)
# - [Atmospheric composition](#atmospheric_composition)
# - [Fire forecast](#fire_forecast)    

# **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.

# <hr>

# ### <a id='ear-interim'></a>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)
# <hr>

# Field types: <br> - Daily - stream: oper, <br> - Monthly Means of Daily means - stream: moda

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

# | Dataset | Param | Type | Level type | Spatial resolution | Temporal resolution | Time | Step | Format |
# |------------------------|----------------------|------------------|-----------------|-----------------------|-------------|------------|
# | 2 metre temperature | 167.128  | - Analysis (an) <br> - Forecast (fc) | Surface | Global | 1 Jan 1979 - 31 Oct 2016 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3 hours up to step 12 | GRIB, netCDF |
# | 10 metre wind <br> - U component <br> - V component | 165.128 <br> 166  | - Analysis (an) <br> - Forecast (fc) | Surface | Global | 1 Jan 1979 - 31 Oct 2016 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 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) <br> - Forecast (fc) | Surface | Global | 1 Jan 1979 - 31 Oct 2016 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3 hours up to step 12 | GRIB, netCDF |
# | Sea surface temperature | 34.128  | - Analysis (an) <br> - Forecast (fc) | Surface| Global | 1 Jan 1979 - 31 Oct 2016 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 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) <br> - Forecast (fc) | Surface | Global | 1 Jan 1979 - 31 Oct 2016 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 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) <br> - Forecast (fc) | Surface | Global | 1 Jan 1979 - 31 Oct 2016 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3 hours up to step 12 | GRIB, netCDF |
# 

# <br>

# <hr/>
# 
# Level type: Pressure level in hPa (pl) <br> 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", <br> "dataset": "interim", <br> "date": "2016-12-01/to/2016-12-31", <br> "expver": "1", <br> "grid": "0.75/0.75", <br> "levelist": "800/900/975/1000", <br> "levtype": "pl", <br> "param": "155.128", <br> "step": "0", <br> "stream": "oper", <br> "time": "00:00:00/06:00:00", <br> "type": "an", <br> "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 <br> - U component <br> - V component | <br> - 131.128 <br> - 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 |

# <hr>

# ### <a id='atmospheric_composition'></a>Atmospheric composition
# 

# - [CAMS Near-real-time](#cams_real-time)
# - [CAMS Global Fire Assimilation System](#cams_global_fire)
# - [CAMS GHG flux inversions](#cams_ghg_fluxes)
# 
# - [MACC Reanalysis](#macc_reanalysis)
# - [MACC GHG flux inversions](#macc_ghg_fluxes)

# #### <a id='cams_real-time'></a>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)
# <hr>

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

# | Dataset | Param | Type | Level type | Spatial resolution | Temporal resolution | Time | Step |  Format |
# |------------------------|-------------------|------------------|-----------------|-----------------------|-------------|------------|-----------------|
# | 2 metre dewpoint temperature | 168.128  | - Analysis (an) <br> - Forecast (fc) | Surface | Global | 1 Jul 2012 - 31 Jan 2017 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 120 | GRIB, netCDF |
# | 2 metre temperature | 167.128  | - Analysis (an) <br> - Forecast (fc) | Surface | Global | 1 Jul 2012 - 31 Jan 2017 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 120 | GRIB, netCDF |
# | 10 metre <br> - U wind component <br> - V wind component | <br> 165.128 <br> 166.128  | - Analysis (an) <br> - Forecast (fc) | Surface | Global | 1 Jul 2012 - 31 Jan 2017 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 120 | GRIB, netCDF |
# | - UV biologically effective dose <br> - UV biologically effective dose clear-sky | 2.214 <br> 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) <br> - Forecast (fc) | Surface | Global | 1 Jul 2012 - 31 Jan 2017 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 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) <br> - Forecast (fc) | Surface | Global | 1 Jul 2012 - 31 Jan 2017 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 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 <br> - high <br> - medium <br> - low | <br> 188.128 <br> 187.128 <br> 186.128  | - Analysis (an) <br> - Forecast (fc) | Surface | Global | 1 Jul 2012 - 31 Jan 2017 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 120 | GRIB, netCDF |
# | Land-sea mask | 172.128  | - Analysis (an) <br> - Forecast (fc) | Surface | Global | 1 Jul 2012 - 31 Jan 2017 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 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 <br> - d < 1um <br> - d < 2.5 um <br> - d < 10 um | <br> 72.210 <br> 73.210 <br> 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) <br> - Forecast (fc) | Surface | Global | 1 Jul 2012 - 31 Jan 2017 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 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 <br> - Dust <br> - Organic Matter <br> - Sulphate <br> - Sea Salt | <br> 209.210 <br> 208.210 <br> 210.210 <br> 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 <br> - 469 nm <br> - 550 nm <br> - 670 nm <br> - 865 nm <br> - 1240 nm | <br> 207.210 <br> 213.210 <br> 214.210 <br> 215.210 <br> 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) <br> - Forecast (fc) | Surface | Global | 1 Jul 2012 - 31 Jan 2017 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 120 | GRIB, netCDF |
# | Total column <br> - Nitrogen Oxides <br> - ethane <br> - isoprene <br> - peroxyacetyl nitrate <br> - Carbon monoxide <br> - Formaldehyde <br> - Nitrogen dioxide <br> - Sulphur dioxide <br> - hydroxyl radical <br> - methane <br> - nitric acid <br> - nitrogen monoxide <br> - propane <br> - water vapour | <br> 130.210 <br> 16.218 <br> 45.218 <br> 13.218 <br> 127.210 <br> 125.210 <br> 128.210 <br> 30.218 <br> 126.210 <br> 4.218 <br> 6.218 <br> 27.218 <br> 47.218 <br> 137.128 | - Analysis (an) <br> - Forecast (fc) | Surface | Global | 1 Sep 2014 - 31 Jan 2017 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 120 | GRIB, netCDF |

# <br>

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

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

# | Dataset | Param | Type | Level type | Spatial resolution | Temporal resolution | Time | Step |  Format |
# |------------------------|----------------------|------------------|-----------------|-----------------------|-------------|------------|-----------------|
# | Carbon monoxide | 123.210  | - Analysis (an) <br> - Forecast (fc) | Pressure levels | Global | 1 Jul 2012 - 31 Jan 2017 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 120 | GRIB, netCDF |
# | Divergence | 155.128  | - Analysis (an) <br> - Forecast (fc) | Pressure levels  | Global | 1 Jul 2012 - 31 Jan 2017 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 120 | GRIB, netCDF |
# | Dust Aerosol Mixing Ration <br> - 0.03 - 0.55 um <br> - 0.55 - 0.9 um <br> - 0.9 - 20 um | <br> 4.210 <br> 5.210 <br> 6.210 | - Analysis (an) <br> - Forecast (fc) | Pressure levels | Global | 1 Jul 2012 - 31 Jan 2017 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 120 | GRIB, netCDF |
# | Ethane | 45.217 | - Analysis (an) <br> - Forecast (fc) | Pressure levels |  Global | 1 Jul 2012 - 31 Jan 2017 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 120 | GRIB, netCDF |
# | Formaldehyde | 124.210  | - Analysis (an) <br> - Forecast (fc) | Pressure levels |  Global | 1 Jul 2012 - 31 Jan 2017 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 120 | GRIB, netCDF |
# | GEMS Ozone | 203.210  | - Analysis (an) <br> - Forecast (fc) | Pressure levels |  Global | 1 Jul 2012 - 31 Jan 2017 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 120 | GRIB, netCDF |
# | Geopotential | 129.128  | - Analysis (an) <br> - Forecast (fc) | Pressure levels |  Global | 1 Jul 2012 - 31 Jan 2017 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 120 | GRIB, netCDF |
# | Hydrophilic Aerosol Mixing Ratio <br> - Black Carbon <br> - Organic Matter | <br> 7.210 <br> 8.210  | - Analysis (an) <br> - Forecast (fc) | Pressure levels | Global | 1 Jul 2012 - 31 Jan 2017 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 120 | GRIB, netCDF |
# | Hydrophobic Aerosol Mixing Ratio <br> - Black Carbon <br> - Organic Matter | <br> 9.210 <br> 10.210  | - Analysis (an) <br> - Forecast (fc) | Pressure levels |  Global | 1 Jul 2012 - 31 Jan 2017 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 120 | GRIB, netCDF |
# | Hydroxyl radical | 4.217  | - Analysis (an) <br> - Forecast (fc) | Pressure levels |  Global | 1 Jul 2012 - 31 Jan 2017 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 120 | GRIB, netCDF |
# | Isoprene | 6.217  | - Analysis (an) <br> - Forecast (fc) | Pressure levels |  Global | 1 Jul 2012 - 31 Jan 2017 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 120 | GRIB, netCDF |
# | Methane | 16.217  | - Analysis (an) <br> - Forecast (fc) | Pressure levels |  Global | 1 Jul 2012 - 31 Jan 2017 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 120 | GRIB, netCDF |
# | Nitric acid | 30.217  | - Analysis (an) <br> - Forecast (fc) | Pressure levels |  Global | 1 Jul 2012 - 31 Jan 2017 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 120 | GRIB, netCDF |
# | Nitrogen <br> - Oxides <br> - Dioxide <br> - Monoxide| <br> 27.217 <br> 121.210 <br> 129.210  | - Analysis (an) <br> - Forecast (fc) | Pressure levels | Global | 1 Jul 2012 - 31 Jan 2017 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 120 | GRIB, netCDF |
# | Peroxyacetyl nitrate | 13.217  | - Analysis (an) <br> - Forecast (fc) | Pressure levels |  Global | 1 Jul 2012 - 31 Jan 2017 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 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) <br> - Forecast (fc) | Pressure levels |  Global | 1 Jul 2012 - 31 Jan 2017 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 120 | GRIB, netCDF |
# | Relative humidity | 157.128  | - Analysis (an) <br> - Forecast (fc) | Pressure levels | Global | 1 Jul 2012 - 31 Jan 2017 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 120 | GRIB, netCDF |
# | Sea Salt Aerosol Mixing Ratio <br> - 0.03 -0.5 um <br> - 0.5 - 5 um <br> - 5 - 20 um | <br> 1.210 <br> 2.210 <br> 3.210   | - Analysis (an) <br> - Forecast (fc) | Pressure levels |  Global | 1 Jul 2012 - 31 Jan 2017 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 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) <br> - Forecast (fc) | Pressure levels |  Global | 1 Jul 2012 - 31 Jan 2017 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 120 | GRIB, netCDF |
# | Sulphur dioxide | 122.210  | - Analysis (an) <br> - Forecast (fc) | Pressure levels | Global | 1 Jul 2012 - 31 Jan 2017 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 120 | GRIB, netCDF |
# |Temperature | 130.128 | - Analysis (an) <br> - Forecast (fc) | Pressure levels |Global | 1 Jul 2012 - 31 Jan 2017 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 120 | GRIB, netCDF |
# | Vorticity | 138.128  | - Analysis (an) <br> - Forecast (fc) | Pressure levels |  Global | 1 Jul 2012 - 31 Jan 2017 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 120 | GRIB, netCDF |

# <br>

# #### <a id='cams_global_fire'></a>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
# <hr>

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

# | 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 <br> - Acetaldehyde (C2H4O) <br> - Acetone (C3H6O) <br> - Ammonia (NH3) <br> - Benzene (C6H6) <br> - Butanes (C4H10) <br> - Butenes (C4H8) <br> - Dimethyl Sulfide (DMS) (C2H6S) <br> - Ethane (C2H6) <br> - Ethanol (C2H5OH) <br> - Ethene (C2H4) <br> - Formaldehyde (CH2O) <br> - Heptane (C7H16) <br> - Hexanes (C6H14) <br> - Hexene (C6H12) <br> - Higher Alkanes (CnH2n+2, C>=4) <br> - Higher Alkenes (CnH2n, C>=4) <br> - Isoprene (C5H8) <br> - Methanol (CH3OH) <br> - Octene (C8H16) <br> - Pentanes (C5H12) <br> - Pentenes (C5H10) <br> - Propane (C3H8) <br> - Propene (C3H6) <br> - Terpenes (C5H8) <br> - Toluene (C7H8) <br> - Toluene_lump (C7H8+ C6H6+ C8H10) <br> - Xylene (C8H10)  | <br> - 114.201 <br> - 115.210 <br> - 116.210 <br> - 232.210 <br> - 234.210 <br> - 238.210 <br> - 117.210 <br> - 118.210 <br> - 104.201 <br> - 106.210 <br> - 113.210 <br> - 241.210 <br> - 236.210 <br> - 240.210 <br> - 111.210 <br> - 112.210 <br> - 103.210 <br> - 108.210 <br> - 237.210 <br> - 239.210 <br> - 105.210 <br> - 235.210 <br> - 107.210 <br> - 109.210 <br> - 110.210 <br> - 231.210 <br> - 233.210 | Reanalysis (ga) | Global | 1 Jan 2003 - 31 Jan 2017 | daily (step: 0-24) | GRIB, netCDF |
# | Wildfire flux of <br> - Black Carbon <br> - Carbon Dioxide <br> - Carbon Monoxide <br> - Hydrogen <br> - Methane <br> - Nitrogen Oxides NOx <br> - Nitrous Oxide <br> - Non-Methane Hydro-Carbons <br> - Organic Carbon <br> - Particulate Matter PM2.5 <br> - Sulfur Dioxide <br> - Total Carbon in Aerosols <br> - Total Particulate Matter <br> | <br> - 80.210 <br> - 91.210 <br> - 81.210 <br> - 84.210 <br> - 82.210 <br> - 85.210 <br> - 83.210 <br> - 86.210 <br> - 87.210 <br> - 90.210 <br> - 89.210 <br> - 102.210 <br> - 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 |

# <br>

# #### <a id='cams_ghg_fluxes'></a>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
# <hr>

# ** *MARS request example* **  
# "dataset": "cams_ghg_inversions", <br> "datatype": "ra", <br> "date": "2015-06-01/to/2015-12-31", <br> "frequency": "mm", <br> "param": "co2", <br> "quantity": "surface_flux", <br> "version": "v15r2", <br> "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 <br> - monthly average | - Concentration / Surface flux / Total column <br> - Surface flux | GRIB, netCDF |
# |Nitrous oxide | n2o | Reanalysis |v14r1| Global | Jan 1996 - Dec 2014 | - 3 hourly <br> - monthly average | - Concentration <br> - Surface flux | GRIB, netCDF |

# <br>

# #### <a id='macc_reanalysis'></a>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)
# <hr>

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

# | Dataset | Param | Type | Level type | Spatial resolution | Temporal resolution | Time | Step |  Format |
# |------------------------|----------------------|------------------|-----------------|-----------------------|-------------|------------|-----------------|
# | 2 metre temperature | 167.128  | - Analysis (an) <br> - Forecast (fc) | Surface | Global | 1 Jan 2003 - 31 Dec 2012 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 24 | GRIB, netCDF |
# | 10 metre wind <br> - U component <br> - V component | <br> 165.128 <br> 166.128  | - Analysis (an) <br> - Forecast (fc) | Surface | Global | 1 Jan 2003 - 31 Dec 2012 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 24 | GRIB, netCDF |
# | Aerosol Optical Depth at 550 nm <br> - Black Carbon <br> - Dust <br> - Organic Matter <br> - Sea Salt <br> - Sulphate  | <br> 211.210 <br> 209.210 <br> 210.210 <br> 208.210 <br> 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  <br> - at 469 nm <br> - at 550 nm <br> - at 670 nm <br> - at 865 nm <br> - at 1240 nm  | <br> 207.210 <br> 213.210 <br> 214.210 <br> 215.210 <br> 216.210  | - Forecast (fc) | Surface | Global | 1 Jan 2003 - 31 Dec 2012 | - 00 / 12 | - 3-hours up to step 24 | GRIB, netCDF |
# | Total column  <br> - Carbon monoxide <br> - Formaldehyde <br> - Methane <br> - Sulphur dioxide | <br> 65.210 <br> 126.210 <br> 127.210 <br> 128.210 | - Analysis (an) <br> - Forecast (fc) | Surface | Global | 1 Jan 2003 - 31 Dec 2012 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 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) <br> - Forecast (fc) | Surface | Global | 1 Jan 2003 - 31 Dec 2012 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 24 | GRIB, netCDF |
# | Mean sea level pressure | 151.128  | - Analysis (an) <br> - Forecast (fc) | Surface | Global | 1 Jan 2003 - 31 Dec 2012 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 24 | GRIB, netCDF |
# | GEMS Total column ozone | 206.210  | - Analysis (an) <br> - Forecast (fc) | Surface | Global | 1 Jan 2003 - 31 Dec 2012 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 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 |

# <br>

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

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

# | Dataset | Param | Type | Level type | Spatial resolution | Temporal resolution | Time | Step |  Format |
# |------------------------|----------------------|------------------|-----------------|-----------------------|-------------|------------|-----------------|
# | Carbon monoxide | 123.210  | - Analysis (an) <br> - Forecast (fc) | Pressure levels | Global | 1 Jan 2003 - 31 Dec 2012 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 24 | GRIB, netCDF |
# | Divergence | 155.128  | - Analysis (an) <br> - Forecast (fc) | Pressure levels | Global | 1 Jan 2003 - 31 Dec 2012 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 24 | GRIB, netCDF |
# | Formaldehyde | 124.210  | - Analysis (an) <br> - Forecast (fc) | Pressure levels | Global | 1 Jan 2003 - 31 Dec 2012 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 24 | GRIB, netCDF |
# | GEMS Ozone | 203.210  | - Analysis (an) <br> - Forecast (fc) | Pressure levels | Global | 1 Jan 2003 - 31 Dec 2012 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 24 | GRIB, netCDF |
# | Geopotential | 129.128  | - Analysis (an) <br> - Forecast (fc) | Pressure levels | Global | 1 Jan 2003 - 31 Dec 2012 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 24 | GRIB, netCDF |
# | Methane | 62.210  | - Analysis (an) <br> - Forecast (fc) | Pressure levels | Global | 1 Jan 2003 - 31 Dec 2012 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 24 | GRIB, netCDF |
# | Nitrogen Oxide | 129.210  | - Analysis (an) <br> - Forecast (fc) | Pressure levels | Global | 1 Jan 2003 - 31 Dec 2012 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 24 | GRIB, netCDF |
# | Humidity <br> - relative <br> specific | <br> 157.128 <br> 133.210  | - Analysis (an) <br> - Forecast (fc) | Pressure levels | Global | 1 Jan 2003 - 31 Dec 2012 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 24 | GRIB, netCDF |
# | Sulphur dioxide | 122.210  | - Analysis (an) <br> - Forecast (fc) | Pressure levels | Global | 1 Jan 2003 - 31 Dec 2012 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 24 | GRIB, netCDF |
# | Temperature | 130.128  | - Analysis (an) <br> - Forecast (fc) | Pressure levels | Global | 1 Jan 2003 - 31 Dec 2012 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 24 | GRIB, netCDF |
# | Wind <br> - U component <br> - V component | <br> 131.128 <br> 132.128  | - Analysis (an) <br> - Forecast (fc) | Pressure levels | Global | 1 Jan 2003 - 31 Dec 2012 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 24 | GRIB, netCDF |
# | Vertical velocity | 135.128  | - Analysis (an) <br> - Forecast (fc) | Pressure levels | Global | 1 Jan 2003 - 31 Dec 2012 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 24 | GRIB, netCDF |
# | Vorticity (relative) | 138.128  | - Analysis (an) <br> - Forecast (fc) | Pressure levels | Global | 1 Jan 2003 - 31 Dec 2012 | - 00 / 06 / 12 / 18 <br> - 00 / 12 | - 0 <br> - 3-hours up to step 24 | GRIB, netCDF |

# <br>

# #### <a id='macc_ghg_fluxes'></a>MACC GHG flux inversions

# <b>Web access:</b> http://apps.ecmwf.int/datasets/data/macc-ghg-inversions/  
# <b>License:</b> 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/  
# <b>Dataset:</b> macc_ghg_inversions
# <hr>

# ** *MARS request example* **  
# "dataset": "macc_ghg_inversions", <br> "datatype": "ra", <br> "date": "2013-07-01/to/2013-12-31", <br> "frequency": "3h", <br> "param": "co2", <br> "quantity": "concentration", <br> "version": "v14r2", <br> "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) <br> - monthly average (mm) | - Concentration <br> - Surface flux | GRIB, netCDF |
# |Methane | ch4 | - Delayed-mode analysis <br> - Reanalysis (ra) |v10 | Global | - Jan 2012 - Jun 2014 <br> - Jan 2000 - Dec 2012 | - daily average (dm) <br> - monthly average (mm) | - Concentration <br> - Surface flux | GRIB, netCDF |
# |Nitrous oxide | n2o | Reanalysis (ra) |v12r1, v11r1| Global | Jan 1996 - Dec 2012 | - 3 hourly (3h) <br> - monthly average (mm) | - Concentration <br> - Surface flux | GRIB, netCDF |

# <hr>

# ### <a id='fire_forecast'></a>Fire forecast

# #### <a id='geff_reanalysis'></a>GEFF reanalysis

# <b>Web access:</b> http://apps.ecmwf.int/datasets/data/geff-reanalysis/  
# <b>License:</b> 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/).  
# <b>Dataset:</b> geff_reanalysis

# Level type: surface
# <hr>

# ** *MARS request example* **  
# "dataset": "geff_reanalysis", <br> "datatype": "ra", <br> "date": "2015-12-01/to/2015-12-31", <br> "origin": "fwis", <br> "param": "fwi", <br> "step": "00", <br> "time": "0000", <br> "type": "an", <br> "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 |

# <hr>

# ## <a id='service-example'></a> 2.3 How to access the service

# - [Example in Python](#python_example)
# - [Example in R](#r_example)

# ### <a id='python_example'></a>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](https://software.ecmwf.int/wiki/display/WEBAPI/Access+ECMWF+Public+Datasets).

# #### Retrieve ECMWF key

# - Self-register at http://apps.ecmwf.int/registration
# - Login at https://apps.ecmwf.int/auth/login
# - Retrieve your API key at https://api.ecmwf.int/v1/key/
# - Specify the ECMWFDataServer with your url, key and email information
# 

# #### Install the *ecmwfapi* python library

# - pip install https://software.ecmwf.int/wiki/download/attachments/56664858/ecmwf-api-client-python.tgz
# 
# *If you cannot run the pip commands, just download the [ecmwf-api-client-python.tgz](https://software.ecmwf.int/wiki/download/attachments/56664858/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="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"
    })


# *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="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"
    })


# #### Load downloaded GRIB data file

# * pip install [pygrib](https://pypi.python.org/pypi/pygrib)
# 

# In[25]:


import pygrib
grib = 'test.grb'
grbs = pygrib.open(grib)


# #### Load downloaded netCDF data file

# In[24]:


get_ipython().run_line_magic('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)


# <hr>

# ### <a id='r_example'></a>Example in R

# #### Example with ncdf and raster library

# In[ ]:


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)


# #### Example to load a netcdf file directly into a raster brick object

# In[ ]:


library(raster)

# turn information of a netcdf file dynamically into a raster brick object
tmp <- brick('./test.nc', nlev=3)


# <hr>

# &copy; 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.