Page info | ||||||
---|---|---|---|---|---|---|
|
Note |
---|
Please be aware that the following page is relevant for the CDS API package of the current CDS system. If you are using the new CDS-Beta system, version 0.7.0 or higher of the cdsapi package is required and you must use Python3. Note that your CDS-Beta credentials must be used in your request. |
Info | ||||
---|---|---|---|---|
| ||||
|
Easy Heading Macro |
---|
Note |
---|
You only need to go through this procedure once, before you can use the CDS API on macOS to programmatically download data from either the Climate Data Store (CDS) or the Atmosphere Data Store (ADS). |
Prerequisites
- Have You need to have a CDS or ADS account. If you don't have an account, please self register at the CDS registration page or the ADS registration, whichever is appropriate.
- You need Python
Option 1: use Python 2.
Expand title Test Python 2 and install pip If you want to use Python 2, then it should come with your macOS. Open a Terminal and type command 'python'. You should see something like 'Python 2.7.10 (default, Feb 22 2019, 21:17:52)'. Type 'Control + D' to quit.
For Python 2, run the 2 commands below to install pip:
Code Block curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
python get-pip.py
Option 2: use Python 3. You are recommended to follow instructions here using Homebrew.xcode-select --install
Expand title Install Python3 through Homebrew Code Block xcode-select --install
/bin/
bash -
c "$(curl -fsSL https://raw.githubusercontent.com/
Homebrew/install/master/install.sh)"
brew install python3
- Optional: you are recommended to set up a virtual environment.
Python 3 comes up with this feature. For Python 2, you may want to use Virtualenv. This is out of the scope of this knowledge base article.
Step-by-step guide
- Login to CDS (or Login to ADS)
- Copy a 2 line code, which shows a url and your own uid:API key details as follows:
- For CDS users, Go to this page and copy the 2 line code displayed
- in the black box in the "Install the CDS API key" section.
- For ADS users, Go to this page and copy the 2 line code displayed in the black box in the "Install the CDS API key" section.
Create your key file in your home directory in your Terminal window as follows:
Code Block touch ~/.cdsapirc
- Edit your key file and paste the two lines you copied in Step 2 above to your .cdsapirc key Run 'touch ~/.cdsapirc' in your Terminal to create your key file and copy the two lines you see in 1 to the file.
Install the CDS API client using pip
: 'pip install cdsapi'. You should run this under a Terminal., by running the following command in your Terminal window:
Code Block pip install cdsapi
- Once the CDS API client is installed, it can be used to request data from the datasets listed in the CDS and ADS catalogues. It is necessary to agree to the Terms of Use of every datasets that you intend to download. Attached to each dataset download form, the 'Show API request' button displays the python code to be used.
Info |
---|
If you are getting connection issues, we recommend that in the first instance you check your proxy settings with your local IT team. |
Info | ||
---|---|---|
| ||
This document has been produced in the context of the Copernicus Climate Change Service (C3S). The activities leading to these results have been contracted by the European Centre for Medium-Range Weather Forecasts, operator of C3S on behalf of the European Union (Delegation Agreement signed on 11/11/2014 and Contribution Agreement signed on 22/07/2021). All information in this document is provided "as is" and no guarantee or warranty is given that the information is fit for any particular purpose. The users thereof use the information at their sole risk and liability. For the avoidance of all doubt , the European Commission and the European Centre for Medium - Range Weather Forecasts have no liability in respect of this document, which is merely representing the author's view. |
Related articles
Content by Label | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...