Struct Optics 

pub struct Optics {
    pub wavelength_vacuum_m: f64,
    pub objective_na: f64,
    pub magnification: f64,
    pub camera_pixel_size: f64,
    pub illumination_refractive_index: f64,
    pub objective_medium_refractive_index: f64,
    pub defocus_distance: Option<f64>,
    pub pupil_aberration: Option<PupilAberration>,
}

Physical microscope parameters in SI units.

The sample-plane detector pitch must satisfy the coherent-field sampling invariant

camera_pixel_size / magnification < wavelength_vacuum_m / (2 * objective_na).

Equality is rejected because the circular pupil cutoff would lie on the one-sided discrete Nyquist boundary.

References

• G. Zheng, R. Horstmeyer, and C. Yang, “Wide-field, high-resolution Fourier ptychographic microscopy,” Nature Photonics 7, 739–745 (2013).

Example

use fpm_rs::experiment::Optics;

let optics = Optics {
    wavelength_vacuum_m: 532e-9,
    objective_na: 0.1,
    magnification: 4.0,
    camera_pixel_size: 6.5e-6,
    illumination_refractive_index: 1.0,
    objective_medium_refractive_index: 1.0,
    defocus_distance: None,
    pupil_aberration: None,
};
optics.validate()?;
assert_eq!(optics.object_pixel_size(), 6.5e-6 / 4.0);

Fields

wavelength_vacuum_m: f64

Illumination wavelength in vacuum, in metres.

objective_na: f64

Objective numerical aperture; must not exceed Self::objective_medium_refractive_index.

magnification: f64

Lateral image magnification, as a positive dimensionless ratio.

camera_pixel_size: f64

Physical detector-pixel pitch in metres.

After division by Self::magnification, this must be strictly less than wavelength_vacuum_m / (2 * objective_na).

illumination_refractive_index: f64

Refractive index between illumination sources and the sample.

objective_medium_refractive_index: f64

Refractive index in the objective-side medium.

defocus_distance: Option<f64>

Axial sample displacement from the focal plane in metres.

pupil_aberration: Option<PupilAberration>

Optional sampled-pupil aberration model.

Coefficients are interpreted by crate::model::Pupil::circular as crate-specific radial-polynomial weights in radians, not as normalized Zernike coefficients.

Implementations

impl Optics

pub fn validate(&self) -> Result<()>

Validates positive finite physical parameters, coherent-field sampling, objective-medium compatibility, finite optional defocus, and the optional PupilAberration.

Coherent-field sampling requires camera_pixel_size / magnification < wavelength_vacuum_m / (2 * objective_na). Equality is invalid because it places the pupil cutoff on the discrete Nyquist boundary.

pub fn object_pixel_size(&self) -> f64

Returns the sample-plane pixel pitch camera_pixel_size / magnification, in metres.

pub fn illumination_wavenumber(&self) -> f64

Returns 2π n_illumination / wavelength_vacuum, in radians per metre.

pub fn objective_medium_wavenumber(&self) -> f64

Returns the objective-medium angular wavenumber in radians per metre.

Trait Implementations

impl Clone for Optics

fn clone(&self) -> Optics

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Optics

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Optics

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Optics

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.