Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: changed install key 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. Python
  4. Client libraries
  5. Check data availability
  6. Choose dataset
  7. Script examples
  8. Request syntax

  9. More clients

Anchor
key
key

{ "url" : "https://api.ecmwf.int/v1", "key" : "XXXXXXXXXXXXXXXXXXXXXX", "email" : "john.smith@example.com" }

Panel
titleColorwhite
titleBGColor#2B619E
titleInstall ECMWF KEY

Include Page
Install ECMWF API Key
Install ECMWF API 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/

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

Code Block
languagebash
titlecontents of $HOME/.ecmwfapirc (Unix/Linux) or %USERPROFILE%\.ecmwfapirc (Windows)

Anchor
clientlibraries
clientlibraries

Panel
titleColorwhite
titleBGColor#2B619E
titleInstall client libraries

Anchor
python
python

Python

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.

Warning

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

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

Anchor
availability
availability

...

Panel
titleColorwhite
titleBGColor#2B619E
titleRequest syntax

See Brief request syntax 

...

panel

titleColorwhite
titleBGColor#2B619E
titleClient Libraries

We also have some API for several client languages. Note that Python is the most tested and supported.

Attachments
previewfalse
uploadfalse
oldfalse
patterns*.tgz
sortByname
pageWeb-API Downloads

Perl

You need to download the clien, extract its content and to a directory pointed by the environment variable  PERL5LIB . This code relies on the JSON perl module, as well as libwww-perl and Crypt::SSLeay.

Java

You need to download the client and you will also need the Java JSON package.

 

Content by Label
showLabelsfalse
max5
spaces~uscs
showSpacefalse
sortmodified
reversetrue
typepage
cqllabel in ("perl","mars","web","script","python","api","batch","java") and type = "page" and space = "~uscs"
labelsmars web api python perl java script batch

Page properties
hiddentrue


Related issues 

 

 

 

 

 

 

 

 

 

...