Struct IncrementalDiskANN 

pub struct IncrementalDiskANN<D>
where
    D: Distance<f32> + Send + Sync + Copy + Clone + 'static,
{ /* private fields */ }

An incremental DiskANN index supporting add/delete without full rebuild

Implementations

impl<D> IncrementalDiskANN<D>

where D: Distance<f32> + Send + Sync + Copy + Clone + Default + 'static,

pub fn build_default( vectors: &[Vec<f32>], file_path: &str, ) -> Result<Self, DiskAnnError>

Build a new incremental index with default parameters

pub fn open(path: &str) -> Result<Self, DiskAnnError>

Open an existing index for incremental updates

impl<D> IncrementalDiskANN<D>

where D: Distance<f32> + Send + Sync + Copy + Clone + 'static,

pub fn build_with_config( vectors: &[Vec<f32>], file_path: &str, config: IncrementalConfig, ) -> Result<Self, DiskAnnError>

where D: Default,

Build a new incremental index with custom configuration

pub fn open_with_config( path: &str, config: IncrementalConfig, ) -> Result<Self, DiskAnnError>

where D: Default,

Open an existing index with custom configuration

pub fn new_empty(dim: usize, dist: D, config: IncrementalConfig) -> Self

Create an empty incremental index (no base, delta-only)

pub fn add_vectors( &self, vectors: &[Vec<f32>], ) -> Result<Vec<u64>, DiskAnnError>

Add new vectors to the index. Returns their assigned IDs.

pub fn delete_vectors(&self, ids: &[u64]) -> Result<(), DiskAnnError>

Delete vectors by their IDs (lazy deletion via tombstones)

pub fn is_deleted(&self, id: u64) -> bool

Check if a vector ID has been deleted

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

Search the index, merging results from base and delta, excluding tombstones

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

Search returning (id, distance) pairs

pub fn search_batch( &self, queries: &[Vec<f32>], k: usize, beam_width: usize, ) -> Vec<Vec<u64>>

Parallel batch search

pub fn get_vector(&self, id: u64) -> Option<Vec<f32>>

Get a vector by its ID (works for both base and delta)

pub fn should_compact(&self) -> bool

Check if compaction is recommended

pub fn compact(&mut self, new_path: &str) -> Result<(), DiskAnnError>

where D: Default,

Compact the index: merge base + delta, remove tombstones, write new file

pub fn stats(&self) -> IncrementalStats

Get statistics about the index

pub fn dim(&self) -> usize

Get the dimensionality of vectors in this index