Struct HnswIndex 

pub struct HnswIndex { /* private fields */ }

HNSW index for approximate nearest neighbor search

Thread-safe implementation using Arc<RwLock<>> for concurrent reads.

Implementations

impl HnswIndex

pub fn new() -> Self

Create a new HNSW index with default configuration

pub fn with_config(config: HnswConfig) -> Self

Create a new HNSW index with custom configuration

pub fn insert( &mut self, vector: SemanticVector, ) -> Result<usize, FrameworkError>

Insert a vector into the index

Arguments

• vector: The SemanticVector to insert

Returns

The assigned node ID

pub fn insert_batch( &mut self, vectors: Vec<SemanticVector>, ) -> Result<Vec<usize>, FrameworkError>

Insert a batch of vectors

More efficient than inserting one at a time for large batches.

pub fn search_knn( &self, query: &[f32], k: usize, ) -> Result<Vec<HnswSearchResult>, FrameworkError>

Search for k nearest neighbors

Arguments

• query: Query vector (must match index dimension)
• k: Number of neighbors to return

Returns

Up to k nearest neighbors, sorted by distance (ascending)

pub fn search_threshold( &self, query: &[f32], threshold: f32, max_results: Option<usize>, ) -> Result<Vec<HnswSearchResult>, FrameworkError>

Search for all neighbors within a distance threshold

Arguments

• query: Query vector
• threshold: Maximum distance (exclusive)
• max_results: Maximum number of results to return (None for unlimited)

Returns

All neighbors within threshold, sorted by distance

pub fn stats(&self) -> HnswStats

Get statistics about the index structure

pub fn get_vector(&self, node_id: usize) -> Option<&Vec<f32>>

Get the underlying vector for a node

pub fn get_external_id(&self, node_id: usize) -> Option<&str>

Get the external ID for a node

pub fn len(&self) -> usize

Get total number of nodes in the index

pub fn is_empty(&self) -> bool

Check if index is empty

Trait Implementations

impl Default for HnswIndex

fn default() -> Self

Returns the “default value” for a type.