Struct AnnIndex 

pub struct AnnIndex {
    pub snapshot_max: u64,
    pub metric: Metric,
    pub dim: u16,
    /* private fields */
}

In-memory ANN index over a (row_id, vector) snapshot.

Fields

snapshot_max: u64

Highest row_id in the snapshot.

metric: Metric

dim: u16

Implementations

impl AnnIndex

pub fn build( rows: Vec<(u64, Vec<f32>)>, metric: Metric, dim: u16, ) -> Result<Self, AnnError>

Build an unfiltered index from (row_id, vector) pairs.

pub fn build_with_attrs( rows: Vec<(u64, Vec<f32>, Vec<u32>)>, num_attrs: usize, metric: Metric, dim: u16, ) -> Result<Self, AnnError>

Build a filtered index from (row_id, vector, attr_codes) triples. Each attribute is a PRISM dimension; distinct tuples form the searchable cells.

pub fn from_parts( prism: PrismIndex, id_map: Vec<u64>, snapshot_max: u64, metric: Metric, dim: u16, ) -> Self

Reassemble from persisted parts (the ANN segment decode path). The caller is responsible for prism.store.vectors being in PRISM-internal (cell-reordered) order - see segment::SegmentParts::into_index.

pub fn prism(&self) -> &PrismIndex

pub fn id_map(&self) -> &[u64]

PRISM internal id -> external row_id.

pub fn active_config(metric: Metric) -> PrismConfig

The PRISM configuration this index family builds with - part of the persisted segment’s binding (a config change invalidates segments).

pub fn search(&self, query: &[f32], k: usize) -> Vec<(u64, f32)>

Top-k search returning (row_id, distance) ascending, at the default ef.

pub fn search_with_ef( &self, query: &[f32], k: usize, ef: usize, ) -> Vec<(u64, f32)>

Unfiltered search with an explicit beam width ef.

pub fn search_filtered_default_ef( &self, query: &[f32], k: usize, filter: &Filter, ) -> Vec<(u64, f32)>

Filtered search at the default ef.

pub fn search_filtered( &self, query: &[f32], k: usize, ef: usize, filter: &Filter, ) -> Vec<(u64, f32)>

Filtered search; filter dims index the build_with_attrs attributes (Filter::none() matches all).

pub fn indexed_len(&self) -> usize

Number of indexed rows.

Trait Implementations

impl Debug for AnnIndex

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

Formats the value using the given formatter.