clusteval

Clusteval provides methods for unsupervised cluster validation

https://github.com/erdogant/clusteval

Science Score: 54.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
    Links to: zenodo.org
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (13.9%) to scientific vocabulary

Keywords

clustering dbindex density-based-clustering machine-learning python silhouette-method unsupervised-clustering validation
Last synced: 6 months ago · JSON representation ·

Repository

Clusteval provides methods for unsupervised cluster validation

Basic Info
Statistics
  • Stars: 60
  • Watchers: 2
  • Forks: 8
  • Open Issues: 2
  • Releases: 24
Topics
clustering dbindex density-based-clustering machine-learning python silhouette-method unsupervised-clustering validation
Created about 6 years ago · Last pushed 10 months ago
Metadata Files
Readme Funding License Citation

README.md

clusteval

Python PyPI Version License BuyMeCoffee Github Forks GitHub Open Issues Project Status Downloads Downloads DOI Sphinx Open In Colab <!---Coffee-->

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 ⭐️

📘 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:

bash conda create -n env_clusteval python=3.12 conda activate env_clusteval

Install via PyPI:

bash pip install clusteval

To upgrade to the latest version:

bash pip install --upgrade clusteval

Import the library:

python 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


☕ Support

If you find this project useful, consider supporting me:

Owner

  • Name: Erdogan
  • Login: erdogant
  • Kind: user
  • Location: Den Haag

Machine Learning | Statistics | Bayesian | D3js | Visualizations

Citation (CITATION.cff)

# YAML 1.2
---
authors: 
  -
    family-names: Taskesen
    given-names: Erdogan
    orcid: "https://orcid.org/0000-0002-3430-9618"
cff-version: "1.1.0"
date-released: 2020-09-01
keywords: 
  - "Python"
  - "Clustering"
  - "Validation"
  - "Dbindex"
  - "Silhouette method"
  - "Unsupervised"
license: "MIT"
message: "If you use this software, please cite it using these metadata."
repository-code: "https://erdogant.github.io/clusteval"
title: "clusteval is a python package for unsupervised cluster validation."
version: "0.1.0"
...

GitHub Events

Total
  • Create event: 2
  • Release event: 3
  • Issues event: 1
  • Watch event: 3
  • Issue comment event: 1
  • Push event: 13
Last Year
  • Create event: 2
  • Release event: 3
  • Issues event: 1
  • Watch event: 3
  • Issue comment event: 1
  • Push event: 13

Committers

Last synced: 9 months ago

All Time
  • Total Commits: 258
  • Total Committers: 2
  • Avg Commits per committer: 129.0
  • Development Distribution Score (DDS): 0.004
Past Year
  • Commits: 26
  • Committers: 1
  • Avg Commits per committer: 26.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
erdogant e****t@g****m 257
Matt Payne 1****e 1

Issues and Pull Requests

Last synced: 9 months ago

All Time
  • Total issues: 10
  • Total pull requests: 1
  • Average time to close issues: 3 months
  • Average time to close pull requests: about 3 hours
  • Total issue authors: 10
  • Total pull request authors: 1
  • Average comments per issue: 1.8
  • Average comments per pull request: 1.0
  • Merged pull requests: 1
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 1
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 1
  • Pull request authors: 0
  • Average comments per issue: 1.0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • naty88 (1)
  • Tyrannas (1)
  • Michael-E-Rose (1)
  • junefeld (1)
  • nitinvinayak (1)
  • toopazo (1)
  • LaiaBigFish (1)
  • programmer2710 (1)
  • ydennisy (1)
  • Jainu-s (1)
Pull Request Authors
  • Matthew-J-Payne (1)
Top Labels
Issue Labels
Pull Request Labels

Dependencies

docs/source/requirements.txt pypi
  • pipinstallsphinx_rtd_theme *
requirements-dev.txt pypi
  • pytest * development
  • rst2pdf * development
  • sphinx * development
  • sphinx_rtd_theme * development
  • spyder-kernels ==2.2. development
requirements.txt pypi
  • hdbscan *
  • matplotlib *
  • numpy *
  • pandas *
  • pypickle *
  • seaborn *
  • sklearn *
  • tqdm *
  • wget *
setup.py pypi
  • matplotlib *
  • numpy *
  • pandas *
  • pypickle *
  • seaborn *
  • sklearn *
  • tqdm *
  • wget *
.github/workflows/codeql-analysis.yml actions
  • actions/checkout v2 composite
  • github/codeql-action/analyze v1 composite
  • github/codeql-action/autobuild v1 composite
  • github/codeql-action/init v1 composite
.github/workflows/pytest.yml actions
  • actions/checkout v2 composite
  • conda-incubator/setup-miniconda v2 composite