Skip to content

Climate Data Store Datasets

CDS Datasets are represented by the ERA5CDStore AbstractType, which includes ERA5Hourly and ERA5Monthly datasets. These datasets can be downloaded directly from the Climate Data Store using the CDSAPI.

The Types that each dataset calls are listed below, along with their function calls.

TypeResolutionFunction
ERA5HourlyHourlyERA5Hourly()
ERA5MonthlyMonthlyERA5Monthly()
ERA5MonthlyHourMonthly by HourERA5Monthly(hours=...)

Setup

julia
using ERA5Reanalysis

Creating an ERA5Hourly dataset

The ERA5Hourly dataset structure is used to contain information regarding hourly ERA5 datasets.

julia
e5ds = ERA5Hourly(start=Date(2017,2,1),stop=Date(2017,2,4))
The ERA5Hourly Module has the following properties:
    Dataset ID        (ID) : era5hr
    Date Begin     (start) : 2017-02-01
    Date End        (stop) : 2017-02-28
    Data Directory  (path) : /home/runner/era5hr
    Mask Directory (emask) : /home/runner/emask
julia
typeof(e5ds)
ERA5Hourly{String, Date}

Warning

ERA5Hourly datasets are designed to process data by whole-months. It is not possible to specify specific days for download - the entire month will be downloaded.

Creating an ERA5Monthly dataset

The ERA5Monthly dataset structure is used to contain information regarding monthly-averaged ERA5 datasets.

julia
e5ds = ERA5Monthly(start=Date(2017,2,5),stop=Date(2017,6,9))
The ERA5Monthly Module has the following properties:
    Dataset ID        (ID) : era5mo
    Date Begin     (start) : 2017-01-01
    Date End        (stop) : 2017-12-31
    Data Directory  (path) : /home/runner/era5mo
    Mask Directory (emask) : /home/runner/emask
    Hour-of-Day?   (hours) : false
julia
typeof(e5ds)
ERA5Monthly{String, Date}

Warning

ERA5Monthly datasets are designed to process data by years. The start and stop fields define the full years of data.

Creating an ERA5MonthlyHour dataset

The Climate Data Store also provides ERA5 Monthly data by hour-of-day. This is accessed via the ERA5Monthly function by specifying the hours argument:

@example
e5ds = ERA5Monthly(start=Date(2017,1,2),stop=Date(2018,5,1),hours=[0,6,12,18])
julia
typeof(e5ds)
ERA5Monthly{String, Date}

Future Datasets

There are other potential modules that could be incorporated into ERA5Reanalysis.jl, such as:

  • ERA5-Land data

  • Ensemble model averages, individual members, and standard deviations

They have not been added yet into ERA5Reanalysis.jl. If you are potentially interested in having these datasets added, please submit a pull request.

API

ERA5Reanalysis.ERA5Hourly Method
julia
ERA5Hourly(;
    start :: TimeType,
    stop  :: TimeType,
    path  :: AbstractString = homedir(),
) -> ERA5Hourly <: ERA5Dataset

A function that creates an ERA5Hourly module. All possible hours are downloaded, and data is saved month-by-month.

Keyword Arguments

  • path : The specified directory in which to save the data

  • start : The date for which downloads/analysis begins, automatically rounded to the nearest month

  • stop : The date for which downloads/analysis finishes, automatically rounded to the nearest month

source
ERA5Reanalysis.ERA5Monthly Method
julia
ERA5Monthly(;
    start :: TimeType,
    stop  :: TimeType,
    path  :: AbstractString = homedir(),
    hours :: Bool = false,
) -> ERA5Monthly <: ERA5Dataset or ERA5MonthlyHour <: ERA5Dataset

A function that creates an ERA5Monthly or ERA5MonthlyHour module depending on the input arguments of hours. Data is saved year-by-year.

Keyword Arguments

  • path : The specified directory in which to save the data

  • start : The date for which downloads/analysis begins, automatically rounded to the nearest year

  • stop : The date for which downloads/analysis finishes, automatically rounded to the nearest year

  • hours : If false, download monthly-averaged data. If true, download monthly-averaged data for each hour

source