ringdb/lib.rs
1//! # ringDB
2//!
3//! A vector database specialised for **ring queries** in high-dimensional spaces.
4//!
5//! Instead of nearest-neighbour search, ringDB retrieves all vectors whose
6//! Euclidean distance to a query lies within a specified interval `[d-λ, d+λ]`.
7//!
8//! ## Quick start
9//!
10/// ```
11/// use ringdb::{RingDb, RingDbConfig, RingQuery};
12///
13/// let mut db = RingDb::new(RingDbConfig::new(4)).unwrap();
14/// db.add_vector(&[1.0f32, 0.0, 0.0, 0.0], ()).unwrap();
15/// db.add_vector(&[0.0, 5.0, 0.0, 0.0], ()).unwrap();
16///
17/// let db = db.build().unwrap();
18/// let result = db.query(&RingQuery { query: &[0.0f32; 4], d: 1.0, lambda: 0.1 }).unwrap();
19/// // result.ids contains IDs of all vectors at distance ≈ 1.0 from origin
20/// ```
21mod backend;
22mod config;
23mod engine;
24mod error;
25mod payload;
26mod query;
27
28pub use config::{BackendPreference, RingDbConfig};
29pub use engine::{RingDb, SealedRingDb};
30pub use error::RingDbError;
31pub use query::{QueryResult, RingQuery};