Versions Compared

Key

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

...

2) The CDS API is a service providing programmatic access to CDS data in Python (using the CDS API client). Users need to have a CDS account to use it with the related CDS API key. For a full description and some useful examples, please see How to use the CDS API

If users have more than one CDS API key and therefore have to pass credentials in explicitly, the following method can be used:

Code Block
languagepy
import cdsapi
import yaml

with open('/path/to/ads/cdsapirc', 'r') as f:
        credentials = yaml.safe_load(f)
c = cdsapi.Client(url=credentials['url'], key=credentials['key'])

c.retrieve("dataset-short-name", 
           {... sub-selection request ...}, 
           "target-file")

...

Note

For the most common CDS API issues, please see Common Error Messages for CDS Requests.

For no-Python users, CDS API is REST-based so it can be wrapped by any programming language. Please have a look at this example with the R package: Download CDS ERA5 data using R.

3) The CDS Toolbox is a set of software which enables users to develop custom-made applications via an on-line interface (Figure 3). The applications can make use of the content of the CDS to analyse, monitor and predict the evolution of both climate drivers and impacts. The CDS Toolbox is a catalogue of software that can be classified as:

...