Struct BrightfieldCircleInitializer 

pub struct BrightfieldCircleInitializer {
    pub parameters: PlanarArrayCalibrationParameters,
    pub options: BrightfieldCircleOptions,
}

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

The detector uses circular pupil edges in centered intensity spectra only to obtain a physical warm start. It then fits those observed centers to the canonical PlanarLedArray mapping. It does not reconstruct an object and does not produce independent source shifts. Measurement-loss refinement remains the responsibility of IlluminationCalibration.

Assumptions

Selected frames must be single-source, strictly bright-field exposures of a thin coherent specimen with enough reference interference and texture to expose the circular pupil edge. The compiled pupil support must be circular and shift invariant. The initializer uses two deterministic streaming measurement passes and preserves pupil values, backgrounds, source powers, frame gains, sampling, and acquisition topology in its returned model.

Example

use fpm_rs::{
    Result,
    experiment::{Illumination, Optics},
    illumination_calibration::{
        CalibrationParameterSpec, PlanarArrayCalibrationParameters,
    },
    illumination_initialization::BrightfieldCircleInitializer,
    measurements::MeasurementStack,
    model::ImagePlaneModel,
};

let lateral = CalibrationParameterSpec::new(-1e-3, 1e-3, 0.2e-3)
    .finite_difference_step(1e-6);
let parameters = PlanarArrayCalibrationParameters::builder()
    .translation_specs([Some(lateral.clone()), Some(lateral), None])
    .build()?;
let initialized = BrightfieldCircleInitializer::new(parameters)
    .initialize(measurements, optics, nominal, model)?;
let warm_model = initialized.initialized_model;

References

• J. Sun, Q. Chen, Y. Zhang, and C. Zuo, “Efficient positional misalignment correction method for Fourier ptychographic microscopy,” Biomedical Optics Express 7(4), 1336–1350 (2016). Sun et al. search independent apertures during reconstruction and subsequently regress a planar misalignment model; this initializer instead fits detected circle centers directly to the crate’s bounded physical geometry.
• R. Eckert, Z. F. Phillips, and L. Waller, “Efficient illumination angle self-calibration in Fourier ptychography,” Applied Optics 57(19), 5434–5442 (2018). This implementation adopts only the bright-field circular-edge initialization concept, not their iterative spectral-correlation stage or three-dimensional variants.

Fields

parameters: PlanarArrayCalibrationParameters

Global physical parameters selected for fitting.

options: BrightfieldCircleOptions

Detector, rank, and fit controls.

Implementations

impl BrightfieldCircleInitializer

pub fn new(parameters: PlanarArrayCalibrationParameters) -> Self

Creates an initializer for explicitly selected global physical parameters.

pub fn options(self, options: BrightfieldCircleOptions) -> Self

Replaces circle-detection and physical-fit options.

pub fn validate_for(&self, illumination: &Illumination) -> Result<()>

Validates this initializer for the nominal planar-array illumination.

pub fn initialize<M: MeasurementRead>( &self, measurements: &M, optics: &Optics, nominal_illumination: &Illumination, model: &ImagePlaneModel, ) -> Result<PlanarArrayInitializationResult>

Detects bright-field circles and fits a physical warm start using the CPU backend.

pub fn initialize_with_backend<M: MeasurementRead>( &self, measurements: &M, optics: &Optics, nominal_illumination: &Illumination, model: &ImagePlaneModel, backend: Arc<dyn Backend>, ) -> Result<PlanarArrayInitializationResult>

Detects and fits using an explicit FFT backend.

pub fn initialize_with_callback<M: MeasurementRead>( &self, measurements: &M, optics: &Optics, nominal_illumination: &Illumination, model: &ImagePlaneModel, backend: Arc<dyn Backend>, callback: &mut dyn PlanarArrayInitializationCallback, ) -> Result<PlanarArrayInitializationResult>

Detects and fits with an explicit backend and initializer-specific callback.

Trait Implementations

impl Clone for BrightfieldCircleInitializer

fn clone(&self) -> BrightfieldCircleInitializer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BrightfieldCircleInitializer

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

Formats the value using the given formatter.