Struct RunningAverage 

pub struct RunningAverage<T: Averageable> { /* private fields */ }

Running Average (FB_RunningAverage)

Accumulates values and computes their arithmetic mean. Stores only the sum and count internally — no heap allocation.

Generic over any numeric type that implements Averageable (all standard primitives: f32, f64, i32, u64, etc.).

Example

use autocore_std::fb::RunningAverage;

let mut avg = RunningAverage::<f64>::new();

avg.append(10.0);
avg.append(20.0);
avg.append(30.0);

assert_eq!(avg.count(), 3);
assert!((avg.average() - 20.0).abs() < f64::EPSILON);

avg.reset();
assert_eq!(avg.count(), 0);
assert_eq!(avg.average(), 0.0);

Use Cases

• Smoothing noisy sensor readings
• Computing mean cycle times
• Averaging analog input samples over N scans

Implementations

impl<T: Averageable> RunningAverage<T>

pub fn new() -> Self

Creates a new running average with zero samples.

Example

use autocore_std::fb::RunningAverage;

let avg = RunningAverage::<f64>::new();
assert_eq!(avg.count(), 0);
assert_eq!(avg.average(), 0.0);

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

Appends a value to the running average.

Arguments

• value - The value to include in the average

Example

use autocore_std::fb::RunningAverage;

let mut avg = RunningAverage::<f64>::new();
avg.append(5.0);
avg.append(15.0);
assert_eq!(avg.count(), 2);
assert!((avg.average() - 10.0).abs() < f64::EPSILON);

pub fn reset(&mut self)

Resets the running average, clearing all accumulated data.

Example

use autocore_std::fb::RunningAverage;

let mut avg = RunningAverage::<f64>::new();
avg.append(42.0);
assert_eq!(avg.count(), 1);

avg.reset();
assert_eq!(avg.count(), 0);
assert_eq!(avg.average(), 0.0);

pub fn average(&self) -> T

Returns the arithmetic mean of all appended values.

Returns the default value for T (zero) when no values have been appended. For integer types, the result is truncated (integer division).

Example

use autocore_std::fb::RunningAverage;

let mut avg = RunningAverage::<f64>::new();
assert_eq!(avg.average(), 0.0); // No values yet

avg.append(10.0);
avg.append(20.0);
assert!((avg.average() - 15.0).abs() < f64::EPSILON);

pub fn count(&self) -> usize

Returns the number of values appended since creation or the last reset.

Example

use autocore_std::fb::RunningAverage;

let mut avg = RunningAverage::<f32>::new();
assert_eq!(avg.count(), 0);

avg.append(1.0);
avg.append(2.0);
assert_eq!(avg.count(), 2);

Trait Implementations

impl<T: Clone + Averageable> Clone for RunningAverage<T>

fn clone(&self) -> RunningAverage<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug + Averageable> Debug for RunningAverage<T>

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

Formats the value using the given formatter.

impl<T: Averageable> Default for RunningAverage<T>

fn default() -> Self

Returns the “default value” for a type.