eoio.readers.sentinel3_olci.auxiliary module

eoio.readers.sentinel3_olci.auxiliary module#

eoio.readers.sentinel3_olci.aux - Auxiliary data reading for Sentinel-3 OLCI.

eoio.readers.sentinel3_olci.auxiliary.add_aux(*, ds: Dataset, layout: S3OLCILayout, subset: ResolvedROISubset, config: ReaderConfig) → Dataset[source]#

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

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.

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

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

Returns:

Updated dataset with requested auxiliary variables merged in.

eoio.readers.sentinel3_olci.auxiliary.read_instrument_aux(*, ds: Dataset, layout: S3OLCILayout, subset: ResolvedROISubset | None = None, config: ReaderConfig, chunks: Dict[str, int] | None = None, use_chunks: bool = False) → Dataset[source]#

Read instrument auxiliary data (e.g. FWHM, solar flux) and merge in.

Opens the instrument data file and selects requested variables. When detector_index is requested it is read and regridded to match the product coordinates before assignment.

Parameters:

  • ds – Dataset to which instrument auxiliary variables will be added.

  • layout – Layout helper for locating the instrument auxiliary file.

  • subset – Optional resolved ROI subset for clipping; may be None.

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

  • chunks – Optional chunking specification for raster reads.

  • use_chunks – Whether to compute and apply chunking heuristics.

Returns:

Updated dataset with instrument auxiliary variables merged in.

eoio.readers.sentinel3_olci.auxiliary.read_meteo_aux(*, ds: Dataset, layout: S3OLCILayout, subset: ResolvedROISubset | None = None, config: ReaderConfig, chunks: Dict[str, int] | None = None, use_chunks: bool = False) → Dataset[source]#

Read meteorological auxiliary data and merge into ds.

Reads the tie meteo file and extracts requested meteorological fields such as atmospheric temperature profiles, horizontal wind, humidity, surface pressure and columnar water vapour. Data are optionally clipped to the ROI and merged into the provided dataset.

Parameters:

  • ds – Dataset to which meteorological auxiliary variables will be added.

  • layout – Layout helper for locating the tie meteo file.

  • subset – Optional resolved ROI subset for clipping; may be None.

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

  • chunks – Optional chunking specification for raster reads.

  • use_chunks – Whether to compute and apply chunking heuristics.

Returns:

Updated dataset with meteorological auxiliary variables merged in.

eoio.readers.sentinel3_olci.auxiliary.read_obs_geometry(*, ds: Dataset, layout: S3OLCILayout, subset: ResolvedROISubset | None = None, config: ReaderConfig, chunks: Dict[str, int] | None = None, use_chunks: bool = False) → Dataset[source]#

Read observation geometry variables from the tie-point file.

Reads tie_geometries.nc with rioxarray, applies optional ROI clipping, renames observational variables to human-friendly names and merges them into ds.

Parameters:

  • ds – Dataset to which observation geometry variables will be added.

  • layout – Layout helper for locating the tie_geometries.nc file.

  • subset – Optional resolved ROI subset for clipping; may be None.

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

  • chunks – Optional chunking specification for raster reads.

  • use_chunks – Whether to compute and apply chunking heuristics.

Returns:

Updated dataset with observation geometry variables merged in.

eoio.readers.sentinel3_olci.auxiliary.read_removed_pixels(*, ds: Dataset, layout: S3OLCILayout, subset: ResolvedROISubset | None = None, config: ReaderConfig, chunks: Dict[str, int] | None = None, use_chunks: bool = False) → Dataset[source]#

Read removed-pixels information and merge into ds.

Reads removed_pixels.nc and extracts coordinate arrays and per-pixel variables (e.g. SZA, detector index). Optionally reads and decodes quality flag masks and merges the results into ds.

Parameters:

  • ds – Dataset to which removed-pixel data will be added.

  • layout – Layout helper for locating the removed_pixels.nc file.

  • subset – Optional resolved ROI subset for clipping; may be None.

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

  • chunks – Optional chunking specification for raster reads.

  • use_chunks – Whether to compute and apply chunking heuristics.

Returns:

Updated dataset with removed-pixel coordinates, variables and optional flag masks merged in.