velesdb-core 7.0.0

High-performance vector database engine written in Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

//! Multi-query fusion strategies for `VelesDB`.
//!
//! This module provides various strategies for combining results from
//! multiple vector searches into a single ranked list.
//!
//! # Strategies
//!
//! - **Average**: Mean of scores across queries
//! - **Maximum**: Best score across queries
//! - **RRF**: Reciprocal Rank Fusion (position-based)
//! - **Weighted**: Custom weighted combination (avg, max, `hit_count`)
//!
//! # Example
//!
//! ```rust,ignore
//! use velesdb_core::fusion::FusionStrategy;
//!
//! // Fuse results from 4 queries using RRF
//! let strategy = FusionStrategy::RRF { k: 60 };
//! let fused = strategy.fuse(multi_query_results);
//! ```

mod strategy;

#[cfg(test)]
mod strategy_tests;

#[cfg(test)]
mod weight_validation_tests;

// For the hybrid search's top-k heap (`collection::search`), which exists
// only with `persistence`.
#[cfg(feature = "persistence")]
pub(crate) use strategy::fused_score_cmp;
pub use strategy::{
    min_max_normalize, sort_fused_results, FusionError, FusionStrategy, ScoreDirection,
    DEFAULT_WEIGHTED_AVG_WEIGHT, DEFAULT_WEIGHTED_HIT_WEIGHT, DEFAULT_WEIGHTED_MAX_WEIGHT,
};