Skip to content

The Basics of ERA5Reanalysis.jl

There are three essential components in ERA5Reanalysis.jl:

  • An ERA5 dataset of interest (i.e., an ERA5Dataset e5ds)

  • An ERA5 variable of interest (i.e., an ERA5Variable evar)

  • A geographic region of interest (i.e., an ERA5Region ereg)

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 interest

  • stop - The end of the date-range of our data of interest

  • path - The data directory in which our dataset is saved into

ERA5Reanalysis.ERA5Dataset Type
julia
ERA5Dataset

Abstract supertype for ERA5 reanalysis datasets, with the following subtypes:

julia
ERA5CDStore <: ERA5Dataset
ERA5Custom  <: ERA5Dataset
ERA5Dummy   <: ERA5Dataset

All ERA5Dataset Types contain the following fields:

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

  • emask : The specified directory in which to save the LandSea dataset

All ERA5CDStore and ERA5Custom Types also contain the following additional fields:

  • ID : The module ID, that also acts as a prefix to filenames

  • name : The full name of the module

  • start : The date for which downloads/analysis begins

  • stop : The date for which downloads/analysis finishes

  • sldoi : Single-Level DOI (N/A for ERA5Daily)

  • pldoi : Pressure-Level DOI (N/A for ERA5Daily)

  • ptype : Product type (N/A for ERA5Daily), set to reanalysis

source

The ERA5Variable Type

An ERA5Variable specifies the meteorological variable to download or analyze. There are two main types:

  • SingleLevel variables - provided in the (lon, lat) space (e.g., surface temperature, total cloud cover)

  • PressureLevel variables - provided in the (lon, lat, pressure) space (e.g., atmospheric temperature, specific humidity)

ERA5Reanalysis.ERA5Variable Type
julia
ERA5Variable

Abstract supertype for ERA5 variables, with the following subtypes

julia
SingleLevel   <: ERA5Variable
PressureLevel <: ERA5Variable

All ERA5Variable Types contain the following fields:

  • ID : The variable ID, that is also the identifier in the NetCDF files

  • name : The full-name of the variable

  • long : The variable long-name, which is used to specify retrievals from CDS

  • dataset : The full-name of the variable

  • units : The units of the variable

All PressureLevel Types contain the following fields:

  • hPa : The pressure level (in hPa) of the pressure-variable of interest
source

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
julia
ERA5Region

Abstract supertype for ERA5 Regions, with the following subtypes

julia
ERA5LonLatGrid <: ERA5Region
ERA5NativeGrid <: ERA5Region

All ERA5Region Types contain the following fields:

  • geo : The GeoRegion containing the geographical information

  • ID : The ID used to specify the GeoRegion

  • resolution : The resolution of the gridded data to be downloaded/analysed

  • string : Specification of folder and file name, mostly for backend usage

  • isglb : A Bool, true if spans the globe, false if no

  • is360 : True if it spans 360º longitude

source