Struct Codec 

pub struct Codec;

Zero-sized stateless codec service. Mirrors Python tinyquant_cpu.codec.Codec.

Implementations

impl Codec

pub const fn new() -> Self

Create a new Codec instance (zero allocation).

pub fn compress( &self, vector: &[f32], config: &CodecConfig, codebook: &Codebook, ) -> Result<CompressedVector, CodecError>

Compress a single vector. vector.len() must equal config.dimension().

Pipeline: rotate → quantize → (optional) residual.

Errors

• CodecError::DimensionMismatch if vector.len() != config.dimension()
• CodecError::CodebookIncompatible if codebook.bit_width() != config.bit_width()

pub fn decompress( &self, compressed: &CompressedVector, config: &CodecConfig, codebook: &Codebook, ) -> Result<Vec<f32>, CodecError>

Allocating decompress — returns a new Vec<f32>.

Errors

Propagates errors from Self::decompress_into.

pub fn decompress_into( &self, compressed: &CompressedVector, config: &CodecConfig, codebook: &Codebook, output: &mut [f32], ) -> Result<(), CodecError>

In-place decompress into caller-supplied buffer.

Pipeline: dequantize → (optional) apply residual → inverse rotate.

Errors

• CodecError::ConfigMismatch if compressed.config_hash() != config.config_hash()
• CodecError::CodebookIncompatible on bit-width mismatch
• CodecError::DimensionMismatch if output.len() != config.dimension()

pub fn compress_batch( &self, vectors: &[f32], rows: usize, cols: usize, config: &CodecConfig, codebook: &Codebook, ) -> Result<Vec<CompressedVector>, CodecError>

Row-major batch compress using the serial strategy.

Errors

• CodecError::DimensionMismatch if cols != config.dimension()
• CodecError::LengthMismatch if vectors.len() != rows * cols

pub fn compress_batch_with( &self, vectors: &[f32], rows: usize, cols: usize, config: &CodecConfig, codebook: &Codebook, parallelism: Parallelism, ) -> Result<Vec<CompressedVector>, CodecError>

Row-major batch compress with explicit parallelism strategy.

Phase 21: honours parallelism. Serial runs the existing single-threaded loop; Custom(driver) uses the MaybeUninit + AtomicPtr<CompressedVector> parallel path in batch.rs (requires the std feature).

The determinism contract guarantees byte-identical output regardless of the driver or thread count (see batch.rs module doc).

Errors

Same as Self::compress_batch.

pub fn decompress_batch_into( &self, compressed: &[CompressedVector], config: &CodecConfig, codebook: &Codebook, output: &mut [f32], ) -> Result<(), CodecError>

Batch decompress into a contiguous row-major output buffer.

Errors

• CodecError::LengthMismatch if output.len() != compressed.len() * config.dimension()
• Propagates per-vector decompress errors.

Trait Implementations

impl Clone for Codec

fn clone(&self) -> Codec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Codec

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

Formats the value using the given formatter.

impl Default for Codec

fn default() -> Codec

Returns the “default value” for a type.

impl Copy for Codec