Versions Compared

Key

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

...

This article describes how to switch to using the CDS API for Copernicus Atmosphere Monitoring Service (CAMS) data users. This is the programmatic way of downloading data from the Atmosphere Data Store (ADS).

The ADS also offers an interactive way of downloading the CAMS data through its web interface ("Download Data tab").

...

Before the release of Copernicus Atmosphere Monitoring Service (CAMS) Atmosphere Data Store (ADS) in March 2020, CAMS datasets were made available through various means depending on data host (e.g. Global CAMS analysis and forecast data hosted at the ECMWF data server and made available though the ECMWF Web API, the programmatic way of retrieving data; European air quality forecast or analysis data through www.regional.atmosphere.copernicus.eu and download.regional.atmosphere.copernicus.eu; etc...)

...

  1. 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.
  2. Install the CDS API:
    • on linux or on cygwyn (using pip), please follow the instructions HERE.
    • Windows users may follow the instructions HERE instead.
    • macOS user, please read instructions HERE
    • On systems running Anaconda, you can install using conda:

      Code Block
      /<install_path>/conda/anaconda2/bin/conda config --add channels conda-forge
      /<install_path>/conda/anaconda2/bin/conda install cdsapi


  3. You are recommended to use the latest release of packages:  CDS API and see the following page for more details: https://ads.atmosphere.copernicus.eu/api-how-to-api
  4. ADS account - If you do not yet have a ADS account, please create one HERE.

    Info

    We have had some problems with mail servers rejecting address confirmation emails from the ADS. We are working on this but if you register on the site and don't receive the registration email, please contact User Support and we will authorise your address manually.


  5. Data licence  - Before you may download any data from the ADS, you need to have accepted the Terms and Conditions of the dataset of choice. Further details below on how to do this.

Steps to accept data licence and generate a basic API script using the ADS web interface:

  1. Go to the CAMS atmosphere data store (ADS)
  2. On the top menu bar, click on 'Datasets'
  3. On the left-hand side menu, expand 'Product type' and select Product type of interest (e.g. "Analysis", "Forecast", "Reanalysis")
  4. Follow the dataset title link of interest to the full dataset record
  5. Accept dataset licence and generate basic API script

...