Struct HybridEngine 

pub struct HybridEngine {
    pub alpha: f32,
    pub strategy: FusionStrategy,
    pub oversample_factor: usize,
}

Fields

alpha: f32

Weight for dense scores (1.0 = pure dense, 0.0 = pure sparse).

strategy: FusionStrategy

Fusion strategy to use.

oversample_factor: usize

Oversampling factor: dense retrieves k * oversample_factor candidates before sparse re-scoring.

Implementations

impl HybridEngine

pub fn new( alpha: f32, strategy: FusionStrategy, oversample_factor: usize, ) -> Self

Construct a new engine.

Panics

Panics if alpha is not in [0.0, 1.0] or oversample_factor < 1. These are programming errors, not runtime errors.

pub fn fuse( &self, dense_results: Vec<(VectorId, f32)>, sparse_results: Vec<(VectorId, f32)>, k: usize, ) -> Result<Vec<SearchResult>>

Fuse pre-computed dense and sparse result lists into a single ranked list.

• Both empty → empty result.
• Dense only → pure dense path; sparse_score = None.
• Sparse only → pure sparse path; dense_score = None.
• Both present → fuse with self.strategy.

dense_score and sparse_score in each SearchResult hold the original (pre-normalization) scores. score holds the fused value. payload and text are left as Null / None — caller hydrates.

pub fn compute_oversample_k(&self, k: usize) -> usize

How many dense candidates to fetch before sparse re-scoring.

Returns k * oversample_factor (minimum k).

Trait Implementations

impl Clone for HybridEngine

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for HybridEngine

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

Formats the value using the given formatter.

impl Default for HybridEngine

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for HybridEngine

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for HybridEngine

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.