Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: changed install instructions

...

Panel
titleColorwhite
titleBGColor#000000
titleStep-by-step guide

This method allows users to download ECMWF public datasets in a programmatic way.

  1. Install ECMWF key
  2. Install client libraries
  3. Check data availability
  4. Choose dataset
  5. Script examples
  6. Request syntax

Anchor
key
key

Panel
titleColorwhite
titleBGColor#2B619E
titleInstall ECMWF KEY
  1. If you don't have an account, please self register at https://apps.ecmwf.int/registration/ and then go to the steps below.
  2. Login https://apps.ecmwf.int/auth/login/

  3. Retrieve you key at https://api.ecmwf.int/v1/key/

    Info

    Note that the key expires in 1 year. You will receive an email to the registered email address 1 month before the expiration date with the renewal instructions. To check the expiry date of your current key log into www.ecmwf.int, then click here.


  4. Copy the information in this page and paste it in the file $HOME/.ecmwfapirc (Unix/Linux) or %USERPROFILE%\.ecmwfapirc (Windows: usually in C:\Users\<USERNAME>\.ecmwfapirc ; see how to create a file with a leading dot)

Code Block
languagebash
titlecontents of $HOME/.ecmwfapirc (Unix/Linux) or %USERPROFILE%\.ecmwfapirc (Windows)
{
    "url"   : "https://api.ecmwf.int/v1",
    "key"   : "XXXXXXXXXXXXXXXXXXXXXX",
    "email" : "john.smith@example.com"
}


...

Panel
titleColorwhite
titleBGColor#2B619E
titleInstall client libraries

Anchor
python
python

Python
Warning

This version of the library provides support for both Python 2.7.x and Python 3.

For languages other than Python please see Web-API Downloads

You can install the ecmwfapi python library by running on Unix/Linux:

Code Block
languagebash
sudo pip install https://software.ecmwf.int/wiki/download/attachments/56664858/ecmwf-api-client-python.tgz

or on Windows:

Code Block
languagetext
pip install https://software.ecmwf.int/wiki/download/attachments/56664858/ecmwf-api-client-python.tgz

If you cannot run the sudo or pip commands, just download the ecmwf-api-client-python.tgz. Extract its content and copy the module ecmwfapi to a directory pointed by the environment variable PYTHONPATH. Alternatively you can use the --user option of pip to install it in $HOME/.local/lib :

Code Block
pip install --user https://software.ecmwf.int/wiki/download/attachments/56664858/ecmwf-api-client-python.tgz

Include Page
Install ECMWF Web API Python client library
Install ECMWF Web API Python client library
 

Anchor
availability
availability

...

Page properties
hiddentrue


Related issues 

 

 

 

 

 

 

 

 

 

...