curryer.correction.image_match

Attributes

logger

Classes

IntegratedImageMatchResult

Functions

validate_image_matching_output(→ None)

Validate image matching output conforms to expected format.

integrated_image_match(→ IntegratedImageMatchResult)

Perform complete image matching workflow with PSF modeling.

Module Contents

curryer.correction.image_match.logger
curryer.correction.image_match.validate_image_matching_output(output: xarray.Dataset) → None

Validate image matching output conforms to expected format.

Parameters:

output (xr.Dataset) – Dataset returned by image matching function.

Raises:

  • TypeError – If output is not an xarray Dataset.

  • ValueError – If required fields are missing or malformed.

Examples

>>> result = image_matching_func(...)
>>> validate_image_matching_output(result)
class curryer.correction.image_match.IntegratedImageMatchResult
lat_error_km: float
lon_error_km: float
ccv_final: float
final_index_row: int
final_index_col: int
final_grid_step_m: float
dynamic_psf: curryer.correction.grid_types.PSFGrid
projected_psf: curryer.correction.grid_types.ProjectedPSF
convolved_gcp: curryer.correction.grid_types.ImageGrid
curryer.correction.image_match.integrated_image_match(subimage: curryer.correction.grid_types.ImageGrid, gcp: curryer.correction.grid_types.ImageGrid, r_iss_midframe_m: numpy.ndarray, los_vectors_hs: numpy.ndarray, optical_psfs: collections.abc.Iterable[curryer.correction.grid_types.OpticalPSFEntry], geolocation_config: curryer.correction.config.PSFSamplingConfig | None = None, search_config: curryer.correction.config.SearchConfig | None = None) → IntegratedImageMatchResult

Perform complete image matching workflow with PSF modeling.

Replicates MATLAB IntegratedImageMatch: projects PSF, applies spacecraft motion blur, convolves with GCP, and performs correlation-based search.

Parameters:

  • subimage (ImageGrid) – Observed image data with geolocation.

  • gcp (ImageGrid) – Ground control point reference image.

  • r_iss_midframe_m (np.ndarray) – Spacecraft position at mid-frame, shape (3,), units: meters.

  • los_vectors_hs (np.ndarray) – Line-of-sight vectors in instrument frame, shape (n_pixels, 3).

  • optical_psfs (Iterable[OpticalPSFEntry]) – Optical PSF samples at different field angles.

  • geolocation_config (PSFSamplingConfig, optional) – PSF geolocation parameters. Defaults to standard config.

  • search_config (SearchConfig, optional) – Image search parameters. Defaults to standard config.

Returns:

Geolocation errors, correlation value, and intermediate products.

Return type:

IntegratedImageMatchResult