Struct MultiLayerNodeManager 

pub struct MultiLayerNodeManager { /* private fields */ }

Multi-layer node manager that orchestrates layer operations

Provides high-level interface for multi-layer HNSW functionality, coordinating between vector storage, layer management, and search operations. Wraps existing single-layer components to provide multi-layer capabilities.

Key Responsibilities

• Coordinate insertions across multiple layers
• Manage bidirectional ID mappings
• Orchestrate multi-layer search operations
• Provide feature flag for safe migration

Implementations

impl MultiLayerNodeManager

pub fn new(config: HnswConfig) -> Result<Self, HnswError>

Create new multi-layer node manager

Arguments

• config - HNSW configuration

Returns

New MultiLayerNodeManager instance

pub fn insert_vector( &mut self, vector_id: u64, ) -> Result<(usize, Vec<(usize, u64)>), HnswError>

Insert vector into appropriate layers

Arguments

• vector_id - Global vector ID from storage

Returns

Tuple of (highest_level, layer_assignments) where layer_assignments is a vector of (layer_id, local_id) pairs

pub fn remove_vector(&mut self, vector_id: u64) -> Result<(), HnswError>

Remove vector from all layers

Arguments

• vector_id - Global vector ID to remove

pub fn get_local_id(&self, vector_id: u64, layer_id: usize) -> Option<u64>

Get local ID for global ID in specific layer

Arguments

• vector_id - Global vector ID
• layer_id - Layer ID

Returns

Local node ID if mapping exists

pub fn get_global_id(&self, layer_id: usize, local_id: u64) -> Option<u64>

Get global ID for local ID in specific layer

Arguments

• layer_id - Layer ID
• local_id - Local node ID

Returns

Global vector ID if mapping exists

pub fn get_layer_vectors(&self, layer_id: usize) -> Vec<u64>

Get vectors assigned to specific layer

Arguments

• layer_id - Layer ID

Returns

Iterator over global IDs in the layer

pub fn get_vector_level(&self, vector_id: u64) -> Option<usize>

Get highest level assignment for a vector

Arguments

• vector_id - Global vector ID

Returns

Highest layer where vector exists, or None if not inserted

pub fn get_statistics(&self) -> (usize, Vec<usize>, usize)

Get statistics about layer distribution

Returns

Tuple of (total_vectors, layer_counts, memory_usage)

pub fn validate_consistency(&self) -> Result<(), HnswError>

Validate all mappings and consistency

Returns

Ok(()) if all mappings are consistent

pub fn clear(&mut self) -> Result<(), HnswError>

Clear all mappings and start fresh

Trait Implementations

impl Debug for MultiLayerNodeManager

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

Formats the value using the given formatter.