geokmeans

Fast, eco-friendly k-means clustering for Python — a scikit-learn-style interface to a C++ library implementing seven k-means algorithms, including Geometric-k-means, the bound-free method of Sharma et al. (2026).

All seven algorithms return the same Lloyd’s k-means solution; they differ only in how aggressively they prune distance computations, so you get identical results with far less work.

Contents

• Installation
  • Requirements
• Quickstart
  • Choosing an algorithm
  • Long-running jobs
• API reference
  • geokmeans.GeoKMeans
  • GeoKMeans

Citation

If you use this package, please cite:

Sharma, P., Stanislaw, M., Kurban, H., Kulekci, O., & Dalkilic, M. (2026). Geometric-k-means: A Bound Free Approach to Fast and Eco-Friendly k-means. Machine Learning, 115(2), 30. https://doi.org/10.1007/s10994-025-06891-1

Indices

• Index

• Search Page