Struct CompressedVector 

pub struct CompressedVector { /* private fields */ }

Immutable per-vector compressed payload. Mirrors Python CompressedVector.

Invariants

• indices.len() == dimension as usize
• bit_width ∈ {2, 4, 8}
• If residual.is_some(), residual.len() == dimension as usize * 2

Implementations

impl CompressedVector

pub fn new( indices: Box<[u8]>, residual: Option<Box<[u8]>>, config_hash: ConfigHash, dimension: u32, bit_width: u8, ) -> Result<Self, CodecError>

Validated constructor. Mirrors Python CompressedVector.__post_init__.

Errors

• CodecError::UnsupportedBitWidth if bit_width ∉ {2, 4, 8}
• CodecError::DimensionMismatch if indices.len() != dimension
• CodecError::LengthMismatch if residual.len() != dimension * 2

pub fn indices(&self) -> &[u8]

Raw index bytes — one byte per dimension (upper bits zero for bit_width < 8).

pub fn residual(&self) -> Option<&[u8]>

Optional f16 LE residual bytes — 2 * dimension bytes when present.

pub const fn config_hash(&self) -> &ConfigHash

The config_hash of the CodecConfig used to compress this vector.

pub const fn dimension(&self) -> u32

Number of dimensions (= indices.len()).

pub const fn bit_width(&self) -> u8

Bit width used during compression.

pub fn has_residual(&self) -> bool

true when a residual buffer is present.

pub fn size_bytes(&self) -> usize

Python-parity size estimate: ceil(dim * bit_width / 8) + residual.len().

This is the packed on-disk footprint, not the in-memory footprint (indices are stored unpacked, 1 byte/dim, until Phase 16).

Trait Implementations

impl Clone for CompressedVector

fn clone(&self) -> CompressedVector

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CompressedVector

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

Formats the value using the given formatter.