rvf-quant 0.2.0

RuVector Format temperature-tiered vector quantization (f32/f16/u8/binary)
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

//! Temperature-tiered vector quantization for the RuVector Format (RVF).
//!
//! Provides three quantization levels mapped to temperature tiers:
//!
//! | Tier | Quantization | Compression |
//! |------|-------------|-------------|
//! | Hot  | Scalar (int8) | 4x |
//! | Warm | Product (PQ)  | 8-16x |
//! | Cold | Binary (1-bit)| 32x |
//!
//! The [`rabitq`] module provides a RaBitQ-style 1-bit codec (centroid
//! centering + seeded random rotation + correction scalars) with an
//! asymmetric distance estimator, intended for two-stage
//! (scan-then-rescore) search at ~32x code compression.
//!
//! A Count-Min Sketch tracks per-block access frequency to drive
//! promotion/demotion decisions.

#![cfg_attr(not(feature = "std"), no_std)]

extern crate alloc;

pub mod binary;
pub mod codec;
pub mod product;
pub mod rabitq;
pub mod scalar;
pub mod sketch;
pub mod tier;
pub mod traits;

pub use binary::{decode_binary, encode_binary, hamming_distance};
pub use product::ProductQuantizer;
pub use rabitq::{RabitqCode, RabitqQuantizer, RabitqQuery};
pub use scalar::ScalarQuantizer;
pub use sketch::CountMinSketch;
pub use tier::TemperatureTier;
pub use traits::Quantizer;