eoio.readers.sentinel3_slstr.auxiliary module

eoio.readers.sentinel3_slstr.auxiliary module#

Auxiliary-data helpers for Sentinel-3 SLSTR reader.

eoio.readers.sentinel3_slstr.auxiliary.add_aux(*, ds: Dataset, layout: S3SLSTRLayout, grids: List[str], subset: ResolvedROISubset, clip_boxes: Dict[str, Tuple[float, float, float, float]] | None = None, config: ReaderConfig, use_chunks: bool = False, chunks: Dict[str, int] | None = None) → Dataset[source]#

Read in auxiliary data and add to an xarray Dataset for SLSTR.

This helper reads the auxiliary data requested in config.vars_sel and merges the content into ds. Supported auxiliary groups include meteorological, instrument and geometry-related datasets.

Parameters:

  • ds – Dataset to update with auxiliary variables.

  • layout – Layout helper to locate auxiliary files.

  • grids – Dictionary mapping grid names to their spatial resolutions.

  • subset – Optional resolved ROI subset for clipping auxiliary data.

  • clip_boxes – Optional pre-computed clip boxes for auxiliary data.

  • config – Reader configuration containing variable selection and read parameters.

  • use_chunks – Whether to compute and apply chunking heuristics to auxiliary data.

  • chunks – Optional chunking specification to apply to auxiliary data.

Returns:

Updated dataset with requested auxiliary variables merged in.

eoio.readers.sentinel3_slstr.auxiliary.read_cartesian_geometry(*, ds: Dataset, layout: S3SLSTRLayout, grids: List[str], subset: ResolvedROISubset, clip_boxes: Dict[str, Tuple[float, float, float, float]] | None = None, config: ReaderConfig, use_chunks: bool = False, chunks: Dict[str, int] | None = None) → Dataset[source]#

Read in cartesian geometry auxiliary data and merge into dataset.

Parameters:

  • ds – Dataset to update with cartesian geometry variables.

  • layout – Layout helper to locate cartesian geometry files.

  • grids – Dictionary mapping grid names to their spatial resolutions.

  • subset – Optional resolved ROI subset for clipping auxiliary data.

  • clip_boxes – Optional pre-computed clip boxes for auxiliary data.

  • config – Reader configuration containing variable selection and read parameters.

  • use_chunks – Whether to compute and apply chunking heuristics to auxiliary data.

  • chunks – Optional chunking specification to apply to auxiliary data.

Returns:

Updated dataset with cartesian geometry variables merged in.

eoio.readers.sentinel3_slstr.auxiliary.read_indices(*, ds: Dataset, layout: S3SLSTRLayout, grids: List[str], subset: ResolvedROISubset, clip_boxes: Dict[str, Tuple[float, float, float, float]] | None = None, config: ReaderConfig, use_chunks: bool = False, chunks: Dict[str, int] | None = None) → Dataset[source]#

Read in indices auxiliary data and merge into dataset.

Parameters:

  • ds – Dataset to update with indices variables.

  • layout – Layout helper to locate indices files.

  • grids – Dictionary mapping grid names to their spatial resolutions.

  • subset – Optional resolved ROI subset for clipping auxiliary data.

  • clip_boxes – Optional pre-computed clip boxes for auxiliary data.

  • config – Reader configuration containing variable selection and read parameters.

  • use_chunks – Whether to compute and apply chunking heuristics to auxiliary data.

  • chunks – Optional chunking specification to apply to auxiliary data.

Returns:

Updated dataset with indices variables merged in.

eoio.readers.sentinel3_slstr.auxiliary.read_met(*, ds: Dataset, layout: S3SLSTRLayout, subset: ResolvedROISubset, clip_boxes: Dict[str, Tuple[float, float, float, float]] | None = None, config: ReaderConfig, use_chunks: bool = False, chunks: Dict[str, int] | None = None) → Dataset[source]#

Read in meteorological auxiliary data and merge into dataset.

