A standalone mechanics laboratory for learning, testing, visualizing, validating, freezing, and revisiting the belt mechanics that may later inform CINDER v2.
This repository is not CINDER v2. It is the evidence-building environment used to decide what CINDER v2 should eventually contain.
- Manifest-driven roadmap/homepage covering:
- Belt Continuum: 1D -> 2D -> 3D
- Cross-Section Laboratory: CS-A -> CS-D (provisional)
- Contact & Integration studies
- Retained Evidence studies
- Headless mechanics package, separate from the web UI.
- Provenance-aware materials library.
- Saved canonical demo configurations plus simple local user setups.
- Persistent run directories containing exact configuration, result data, summaries, and provenance snapshots.
- A small real 1D linear-elastic rod demo to exercise the complete study -> runner -> persistence -> UI path. It is a framework exercise, not the finished 1D milestone.
- Automated tests for registry integrity, materials, mechanics, persistence, and web routing.
python -m venv .venv
# Windows: .venv\\Scripts\\activate
# macOS/Linux: source .venv/bin/activate
pip install -e ".[dev]"
pytest
python app.pyThen open http://127.0.0.1:8080.
.\scripts\setup.ps1
.\scripts\test.ps1
.\scripts\run.ps1Set BELTBAY_PORT before launching if port 8080 is already occupied.
mechanics/ owns physics and numerical kernels. It has no UI imports.
studies/ owns research intent: manifests, demos, runner selection, questions, planned evidence, and status.
ui/ only exposes those studies through a local web application.
materials/ is a shared provenance-aware input library.
See docs/reference/ for the current North Star and Research Bay framework documents.