remotior_sensus.tools.preprocess_products module

Perform the preprocessing of products.

remotior_sensus.tools.preprocess_products.create_product_table(input_path, metadata_file_path=None, product=None, nodata_value=None, sensor=None, acquisition_date=None)
remotior_sensus.tools.preprocess_products.perform_preprocess(product_table, output_path, dos1_correction=False, add_bandset=None, output_prefix='', n_processes: int | None = None, available_ram: int | None = None, bandset_catalog: BandSetCatalog | None = None, progress_message=True) → OutputManager

Preprocess products.

Perform preprocessing based on product table.

Parameters:

  • product_table – product table object.

  • output_path – string of output path directory.

  • dos1_correction – if True, perform DOS1 correction.

  • add_bandset – if True, create a new bandset and add output bands to it; if False, add output bands to current bandset.

  • output_prefix – optional string for output name prefix.

  • n_processes – number of parallel processes.

  • available_ram – number of megabytes of RAM available to processes.

  • bandset_catalog – BandSetCatalog object.

  • progress_message – progress message.

Returns:

Object OutputManager() with

  • paths = output list

remotior_sensus.tools.preprocess_products.preprocess(input_path, output_path, metadata_file_path=None, add_bandset=None, product=None, nodata_value=None, sensor=None, acquisition_date=None, dos1_correction=False, output_prefix='', n_processes: int | None = None, bandset_catalog: BandSetCatalog | None = None, available_ram: int | None = None, progress_message=True) → OutputManager

Create table and preprocess products.

Perform image conversion to reflectance of several products.

Can calculate DOS1 corrected reflectance (Sobrino, J. et al., 2004. Land surface temperature retrieval from LANDSAT TM 5. Remote Sensing of Environment, Elsevier, 90, 434-440) approximating path radiance to path reflectance for level 1 data:

TOA reflectance = DN * reflectance_scale + reflectance_offset

path reflectance p = DNm - Dark Object reflectance = DNm * reflectance_scale + reflectance_offset - 0.01

land surface reflectance = TOA reflectance - p = (DN * reflectance_scale) - (DNm * reflectance_scale - 0.01)

Landsat’s data Collection 1 and 2 Level 1T Landsat 8-9 TOA reflectance proportional to exo-atmospheric solar irradiance in each band and the Earth-Sun distance (USGS, 2021. Landsat 8-9 Calibration and Validation (Cal/Val) Algorithm Description Document (ADD). Version 4.0. Department of the Interior U.S. Geological Survey, South Dakota)

TOA reflectance with correction for the sun angle = DN * Reflectance multiplicative scaling factor + Reflectance additive scaling factor / sin(Sun elevation)

Level 2S

Surface reflectance = DN * Reflectance multiplicative scaling factor + Reflectance additive scaling factor

Sentinel-2 data Level 1C

TOA reflectance = DN / QUANTIFICATION VALUE + OFFSET

Level 2S

Surface reflectance = DN / QUANTIFICATION VALUE + OFFSET

Parameters:

  • input_path – path containing the raster bands.

  • output_path – string of output path directory.

  • metadata_file_path – optional metadata file path.

  • dos1_correction – if True, perform DOS1 correction.

  • add_bandset – if True, create a new bandset and add output bands to it; if False, add output bands to current bandset.

  • product – product name.

  • nodata_value – nodata value.

  • sensor – sensor name.

  • acquisition_date – acquisition date.

  • output_prefix – optional string for output name prefix.

  • n_processes – number of parallel processes.

  • available_ram – number of megabytes of RAM available to processes.

  • bandset_catalog – BandSetCatalog object.

  • progress_message – progress message.

Returns:

Object OutputManager() with

  • paths = output list