energy_data_retrieval.climate_grid#

Bounded decoding of monthly provider NetCDF archives (no climate algorithms).

energy_data_retrieval.climate_grid.open_netcdf(path, *, maximum_uncompressed_bytes=2147483648)[source]#

Decode CF fill values/scales; expand gzip on disk with a hard byte limit.

Parameters:
  • path (Path)

  • maximum_uncompressed_bytes (int)

Return type:

Generator[Dataset, None, None]

energy_data_retrieval.climate_grid.normalize_monthly(dataset, variables, *, start_year, end_year, bbox=None, maximum_values=20000000)[source]#

Select before loading. Output time is a calendar-month label, not UTC telemetry.

variables maps native names to (output name, canonical unit). Native units are checked by the source adapter. Spatial bounds are inclusive cell centres; west > east selects across the antimeridian. No resampling or gap filling.

Parameters:
  • dataset (Dataset)

  • variables (dict[str, tuple[str, str]])

  • start_year (int)

  • end_year (int)

  • bbox (tuple[float, float, float, float] | None)

  • maximum_values (int)

Return type:

Dataset