pyvq 0.1.0a1

Python bindings for the Vq library

PyVq

PyVq provides Python bindings for Vq vector quantization library.

[!IMPORTANT] PyVq is in early development, so breaking changes and bugs are expected. Please report bugs on GitHub issues.

Installation

pip install pyvq

Quickstart

import numpy as np
import pyvq

# Binary Quantization
bq = pyvq.BinaryQuantizer(threshold=0.0, low=0, high=1)
vector = np.array([-0.5, 0.0, 0.5, 1.0], dtype=np.float32)
codes = bq.quantize(vector)
print(f"Binary codes: {codes}")  # [0, 1, 1, 1]

# Scalar Quantization  
sq = pyvq.ScalarQuantizer(min_val=-1.0, max_val=1.0, levels=256)
quantized = sq.quantize(vector)
reconstructed = sq.dequantize(quantized)
print(f"Reconstructed: {reconstructed}")

# Distance Computation
dist = pyvq.Distance.euclidean()
a = np.array([1.0, 2.0, 3.0], dtype=np.float32)
b = np.array([4.0, 5.0, 6.0], dtype=np.float32)
print(f"Distance: {dist.compute(a, b)}")

Documentation

Visit PyVq's documentation page for detailed information including examples and API references.

License

PyVq is licensed under the MIT License.