eoio.readers.ecmwf.subset module

eoio.readers.ecmwf.subset module#

eoio.readers.ecmwf.subset#

Resolves user-defined subsets for ECMWF (ERA5 / CAMS) datasets.

ROI and datetime subsetting live here rather than in eoio.readers.generic_netcdf.subset because they depend on knowing what the product’s coordinates mean: ECMWFReader.open_dataset renames valid_time to datetime and guarantees a CRS before calling in, and ECMWFReader declares roi/roi_crs/datetime in its default_subset so callers can actually reach them. The generic netCDF reader can assume neither, so it keeps a deliberately smaller subset vocabulary.

Classes#

ECMWFSubset(datetime_indices, roi_subset)

Resolved subsetting info for ECMWF reads.

Functions#

build_subset(ds, subset)

Build an ECMWFSubset from a dataset and subset definition.
class eoio.readers.ecmwf.subset.ECMWFSubset(datetime_indices: ndarray | None, roi_subset: ResolvedROISubset | None)[source]#

Bases: object

Resolved subsetting info for ECMWF reads.

datetime_indices#

Indices along the datetime dimension, or None for no constraint

Type:

numpy.ndarray | None

roi_subset#

Resolved ROI in the image CRS, or None for no constraint

Type:

eoio.readers.subset.roi_subset.ResolvedROISubset | None

datetime_indices: ndarray | None#
roi_subset: ResolvedROISubset | None#
eoio.readers.ecmwf.subset.build_subset(ds: Dataset, subset: dict) → ECMWFSubset[source]#

Build an ECMWFSubset from a dataset and subset definition.

Parameters:

  • ds – The input dataset, with its time coordinate already named datetime and a CRS written.

  • subset – Subsetting definition.

Returns:

The resolved subsetting information.