eoio.processors.units.drivers.airbus_pleiades module

eoio.processors.units.drivers.airbus_pleiades module#

eoio.processors.units.drivers.airbus_pleiades - unit conversion for AirbusPleiades products

class eoio.processors.units.drivers.airbus_pleiades.AirbusPleiadesUnitDriver[source]#

Bases: BaseUnitConversionDriver

AirbusPleiades unit conversion driver.

Intended scope: - radiance -> reflectance, using attributes available in the product - radiance -> DNs, using attributes available in the product

This driver assumes eoio readers provide enough product identification to allow cheap matching (e.g. ds.attrs[‘eoio:product’] in {“airbus_pleiades”}).

Notes

AirbusPleiades unit conversion depends on: - per-band reflectance coefficients

Where those values live should be standardised in dataset and variable attrs.

convert(ds: Dataset, to: str, var_names: Sequence[str] | None, *, context: Mapping[str, Any]) → Dataset[source]#

Convert selected variables in the dataset to the requested target units, based on supported conversion pairs. If no variables are selected, the default is all measurement vars. Converts the data using conversion coefficients found in metadata (per band gain and bias, solar zenith, etc.) and updates units attributes accordingly.

Parameters:

  • ds – Input dataset.

  • to – Target unit name (e.g. “reflectance”).

  • var_names – Variables to convert. If None default is all measurement vars.

  • context – Processing context provided by eoio, passed to all processors.

Returns:

Dataset with converted variables.

Raises:

  • ValueError – If an unsupported conversion is requested.

  • KeyError – If requested variables are not present.

matches(ds: Dataset, context: Mapping[str, Any]) → bool[source]#

Determine whether this driver can handle the given dataset.

Matching should be cheap and unambiguous; avoid heavy inspection.

Parameters:

  • ds – Input dataset.

  • context – Processing context provided by eoio.

Returns:

True if this looks like a AirbusPleiades dataset, otherwise False.

name: str = 'airbus_pleiades'#
supported() → Set[Tuple[str, str]][source]#

Return supported conversion pairs.

Returns:

Set of supported (from_unit, to_unit) pairs.