Versions Compared

Key

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

This page is not yet complete.

Accessing the batch service

...

with Python

Installing the Python library

You can install the ecmwfapi python library by running

To access ECMWF you will need an API key that can be optained at https://api.ecmwf.int/v1/key/

Python

To get the python library, run:

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

 

...

Installing your API key

To access ECMWF you will need an API key that can be obtained at https://api.ecmwf.int/v1/key/. Copy the information in this page and paste it in the file $HOME/.ecmwfapirc

Code Block
languagejavascript
titleContent $HOME/.ecmwfapirc
{
    "url"   : "https://api.ecmwf.int/v1",
    "key"   : "XXXXXXXXXXXXXXXXXXXXXX",
    "email" : "john.smith@example.com"
}

Environment varibables

 

Name 
ECMWF_API_KEYhttps://api.ecmwf.int/v1
ECMWF_API_URLXXXXXXXXXXXXXXXXXXXXXX
ECMWF_API_EMAILjohn.smith@example.com

 

Arguments

Code Block
ECMWFDataServer(
       'https://api.ecmwf.int/v1',
       'XXXXXXXXXXXXXXXXXXXXXX',
       'john.smith@example.com'
    )

 

Sample Python script

Below is a simple Python script making use of the ecmwfapi library: 

Code Block
languagepython
titlePython client
#!/usr/bin/env python
from ecmwfapi import ECMWFDataServer

server = ECMWFDataServer()

server.retrieve({
    'dataset' : "tigge",
    'step'    : "24/to/120/by/24",
    'number'  : "all",
    'levtype' : "sl",
    'date'    : "20071001/to/20071003",
    'time'    : "00/12",
    'origin'  : "all",
    'type'    : "pf",
    'param'   : "tp",
    'area'    : "70/-130/30/-60",
    'grid'    : "2/2",
    'target'  : "data.grib"
    })

 

Datasets

MARS language

Find 

http://www.ecmwf.int/publications/manuals/mars/guide/index.html

Proxies

SSL

Learning more

A full description of the ECMWF WEB API can be found at { "ECMWF" : "API", "version" : 1 }.