Struct ReconstructionState 

pub struct ReconstructionState { /* private fields */ }

Mutable numerical state shared by algorithms during reconstruction.

The object spectrum is centered and shaped on the high-resolution grid. The pupil and scratch arrays use the low-resolution grid. Accessors borrow storage without copying; mutating the spectrum invalidates the cached object-domain field.

Implementations

impl ReconstructionState

pub fn object_spectrum(&self) -> ArrayView2<'_, Complex64>

Borrows the centered high-resolution complex object spectrum.

pub fn object_spectrum_mut(&mut self) -> ArrayViewMut2<'_, Complex64>

Mutably borrows the object spectrum and invalidates the object-domain cache.

pub fn pupil(&self) -> &Pupil

Borrows the current low-resolution complex pupil and binary support.

pub fn illumination_corrections(&self) -> Option<&[(f64, f64)]>

Borrows optional per-source (row, column) corrections in Fourier-grid pixels.

pub fn frame_gains(&self) -> Option<&[f64]>

Borrows optional positive gains in acquisition-frame order.

pub fn background(&self) -> Option<&[f64]>

Borrows optional additive backgrounds in acquisition-frame order.

pub fn physical_illumination_calibration( &self, ) -> Option<&IlluminationCalibrationState>

Borrows checkpointable physical planar-array calibration state, when active.

pub fn calibrated_model(&self) -> Option<&ImagePlaneModel>

Borrows the illumination-refreshed model used by joint reconstruction, when active.

pub fn illumination_gradient(&self) -> &[(f64, f64)]

Most recently accumulated per-source illumination gradient.

pub fn effective_source_offset( &self, model: &ImagePlaneModel, source: usize, ) -> Result<FourierOffset>

Adds the current calibration correction to a model source offset and validates bounds.

pub fn initialize<M: MeasurementRead>( problem: &ReconstructionProblem<M>, ) -> Result<Self>

Initializes a CPU-backed object estimate from weighted measured amplitudes.

pub fn initialize_with_backend<M: MeasurementRead>( problem: &ReconstructionProblem<M>, backend: Arc<dyn Backend>, ) -> Result<Self>

Initializes an object estimate, pupil, calibration variables, and scratch storage using backend after validating problem.

pub fn from_object<M: MeasurementRead>( problem: &ReconstructionProblem<M>, object: Array2<Complex64>, ) -> Result<Self>

Initializes state from an owned standard-layout high-resolution complex object.

pub fn from_checkpoint<M: MeasurementRead>( problem: &ReconstructionProblem<M>, checkpoint: &ReconstructionCheckpoint, ) -> Result<Self>

Restores CPU-backed state from a checkpoint validated against problem.

pub fn from_checkpoint_with_backend<M: MeasurementRead>( problem: &ReconstructionProblem<M>, checkpoint: &ReconstructionCheckpoint, backend: Arc<dyn Backend>, ) -> Result<Self>

Restores state from a compatible checkpoint using backend.

Trait Implementations

impl Clone for ReconstructionState

fn clone(&self) -> ReconstructionState

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ReconstructionState

fn fmt(&self, formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.