3D Machine Learning Visualizer

Project Overview

The 3D Machine Learning Visualizer is an educational tool designed to demystify the inner workings of various machine learning algorithms through interactive 3D visualizations. Using Three.js, this project allows users to explore and interact with different algorithms, including DBSCAN, SVM, K-Means, KNN, and Decision Trees, to gain a deeper understanding of their mechanics and applications.

Features

• Interactive 3D Visualizations: Each algorithm is represented through a unique and dynamic 3D scene.
• Real-time Algorithm Parameter Adjustments: Users can modify algorithm parameters on-the-fly to see how changes affect the outcome.
• Multiple Algorithm Support: Visualize and learn about different machine learning algorithms in one platform.
• Educational Tool: Ideal for students, educators, or anyone curious about machine learning.

Here’s what each part of the chart represents:

• User: The starting point where the user interacts with the application.
• Dropdown Menu: The UI element allowing the user to select which algorithm visualization to view.
• 3D Visualization Scene: Acts as a decision node based on the selected algorithm.
• Algorithm Visualization: Individual visualization components for each algorithm.
• Adjust Parameters: Represents the user's ability to adjust algorithm parameters.
• View Updated Visualization: The result of parameter adjustments reflecting on the visualization.

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

Prerequisites

• Node.js
• NPM (Node Package Manager)

Installation

1. Clone the repo

   git clone https://github.com/yourusername/3d-ml-visualizer.git
   

2. Navigate to the project directory

   cd 3d-ml-visualizer
   

3. Install NPM packages

   npm install
   

4. Run the development server

   npm run start
   

5. Open your browser and navigate to http://localhost:1234 (or the port provided in your terminal)

Usage

Select an algorithm from the dropdown menu to view its 3D visualization. Use the UI controls to adjust parameters and interact with the visualization in real-time.

Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Acknowledgements

• Three.js
• Hong Kong Baptist University - Department of Computer Science
• Dr. CHEN, Jie - Assistant Professor
• Baiel Muzuraimov - Contributor
• Mak Tsun Ho - Contributor