Module illumination_initialization 

Bright-field circle initialization for bounded physical planar arrays. Bright-field circle initialization for physical planar LED arrays.

This module estimates bright-field illumination wave vectors directly from measured intensity spectra, then fits those observations to the canonical PlanarLedArray geometry. It is an optional warm start for reconstruction and IlluminationCalibration, not a reconstruction algorithm or an independent per-source correction path.

Structs

BrightfieldCircleInitializer

Bright-field detector and bounded physical planar-array fitter.

BrightfieldCircleObservation

One considered acquisition frame and its circle-localization diagnostics.

BrightfieldCircleOptions

Numerical and validation controls for bright-field circle initialization.

InitializationBundle

Eagerly verified initialization bundle and its authoritative physical result.

InitializationBundleArtifact

Manifest-verified file inside a planar-array initialization bundle.

InitializationBundleVerificationResult

Aggregate result of re-verifying an initialization bundle.

PlanarArrayInitializationDiagnostics

Structural and numerical summary of circle detection and physical fitting.

PlanarArrayInitializationFitRecord

One accepted or rejected bounded physical-fit step.

PlanarArrayInitializationProgress

Immutable progress record for initializer-specific callbacks.

PlanarArrayInitializationResult

Complete serializable output of bright-field planar-array initialization.

PlanarArrayInitializationRuntime

Runtime metadata for one completed initialization.

Enums

PlanarArrayInitializationAction

Action returned by a planar-array initialization callback.

PlanarArrayInitializationStage

Progress stage reported by a bright-field initializer.

Constants

INITIALIZATION_BUNDLE_FORMAT_VERSION

Current verified directory-bundle format for initialization results.

INITIALIZATION_FORMAT_VERSION

Current JSON serialization format for planar-array initialization results.

Traits

PlanarArrayInitializationCallback

Callback interface dedicated to pre-reconstruction planar-array initialization.

Functions

read_initialization_bundle

Opens and verifies a planar-array initialization bundle.