Struct QuantizationErrorTracker 

pub struct QuantizationErrorTracker {
    pub history: VecDeque<QuantizationError>,
    pub total_vectors: u64,
}

Tracks quantization error across a rolling window of vectors.

The tracker maintains the last HISTORY_CAPACITY (256) measurements and exposes rolling statistics that let callers detect when quantization error is accumulating to unacceptable levels.

Fields

history: VecDeque<QuantizationError>

Rolling window of recent error measurements (capped at 256).

total_vectors: u64

Total number of vectors recorded since creation (monotonically increasing).

Implementations

impl QuantizationErrorTracker

pub fn new() -> Self

Create a new, empty tracker.

pub fn compute_error( &self, original: &[f32], quantized: &[f32], ) -> Result<QuantizationError, QErrorError>

Compute QuantizationError between an original and a quantized vector.

Errors

• QErrorError::EmptyVector – if original is empty.
• QErrorError::LengthMismatch – if lengths differ.

pub fn record(&mut self, error: QuantizationError)

Record a QuantizationError measurement into the rolling history.

When the history reaches 256 entries the oldest entry is evicted.

pub fn rolling_mse(&self) -> f64

Average MSE over all entries in the rolling history.

Returns 0.0 when the history is empty.

pub fn rolling_mae(&self) -> f64

Average MAE over all entries in the rolling history.

Returns 0.0 when the history is empty.

pub fn p99_mse(&self) -> f64

99th-percentile MSE across the rolling history.

Uses the nearest-rank method: the index is ceil(0.99 * n) - 1 (0-based) on a sorted copy of the MSE values.

Returns 0.0 when the history is empty.

pub fn is_quality_acceptable(&self, max_mse: f64) -> bool

Returns true when the rolling MSE is within max_mse.

pub fn history_len(&self) -> usize

Returns the number of entries currently in the rolling history.

pub fn clear_history(&mut self)

Clear all history entries. total_vectors is not reset.

Trait Implementations

impl Clone for QuantizationErrorTracker

fn clone(&self) -> QuantizationErrorTracker

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for QuantizationErrorTracker

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

Formats the value using the given formatter.

impl Default for QuantizationErrorTracker

fn default() -> Self

Returns the “default value” for a type.