The Basics of ERA5Reanalysis.jl
There are three essential components in ERA5Reanalysis.jl:
An ERA5 dataset of interest (i.e., an
ERA5Datasete5ds)An ERA5 variable of interest (i.e., an
ERA5Variableevar)A geographic region of interest (i.e., an
ERA5Regionereg)
With these three components, you can perform the following actions:
Download data of interest using
download(e5ds, evar, ereg)Read downloaded data using
read(e5ds, evar, ereg, dt)Perform basic analysis on the data
The ERA5Dataset Type
All ERA5Dataset types (except for the Dummy types) contain the following information:
start- The beginning of the date-range of our data of intereststop- The end of the date-range of our data of interestpath- The data directory in which our dataset is saved into
ERA5Reanalysis.ERA5Dataset Type
ERA5DatasetAbstract supertype for ERA5 reanalysis datasets, with the following subtypes:
ERA5CDStore <: ERA5Dataset
ERA5Custom <: ERA5Dataset
ERA5Dummy <: ERA5DatasetAll ERA5Dataset Types contain the following fields:
path: The specified directory in which to save the dataemask: The specified directory in which to save theLandSeadataset
All ERA5CDStore and ERA5Custom Types also contain the following additional fields:
ID: The module ID, that also acts as a prefix to filenamesname: The full name of the modulestart: The date for which downloads/analysis beginsstop: The date for which downloads/analysis finishessldoi: Single-Level DOI (N/A for ERA5Daily)pldoi: Pressure-Level DOI (N/A for ERA5Daily)ptype: Product type (N/A for ERA5Daily), set toreanalysis
The ERA5Variable Type
An ERA5Variable specifies the meteorological variable to download or analyze. There are two main types:
SingleLevelvariables - provided in the (lon, lat) space (e.g., surface temperature, total cloud cover)PressureLevelvariables - provided in the (lon, lat, pressure) space (e.g., atmospheric temperature, specific humidity)
ERA5Reanalysis.ERA5Variable Type
ERA5VariableAbstract supertype for ERA5 variables, with the following subtypes
SingleLevel <: ERA5Variable
PressureLevel <: ERA5VariableAll ERA5Variable Types contain the following fields:
ID: The variable ID, that is also the identifier in the NetCDF filesname: The full-name of the variablelong: The variable long-name, which is used to specify retrievals from CDSdataset: The full-name of the variableunits: The units of the variable
All PressureLevel Types contain the following fields:
hPa: The pressure level (in hPa) of the pressure-variable of interest
The ERA5Region Type
An ERA5Region defines the geometry of your geographical region of interest, built on top of the GeoRegion functionality in GeoRegions.jl. It additionally specifies the resolution at which the data will be downloaded/analyzed.
ERA5Reanalysis.ERA5Region Type
ERA5RegionAbstract supertype for ERA5 Regions, with the following subtypes
ERA5LonLatGrid <: ERA5Region
ERA5NativeGrid <: ERA5RegionAll ERA5Region Types contain the following fields:
geo: TheGeoRegioncontaining the geographical informationID: The ID used to specify theGeoRegionresolution: The resolution of the gridded data to be downloaded/analysedstring: Specification of folder and file name, mostly for backend usageisglb: A Bool, true if spans the globe, false if nois360: True if it spans 360º longitude