Struct RollingWindow 

pub struct RollingWindow { /* private fields */ }

Exact sliding-window mean and variance over the last capacity samples.

Uses a circular buffer (VecDeque) plus Welford incremental updates on the window boundary (remove oldest, add newest) so each push is O(1) in both time and space.

Implementations

impl RollingWindow

pub fn new(capacity: usize) -> Self

Creates a rolling window with the given capacity (must be ≥ 1).

Panics

Panics when capacity is zero.

pub fn push(&mut self, value: f64)

Pushes a new sample into the window, evicting the oldest if full.

pub fn len(&self) -> usize

Returns the current number of samples in the window (≤ capacity).

pub fn is_empty(&self) -> bool

Returns true if the window contains no samples.

pub fn is_full(&self) -> bool

Returns true when the window has been filled to capacity.

pub fn capacity(&self) -> usize

Returns the window capacity.

pub fn mean(&self) -> f64

Returns the mean of the current window, or 0.0 if empty.

pub fn variance(&self) -> f64

Returns the population variance of the current window.

Uses the computational formula: σ² = E[X²] − (E[X])².

pub fn stddev(&self) -> f64

Returns the population standard deviation of the current window.

pub fn min(&self) -> f64

Returns the minimum value in the current window, or f64::INFINITY if empty.

pub fn max(&self) -> f64

Returns the maximum value in the current window, or f64::NEG_INFINITY if empty.

pub fn samples(&self) -> Vec<f64>

Returns a snapshot of all current window samples, oldest first.

Trait Implementations

impl Clone for RollingWindow

fn clone(&self) -> RollingWindow

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RollingWindow

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

Formats the value using the given formatter.