Wave Flow Simulation

This project simulates flowing line art with Pygame and Box2D.

Project Layout

src/
  waveflow_app.py             Main STL-based simulation app.
  lineart_properties_ui.py    PyQt properties-window prototype.

tools/
  inspect_stl.py              Plot an STL-style streamline file.
  inspect_txt_streamlines.py  Plot parsed Vertex text data.
  parse_owl_stl.py            Convert an owl trial STL into parsed text.

data/
  samples/                    Small active STL/TXT inputs for development.
  svg/                        Source SVG references.
  trials/                     Larger trial data and tensors.

outputs/
  legacy_frame_sets/          Previous generated frame exports.
  generated_frames/           New app exports; ignored by git.

archive/
  python_experiments/         Older script versions.
  demos/                      Unrelated demos.
  utility_scripts/            One-off utility scripts.

docs/
  memo.txt                    Original notes.

Run

python src/waveflow_app.py

The app loads STL files from data/samples/ and writes new exports to outputs/generated_frames/.

Dependencies

Install the Python packages listed in requirements.txt.