Struct StatisticsAccumulator 

pub struct StatisticsAccumulator { /* private fields */ }

Accumulator for a single iteration’s samples and for the cross-iteration weighted average.

Example

use ocas_eval::numeric::StatisticsAccumulator;

let mut acc = StatisticsAccumulator::new();
acc.add_sample(1.0, 1.5);
acc.add_sample(1.0, 1.8);
acc.add_sample(1.0, 2.1);
assert_eq!(acc.samples(), 3);

acc.finalize_iteration();
assert_eq!(acc.iterations(), 1);

Implementations

impl StatisticsAccumulator

pub fn new() -> Self

Create a fresh accumulator.

pub fn add_sample(&mut self, weight: f64, f: f64)

Add a sample with the given Vegas weight (1/pdf). The contribution to the integral estimate is weight · f(xs).

pub fn samples(&self) -> usize

Number of samples in the current (not-yet-finalised) iteration.

pub fn finalize_iteration(&mut self)

Finalise the current iteration: fold its mean and variance into the cross-iteration weighted average, then reset per-iteration accumulators.

pub fn integral(&self) -> f64

Current best estimate of the integral.

pub fn error(&self) -> f64

Standard error on Self::integral.

pub fn chi_square(&self) -> f64

χ² across iterations; values near iterations − 1 indicate consistent estimates.

pub fn iterations(&self) -> usize

Number of completed iterations.

Trait Implementations

impl Clone for StatisticsAccumulator

fn clone(&self) -> StatisticsAccumulator

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StatisticsAccumulator

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

Formats the value using the given formatter.

impl Default for StatisticsAccumulator

fn default() -> Self

Returns the “default value” for a type.