Struct TurboTable 

pub struct TurboTable { /* private fields */ }

Approximate-nearest-neighbour table backed by turbovec::TurboQuantIndex.

Implementations

impl TurboTable

pub fn new(distance: Distance, dim: u16, bits: u8) -> Result<Self, IndexError>

Build an empty turbovec-backed table.

Errors

IndexError::Empty when dim == 0, or when bits is not in {2, 3, 4}. IndexError::DimensionMismatch when dim is not a positive multiple of 8 (turbovec’s only dimensional constraint); the expected field is rounded up to the next multiple of 8 to give the caller a workable suggestion.

pub fn len(&self) -> usize

Number of live (non-deleted) vectors.

pub fn is_empty(&self) -> bool

true when there are no live vectors.

pub fn dim(&self) -> u16

Vector dimension.

pub fn distance(&self) -> Distance

Distance metric this table was built with.

pub fn bits(&self) -> u8

Bit width handed to turbovec.

pub fn insert(&mut self, id: NodeId, vector: Vec<f32>) -> Result<(), IndexError>

Insert a vector under id.

vector is taken in the application’s f32 form; the turbovec encode pipeline handles rotation, calibration and packing. When the table’s metric is Cosine or Euclidean the vector is L2-normalised before being added, so turbovec’s inner-product surrogate doubles as a cosine estimate.

Errors

IndexError::Empty for a zero-dim vector, IndexError::DimensionMismatch when the vector’s dimension differs from the table’s frozen dim, and IndexError::Duplicate when id is already present.

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

Soft-delete the vector at id. The slot stays in the turbovec index for positional integrity but is filtered out of search results via the bool mask.

Returns true when the id was present, false otherwise.

pub fn contains(&self, id: NodeId) -> bool

true when id is currently a live vector.

pub fn search( &self, query: &[f32], k: usize, _ef: Option<usize>, ) -> Result<Vec<SearchResult>, IndexError>

Search for the k nearest neighbours of query. The _ef argument is accepted for HNSW API parity and ignored; turbovec scans every block and does not expose a beam-width knob.

Errors

IndexError::DimensionMismatch when the query dimension does not match the table’s frozen dim.