Enum GuaranteeMode 

pub enum GuaranteeMode {
    Approximate,
    Calibrated {
        recall_target: f32,
        confidence: f32,
    },
    Certified,
}

Guarantee mode for search correctness

Variants

Approximate

Fast approximate search - ignores quantization error

Returns top-k by proxy score (e.g., PQ/ADC distance). Fastest but may miss true nearest neighbors.

Calibrated

Calibrated high-recall search - probabilistic guarantees

Uses learned error envelopes to bound approximation error. Guarantees P(recall@k ≥ ρ) ≥ 1-δ with configurable ρ and δ.

Fields

recall_target: f32

Target recall (ρ)

confidence: f32

Confidence level (1-δ)

Certified

Certified search - deterministic correctness

Uses lower/upper bound envelopes for all candidates. Guarantees exact top-k results (same as brute force).

Implementations

impl GuaranteeMode

pub fn calibrated(recall_target: f32, confidence: f32) -> Self

Create calibrated mode with given recall target

pub fn requires_rerank(&self) -> bool

Returns true if this mode requires rerank verification

pub fn uses_error_envelopes(&self) -> bool

Returns true if this mode uses error envelopes

pub fn error_quantile(&self) -> Option<f32>

Get the error quantile to use for this mode

Trait Implementations

impl Clone for GuaranteeMode

fn clone(&self) -> GuaranteeMode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for GuaranteeMode

impl Debug for GuaranteeMode

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

Formats the value using the given formatter.

impl Default for GuaranteeMode

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for GuaranteeMode

fn eq(&self, other: &GuaranteeMode) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for GuaranteeMode