Struct QuantizedIndex 

pub struct QuantizedIndex { /* private fields */ }

Exact scan over a selected compact representation.

Int8 and Binary require cosine distance. Floating-point formats support every DistanceMetric. Returned compact distances can be re-scored with Self::search_rerank.

Implementations

impl QuantizedIndex

pub fn build( config: IndexConfig, kind: QuantizationKind, vectors: &[(u64, &[f32])], ) -> Result<Self, SearchError>

Builds a compact exact-scan index.

Errors

Returns typed config, vector, key, capacity, or allocation errors.

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub const fn dimensions(&self) -> usize

pub const fn kind(&self) -> QuantizationKind

pub const fn config(&self) -> &IndexConfig

pub fn estimated_memory_bytes(&self) -> usize

pub fn search( &self, query: &[f32], count: usize, ) -> Result<Vec<SearchHit>, SearchError>

Searches all compact vectors.

Errors

Returns a typed query validation or allocation error.

pub fn search_batch( &self, queries: &[&[f32]], count: usize, ) -> Result<Vec<Vec<SearchHit>>, SearchError>

Searches independent queries with bounded workers.

Errors

Returns the first input or worker error.

pub fn search_rerank( &self, oracle: &VectorIndex, query: &[f32], count: usize, candidates: usize, ) -> Result<Vec<SearchHit>, SearchError>

Retrieves compact candidates and re-scores them against an f32 index.

Errors

Returns a typed dimension, query, key, or allocation error.

impl QuantizedIndex

pub fn to_bytes(&self) -> Result<Vec<u8>, SearchError>

Serializes the complete compact index into a checksummed buffer.

Errors

Returns a capacity or allocation error.

pub fn from_bytes(bytes: &[u8]) -> Result<Self, SearchError>

Restores and fully validates a compact index from a buffer.

Errors

Returns a typed format, integrity, configuration, or allocation error.

pub fn write_to(&self, writer: impl Write) -> Result<(), SearchError>

Writes the checksummed compact representation to a stream.

Errors

Returns a serialization or stream error.

pub fn read_from(reader: impl Read) -> Result<Self, SearchError>

Reads and validates a compact representation from a stream.

Errors

Returns a stream, format, integrity, or allocation error.

pub fn save(&self, path: impl AsRef<Path>) -> Result<(), SearchError>

Atomically saves a checksummed compact snapshot.

Errors

Returns a serialization or filesystem error.

pub fn load(path: impl AsRef<Path>) -> Result<Self, SearchError>

Loads and validates a compact snapshot.

Errors

Returns a filesystem, format, integrity, or allocation error.

Trait Implementations

impl Debug for QuantizedIndex

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

Formats the value using the given formatter.

impl SearchShard for QuantizedIndex

fn dimensions(&self) -> usize

fn search_shard( &self, query: &[f32], count: usize, ) -> Result<Vec<SearchHit>, SearchError>

Searches this shard.