Struct TqCodec 

pub struct TqCodec { /* private fields */ }

Complete TQ codec for one field dimension. Cheap to build (sub-millisecond) and immutable; share via Arc per open segment.

Implementations

impl TqCodec

pub fn new(dim: usize) -> Self

pub fn dim(&self) -> usize

pub fn padded_dim(&self) -> usize

pub fn code_size(&self) -> usize

Logical bytes per vector (two 4-bit coordinates per byte).

pub fn fingerprint(&self) -> u64

Deterministic compatibility fingerprint carried as quantizer_version.

pub fn estimated_memory_bytes(&self) -> usize

Heap footprint: two rotations (signs f32 + perm u32 per padded coord) plus the fixed-size codebook.

pub fn encode_into( &self, vector: &[f32], nibbles: &mut [u8], scratch: &mut TqEncodeScratch, ) -> f32

Encode one vector into nibbles (one 0..=15 value per padded coordinate) and return gamma. The vector is normalized internally; zero vectors encode as all-zero nibbles with gamma = 0.

pub fn encode_residual_into( &self, vector: &[f32], nibbles: &mut [u8], scratch: &mut TqEncodeScratch, ) -> (f32, f32)

Encode one (possibly non-unit) vector as scale · unit_direction and return (scale = ‖vector‖₂, gamma). IVF leaves store centroid residuals, whose norms carry ranking information; scale restores it at score time. Zero vectors encode as all-zero nibbles with scale = gamma = 0.

Trait Implementations

impl Clone for TqCodec

fn clone(&self) -> TqCodec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TqCodec

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

Formats the value using the given formatter.