Struct BinaryQuantizer 

pub struct BinaryQuantizer { /* private fields */ }

Binary quantizer for extreme memory compression (32x reduction)

Converts float32 vectors to 1-bit by thresholding each dimension. Uses efficient bit-packing and Hamming distance for similarity.

Implementations

impl BinaryQuantizer

pub fn new(config: BinaryQuantizationConfig) -> Self

Create a new binary quantizer

pub fn fit(&mut self, vectors: &[Vec<f32>]) -> Result<()>

Fit quantizer to training data

Computes per-dimension thresholds (mean or zero).

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

Quantize a float32 vector to binary (packed as u8 array)

Each bit represents whether the value is above the threshold. Bits are packed into u8 bytes (8 bits per byte).

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

Dequantize a binary vector back to float32 (approximate)

Reconstructs as threshold ± 1.0 based on bit values.

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

Quantize multiple vectors

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

Dequantize multiple vectors

pub fn hamming_distance(&self, a: &[u8], b: &[u8]) -> u32

Compute Hamming distance between binary vectors

Hamming distance = number of differing bits (very fast with XOR + popcount).

pub fn hamming_similarity(&self, a: &[u8], b: &[u8]) -> f32

Compute normalized Hamming similarity (0.0 to 1.0)

Similarity = 1 - (hamming_distance / num_bits)

pub fn compression_ratio(&self) -> f32

Get compression ratio

pub fn memory_savings(&self) -> f32

Get memory savings percentage

pub fn is_fitted(&self) -> bool

Check if quantizer is fitted

pub fn dimensions(&self) -> usize

Get number of dimensions

Trait Implementations

impl Clone for BinaryQuantizer

fn clone(&self) -> BinaryQuantizer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BinaryQuantizer

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for BinaryQuantizer

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for BinaryQuantizer

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.