Giters

hussainashiqktk / K-mean-clusterer

Python-based K-means clustering algorithm with GUI for data mining course project. User inputs points & initial centroids (optional) to output clusters with graphical representation. Utilizes Tkinter & NumPy libraries. MIT License. Contributions welcome.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

K-Means-Clusterer 👨‍💻

A Python-based K-means clustering algorithm with a Graphical User Interface (GUI) that can cluster a set of points into clusters using the K-means algorithm. The application allows users to input a set of points and initial centroids (optional) and outputs the clusters of points with a graphical representation of the points in a 2D XY plan with circled clusters in red.

Usage

  1. Clone the repository:
git clone https://github.com/<username>/<repository>.git
  1. Install the required dependencies:
pip install -r requirements.txt
  1. Run the application:
python kmeans.py

  1. Input the points and initial centroids (if any) in the GUI and click on the "Cluster" button.

  2. The clusters of points will be displayed with a graphical representation of the points in a 2D XY plan with circled clusters in red.

Screenshots

Screenshot 1

Screenshot 2

Technologies Used

  • Python 3.9
  • Tkinter for GUI
  • NumPy for mathematical computations

Project Structure

.
├── kmeans.py          # Main application file
├── README.md          # Project README file
├── requirements.txt   # Required dependencies
└── screenshots        # Screenshots directory
    ├── screenshot1.png
    └── screenshot2.png

Contributions

Contributions are always welcome! Please feel free to raise an issue or submit a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for more information.

Acknowledgements

👨‍💻 Developed by Hussain Ashiq Khattak

About

Python-based K-means clustering algorithm with GUI for data mining course project. User inputs points & initial centroids (optional) to output clusters with graphical representation. Utilizes Tkinter & NumPy libraries. MIT License. Contributions welcome.