Struct MonteCarlo 

pub struct MonteCarlo { /* private fields */ }

A rocket’s nominal flight and the dispersion of its inputs, ready to fly samples.

Implementations

impl MonteCarlo

pub fn new( nominal: FlightInputs, dispersion: Dispersion, ) -> Result<Self, AnalysisError>

A run of nominal dispersed by dispersion.

Errors

• As Dispersion::validate.
• AnalysisError::NoConfiguration if the design has no configuration of that id.
• AnalysisError::Design if the design can’t be laid out.
• AnalysisError::Unsupported for a dispersed impulse or burn time on a motor whose propellant model dispersed_motor doesn’t know.

pub fn nominal(&self) -> &FlightInputs

The nominal flight.

pub fn dispersion(&self) -> &Dispersion

The dispersion.

pub fn draw(&self, seed: u64, index: u64) -> Draw

What sample index of a run seeded with seed draws.

pub fn inputs(&self, draw: &Draw) -> Result<FlightInputs, AnalysisError>

The flight inputs draw gives: the nominal ones, with each input whose entry isn’t its nominal value (a factor of 1, an offset of 0) changed as the module’s docs say. An entry at its nominal value leaves its input as it is, so a draw with no dispersion flies the nominal flight bit for bit; any other entry is applied, whatever the dispersion, so a draw read back or written by hand flies as it says.

Errors

• AnalysisError::Count for a list whose length isn’t the design’s number of stages, the configuration’s number of motors or the number of recovery devices.
• AnalysisError::Domain for an entry that isn’t finite, and from dispersed_motor for an impulse or burn-time factor at or below zero.
• AnalysisError::Unsupported and AnalysisError::Motor as dispersed_motor.

pub fn fly(&self, draw: &Draw) -> Result<FlightSummary, AnalysisError>

Flies draw (MonteCarlo::inputs) to the ground and gives its metrics, on what the run’s flights share (the module’s Speed): as FlightInputs::fly on the same inputs, bit for bit, but without laying out the parts or building a supersonic table again. For flights drawn by hand, as a sensitivity analysis’s (crate::sensitivity).

Errors

As MonteCarlo::inputs, and AnalysisError::Sim around the errors of FlightInputs::fly.

pub fn sample(&self, seed: u64, index: u64) -> Sample

Draws and flies sample index of a run seeded with seed. A draw that makes an input impossible, or a flight that stops with an error, is a failed sample, not an error.

pub fn run(&self, seed: u64, count: u64) -> Run

Flies samples 0..count of a run seeded with seed, one after another.

pub fn run_parallel(&self, seed: u64, count: u64) -> Run

As MonteCarlo::run, with the samples spread over the threads of the current rayon pool: the global one, or one a caller’s rayon::ThreadPool::install sets up to choose how many. The run is the same, bit for bit, whatever the number of threads.

Trait Implementations

impl Clone for MonteCarlo

fn clone(&self) -> MonteCarlo

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MonteCarlo

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

Formats the value using the given formatter.