For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
GitHubCUDA-X
    • Home
    • Installation
  • Getting Started
    • Introduction
    • Integrations
    • Use-cases
  • User Guide
    • API Guide
    • Benchmarking Guide
    • Field Guide
    • References
  • Developer Guide
    • Coding Guidelines
    • Contributing
  • API Reference
    • C API Documentation
    • Cpp API Documentation
    • Python API Documentation
    • Java API Documentation
    • Rust API Documentation
      • cuVS Cluster
      • cuVS Cluster Kmeans
      • cuVS Cluster Kmeans Params
      • cuVS
      • cuVS Dlpack
      • cuVS Error
      • cuVS Resources
      • cuVS Distance
      • cuVS Distance Type
      • cuVS Brute Force
      • cuVS Cagra
      • cuVS Cagra Index
      • cuVS Cagra Index Params
      • cuVS Cagra Search Params
      • cuVS IVF Flat
      • cuVS IVF Flat Index
      • cuVS IVF Flat Index Params
      • cuVS IVF Flat Search Params
      • cuVS IVF PQ
      • cuVS IVF PQ Index
      • cuVS IVF PQ Index Params
      • cuVS IVF PQ Search Params
      • cuVS Vamana
      • cuVS Vamana Index
      • cuVS Vamana Index Params
    • Go API Documentation
NVIDIANVIDIA
Developer-friendly docs for your API
Privacy Policy | Your Privacy Choices | Terms of Service | Accessibility | Corporate Policies | Product Security | Contact

Copyright © 2026, NVIDIA Corporation.

LogoLogocuVS
GitHubCUDA-X
On this page
  • Params
  • new
  • set_metric
  • set_n_clusters
  • set_max_iter
  • set_tol
  • set_n_init
  • set_oversampling_factor
  • set_batch_samples
  • set_batch_centroids
  • set_hierarchical
  • set_hierarchical_n_iters
API ReferenceRust API Documentation

Cluster Kmeans Params Module

||View as Markdown|
Previous

cuVS Cluster Kmeans

Next

cuVS

Rust module: cuvs::cluster::kmeans::params

Source: rust/cuvs/src/cluster/kmeans/params.rs

Params

1pub struct Params(pub ffi::cuvsKMeansParams_t); {
2 /* private fields */
3}

Methods

NameSource
newrust/cuvs/src/cluster/kmeans/params.rs:15
set_metricrust/cuvs/src/cluster/kmeans/params.rs:24
set_n_clustersrust/cuvs/src/cluster/kmeans/params.rs:32
set_max_iterrust/cuvs/src/cluster/kmeans/params.rs:40
set_tolrust/cuvs/src/cluster/kmeans/params.rs:48
set_n_initrust/cuvs/src/cluster/kmeans/params.rs:56
set_oversampling_factorrust/cuvs/src/cluster/kmeans/params.rs:64
set_batch_samplesrust/cuvs/src/cluster/kmeans/params.rs:77
set_batch_centroidsrust/cuvs/src/cluster/kmeans/params.rs:84
set_hierarchicalrust/cuvs/src/cluster/kmeans/params.rs:92
set_hierarchical_n_itersrust/cuvs/src/cluster/kmeans/params.rs:100

new

1pub fn new() -> Result<Params>

Returns a new Params

Source: rust/cuvs/src/cluster/kmeans/params.rs:15

set_metric

1pub fn set_metric(self, metric: DistanceType) -> Params

DistanceType to use for fitting kmeans

Source: rust/cuvs/src/cluster/kmeans/params.rs:24

set_n_clusters

1pub fn set_n_clusters(self, n_clusters: i32) -> Params

The number of clusters to form as well as the number of centroids to generate (default:8).

Source: rust/cuvs/src/cluster/kmeans/params.rs:32

set_max_iter

1pub fn set_max_iter(self, max_iter: i32) -> Params

Maximum number of iterations of the k-means algorithm for a single run.

Source: rust/cuvs/src/cluster/kmeans/params.rs:40

set_tol

1pub fn set_tol(self, tol: f64) -> Params

Relative tolerance with regards to inertia to declare convergence.

Source: rust/cuvs/src/cluster/kmeans/params.rs:48

set_n_init

1pub fn set_n_init(self, n_init: i32) -> Params

Number of instance k-means algorithm will be run with different seeds.

Source: rust/cuvs/src/cluster/kmeans/params.rs:56

set_oversampling_factor

1pub fn set_oversampling_factor(self, oversampling_factor: f64) -> Params

Oversampling factor for use in the k-means|| algorithm

Source: rust/cuvs/src/cluster/kmeans/params.rs:64

set_batch_samples

1pub fn set_batch_samples(self, batch_samples: i32) -> Params

Source: rust/cuvs/src/cluster/kmeans/params.rs:77

set_batch_centroids

1pub fn set_batch_centroids(self, batch_centroids: i32) -> Params

if 0 then batch_centroids = n_clusters

Source: rust/cuvs/src/cluster/kmeans/params.rs:84

set_hierarchical

1pub fn set_hierarchical(self, hierarchical: bool) -> Params

Whether to use hierarchical (balanced) kmeans or not

Source: rust/cuvs/src/cluster/kmeans/params.rs:92

set_hierarchical_n_iters

1pub fn set_hierarchical_n_iters(self, hierarchical_n_iters: i32) -> Params

For hierarchical k-means , defines the number of training iterations

Source: rust/cuvs/src/cluster/kmeans/params.rs:100

Source: rust/cuvs/src/cluster/kmeans/params.rs:11