libera_utils.footprint_matching.readers.era5_surface#

ERA5 single-level reader plugin for the footprint matching pipeline.

Data source: ECMWF ERA5 Reanalysis (single-level surface fields)

  • Format: NetCDF4 (.nc), distributed via the Copernicus Climate Data Store

  • Spatial resolution: ~0.25° (~28 km), stored as 28 km in RESOLUTION_KM

  • Grid: Regular lat/lon, global coverage, latitudes in DESCENDING order (90 → -90)

  • Temporal resolution: Hourly

  • Temporal coverage: 1940-present. ERA5 final data lags real time by ~5 days (the preliminary ERA5T stream lags ~1 day).

Variables read#

Every variable is carried by FMATCH-IMAGER and FMATCH-IMAGER-CAMTIME, alongside the RBSP CLDPIX/FLASHFlux cloud fields. The CAM products carry none: no consumer of FMATCH-CAM or FMATCH-CAM-CAMTIME reads them.

  • u10 / v10: 10 m U/V wind components

  • t2m: 2 m temperature

  • d2m: 2 m dewpoint temperature

  • sp: surface pressure

  • z: geopotential (surface; orography × g)

  • fal: forecast albedo

References

CDS dataset: https://cds.climate.copernicus.eu/datasets/reanalysis-era5-single-levels CDS API docs: https://cds.climate.copernicus.eu/how-to-api Variable list:https://confluence.ecmwf.int/display/CKB/ERA5+data+documentation Param DB (id): u10=165, v10=166, t2m=167, d2m=168, sp=134, z=129, fal=243, e.g. https://apps.ecmwf.int/codes/grib/param-db?id=165

Classes

ERA5ReaderBase(file_paths)

Shared machinery for the ERA5 reader family (single-level and pressure-level).

ERA5SurfaceReader(file_paths)

Read ERA5 single-level fields from a CDS NetCDF4 file.