Struct Sq8Rerank 

pub struct Sq8Rerank { /* private fields */ }

Object-safe RerankCodec wrapper around Sq8Codec.

train() calls Sq8Codec::calibrate to fit per-dimension min/max from a sample of vectors. Subsequent encode / distance_prepared calls use the calibrated codec.

Implementations

impl Sq8Rerank

pub fn new(dim: usize) -> Self

Create an untrained wrapper with a default-calibrated codec.

The default codec treats every dimension’s min as 0.0 and max as 1.0, which is suitable for normalized embeddings. For best accuracy call train() with representative samples before encoding.

pub fn from_codec(codec: Sq8Codec) -> Self

Wrap an already-trained Sq8Codec.

Trait Implementations

impl RerankCodec for Sq8Rerank

fn encode(&self, v: &[f32]) -> Result<Vec<u8>, RerankError>

Encode a full-precision vector to SQ8 bytes.

The serialized form is the raw UnifiedQuantizedVector buffer (as_bytes()), which embeds a 32-byte QuantHeader followed by dim packed INT8 codes.

fn prepare_query(&self, q: &[f32]) -> Result<PreparedQuery, RerankError>

Prepare the query for repeated distance calls.

SQ8 is asymmetric: the query is kept in full FP32 precision while candidates are INT8. The prepared form is therefore PreparedQuery::Raw.

fn distance_prepared( &self, prepared: &PreparedQuery, encoded: &[u8], ) -> Result<f32, RerankError>

Compute asymmetric L2 distance from a prepared FP32 query to an SQ8-encoded candidate.

fn train(&mut self, samples: &[&[f32]]) -> Result<(), RerankError>

Calibrate from a sample of vectors.

Replaces the current codec state. Requires at least one sample.

fn name(&self) -> CodecName

Identity tag for mismatch detection.

fn to_bytes(&self) -> Result<Vec<u8>, RerankError>

Serialize trained state to bytes. Each codec uses its own magic header (NDSQ / NDBIN / NDPQ / NDRBQ / NDBBQ). The bytes are codec-specific; rerank_codec_from_bytes is used for restore, paired with name().