Struct BlockedCodeStorage 

pub struct BlockedCodeStorage { /* private fields */ }

Owns the encoded-codes storage for a TurboQuant collection.

Deep module: the only surface callers need is append, plus a few read accessors used by the scoring kernels. The PERM0 interleave, 64-byte alignment, and block-fill bookkeeping all live behind this struct.

Implementations

impl BlockedCodeStorage

pub fn new(n_byte_groups: usize) -> BlockedCodeStorage

pub fn n_byte_groups(&self) -> usize

pub fn n_blocks(&self) -> usize

pub fn n_vectors(&self) -> usize

pub fn block_lanes_filled(&self, block_idx: usize) -> usize

pub fn block_codes(&self, block_idx: usize) -> &[u8]

Returns the raw PERM0-packed codes for block_idx. Guaranteed to be aligned to SIMD_ALIGN (64 bytes); SIMD kernels can load aligned register-width slices directly.

pub fn lane_scale(&self, block_idx: usize, lane: usize) -> f32

pub fn append(&mut self, packed: &[u8], scale: f32) -> BlockHandle

Append a vector’s per-vector packed bytes (lo | hi << 4 per byte group, in dim-major order) to the open partial block, opening a new block if the trailing block is full.

pub fn decode_lane(&self, block_idx: usize, lane: usize) -> Vec<u8>

Decode the per-vector packed bytes that were written at (block_idx, lane). The returned bytes match the original packed argument from Self::append exactly — PERM0 is fully internal to the storage layer.

Trait Implementations

impl Debug for BlockedCodeStorage

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

Formats the value using the given formatter.