Struct AcquisitionPlan 

pub struct AcquisitionPlan { /* private fields */ }

Sparse source-to-frame acquisition structure.

Predicted intensity is gain[f] * sum_s(weight[f,s] * power[s] * I_s). Source contributions are mutually incoherent; every multiplier acts on intensity rather than field amplitude and is not automatically normalized.

Implementations

impl AcquisitionPlan

pub fn all_sources(source_count: usize) -> Result<Self>

Creates one unit-gain frame per source in natural order.

pub fn sequential(order: Vec<usize>) -> Result<Self>

Creates one unit-gain frame per listed source.

The order may omit or repeat sources. Index range is checked when the complete Illumination is resolved.

pub fn from_sparse(frames: Vec<IlluminationFrame>) -> Result<Self>

Canonicalizes sparse frames by merging duplicates and removing zero weights.

pub fn from_dense(weights: Vec<Vec<f64>>) -> Result<Self>

Converts a dense (frames, sources) matrix to canonical sparse storage.

pub fn frame_count(&self) -> usize

Returns the number of acquired frames.

pub fn frames(&self) -> &[IlluminationFrame]

Borrows canonical sparse frames.

pub fn dense_weights(&self, source_count: usize) -> Result<Vec<Vec<f64>>>

Allocates dense (frames, sources) row-major weights.

Trait Implementations

impl Clone for AcquisitionPlan

fn clone(&self) -> AcquisitionPlan

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AcquisitionPlan

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AcquisitionPlan

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for AcquisitionPlan

fn eq(&self, other: &AcquisitionPlan) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for AcquisitionPlan

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for AcquisitionPlan