| Page info | ||||||
|---|---|---|---|---|---|---|
|
| Show If | ||
|---|---|---|
| ||
Major modification in progress for this article - please DO NOT UPDATE THIS PAGE or your edits will get overwritten when the new modified article will be published. Please edit the working copy of this page in the C3S Modified CKB articles section. |
| Info | ||||
|---|---|---|---|---|
| ||||
|
...
Although some flavours of the ERA5 family data is not online in the CDS (i.e. not available through the interactive web download form), it is accessible through CDS API. This embraces ERA5-complete and , ERA5.1-complete and ERA5-complete-preliminary, which provide data in the 'raw' format as they were produced:
...
The ERA5-Land dataset at the native 9km octahedral grid is an exception and is currently not available via the CDS API protocol. However, all information is available online at the slightly reduced 0.1°x0.1° regular lat-lon grid (access via Option A, above).
Due to the vast volume of these datasets (currently about 6 petabyte10petabyte) these are not stored on spinning disk, but reside in the ECMWF's MARS tape archive, instead. Access to this data is in general much slower. Please note that the ERA5 back extension (preliminary version) 'raw' format from MARS is not yet available (expected around the end of 2020), except for the latest couple of months of ERA5-complete, which are also kept online.
| Note |
|---|
Please be aware that there is an additional queueing system for downloading data from the ECMWF's MARS archive - expect several hours to several days for submitted requests to complete at this time. You can check the Live status of your request |
...
- Open the MARS ERA5 catalogue
browse for discovery, and browse your way to the parameter level to build a request.
Info - More information on the available streams, product types and levels is available in the ERA5 data documentation.
- On the parameter level, use the left-mouse button and the shift key to select more than one field in one retrieval.
- The MARS catalogue only shows data for the final quality controlled data that is made available 2-3 months in arrear. However, data is also available from preliminary timely updates up to 5 days behind real time, using the same retrieval structure.
Note To retrieve MARS data efficiently (and get your data quicker!) you should retrieve all the data you need from one tape, then from the next tape, and so on.
As a rule of thumb everything shown on one page at parameter level in the MARS ERA5 catalogue is grouped together on one tape
- For analysis fields this is one month of data with respect to one particular level type (e.g. surface).
- For forecast fields on model levels this is limited to one single day.
Use the " View MARS request " feature - this will help you build your own CDS API Python script to retrieve the data through the CDS API.
Expand title Example: Download ERA5 model level analysis data (temperature) in the native spherical harmonics representation in GRIB format. Code Block #!/usr/bin/env python import cdsapi c = cdsapi.Client() c.retrieve('reanalysis-era5-complete', { # Requests follow MARS syntax # Keywords 'expver' and 'class' can be dropped. They are obsolete # since their values are imposed by 'reanalysis-era5-complete' 'date' : '2013-01-01', # The hyphens can be omitted 'levelist': '1/10/100/137', # 1 is top level, 137 the lowest model level in ERA5. Use '/' to separate values. 'levtype' : 'ml', 'param' : '130', # Full information at https://apps.ecmwf.int/codes/grib/param-db/ # The native representation for temperature is spherical harmonics 'stream' : 'oper', # Denotes ERA5. Ensemble members are selected by 'enda' 'time' : '00/to/23/by/6', # You can drop :00:00 and use MARS short-hand notation, instead of '00/06/12/18' 'type' : 'an', }, 'output') # Output file; in this example containing fields in grib format. Adapt as you wish.- Tailor your request to
- re-grid to the desired regular lat-lon resolution
- convert to NetCDF (works for regular grids only, i.e., so you need to use the 'grid' keyword as well)
select sub areas
Expand title Example to download model level ERA5 analysis data (temperature) for a given area at a regular lat/lon grid in NetCDF format. Code Block #!/usr/bin/env python import cdsapi c = cdsapi.Client() c.retrieve('reanalysis-era5-complete', { # Requests follow MARS syntax # Keywords 'expver' and 'class' can be dropped. They are obsolete # since their values are imposed by 'reanalysis-era5-complete' 'date' : '2013-01-01', # The hyphens can be omitted 'levelist': '1/10/100/137', # 1 is top level, 137 the lowest model level in ERA5. Use '/' to separate values. 'levtype' : 'ml', 'param' : '130', # Full information at https://apps.ecmwf.int/codes/grib/param-db/ # The native representation for temperature is spherical harmonics 'stream' : 'oper', # Denotes ERA5. Ensemble members are selected by 'enda' 'time' : '00/to/23/by/6', # You can drop :00:00 and use MARS short-hand notation, instead of '00/06/12/18' 'type' : 'an', 'area' : '80/-50/-25/0', # North, West, South, East. Default: global 'grid' : '1.0/1.0', # Latitude/longitude. Default: spherical harmonics or reduced Gaussian grid 'format' : 'netcdf', # Output needs to be regular lat-lon, so only works in combination with 'grid'! }, 'ERA5-ml-temperature-subarea.nc') # Output file. Adapt as you wish.
...