Struct VectorStorage 

pub struct VectorStorage { /* private fields */ }

Vector storage with optional quantization

Manages storage of vectors in either raw f32 format or E8-quantized format. Supports dynamic re-quantization when changing modes.

Implementations

impl VectorStorage

pub fn new(dimension: usize, quantization: Quantization) -> Self

Create new vector storage

Arguments

• dimension - Vector dimension
• quantization - Quantization mode

pub fn add(&mut self, vector: &[f32], codec: Option<&E8Codec>) -> Result<usize>

Add a vector to storage

Arguments

• vector - Raw f32 vector to store
• codec - Optional E8 codec for quantization

Returns

Assigned vector ID

pub fn get(&self, id: usize, codec: Option<&E8Codec>) -> Result<Vec<f32>>

Get a vector by ID

Arguments

• id - Vector ID
• codec - Optional E8 codec for decoding

Returns

Raw f32 vector (decoded if quantized)

pub fn get_raw_slice(&self, id: usize) -> Option<&[f32]>

Get raw vector slice for unquantized storage (zero-copy) Returns None if vector is quantized or ID is invalid

pub fn get_stored(&self, id: usize) -> Option<&StoredVector>

Get stored vector reference by ID

pub fn get_batch( &self, ids: &[usize], codec: Option<&E8Codec>, ) -> Vec<Option<Vec<f32>>>

Batch get multiple vectors by IDs (more efficient than individual gets)

pub fn len(&self) -> usize

Get number of stored vectors

pub fn is_empty(&self) -> bool

Check if storage is empty

pub fn clear(&mut self)

Clear all vectors

pub fn memory_bytes(&self) -> usize

Get total memory usage in bytes

pub fn bytes_per_vector(&self) -> f32

Get memory usage per vector (average)

pub fn set_quantization( &mut self, new_quantization: Quantization, codec: Option<&E8Codec>, ) -> Result<()>

Change quantization mode (re-quantizes all vectors)

Arguments

• new_quantization - New quantization mode
• codec - E8 codec (required if switching to E8)

pub fn quantization(&self) -> &Quantization

Get current quantization mode

pub fn dimension(&self) -> usize

Get vector dimension

pub fn compute_distance( &self, query: &[f32], id: usize, codec: Option<&E8Codec>, distance_fn: impl Fn(&[f32], &[f32]) -> f32, ) -> Result<f32>

Compute distance between query and stored vector

Uses asymmetric distance for quantized vectors (query in f32, db decoded on-the-fly)

pub fn iter_ids(&self) -> impl Iterator<Item = usize>

Iterate over all vector IDs

Trait Implementations

impl Debug for VectorStorage

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

Formats the value using the given formatter.