This is the package for DenMune Clustering Algorithm published in paper https://doi.org/10.1016/j.patcog.2020.107589
Project description
DenMune: A density-peak clustering algorithm
DenMune a clustering algorithm that can find clusters of arbitrary size, shapes and densities in two-dimensions. Higher dimensions are first reduced to 2-D using the t-sne. The algorithm relies on a single parameter K (the number of nearest neighbors). The results show the superiority of the algorithm. Enjoy the simplicity but the power of DenMune.
Based on the paper
Mohamed Abbas, Adel El-Zoghabi, Amin Ahoukry, DenMune: Density peak based clustering using mutual nearest neighbors In: Journal of Pattern Recognition, Elsevier, volume 109, number 107589, January 2021
Documentation:
Documentation, including tutorials, are available on ReadTheDocs at https://denmune-docs.readthedocs.io/en/latest/.
Watch it in action
This 30 seconds will tell you how a density-baased algorithm, DenMune propagates
How to install DenMune
Simply install DenMune clustering algorithm using pip command from the official Python repository
from the shell run the command
pip install denmune
from jupyter notebook cell run the command
!pip install denmune
How to use DenMune
Once DenMune is installed, you just need to import it
from denmune import DenMune # Please note that first denmune (the package) in small letters, while the other one(the class itself) has D and M in capital case.
How to run and test
-
Launch Examples in Repo2Dpcker Binder
Simply use our repo2docker offered by mybinder.org, which encapsulate the algorithm and all required data in one virtual machine instance. All jupter notebooks examples found in this repository will be also available to you in action to practice in this respo2docer. Thanks mybinder.org, you made it possible!
-
Launch each Example in Google Research, CoLab
Need to test examples one by one, then here another option. Use colab offered by google research to test each example individually.
Here is a list of Google CoLab URL to use the algorithm interactively:
Citing
If you have used this codebase in a scientific publication and wish to cite it, please use the Journal of Pattern Recognition article.
Mohamed Abbas McInnes, Adel El-Zoghaby, Amin Ahoukry, DenMune: Density peak based clustering using mutual nearest neighbors In: Journal of Pattern Recognition, Elsevier, volume 109, number 107589. January 2021
@article{ABBAS2021107589,
title = {DenMune: Density peak based clustering using mutual nearest neighbors},
journal = {Pattern Recognition},
volume = {109},
pages = {107589},
year = {2021},
issn = {0031-3203},
doi = {https://doi.org/10.1016/j.patcog.2020.107589},
url = {https://www.sciencedirect.com/science/article/pii/S0031320320303927},
author = {Mohamed Abbas and Adel El-Zoghabi and Amin Shoukry},
keywords = {Clustering, Mutual neighbors, Dimensionality reduction, Arbitrary shapes, Pattern recognition, Nearest neighbors, Density peak}
}
Licensing
The DenMune algorithm is 3-clause BSD licensed. Enjoy.
Task List
- [x] Update Github with the DenMune sourcode
- [x] create repo2docker repository
- [x] Create pip Package
- [x] create colab shared examples
- [x] create documentation
- [ ] create conda package
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for denmune-0.0.5.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3586e6fcacc67980ef47bb7536a94585a3941e71ac1183c910532e0a7fdae65f |
|
MD5 | 5c631347241b0ada4424725a490de39a |
|
BLAKE2b-256 | 4c7497c29ab2d492039cffdb1b832e47799eb6e5e340bd4224f238d93951ce29 |