Parameters:

  • ds – Dataset to update with meteorological variables.

  • layout – Layout helper to locate meteorological files.

  • subset – Optional resolved ROI subset for clipping auxiliary data.

  • clip_boxes – Optional pre-computed clip boxes for auxiliary data.

  • config – Reader configuration containing variable selection and read parameters.

  • use_chunks – Whether to compute and apply chunking heuristics to auxiliary data.

  • chunks – Optional chunking specification to apply to auxiliary data.

Returns:

Updated dataset with meteorological variables merged in.

eoio.readers.sentinel3_slstr.auxiliary.read_observation_geometry(*, ds: Dataset, layout: S3SLSTRLayout, grids: List[str], subset: ResolvedROISubset, clip_boxes: Dict[str, Tuple[float, float, float, float]] | None = None, config: ReaderConfig, use_chunks: bool = False, chunks: Dict[str, int] | None = None) → Dataset[source]#

Read in geometry auxiliary data and merge into dataset.

Parameters:

  • ds – Dataset to update with geometry variables.

  • layout – Layout helper to locate geometry files.

  • subset – Optional resolved ROI subset for clipping auxiliary data.

  • clip_boxes – Optional pre-computed clip boxes for auxiliary data.

  • config – Reader configuration containing variable selection and read parameters.

  • use_chunks – Whether to compute and apply chunking heuristics to auxiliary data.

  • chunks – Optional chunking specification to apply to auxiliary data.

Returns:

Updated dataset with geometry variables merged in.

eoio.readers.sentinel3_slstr.auxiliary.read_orphan(*, ds: Dataset, layout: S3SLSTRLayout, subset: ResolvedROISubset, clip_boxes: Dict[str, Tuple[float, float, float, float]] | None = None, config: ReaderConfig, use_chunks: bool = False, chunks: Dict[str, int] | None = None) → Dataset[source]#

Read in orphan auxiliary data and merge into dataset.

Parameters:

  • ds – Dataset to update with orphan variables.

  • layout – Layout helper to locate orphan files.

  • subset – Optional resolved ROI subset for clipping auxiliary data.

  • clip_boxes – Optional pre-computed clip boxes for auxiliary data.

  • config – Reader configuration containing variable selection and read parameters.

  • use_chunks – Whether to compute and apply chunking heuristics to auxiliary data.

  • chunks – Optional chunking specification to apply to auxiliary data.

Returns:

Updated dataset with orphan variables merged in.

eoio.readers.sentinel3_slstr.auxiliary.read_time(*, ds: Dataset, layout: S3SLSTRLayout, grids: List[str], subset: ResolvedROISubset, clip_boxes: Dict[str, Tuple[float, float, float, float]] | None = None, config: ReaderConfig) → Dataset[source]#

Read in time auxiliary data and merge into dataset.

Parameters:

  • ds – Dataset to update with time variables.

  • layout – Layout helper to locate time files.

  • grids – Dictionary mapping grid names to their spatial resolutions.

  • subset – Optional resolved ROI subset for clipping auxiliary data.

  • clip_boxes – Optional pre-computed clip boxes for auxiliary data.

  • config – Reader configuration containing variable selection and read parameters.

Returns:

Updated dataset with time variables merged in.

eoio.readers.sentinel3_slstr.auxiliary.read_viscal(*, ds: Dataset, layout: S3SLSTRLayout, subset: ResolvedROISubset, clip_boxes: Dict[str, Tuple[float, float, float, float]] | None = None, config: ReaderConfig) → Dataset[source]#

Read in VISCAL auxiliary data and merge into dataset.

Parameters:

  • ds – Dataset to update with VISCAL variables.

  • layout – Layout helper to locate VISCAL files.

  • subset – Optional resolved ROI subset for clipping auxiliary data.

  • clip_boxes – Optional pre-computed clip boxes for auxiliary data.

  • config – Reader configuration containing variable selection and read parameters.

Returns:

Updated dataset with VISCAL variables merged in.