Struct SimulationConfiguration 

pub struct SimulationConfiguration {
    pub format_version: u32,
    pub true_experiment: ExperimentDescription,
    pub reconstruction_experiment: ExperimentDescription,
    pub image_shape: (usize, usize),
    pub reconstruction_shape: (usize, usize),
    pub compiled_models: CompiledModelPair,
    pub camera: Option<CameraModel>,
    pub illumination_acquisition_errors: Option<IlluminationAcquisitionErrors>,
    pub random_seed: u64,
}

Complete, versioned configuration for simulation and reconstruction.

Fields

format_version: u32

Must equal CONFIGURATION_FORMAT_VERSION.

true_experiment: ExperimentDescription

Physical description used to compile the true acquisition model.

reconstruction_experiment: ExperimentDescription

Physical description assumed by reconstruction.

image_shape: (usize, usize)

Shared low-resolution shape as (height, width).

reconstruction_shape: (usize, usize)

Shared high-resolution shape as (height, width).

compiled_models: CompiledModelPair

Stored true and reconstruction models compiled from the descriptions.

camera: Option<CameraModel>

Optional detector-count response and noise model.

illumination_acquisition_errors: Option<IlluminationAcquisitionErrors>

Optional non-geometric illumination errors injected during acquisition.

random_seed: u64

Deterministic seed for simulation randomness.

Implementations

impl SimulationConfiguration

pub fn new( true_experiment: ExperimentDescription, reconstruction_experiment: ExperimentDescription, image_shape: (usize, usize), reconstruction_shape: ReconstructionShape, ) -> Result<Self>

Compiles true and assumed descriptions on one explicit or automatically selected reconstruction grid and validates the complete configuration.

pub fn with_camera(self, camera: CameraModel) -> Result<Self>

Adds a camera model after validating it for the configured frame shape.

pub fn with_illumination_acquisition_errors( self, errors: IlluminationAcquisitionErrors, ) -> Result<Self>

Adds source gain variation, missing frames, or a source permutation and validates it.

pub fn with_random_seed(self, random_seed: u64) -> Self

Sets the deterministic random seed used for simulation.

pub fn reconstruction_model_for_counts(&self) -> Result<ImagePlaneModel>

Returns the assumed model with known linear camera response compiled in.

The serialized compiled_models.reconstruction_model remains the strict optical model. Use this helper when constructing a reconstruction problem from detector counts loaded through a saved configuration.

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

Checks format version; descriptions and compiled models; shape/frame agreement; camera constraints; and acquisition-error counts, indices, and permutations.

pub fn save(&self, path: impl AsRef<Path>) -> Result<()>

Validates and writes this versioned configuration as pretty-printed JSON.

pub fn load(path: impl AsRef<Path>) -> Result<Self>

Loads and fully validates a versioned JSON configuration.

Trait Implementations

impl Clone for SimulationConfiguration

fn clone(&self) -> SimulationConfiguration

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SimulationConfiguration

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SimulationConfiguration

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SimulationConfiguration

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

where __S: Serializer,

Serialize this value into the given Serde serializer.