Struct QueryMatRef 

pub struct QueryMatRef<'a, T: Repr>(pub MatRef<'a, T>);

A query matrix view for asymmetric distance functions.

This wrapper distinguishes query matrices from document matrices at compile time, preventing accidental argument swapping in asymmetric distance computations like MaxSim and Chamfer.

Example

use diskann_quantization::multi_vector::{MatRef, Standard};
use diskann_quantization::multi_vector::distance::QueryMatRef;

let data = [1.0f32, 2.0, 3.0, 4.0];
let view = MatRef::new(Standard::new(2, 2).unwrap(), &data).unwrap();
let query: QueryMatRef<_> = view.into();

Tuple Fields

0: MatRef<'a, T>

Methods from Deref<Target = MatRef<'a, T>>

pub fn num_vectors(&self) -> usize

Returns the number of rows (vectors) in the matrix.

pub fn repr(&self) -> &T

Returns a reference to the underlying representation.

pub fn get_row(&self, i: usize) -> Option<T::Row<'_>>

Returns an immutable reference to the i-th row, or None if out of bounds.

pub fn rows(&self) -> Rows<'_, T>

Returns an iterator over immutable row references.

pub fn to_owned(&self) -> Mat<T>

where T: NewCloned,

Return a Mat with the same contents as self.

pub fn as_raw_ptr(&self) -> *const u8

Return the base pointer for the MatRef.

Trait Implementations

impl<'a, T: Clone + Repr> Clone for QueryMatRef<'a, T>

fn clone(&self) -> QueryMatRef<'a, T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a, T: Debug + Repr> Debug for QueryMatRef<'a, T>

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

Formats the value using the given formatter.

impl<'a, T: Repr> Deref for QueryMatRef<'a, T>

Deref so that we can transparently access the MatRef in distance functions.

type Target = MatRef<'a, T>

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<const NBITS: usize> DistanceFunctionMut<QueryMatRef<'_, MinMaxMeta<NBITS>>, MatRef<'_, MinMaxMeta<NBITS>>> for MaxSim<'_>

where Unsigned: Representation<NBITS>, InnerProduct: for<'x, 'y> PureDistanceFunction<BitSlice<'x, NBITS, Unsigned>, BitSlice<'y, NBITS, Unsigned>, MathematicalResult<u32>>,

fn evaluate( &mut self, query: QueryMatRef<'_, MinMaxMeta<NBITS>>, doc: MatRef<'_, MinMaxMeta<NBITS>>, )

Compute distances between the left and right arguments.

impl<T: Copy> DistanceFunctionMut<QueryMatRef<'_, Standard<T>>, MatRef<'_, Standard<T>>, Result<(), MaxSimError>> for MaxSim<'_>

where InnerProduct: for<'a, 'b> PureDistanceFunction<&'a [T], &'b [T], f32>,

fn evaluate( &mut self, query: QueryMatRef<'_, Standard<T>>, doc: MatRef<'_, Standard<T>>, ) -> Result<(), MaxSimError>

Compute distances between the left and right arguments.

impl<'a, T: Repr> From<MatRef<'a, T>> for QueryMatRef<'a, T>

fn from(view: MatRef<'a, T>) -> Self

Converts to this type from the input type.

impl<const NBITS: usize> PureDistanceFunction<QueryMatRef<'_, MinMaxMeta<NBITS>>, MatRef<'_, MinMaxMeta<NBITS>>> for Chamfer

where Unsigned: Representation<NBITS>, InnerProduct: for<'a, 'b> PureDistanceFunction<BitSlice<'a, NBITS, Unsigned>, BitSlice<'b, NBITS, Unsigned>, MathematicalResult<u32>>,

fn evaluate( query: QueryMatRef<'_, MinMaxMeta<NBITS>>, doc: MatRef<'_, MinMaxMeta<NBITS>>, ) -> f32

impl<T: Copy> PureDistanceFunction<QueryMatRef<'_, Standard<T>>, MatRef<'_, Standard<T>>> for Chamfer

where InnerProduct: for<'a, 'b> PureDistanceFunction<&'a [T], &'b [T], f32>,

fn evaluate( query: QueryMatRef<'_, Standard<T>>, doc: MatRef<'_, Standard<T>>, ) -> f32

impl<'a, T: Copy + Repr> Copy for QueryMatRef<'a, T>