Skip to content

abdellatif-laghjaj/icosphere

Repository files navigation

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.

Installation

To get started with the Interactive Spherical Icosahedron, follow these steps:

  1. Clone the repository:

    git clone https://github.com/abdellatif-laghjaj/icosphere.git
    cd icosphere
  2. Install the required dependencies:

    pip install -r requirements.txt
  3. Run the application:

    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: For creating the web application.
  • Plotly: For creating interactive 3D visualizations.
  • NumPy: 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
    git checkout -b feature/YourFeatureName
  3. Commit your changes
    git commit -m 'Add some feature'
  4. Push to the branch
    git push origin feature/YourFeatureName
  5. Open a pull request

License

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

Acknowledgements

This application was created with significant effort by 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:

Thank you for using the Interactive Spherical Icosahedron!