Skip to main content

clusteval is a python package for unsupervised cluster validation.

Project description


Python PyPI Version License BuyMeCoffee Github Forks GitHub Open Issues Project Status Downloads Downloads DOI Sphinx Open In Colab

clusteval is a python package that is developed to evaluate detected clusters and return the cluster labels that have most optimal clustering tendency, Number of clusters and clustering quality. Multiple evaluation strategies are implemented for the evaluation; silhouette, dbindex, and derivative, and four clustering methods can be used: agglomerative, kmeans, dbscan and hdbscan.

⭐️ Star this repo if you like it ⭐️


Read the blog to get a structured overview how you can use clusteval.

In case you want to detect identical images, you can also use hash functionalities.

Documentation pages

On the documentation pages you can find detailed information about the working of the clusteval with many examples.


It is advisable to create a new environment (e.g. with Conda).
conda create -n env_clusteval python=3.8
conda activate clusteval
Install from PyPI
pip install clusteval
Import library
from clusteval import clusteval


A structured overview of all examples are now available on the documentation pages.


Please cite clusteval in your publications if this is useful for your research (see right top for citation).

Other interesting techniques/blogs


  • Erdogan Taskesen, github: erdogant
  • Contributions are welcome.
  • If you wish to buy me a Coffee for this work, it is very appreciated :) Star it if you like it!

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

clusteval-2.2.1.tar.gz (36.3 kB view hashes)

Uploaded source

Built Distribution

clusteval-2.2.1-py3-none-any.whl (42.4 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page