Struct BirkhoffAverage 

pub struct BirkhoffAverage {
    pub sum: f64,
    pub count: usize,
    pub history: Vec<f64>,
}

Running Birkhoff time-average of an observable along a trajectory.

Tracks how the time average converges as more of the trajectory is consumed. For an ergodic system, the running average converges to the space average under the invariant measure.

Fields

sum: f64

The accumulated sum of f(x_t) observed so far.

count: usize

Number of samples consumed.

history: Vec<f64>

History of running averages (one entry per update call).

Implementations

impl BirkhoffAverage

pub fn new() -> Self

Create a new, empty Birkhoff accumulator.

pub fn update(&mut self, fx: f64)

Consume a single value fx = f(x_t) and append to history.

pub fn current(&self) -> f64

Return the current time average (returns 0 if no samples consumed).

pub fn consume_trajectory<F>(&mut self, trajectory: &[f64], f: &F)

where F: Fn(f64) -> f64,

Ingest an entire trajectory slice, applying observable f.

Trait Implementations

impl Clone for BirkhoffAverage

fn clone(&self) -> BirkhoffAverage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BirkhoffAverage

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

Formats the value using the given formatter.

impl Default for BirkhoffAverage

fn default() -> Self

Returns the “default value” for a type.