clustering
Library Listed
easy way to perform kmeans clustering on arbitrary data
- Downloads
- 1,632
- Dependents
- 3
- Stars
- 6
- Forks
- 4
- Contributors
- 1
- Commits
- 10
- Latest release
- 0.2.2 ·
About
This crate provides an easy and efficient way to perform kmeans clustering on arbitrary data. The algo is initialized with kmeans++ for best performance of the clustering.
There are three goals to this implementation of the kmeans algorithm:
- it must be generic
- it must be easy to use
- it must be reasonably fast
Important Note
Depending on your execution environment and the size of the dataset you aim to cluster; your code might benefit from parallelisation (this can mean massive performance improvements for large problems). Should you want to enable the multithreaded behavior, then add the "parallel" feature to your dependencies.
# To enable multithreading during clustering, add the "parallel" feature
# to your dependency.
[dependencies]
clustering = {version = "0.2.0", features = ["parallel"]}
# If all you aim for it a sequential clustering, just leave that feature out.
[dependencies]
clustering = {version = "0.2.0"}
Read the full README
Example
use clustering::*;
let n_samples = 20_000; // # of samples in the example
let n_dimensions = 200; // # of dimensions in each sample
let k = 4; // # of clusters in the result
let max_iter = 100; // max number of iterations before the clustering forcefully stops
// Generate some random data
let mut samples: Vec<Vec<f64>> = vec![];
for _ in 0..n_samples {
samples.push((0..n_dimensions).map(|_| rand::random()).collect::<Vec<_>>());
}
// actually perform the clustering
let clustering = kmeans(k, &samples, max_iter);
println!("membership: {:?}", clustering.membership);
println!("centroids : {:?}", clustering.centroids);
Features
This crate comes with two optional features:
parallelwhich enables multithreaded dispatch with rayon (thanks to @jean-pierreBoth 's contribution)loggingwhich you can use to log when clustering takes shortcuts.
Compatibility
- Runs on
- GPU support unknown
What shows it
- no dependency or feature matches a backend row
- Native code
- None found
- No native code found
- Python bindings
- No Python binding crate found
- License
- MIT
Compare with similar projects
Order: strongest tier first, then most downloads, then name, with unmeasured values last. A library counts downloads over 30 days. An app counts binary downloads per release. An app with none counts its crate downloads over 30 days. ML Rust runs this catalogue, so its closest project always gets a row.
| Project | Downloads | Dependents | Stars | Latest release | Runs on (GPU) | Native code | License |
|---|---|---|---|---|---|---|---|
|
easy way to perform kmeans clustering on arbitrary data |
1,632 downloads over 30 days | 3 | 6 | 0.2.2 | GPU support unknown | No native code found | MIT |
|
hdbscan Listed
HDBSCAN clustering in pure Rust. A huge improvement on DBSCAN, capable of identifying clusters of varying densities. |
151,876 downloads over 30 days | 4 | 41 | 0.12.0 | GPU support unknown | No native code found | Apache-2.0 OR MIT |
|
Agglomerative hierarchical clustering. |
71,625 downloads over 30 days | 16 | 106 | 0.3.0 | GPU support unknown | No native code found | MIT |
|
Simple k-means clustering to find dominant colors in images. Backed by a generic k-means implementation offered as a standalone library. |
17,429 downloads over 30 days | 13 | 174 | 0.7.1 | GPU support unknown | No native code found | Apache-2.0 OR MIT |
|
petal-clustering Listed
A collection of clustering algorithms. |
11,542 downloads over 30 days | 3 | 46 | 0.14.0 | GPU support unknown | No native code found | Apache-2.0 |
|
augurs Listed
A time-series toolkit for forecasting, outlier detection, clustering and more. |
7,507 downloads over 30 days | 8 | 580 | 0.10.3 | GPU support unknown | No native code found | Apache-2.0 OR MIT |
|
treeboost Listed
Gradient-boosted decision trees for tabular data: trains a baseline model in one call, with full control over boosting modes and configs, and Scalar, AVX-512, SVE2, WGPU and CUDA backends. Python bindings |
18 downloads over 30 days | 0 | 9 | 0.1.2 | CUDA, WebGPU | No native code found | Apache-2.0 |
Why ListedNo archive, New or Featured rule places it, so it is Listed.
What it lacks for Featured
- It has 2 active dependents and 1 new dependents in 365 days. Featured needs 11 active dependents or 9 new dependents in 365 days. The repository route reads 6 stars, 4 forks and 1 contributor. It needs 4,539 stars, 434 forks and 79 contributors together.
What else the check found
- The last activity is on 21 Nov 2025, 353 days ago. The rules expect an update within 365 days. Dormancy rule
- The oldest outside issue waits 751 days for a reply, past the limit of 270. No maintainer replied in 365 days. Rot signals rule
Exact rules: Listed, Featured library. The check on applied thresholds version 9.
Every rule outcome, as the check records it
expected-interval: version 0.2.2 base 300, capped at 4 releases = 200, raised to the 365-day floor: E = 365 daysdormancy: last activity 2025-11-21, 353 days ago, E = 365: activerot: oldest unanswered issue 751 days (limit 270), no maintainer reply in 365 daysfeatured: not featured: active_users 2 < 11 and new_adopters 1 < 9 and repository route stars 6 (needs 4539), forks 4 (needs 434), contributors 1 (needs 79)listed: listed: no archive, new or featured rule applies
Measurements and sources
Each signal row shows the raw value, its source and the fetch date. The Sources list gathers every distinct source on this page. Movement needs more history.
Sources6 sources
- Description: the crates.io description
- crates.io database dump, fetched
- RustSec advisory database, fetched
- GitHub repository, fetched
- crates.io package, fetched
- GitHub contributors, fetched
Adoption2 active dependents, 1 new dependents in 365 days1 not measured
| Signal | Value | Source | Fetched | Counts |
|---|---|---|---|---|
| Active dependents | 2 | crates.io database dump | Yes | |
| New dependents (365 days) | 1 | crates.io database dump | Yes | |
| Peak active dependents | 2.5 | crates.io database dump | Yes | |
| Active dependents as a share of the peak | 1 | crates.io database dump | Yes | |
| Binary downloads per release | Not measured | Yes |
MaintenanceLatest human commit: 11 months ago3 not measured
| Signal | Value | Source | Fetched | Counts |
|---|---|---|---|---|
| Latest human commit | 2025-11-21 | GitHub repository | Yes | |
| Latest release | 2025-11-21 | crates.io database dump | Yes | |
| First release | 2022-11-14 | crates.io database dump | Yes | |
| Latest version | 0.2.2 | crates.io database dump | Yes | |
| Days the oldest outside issue waits for a reply | 751 | GitHub repository | Yes | |
| Maintainer replies over 365 days | 0 | GitHub repository | Yes | |
| Repository archived | false | GitHub repository | Yes | |
| Repository gone | false | GitHub repository | Yes | |
| Release commit or manifest in the repo | true | crates.io package | Yes | |
| Published docs | true | crates.io database dump | Yes | |
| Latest release fails cargo check | Not measured | Yes | ||
| Build check date | Not measured | Yes | ||
| Build check toolchain | Not measured | Yes |
SecurityUnpatched vulnerabilities: none
| Signal | Value | Source | Fetched | Counts |
|---|---|---|---|---|
| Unpatched vulnerabilities past the grace window | none | RustSec advisory database | Yes | |
| RustSec unmaintained advisory | none | RustSec advisory database | Yes | |
| Deprecation notice | none | crates.io database dump | Yes | |
| Deprecated requirement | none | crates.io database dump | Yes |
Distribution4 releases, 1,632 downloads over 30 days5 not measured
| Signal | Value | Source | Fetched | Counts |
|---|---|---|---|---|
| Releases | 4 | crates.io database dump | Yes | |
| Downloads over 30 days | 1632 | crates.io database dump | Yes | |
| Binary downloads over the last 3 releases | Not measured | Yes | ||
| Homebrew installs on request over 365 days | Not measured | Yes | ||
| Repology repository families | Not measured | Yes | ||
| Docker pull growth over 90 days | Not measured | Yes | ||
| Docker pulls at the growth baseline | Not measured | Yes | ||
| Every version a prerelease | false | crates.io database dump | Yes | |
| Every version 0.0.x | false | crates.io database dump | Yes | |
| Every version yanked | false | crates.io database dump | Yes | |
| Crate deleted from crates.io | false | crates.io database dump | Yes |
Repository6 stars, 4 forks, 1 contributors, 10 commits. Stars alone never qualify a project.
| Signal | Value | Source | Fetched | Counts |
|---|---|---|---|---|
| GitHub stars | 6 | GitHub repository | Yes — one part of the repository route | |
| GitHub forks | 4 | GitHub repository | Yes — one part of the repository route | |
| Contributors with a GitHub account | 1 | GitHub contributors | Yes — one part of the repository route | |
| Commits on the default branch | 10 | GitHub repository | No | |
| Repository's main crate left out of the entry | none | crates.io database dump | Yes |
Facts that never count
| Signal | Value | Source | Fetched | Counts |
|---|---|---|---|---|
| License | MIT | crates.io database dump | No | |
| Runs on, from listed crates and their direct dependencies | GPU support unknown | crates.io database dump | No | |
| What shows each backend | no dependency or feature matches a backend row | crates.io database dump | No | |
| Native code, from listed crates and their dependencies | No native code found | crates.io database dump | No | |
| Python bindings, from direct dependencies of listed crates | No Python binding crate found | crates.io database dump | No | |
| Crates that depend on a listed crate directly | 3 | crates.io database dump | No |
Corrections and review history
No correction applies to this entry.
Judgments
A judgment enters only through an approved issue and a merged pull request.
No judgment applies to this entry.