...
- Go to the C3S climate data store (CDS).
- On the top menu bar, click on 'Datasets'.
- On the left-hand side menu, expand 'Product type' and select Product type of interest (e.g. 'Reanalysis' for ERA5 datasets). Or you can search 'ERA5' in the search box.
- Follow the ERA5 dataset title link of interest to the full dataset record.
The full dataset record includes:
- Overview tab. This gives a description of the selected dataset and metadata information (e.g. spatial details, file format, variables, etc).
- Documentation tab. This provides links to detailed documentation about the dataset.
- Download data tab. This is a Download data web form. Using this web interface, you can:
- make selections as per your requirements
- submit your request online (you will need to login if not already logged in)
Tip: Upon submitting the download form, you will be prompted to accept the data licence (if you have not yet accepted it)! Please note that whether you are downloading the data through the web interface or through the CDS API, you must accept the data licence. - display the API script which corresponds to your selection, by clicking on the Show API request button.
- submit your request online (you will need to login if not already logged in)
- Go to the Download data tab to make your selection for ERA5 data retrieval.
- Click on button 'Submit Form' to submit your data request. Provided you have accepted the Copernicus Licence, 'your requests' page will be displayed showing the status of your submitted request.
...
- Python and pip: You are expected to have at least some basic understanding of Python and in particular know how to install packages on your local machine using pip.
- Install the CDS API:
- You are recommended to use the latest release of package CDS API (tested with version 0.1.1).
Step B: Download ERA5 data listed in CDS through CDS API
Build the basic CDS API request.
As described in on How to migrate from ECMWF Web API to CDS APImentioned above, you can use the CDS web interface to help you build your CDS API download script. In the download form, make some selections, then click the button Show API request and you will be presented with the script.Expand title Basic CDS API script example to download temperature at a given pressure level, 1000 hPa is shown HERE. Code Block language text #!/usr/bin/env python import cdsapi c = cdsapi.Client() c.retrieve('reanalysis-era5-pressure-levels', { 'variable' : 'temperature', 'pressure_level': '1000', 'product_type' : 'reanalysis', 'year' : '2008', 'month' : '01', 'day' : '01', 'time' : '12:00', 'format' : 'netcdf' # Supported format: grib and netcdf. Default: grib }, 'test.nc')- Refining your CDS API script for ERA5 data listed in CDS.
Currently the interactive CDS forms don't allow users to perform a regional sub-selection or an interpolation of the selected data. However, both actions can be performed using the following CDS API keywords:- For a geographical area subset, use key area.
For a different grid resolution, use key grid.
Please note that the ERA5 native grid in CDS is 0.25°x0.25° (atmosphere), 0.5°x0.5° (ocean waves), Mean, spread and members: 0.5°x0.5° (atmosphere), 1°x1° (ocean waves).
Below is a sample script for downloading temperature at a given pressure level, 1000 hPa. It also shows how to request for a geographical subset of the data.Expand title Show basic CDS API script including geographical subset Code Block language text #!/usr/bin/env python import cdsapi c = cdsapi.Client() c.retrieve('reanalysis-era5-pressure-levels', { 'variable' : 'temperature', 'pressure_level': '1000', 'product_type' : 'reanalysis', 'year' : '2008', 'month' : '01', 'day' : '01', 'area' : [60, -10, 50, 2], # North, West, South, East. Default: global 'grid' : [1.0, 1.0], # Latitude/longitude grid: east-west (longitude) and north-south resolution (latitude). Default: 0.25 x 0.25 'time' : '12:00', 'format' : 'netcdf' # Supported format: grib and netcdf. Default: grib }, 'test.nc')
...