Struct UnifiedQuantizedVector 

pub struct UnifiedQuantizedVector { /* private fields */ }

Owned, 128-byte-aligned unified quantized vector buffer.

Layout (contiguous bytes):

[ QuantHeader (32 B) | packed_bits (variable) | outlier_payload (8 B × n) | tail_pad ]

The total allocation is always a multiple of 128 bytes (one AVX-512 cache-line pair).

Implementations

impl UnifiedQuantizedVector

pub fn new( header: QuantHeader, packed_bits: &[u8], outliers: &[(u32, f32)], ) -> Result<Self, CodecError>

Construct from an explicit header, packed-bit slice, and sparse outlier list.

outliers is a slice of (dim_index, value) pairs. The outlier_bitmask in header must have exactly one bit set for each entry in outliers, and bits must correspond to entries in ascending dim_index order (i.e. popcnt-dense order).

Errors

Returns CodecError::LayoutError if:

• outliers.len() does not match popcnt(header.outlier_bitmask).
• Any dim_index in outliers is ≥ 64 (bitmask only covers 64 dims).

pub fn header(&self) -> &QuantHeader

Zero-copy reference to the header (first 32 bytes).

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

Slice of the packed-bit region.

pub fn outlier_count(&self) -> u32

Number of outlier entries, computed via popcnt of outlier_bitmask.

pub fn outlier_at(&self, slot: u32) -> Option<(u32, f32)>

Return the outlier (dim_index, value) for the dimension at position slot in the bitmask.

slot is the dimension index (0–63). Returns None if the bit for slot is not set in outlier_bitmask, or if slot ≥ 64.

Uses a branchless popcnt to find the dense offset into the outlier payload.

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

Full backing buffer suitable for direct I/O.

Trait Implementations

impl AsRef<UnifiedQuantizedVector> for BbqQuantized

fn as_ref(&self) -> &UnifiedQuantizedVector

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<UnifiedQuantizedVector> for OpqQuantized

fn as_ref(&self) -> &UnifiedQuantizedVector

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<UnifiedQuantizedVector> for RaBitQQuantized

fn as_ref(&self) -> &UnifiedQuantizedVector

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<UnifiedQuantizedVector> for TernaryQuantized

fn as_ref(&self) -> &UnifiedQuantizedVector

Converts this type into a shared reference of the (usually inferred) input type.