3D Simulation of Self-Healing Materials

👉 Try it here: Live Demo

This repository showcases a 3D simulation of self-healing materials, built using React Three Fiber, to visually represent how molecular bonds break and heal over time. The simulation offers an engaging way to explore the concept of self-healing at a molecular level.

Inspired by our real-world project on self-healing materials, this tool demonstrates the dynamic process behind materials capable of repairing themselves after sustaining damage.

---

🌟 Features of the Simulation

• Dynamic Hexagonal Grid:
  A 3D representation of hexagonal molecules where bonds randomly break and gradually heal.
• Customizable Settings:
  • Grid dimensions (height, width, depth).
  • Speed of camera movement and animation.
  • Duration for breaking and healing bonds.
  • Percentage of bonds that break.
  • Camera instability for dramatic effects.
  • Size of the hexagonal molecules.
• Smooth Animations:
  The simulation is visually appealing, with seamless animations for bond-breaking and healing.

---

🔬 About the Real-World Project

This simulation is inspired by our hands-on research on self-healing materials.

• What are Self-Healing Materials?
  These materials mimic biological healing systems, enabling them to autonomously repair micro-damage.
• Applications:
  They have potential uses in aerospace, construction, electronics, and more, offering enhanced durability and reduced maintenance.
• Our Contribution:
  As part of our project, we developed a prototype demonstrating self-healing properties in controlled environments, and this simulation serves as a visualization of that concept.

---

🛠️ How to Use

Explore the Live Simulation:

1. Visit the Live Demo.
2. Interact with the 3D grid using your mouse to rotate and zoom.
3. Watch the bonds as they break and heal dynamically.

Customize the Parameters:

Adjust the following to experiment with different behaviors:

• Grid Dimensions: Modify the height, width, and depth.
• Movement Speed: Control how fast the camera moves.
• Healing/Breaking Duration: Set how quickly bonds heal or break.
• Breaking Percentage: Define the fraction of bonds breaking.
• Camera Instability: Toggle dramatic or stable camera effects.

---

🖥️ Running the Simulation Locally

1. Clone the repository:

   git clone https://github.com/Amjuks/3D-Self-Healing-Compound-Simulation
   cd "3D-Self-Healing-Compound-Simulation"

2. Install dependencies:

   npm install

3. Start the development server:

   npm run dev

4. Open the simulation in your browser at http://localhost:5173.

---

📦 Technologies Used

• React Three Fiber: React renderer for Three.js to manage the 3D environment.
• Three.js: The core library for creating and animating the 3D simulation.
• React.js: The framework powering the user interface and interactions.

---

🎯 Goals of the Simulation

The simulation aims to provide an engaging, interactive visualization of the self-healing process, complementing the real-world material research conducted as part of our project.

---

🙌 Credits

This project was developed as part of the Self-Healing Materials research by the Regen Squad at RV College of Engineering. Special thanks to my team and mentors for their invaluable support and guidance.

---

📬 Feedback

Have feedback or suggestions? Feel free to open an issue or reach out!

---

📄 License

This project is open-source and available under the MIT License.