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.
| Type | Resolution | Function |
|---|---|---|
ERA5Hourly | Hourly | ERA5Hourly() |
ERA5Monthly | Monthly | ERA5Monthly() |
ERA5MonthlyHour | Monthly by Hour | ERA5Monthly(hours=...) |
Setup
using ERA5ReanalysisCreating an ERA5Hourly dataset
The ERA5Hourly dataset structure is used to contain information regarding hourly ERA5 datasets.
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/emasktypeof(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.
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) : falsetypeof(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:
e5ds = ERA5Monthly(start=Date(2017,1,2),stop=Date(2018,5,1),hours=[0,6,12,18])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
ERA5Hourly(;
start :: TimeType,
stop :: TimeType,
path :: AbstractString = homedir(),
) -> ERA5Hourly <: ERA5DatasetA 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 datastart: The date for which downloads/analysis begins, automatically rounded to the nearest monthstop: The date for which downloads/analysis finishes, automatically rounded to the nearest month
ERA5Reanalysis.ERA5Monthly Method
ERA5Monthly(;
start :: TimeType,
stop :: TimeType,
path :: AbstractString = homedir(),
hours :: Bool = false,
) -> ERA5Monthly <: ERA5Dataset or ERA5MonthlyHour <: ERA5DatasetA 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 datastart: The date for which downloads/analysis begins, automatically rounded to the nearest yearstop: The date for which downloads/analysis finishes, automatically rounded to the nearest yearhours: If false, download monthly-averaged data. If true, download monthly-averaged data for each hour