Struct CoarseCentroids 

pub struct CoarseCentroids {
    pub num_clusters: u32,
    pub dim: usize,
    pub centroids: Vec<f32>,
    pub version: u64,
    pub soar_config: Option<SoarConfig>,
}

Coarse centroids for IVF - trained once, shared across all segments

Fields

num_clusters: u32

Number of clusters

dim: usize

Vector dimension

centroids: Vec<f32>

Centroids stored as flat array (num_clusters × dim)

version: u64

Version for compatibility checking during merge

soar_config: Option<SoarConfig>

SOAR configuration (if enabled)

Implementations

impl CoarseCentroids

pub fn train(config: &CoarseConfig, vectors: &[Vec<f32>]) -> Self

Train coarse centroids using k-means algorithm

Uses kmeans crate with SIMD acceleration (native feature).

pub fn find_nearest(&self, vector: &[f32]) -> u32

Find nearest cluster for a query vector

pub fn find_k_nearest(&self, vector: &[f32], k: usize) -> Vec<u32>

Find k nearest clusters for a query vector

pub fn find_k_nearest_with_distances( &self, vector: &[f32], k: usize, ) -> Vec<(u32, f32)>

Find k nearest clusters with their distances

pub fn assign(&self, vector: &[f32]) -> MultiAssignment

Assign vector with SOAR (if configured) or standard assignment

pub fn assign_with_soar( &self, vector: &[f32], config: &SoarConfig, ) -> MultiAssignment

SOAR-style assignment: find secondary clusters with orthogonal residuals

pub fn get_centroid(&self, cluster_id: u32) -> &[f32]

Get centroid for a cluster

pub fn compute_residual(&self, vector: &[f32], cluster_id: u32) -> Vec<f32>

Compute residual vector (vector - centroid)

pub fn save(&self, path: &Path) -> Result<()>

Save to binary file

pub fn write_to<W: Write>(&self, writer: &mut W) -> Result<()>

Write to any writer

pub fn load(path: &Path) -> Result<Self>

Load from binary file

pub fn read_from<R: Read>(reader: &mut R) -> Result<Self>

Read from any reader

pub fn to_bytes(&self) -> Result<Vec<u8>>

Serialize to bytes

pub fn from_bytes(data: &[u8]) -> Result<Self>

Deserialize from bytes

pub fn size_bytes(&self) -> usize

Memory usage in bytes

Trait Implementations

impl Clone for CoarseCentroids

fn clone(&self) -> CoarseCentroids

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CoarseCentroids

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CoarseCentroids

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CoarseCentroids

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.