https://github.com/abdellatif-laghjaj/icosphere
Interactive spherical icosahedron
https://github.com/abdellatif-laghjaj/icosphere
icosahedron spherical-geometry
Last synced: 16 days ago
JSON representation
Interactive spherical icosahedron
- Host: GitHub
- URL: https://github.com/abdellatif-laghjaj/icosphere
- Owner: abdellatif-laghjaj
- Created: 2024-06-28T19:16:13.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-06-30T00:57:28.000Z (over 1 year ago)
- Last Synced: 2025-03-01T18:53:35.414Z (8 months ago)
- Topics: icosahedron, spherical-geometry
- Language: Jupyter Notebook
- Homepage: https://interactive-spherical-icosahedron.streamlit.app/
- Size: 8.9 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Interactive Spherical Icosahedron
## Overview
Welcome to the Interactive Spherical Icosahedron project! This application allows you to visualize and interact with an
icosahedron on a unit sphere. With this tool, you can select and subdivide triangles to explore finer details of the
icosahedron.
## Features
- **Interactive Visualization**: Rotate and zoom into the icosahedron using your mouse.
- **Triangle Subdivision**: Select any triangle and subdivide it into four smaller triangles.
- **Dynamic Updates**: The visualization updates dynamically with each subdivision, providing an engaging user
experience.
## Demo
Check out the live demo of the application [here](URL_to_your_demo).
## Installation
To get started with the Interactive Spherical Icosahedron, follow these steps:
1. **Clone the repository**:
```sh
git clone https://github.com/abdellatif-laghjaj/icosphere.git
cd icosphere
```
2. **Install the required dependencies**:
```sh
pip install -r requirements.txt
```
3. **Run the application**:
```sh
streamlit run app.py
```
## Usage
Upon running the application, you will see a sidebar with options to select a triangle and subdivide it. The icosahedron
will be displayed in the main area, and you can interact with it using your mouse.
## Technologies Used
- **[Streamlit](https://streamlit.io/)**: For creating the web application.
- **[Plotly](https://plotly.com/python/)**: For creating interactive 3D visualizations.
- **[NumPy](https://numpy.org/)**: For numerical computations.
## Contributing
Contributions are welcome! If you have any ideas or suggestions to improve this project, feel free to open an issue or
create a pull request.
1. **Fork the repository**
2. **Create a new branch**
```sh
git checkout -b feature/YourFeatureName
```
3. **Commit your changes**
```sh
git commit -m 'Add some feature'
```
4. **Push to the branch**
```sh
git push origin feature/YourFeatureName
```
5. **Open a pull request**
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.
## Acknowledgements
This application was created with significant effort by [Abdellatif Laghjaj](https://github.com/abdellatif-laghjaj/).
Special thanks to all contributors and the open-source community.
## Contact
If you have any questions or suggestions, feel free to reach out to me at:
- GitHub: [abdellatif-laghjaj](https://github.com/abdellatif-laghjaj/)
- Email: abdelatiflaghjaj@gmail.com
Thank you for using the Interactive Spherical Icosahedron!