Struct BinaryQuantizedVector 

pub struct BinaryQuantizedVector {
    pub data: Vec<u8>,
    /* private fields */
}

A binary quantized vector using 1-bit per dimension.

Each f32 value is converted to 1 bit: >= 0.0 becomes 1, < 0.0 becomes 0. This provides 32x memory reduction compared to f32 storage.

Memory Usage

Dimension	f32	Binary
768	3072 bytes	96 bytes
1536	6144 bytes	192 bytes

Use with Rescoring

For best accuracy, use binary search for candidate selection, then rescore top candidates with full-precision vectors.

Fields

data: Vec<u8>

Binary data (1 bit per dimension, packed into bytes).

Implementations

impl BinaryQuantizedVector

pub fn from_f32(vector: &[f32]) -> Self

Creates a new binary quantized vector from f32 data.

Values >= 0.0 become 1, values < 0.0 become 0.

Arguments

• vector - The original f32 vector to quantize

Panics

Panics if the vector is empty.

pub fn dimension(&self) -> usize

Returns the dimension of the original vector.

pub fn memory_size(&self) -> usize

Returns the memory size in bytes.

pub fn get_bits(&self) -> Vec<bool>

Returns the individual bits as a boolean vector.

Useful for debugging and testing.

pub fn hamming_distance(&self, other: &Self) -> u32

Computes the Hamming distance to another binary vector.

Hamming distance counts the number of bits that differ. Uses POPCNT for fast bit counting.

Panics

Panics if the vectors have different dimensions.

pub fn hamming_similarity(&self, other: &Self) -> f32

Computes normalized Hamming similarity (0.0 to 1.0).

Returns 1.0 for identical vectors, 0.0 for completely different.

pub fn to_bytes(&self) -> Vec<u8>

Serializes the binary quantized vector to bytes.

pub fn from_bytes(bytes: &[u8]) -> Result<Self>

Deserializes a binary quantized vector from bytes.

Errors

Returns an error if the bytes are invalid.

Trait Implementations

impl Clone for BinaryQuantizedVector

fn clone(&self) -> BinaryQuantizedVector

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BinaryQuantizedVector

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

Formats the value using the given formatter.