Struct StatisticsWindow 

pub struct StatisticsWindow<T: Copy + Into<f64>> { /* private fields */ }

A simple sliding-window buffer that retains the most-recent capacity values and exposes statistical helpers.

Unlike LockFreeRingBuffer this type is single-threaded and designed for convenience, not throughput.

Type bound

T: Copy + Into<f64> so that integer and floating-point scalars can all be treated uniformly.

Example

use trustformers_debug::ring_buffer::StatisticsWindow;
let mut w = StatisticsWindow::new(4);
w.push(1u32);
w.push(2u32);
w.push(3u32);
assert_eq!(w.mean(), Some(2.0));

Implementations

impl<T: Copy + Into<f64>> StatisticsWindow<T>

pub fn new(capacity: usize) -> Self

Create a new window that retains at most capacity values.

Panics if capacity == 0.

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

Push a value; if the window is full the oldest value is evicted.

pub fn len(&self) -> usize

Number of values currently stored.

pub fn is_empty(&self) -> bool

Returns true when no values are stored.

pub fn iter_ordered(&self) -> impl Iterator<Item = T> + '_

Iterate over the window contents in insertion order (oldest first).

pub fn mean(&self) -> Option<f64>

Mean of the current window contents.

pub fn std_dev(&self) -> Option<f64>

Population standard deviation of the current window.

Returns None when fewer than 2 values are stored.

pub fn min(&self) -> Option<T>

Minimum value in the current window.

pub fn max(&self) -> Option<T>

Maximum value in the current window.

pub fn percentile(&self, p: f64) -> Option<f64>

Approximate the p-th percentile (0.0–100.0) via a sorted copy.

Uses nearest-rank method.

pub fn windowed_mean(&self, window: usize) -> Option<f64>

Mean of the last window values (or all values if fewer available).