Struct MinMaxNormF32 

pub struct MinMaxNormF32 { /* private fields */ }

Windowed min-max normalizer.

Scales values to [0, 1] using the windowed minimum and maximum over a sliding timestamp window: (sample - min) / (max - min).

When the range is zero (all values equal), returns 0.5.

Examples

use nexus_stats_core::normalization::MinMaxNormF32;

let mut mm = MinMaxNormF32::builder().window(100).build().unwrap();
let _ = mm.update(0, 10.0 as f32);
let _ = mm.update(1, 20.0 as f32);
let v = mm.update(2, 15.0 as f32).unwrap();
assert!(v.is_some());

Implementations

impl MinMaxNormF32

pub fn builder() -> MinMaxNormF32Builder

Creates a builder.

pub fn update( &mut self, timestamp: u64, sample: f32, ) -> Result<Option<f32>, DataError>

Feeds a sample at the given timestamp. Returns normalized value in [0, 1] once at least one sample has been observed.

Errors

Returns DataError::NotANumber if the sample is NaN, or DataError::Infinite if the sample is infinite.

pub fn normalize(&self, value: f32) -> Option<f32>

Normalizes an arbitrary value against current windowed min/max without updating state.

Returns None if not primed.

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

Current windowed minimum, or None if empty.

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

Current windowed maximum, or None if empty.

pub fn range(&self) -> Option<f32>

Current range (max - min), or None if empty.

pub fn count(&self) -> u64

Number of samples processed (minimum of both trackers).

pub fn is_primed(&self) -> bool

Whether at least one sample has been observed.

pub fn reset(&mut self)

Resets accumulated state. Window size preserved.

Trait Implementations

impl Clone for MinMaxNormF32

fn clone(&self) -> MinMaxNormF32

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MinMaxNormF32

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

Formats the value using the given formatter.