Skip to main content

clusteval

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.

Blogs

  1. A step-by-step guide for clustering images
  2. Detection of Duplicate Images Using Image Hash Functions
  3. From Data to Clusters: When is Your Clustering Good Enough?
  4. From Clusters To Insights; The Next Step

Documentation

Full documentation is available at erdogant.github.io/clusteval, including examples and API references.


Installation

It is advisable to use a virtual environment:

conda create -n env_clusteval python=3.12
conda activate env_clusteval

Install via PyPI:

pip install clusteval

To upgrade to the latest version:

pip install --upgrade clusteval

Import the library:

from clusteval import clusteval

Examples

A structured overview is available in the documentation.


Silhouette Score

Optimal Clusters

Dendrogram

Davies-Bouldin Index

Derivative Method

DBSCAN

HDBSCAN A

HDBSCAN B

Citation

Please cite clusteval in your publications if it has been helpful in your research. Citation information is available at the top right of the GitHub page.


Related Tools & Blogs


Star history

Star History Chart

Contributors

Thank the contributors!

Maintainer

  • Erdogan Taskesen, github: erdogant
  • Contributions are welcome.
  • Yes! This library is entirely free but it runs on coffee! :) Feel free to support with a Coffee.

Buy me a coffee

Release files for clusteval 2.2.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for clusteval 2.2.7
File Size Uploaded
clusteval-2.2.7.tar.gz 37.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for clusteval 2.2.7
File Interpreter ABI Platform
clusteval-2.2.7-py3-none-any.whl Python 3 none any Details

Total release size: 79.7 kB

Release files / clusteval-2.2.7.tar.gz

Download URL clusteval-2.2.7.tar.gz
Size 37.0 kB
Tags Source
SHA-256 checksum
How to use checksums
439ab17de89d6f9a6d1e9e9d7f7058b24b8520dd9590135414b8297e7ec569d2
BLAKE2b-256 checksum
How to use checksums
a7d46826ec5d2a85d33eaf32acb1fd04c750d4a7afd918399e56fa30c5553c68
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.12

Release files / clusteval-2.2.7-py3-none-any.whl

Download URL clusteval-2.2.7-py3-none-any.whl
Size 42.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
20adfa5723ab0c939027c5073e21f685826b3450e6df2ea85593baa12d349ab2
BLAKE2b-256 checksum
How to use checksums
1ca94ed583c2d5856e52e0ed3b1a7ee4f5567d1e9aea7b7ca4a60506645b5f5b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.12

Release history Release notifications | RSS feed

This release

2.2.7 This release

2 release files

2.2.6

2 release files

2.2.5

2 release files

2.2.4

2 release files

2.2.3

2 release files

2.2.2

2 release files

2.2.1

2 release files

2.2.0

2 release files

2.1.5

2 release files

2.1.4

2 release files

2.1.3

2 release files

2.1.2

2 release files

2.1.1

2 release files

2.1.0

2 release files

2.0.5

2 release files

2.0.4

2 release files

2.0.3

2 release files

2.0.2

2 release files

2.0.1

2 release files

2.0.0

2 release files

1.0.2

2 release files

1.0.1

2 release files

1.0.0

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page