Skip to main content

Readers and converters for data from the ECMWF reanalysis models.

Project description

Readers and converters for data from the ECMWF reanalysis models. Written in Python.

Works great in combination with pytesmo.


A small package for downloading ECMWF reanalysis data and converting it into a time series format supported by pytesmo.


Documentation Status

Supported Products

This version supports the following products:

  • ERA-Interim

Downloading data

ERA-Interim data can be downloaded manually from the ECMWF servers. It can also be done automatically using the ECMWF API. To use the ECMWF API you have to be registered, install the ecmwf-api Python package and setup the ECMWF API Key. A guide for this is provided by ECMWF.

After that you can use the command line program ecmwf_download to download data. For example ecmwf_download /path/to/storage 39 40 -s 2000-01-01 -e 2000-02-01 would download the parameters 39 and 40 into the folder /path/to/storage between the first of January 2000 and the first of February 2000 The data will be stored in yearly subfolders of the format ei_YYYY. After the download the data can be read with the ecmwf_models.ERAInterimDs class.

Reading data

The dataset can be read by datetime using the ecmwf_models.ERAInterimDs.

from ecmwf_models import ERAInterimDs
root_path = "/path/to/storage"
ds = ERAInterimDs('39', root_path)
data =, 1, 1, 0))
assert['39'].shape == (256, 512)
assert data.lon.shape == (256, 512)
assert == (256, 512)

Multiple parameters can be read by providing a list to ERAInterimDs:

from ecmwf_models import ERAInterimDs
root_path = "/path/to/storage"
ds = ERAInterimDs(['39', '40'], root_path)
data =, 1, 1, 0))
assert['39'].shape == (256, 512)
assert['40'].shape == (256, 512)

All images between two given dates can be read using the ERAInterimDs.iter_images method.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for ecmwf-models, version 0.1
Filename, size File type Python version Upload date Hashes
Filename, size ecmwf_models-0.1-py2.py3-none-any.whl (10.3 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size ecmwf_models-0.1.tar.gz (442.2 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page