Struct Sq8Codec 

pub struct Sq8Codec {
    pub dim: usize,
    /* private fields */
}

SQ8 calibration parameters: per-dimension min/max.

Fields

dim: usize

Implementations

impl Sq8Codec

pub fn calibrate(vectors: &[&[f32]], dim: usize) -> Self

Calibrate min/max from a set of training vectors.

Scans all vectors to find per-dimension min/max bounds. At least 1000 vectors recommended for stable calibration; for fewer vectors the bounds may be tight, causing clipping on future inserts outside the calibration range.

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

Quantize a single FP32 vector to INT8.

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

Batch quantize: quantize all vectors into a contiguous byte array.

Returns dim * N bytes laid out as [v0_d0, v0_d1, ..., v1_d0, ...].

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

Dequantize INT8 back to FP32 (lossy reconstruction).

pub fn asymmetric_l2(&self, query: &[f32], candidate: &[u8]) -> f32

Asymmetric L2 squared distance: query (FP32) vs candidate (INT8).

This is the hot-path function used during HNSW traversal. The query stays in full precision; only the candidate is quantized.

pub fn asymmetric_cosine(&self, query: &[f32], candidate: &[u8]) -> f32

Asymmetric cosine distance: query (FP32) vs candidate (INT8).

pub fn asymmetric_ip(&self, query: &[f32], candidate: &[u8]) -> f32

Asymmetric negative inner product: query (FP32) vs candidate (INT8).

pub fn dim(&self) -> usize

Dimension count.

Trait Implementations

impl Clone for Sq8Codec

fn clone(&self) -> Sq8Codec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'de> Deserialize<'de> for Sq8Codec

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Sq8Codec

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

where __S: Serializer,

Serialize this value into the given Serde serializer.