Crate vq 

Vq

vq is a vector quantization library for Rust.

It provides efficient implementations of various vector quantization algorithms, including binary quantization (BQ), scalar quantization (SQ), product quantization (PQ), and tree-structured vector quantization (TSVQ).

Features

• Unified API: All algorithms implement the Quantizer trait.
• Distance metrics: Supports Euclidean, squared Euclidean, Manhattan, and cosine distances.
• Performance:
  • SIMD acceleration (AVX/AVX2/AVX512/NEON/SVE) via simd feature.
  • Parallel training via parallel feature.

Example

use vq::{Quantizer, VqResult};
use vq::sq::ScalarQuantizer;

fn main() -> VqResult<()> {
    let sq = ScalarQuantizer::new(-1.0, 1.0, 256)?;
    let vector = vec![0.5, -0.2, 0.9];
    let quantized = sq.quantize(&vector)?;
    let reconstructed = sq.dequantize(&quantized)?;
    Ok(())
}

Re-exports

pub use bq::BinaryQuantizer;

pub use pq::ProductQuantizer;

pub use sq::ScalarQuantizer;

pub use tsvq::TSVQ;

pub use core::distance::Distance;

pub use core::error::VqError;

pub use core::error::VqResult;

pub use core::quantizer::Quantizer;

pub use core::vector::Vector;

Modules

bq

Binary quantization (BQ) implementation.

core

Core types and traits for the vq library.

pq

Product quantization (PQ) implementation.

sq

Scalar quantization (SQ) implementation.

tsvq

Tree-structured vector quantization (TSVQ) implementation.