Struct McConvergence 

pub struct McConvergence {
    pub level: ConfidenceLevel,
    pub target_half_width: f64,
    pub min_samples: u64,
    pub max_samples: u64,
    pub batch_size: u64,
}

How precise the hit probability has to get, and how much sampling may be spent getting there.

Default reproduces the legacy fixed-count run’s sample size as the floor (min_samples: 1_000, which is MonteCarloParams::default’s num_simulations) and then keeps going, in batches, until the interval is tight enough or the ceiling is hit.

Fields

level: ConfidenceLevel

Confidence level of the reported interval.

target_half_width: f64

Stop once the confidence sequence’s half-width is at or below this, in probability units. 0.02 means “the hit probability is known to about +-2 percentage points”.

min_samples: u64

Never stop before this many trials, even if the interval is already tight. Guards against an early run of all-hits or all-misses producing a narrow interval off a handful of trials.

max_samples: u64

Never run more than this many trials, even if the interval is still wide. This is what bounds the wall time of an unreachable target_half_width.

batch_size: u64

How many trials to run between convergence checks. Larger batches check less often (a bounds() call is two 200-step bisections); smaller batches can stop sooner.

Implementations

impl McConvergence

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

Rejects a configuration that cannot produce a meaningful run, naming the offending field.

Checked once up front rather than defended against inside the loop: a zero batch_size would spin forever making no progress, and a non-positive or NaN target_half_width can never be met, so both would surface as a hang or a silent max-samples cap instead of an error the caller can read. NaN is caught by the is_finite test – NaN <= 0.0 is false, so a bare comparison would let it through.

Trait Implementations

impl Clone for McConvergence

fn clone(&self) -> McConvergence

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for McConvergence

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

Formats the value using the given formatter.

impl Default for McConvergence

fn default() -> Self

Returns the “default value” for a type.