Struct CodecConfig 

pub struct CodecConfig { /* private fields */ }

Immutable configuration snapshot that fully determines codec behavior.

Two configs with identical primary fields are interchangeable. The cached config_hash is computed eagerly in CodecConfig::new and ignored by PartialEq / Hash so semantically equal configs compare equal regardless of which instance owns the Arc<str>.

Implementations

impl CodecConfig

pub fn new( bit_width: u8, seed: u64, dimension: u32, residual_enabled: bool, ) -> Result<Self, CodecError>

Validate the field invariants and return a new CodecConfig.

Errors

• CodecError::UnsupportedBitWidth — bit_width is not in SUPPORTED_BIT_WIDTHS.
• CodecError::InvalidDimension — dimension == 0.

pub const fn bit_width(&self) -> u8

The bit width of the quantized indices.

pub const fn seed(&self) -> u64

The seed used for deterministic rotation and codebook generation.

pub const fn dimension(&self) -> u32

The expected input vector dimensionality.

pub const fn residual_enabled(&self) -> bool

Whether stage-2 residual correction is enabled.

pub const fn num_codebook_entries(&self) -> u32

2^bit_width — the number of quantization levels in the codebook.

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

Cached SHA-256 hex digest of the canonical string representation.

Returned as an Arc<str> borrow; clone with .clone() for owned use.

Trait Implementations

impl Clone for CodecConfig

fn clone(&self) -> CodecConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CodecConfig

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

Formats the value using the given formatter.

impl Hash for CodecConfig

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for CodecConfig

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for CodecConfig