Struct SieveRouter 

pub struct SieveRouter<'a> {
    pub collection: &'a SieveCollection,
    pub fallback: &'a HnswIndex,
}

Routes a filtered ANN query to the right index.

• If predicate_signature is Some(sig) and a subindex exists for sig, the query is executed directly on that subindex (no bitmap needed).
• Otherwise the query falls back to navix_search on the global fallback index using allowed as the sideways-information bitmap.

Fields

collection: &'a SieveCollection

Collection of specialized subindices.

fallback: &'a HnswIndex

Global index used when no subindex matches.

Implementations

impl<'a> SieveRouter<'a>

pub fn route( &self, query: &[f32], predicate_signature: Option<&PredicateSignature>, allowed: RoaringBitmap, k: usize, ef_search: usize, metric: DistanceMetric, ) -> Vec<SearchResult>

Execute a filtered k-NN query.

Parameters

• query — query vector.
• predicate_signature — optional stable predicate; if present and a subindex exists for it, that subindex is used directly.
• allowed — bitmap of allowed IDs for the NaviX fallback path. Ignored when a subindex is matched.
• k — number of nearest neighbours to return.
• ef_search — beam width for HNSW/NaviX traversal.
• metric — distance metric.

Returns

Up to k nearest-neighbour results, sorted by ascending distance.