Struct FlatIndex 

pub struct FlatIndex { /* private fields */ }

Flat vector index: append-only buffer with brute-force search.

Implementations

impl FlatIndex

pub fn new(dim: usize, metric: DistanceMetric) -> Self

Create a new empty flat index.

pub fn insert(&mut self, vector: Vec<f32>) -> u32

Insert a vector. Returns the assigned vector ID.

pub fn delete(&mut self, id: u32) -> bool

Soft-delete a vector by ID.

pub fn search_with_metric( &self, query: &[f32], top_k: usize, metric: DistanceMetric, ) -> Vec<SearchResult>

Brute-force k-NN search with an explicit distance metric override. Overrides the self.metric configured at collection creation time.

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

Brute-force k-NN search. Exact results — no approximation.

pub fn search_filtered( &self, query: &[f32], top_k: usize, bitmap: &[u8], ) -> Vec<SearchResult>

Search with a pre-filter bitmap (byte-array format).

pub fn search_filtered_offset_with_metric( &self, query: &[f32], top_k: usize, bitmap: &[u8], id_offset: u32, metric: DistanceMetric, ) -> Vec<SearchResult>

Filtered search with an explicit metric override.

pub fn search_filtered_offset( &self, query: &[f32], top_k: usize, bitmap: &[u8], id_offset: u32, ) -> Vec<SearchResult>

Search with a pre-filter bitmap applying a global id offset.

bitmap is a serialized RoaringBitmap (matching the HNSW filter format). Bit i + id_offset tests local id i. Used by multi-segment collections where the bitmap holds GLOBAL vector ids. If the bytes fail to deserialize, the search degrades to unfiltered.

pub fn len(&self) -> usize

pub fn live_count(&self) -> usize

pub fn is_empty(&self) -> bool

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

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

Raw access bypassing tombstone filter — used by snapshot/restore.

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

Whether the given local id has been tombstoned.

pub fn insert_tombstoned(&mut self, vector: Vec<f32>) -> u32

Insert a vector that is already tombstoned (for checkpoint restore).

pub fn dim(&self) -> usize

pub fn metric(&self) -> DistanceMetric

pub fn tombstone_count(&self) -> usize