Struct StreamingStats 

pub struct StreamingStats { /* private fields */ }

Accumulateur de moyenne en ligne, O(1) mémoire.

Implémente la mise à jour incrémentale de Welford :

mean_n = mean_{n-1} + (x_n − mean_{n-1}) / n

Stable numériquement même pour des millions de points. Rejette les valeurs non-finies sans corrompre l’état interne.

Exemples

use embedded_stats_f32::{StreamingStats, StatsError};

let mut s = StreamingStats::new();
for x in [1.0_f32, 2.0, 3.0, 4.0, 5.0] { s.update(x).unwrap(); }

assert!((s.mean().unwrap() - 3.0).abs() < 1e-6);
assert_eq!(s.count(), 5);

// NaN rejeté, état interne préservé
assert_eq!(s.update(f32::NAN), Err(StatsError::NonFiniteValue));
assert_eq!(s.count(), 5);

Implementations

impl StreamingStats

pub const fn new() -> Self

Crée un accumulateur vide.

pub fn update(&mut self, x: f32) -> Result<(), StatsError>

Intègre une nouvelle observation.

Retourne StatsError::NonFiniteValue si x est NaN ou ±inf. En cas d’erreur, l’état interne est inchangé.

pub fn mean(&self) -> Result<f32, StatsError>

Retourne la moyenne courante.

Erreurs

• StatsError::EmptySlice : aucune observation intégrée
• StatsError::NonFiniteValue : état interne corrompu (théoriquement impossible via update, garde de sécurité défensive)

pub const fn count(&self) -> u32

Retourne le nombre d’observations intégrées.

pub fn reset(&mut self)

Remet l’accumulateur à zéro.

pub fn running_variance(&self) -> Result<f32, StatsError>

Variance de population (diviseur N) en streaming.

pub fn running_std_dev(&self) -> Result<f32, StatsError>

Écart type en streaming (= √variance).

Trait Implementations

impl Clone for StreamingStats

fn clone(&self) -> StreamingStats

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StreamingStats

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

Formats the value using the given formatter.

impl Default for StreamingStats

fn default() -> Self

Returns the “default value” for a type.

impl Copy for StreamingStats