Struct Quantizer 

pub struct Quantizer { /* private fields */ }

Packs a batch of f32 readings into a compact byte form for a metered link.

A quantizer rounds each reading to a fixed precision - set by the scale, where 100.0 keeps two decimal places - turns it into an integer, and delta-encodes the batch with encode_deltas. This is lossy by exactly the rounding step, which is the right trade for a cheap sensor on an expensive link: a fridge temperature to the nearest hundredth of a degree costs a byte or two per sample instead of four. The same scale must be used to encode and decode.

Examples

use pamoja_codec::Quantizer;

// Quantize to 0.1 precision and pack a slowly-rising series.
let quantizer = Quantizer::new(10.0);
let readings = [20.0, 20.1, 20.2, 20.3];
let packed = quantizer.encode(&readings);
assert!(packed.len() < readings.len() * 4); // smaller than four bytes per reading

let restored = quantizer.decode(&packed).unwrap();
assert!((restored[2] - 20.2).abs() < 0.05);

Implementations

impl Quantizer

pub fn new(scale: f32) -> Self

Creates a quantizer with the given precision scale.

Arguments

• scale - the multiplier applied before rounding; 100.0 keeps two decimal places. Must be positive.

Returns

The quantizer.

pub fn encode(&self, readings: &[f32]) -> Vec<u8>

Quantizes and delta-encodes a batch of readings.

Arguments

• readings - the readings to pack, in order.

Returns

The compact encoding of the batch.

pub fn decode(&self, bytes: &[u8]) -> Result<Vec<f32>>

Decodes a batch back into readings, to within the quantizer’s precision.

Arguments

• bytes - the encoding produced by encode with the same scale.

Returns

The decoded readings, in order.

Errors

Returns Error::Codec if bytes is malformed.

Trait Implementations

impl Clone for Quantizer

fn clone(&self) -> Quantizer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Quantizer

impl Debug for Quantizer

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

Formats the value using the given formatter.