Struct HnswVectorIndex 

pub struct HnswVectorIndex { /* private fields */ }

A thread-safe HNSW-based vector index.

Wraps HnswIndex with a parking_lot::RwLock so that multiple readers can search concurrently, while writes (insert/remove) acquire exclusive access.

Implementations

impl HnswVectorIndex

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

Create a new HNSW vector index with default parameters.

• m = 16
• ef_construction = 200
• ef_search = 50

pub fn with_params( dimension: usize, metric: DistanceMetric, m: usize, ef_construction: usize, ef_search: usize, ) -> Self

Create a new HNSW vector index with custom parameters.

pub fn with_seed(dimension: usize, metric: DistanceMetric, seed: u64) -> Self

Create a new HNSW vector index with a fixed RNG seed for reproducible level sampling — useful for tests and benchmarks where the exact graph layout needs to be deterministic. Uses the same default parameters as Self::new otherwise. astraeadb-issues.md #18.

pub fn save_to_file(&self, path: &Path) -> Result<()>

Persist the index to the given file path.

Acquires a read lock on the inner index and writes the full HNSW state to a versioned binary file.

pub fn load_from_file(path: &Path) -> Result<Self>

Load an index from the given file path.

Reads and validates the binary file, then wraps the deserialized HnswIndex in a new HnswVectorIndex with the default ef_search.

Trait Implementations

impl VectorIndex for HnswVectorIndex

fn insert(&self, node_id: NodeId, embedding: &[f32]) -> Result<()>

Insert a vector for a node. Dimension must match the index’s configured dimension.

fn remove(&self, node_id: NodeId) -> Result<bool>

Remove a vector for a node.

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

Search for the k nearest neighbors of the query vector.

fn dimension(&self) -> usize

The dimensionality of vectors in this index.

fn metric(&self) -> DistanceMetric

The distance metric used by this index.

fn len(&self) -> usize

Number of vectors currently in the index.

fn node_ids(&self) -> Vec<NodeId>

Return all node IDs currently held by the index.

fn save_to_path(&self, path: &Path) -> Result<()>

Persist the full index state to the given file path.

fn is_empty(&self) -> bool

Whether the index is empty.