Skip to content

Sensor Pft Transfer

Module: spectralbridge.sensor_pft_transfer.

Paired, conditional PFT structure under synthetic spectral reduction.

MicaSense export identity remains gated. This is not independent sensor validation.

API glossary ยท Workflow / scientific context

Signatures and documentation below are collected from the current source. Advanced objects are not newly declared stable by inclusion here.

Audience: advanced.

validate_sensor_coordinates

validate_sensor_coordinates(wavelengths, sensor)

No guessed ten-band relabeling; the supplied MicaSense cannot pass.

Audience: advanced.

paired_observations

paired_observations(products)

Intersect valid observations before medians; reject identity/label drift.

Audience: advanced.

joint_cluster_multiplicities

joint_cluster_multiplicities(table, replicates, seed)

GlobalID clusters coupled across sensors, contrasts and repeated years.

Stratify by label/site and complete year/history pattern to preserve cell counts. Singleton strata remain fixed and are explicitly reported.

Audience: advanced.

bootstrap_contrasts

bootstrap_contrasts(values, labels, blocks, multiplicities, integration_weights)

Stable centered sufficient moments for a fixed-count cluster bootstrap.

Audience: advanced.

project_neon_to_oli

project_neon_to_oli(values, wavelengths) -> tuple[np.ndarray, np.ndarray]

Diagnostically project common-support NEON curves to seven OLI channels.

Parameters:

Name Type Description Default
values array - like

Stored reflectance, shape (N, B).

required
wavelengths array - like

Increasing finite native coordinates (B,), nm.

required

Returns:

Type Description
tuple[ndarray, ndarray]

tuple[numpy.ndarray, numpy.ndarray]: Projected values (N, 7), in input units, and Gaussian response-mass fractions (7,). Order is coastal, blue, green, red, NIR, SWIR1, SWIR2. Packaged centers/FWHMs define the Gaussian approximation; these are not independent Landsat observations.

Raises:

Type Description
ValueError

Invalid grid/dimensions or no supported response mass.

Uses columns finite across all supplied observations and local quadrature only across adjacent intervals <=8 nm. No interpolation across atmospheric gaps. Caller must omit excluded regions before this diagnostic. Applied after medians, it need not equal a product convolved before medians.

Audience: advanced.

run_sensor_pft_transfer

run_sensor_pft_transfer(source, output, *, config=None, bootstraps=499, minimum=10)

Primary inferred-PFT and separate researcher-category paired OLI experiment.