eoio.readers.landsat.data_io module

eoio.readers.landsat.data_io module#

eoio.readers.landsat.data_io - data reading functionality for Landsat meas vars

eoio.readers.landsat.data_io.read_bands_into_dataset(*, ds: Dataset, layout: LandsatLayout, meas_vars: List[str], subset: None | ResolvedROISubset, mtd: LSMetadataExtractor, chunks: Dict[str, int] | None = None, use_chunks: bool = False, mask_zero_as_nodata: bool = True) → Dataset[source]#

Reads Landsat bands into the dataset.

Minimal example: - Opens each TIF file via rioxarray. - Applies clip_box/geometries if present. - Stores each band as ds[varname].

Parameters:

  • ds – xarray.Dataset to populate.

  • layout – LandsatLayout object defining the product structure.

  • meas_vars – List of measurement variables to read, e.g. [“B2”, “B3”].

  • meas_var_res – Dictionary mapping measurement variables to their resolutions.

  • subset – Subset information for ROI and geometries.

  • chunks – Optional mapping of dimension names to chunk sizes passed directly to rioxarray.open_rasterio. If provided, this overrides any automatically derived chunk sizes.

  • use_chunks – If True and chunks is not provided, enable Dask-backed lazy reading using block-aligned chunk sizes inferred from the raster metadata.

  • mask_zero_as_nodata – If True, values equal to zero are masked as missing data after scaling.

Returns:

Populated xarray.Dataset.