Versions Compared

Key

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

...

  1. This is Python based.
    • This may require some basic knowledge of Python. However, in most cases common-sense adaptions of example requests obtained from the web interface should be sufficient.
  2. Install the CDS API:
    • this may require some basic knowledge of pip, in particular know how to install packages on your local machine using pip.
    • On linux or on cygwin, please follow the instructions HERE.
    • Windows users may follow the instructions HERE instead.
    • Mac users may follow the instructions HERE.
  3. You are recommended to use the latest release of package CDS API.
  4. Run CDS API requests, either interactively or in batch mode.
Note

In a small number of cases, users may experience some issues when requesting data from the CDS API. The most common issues here documented here.


Option A: Download ERA5 family data stored on CDS disks - FAST ACCESS

...

To retrieve data efficiently using the CDS API please have a look at the efficiency tips section on CDS documentation.


Note
titleRequest for ERA5 data in NetCDF

When requesting ERA5 data from the CDS in NetCDF (web or CDS API), users should not request ERA5 reanalysis atmospheric data, wave data, and ensemble data in one request. This is because the data has different spatial grids, which can cause issues for the current grib to NetCDF converter and producing incorrect results.

Option B: Download ERA5 family data that is NOT listed in the CDS online catalogue - SLOW ACCESS

...

Due to the vast volume of these datasets (currently about 6 petabyte) 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).


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


You can discover the ERA5-complete structure and learn how to build a CDS API request by following these steps:

...