Skip to content

README.md

Latest commit

 

History

History
56 lines (35 loc) · 1.81 KB

README.md

File metadata and controls

56 lines (35 loc) · 1.81 KB
Raw

Wave Simulation – README

Overview

Interactive 2-D wave simulator built in HTML, CSS, and JavaScript. Users can create, edit, and animate wave sources, adjust medium properties, and observe interference patterns in real time.

Features

  • Realistic Physics toggle

    • Switch between exponential decay with user-controlled damping and geometric decay for physically accurate 2-D spreading.

  • Medium Properties panel

    • Animation speed, damping (hidden in realistic mode), resolution, and color mode controls.

  • Pattern Generator panel

    • Tools to create preset or custom source patterns.

  • Edit Points panel

    • Add, move, or delete individual wave sources.

  • Floating toggle buttons

    • Grid and Points visibility controls with active/inactive color states, always visible above the Clear and Sync buttons.

  • Responsive UI

    • Panels and floating controls adapt to desktop and mobile layouts.

Usage

  1. Open index.html in a modern browser.

  2. Use floating buttons to show or hide the grid or source points.

  3. Navigate through the three panels to:

    • Adjust medium parameters and enable Realistic Physics.
    • Generate wave patterns.
    • Edit source points manually.

  4. Clear or sync the simulation at any time using the floating utility buttons.

Technical Notes

  • Wave computation is handled in WaveEngine, which calculates pixel values using either exponential or geometric decay.
  • UI state is managed by UIController, which updates engine parameters and handles floating button states.
  • No external dependencies; runs entirely client-side.

Browser Support

Tested on recent versions of Chrome, Firefox, Edge, and Safari.

License

MIT License – see LICENSE for details.

Contributing

Fork the repository and submit pull requests with clear descriptions of changes.