Version 26 (modified by anphi, 4 years ago) (diff)

changed link to git repo for version 7.1 to the tag v7.1 instead of dev branch

FLEXPART meteorological input from ECMWF

Do not remove or rename this page as it is referenced in a GMD paper

^back to FpInput

flex_extract: Software for the retrieval of ECMWF data as needed by FLEXPART

  • The Software for retrieving ECMWF data in the specific format needed by FLEXPART was originally created by Gerhard Wotawa. The later versions were written by Leo Haimberger on behalf of CTBTO.From v7.0.3 on, together with Anne Philipp.
  • Since v7, this software has been given the name flex_extract (before, various names were used to refer to it).
  • Originally, this software was usable for member-state users only. From v7.0.3 on, retrieving public datasets as non-member-state user is supported.
  • The Version column in the table below has links for downloading the corresponding tarball.
Version git Remarks
4-- Allows to retrieve compressed ECMWF data on old AIX ecgate in mixed GRIB1/GRIB2 coding
4.0-- Allows to retrieve compressed ECMWF data on new Linux ecgate in mixed GRIB1/GRIB2 coding
6.0--A new version for retrieval with 1 h time resolution and other enhancements (use on ecgate only)
7.0.2-- Python-based version. Allows access to publicly available data without a member state account through the python framework of ECMWF (ecmwf-api-client-python). Note that if you have the choice between working through this interface or directly on ecaccess/ through a gateway server, one of the latter options will usually be considerably faster. In any case, extracting large data sets takes time.
7.0.3 FpInputMetEcmwfLinks has relevant links and a step-by-step instruction of how to prepare your environment for being able to install and use flex_extract v7. We now have flex_exctract also in a public git repository on
7.0.4 tag 7.0.4A bugfix version which solves problems with ERA5 and CERA retrieval from v7.0.3 and added two new features: It can retrieve analysis and forecast ensembles efficiently, e.g. by setting number=0/to/9 (suffix for the ensemble member number is added to output file names). Additionally, it can write an extra file mars_requests.csv which contains all MARS request parameters for each request.
7.1 tag v7.1 Completely revised version, with bug fixes, modularised code, new disaggregation scheme, new test cases for quality assurance, improved user friendliness and an online documentation; a software description is now available as discussion paper at GMD; the tarball can be downloaded from here

Use and install flex_extract

FpInputMetEcmwfLinks has relevant links and a step-by-step instruction of how to prepare your environment for being able to install and use flex_extract.

Obtaining access to ECMWF MARS

In order to extract data from the ECMWF MARS archive, one needs an account at ECMWF.

Reanalysis and MACC/CAMS data are publicly available. The procedure for registration is explained on the ECMWF web site (register and perform steps 1 and 2). Consider the applicable licence. (FpInputMetEcmwfLinks contains instructions and links as well)

For other data (e.g., operational IFS data) a member-state or special-project account is be required. Contact your national meteorological service if you need this and your country is among the ECMWF member states.

hosted by ZAMG