Dealing with ERA5 Reanalysis datasets
Author natgeo-wong
5 Stars
Updated Last
1 Year Ago
Started In
August 2021


Repo Status GitHub Actions
MIT License Release Version Stable Documentation Latest Documentation

Created By: Nathanael Wong (


ERA5Reanalysis.jl is a Julia package that aims to streamline the following processes:

  • downloads of ERA5 Datasets from the Climate Data Store (does not include MARS requests)
  • basic analysis of said datasets
  • perform all the above operations innately over a given geographical region using the GeoRegion functionality of GeoRegions.jl (v2 and above)

ERA5Reanalysis.jl has not been officially registered as a Julia package yet. To install it, add it directly using the GitHub link as follows:

julia> ]
(@v1.6) pkg> add

Required Installation

In order to download data from the Climate Data Store (CDS), you need to register with Copernicus first, and then follow the instructions here such that the information can be retrieved from the ~/.cdsapirc file


Please refer to the documentation for instructions and examples. A working knowledge of the GeoRegion supertypes used in GeoRegions.jl v2 is also needed.

Tip: Both the GeoRegions.jl and Dates dependencies are reexported by ERA5Reanalysis.jl, and therefore there is no need to call either GeoRegions.jl or Dates separately when using the ERA5Reanalysis.jl package.

Supported Datasets

The following ERA5 datasets available on CDS are supported:

  • Hourly Data, 0.25º resolution, from 1979-present
    • Early and Late runs of Half-Hourly and Daily Data
    • Ensemble data, mean and std not yet supported, addition is possible depending on demand
  • Monthly Data, 0.25º resolution, from 1979-present
    • Both monthly reanalysis, and monthly-by-hour are supported
    • Ensemble data not yet supported, addition is possible depending on demand
  • Support for the back-extension (1950-1978) for all datasets coming soon
  • Support for ERA5-Land reanalysis will eventually be included. How fast depends on demand

Only the calibrated precipitation data is downloaded, with units of rate in log2(mm/s).

If there is demand, I can try to add other datasets available on the Climate Data Store to the mix as well. Please open an issue if you want me to do so.

Used By Packages

No packages found.