Files
pumpingStation/wiki
znetsixe 3e13512a83 Rename eval/ → simulations/ and fix log-write bug
Per discussion: "test" and "eval" overlap in meaning; "simulations"
is more honest about what's actually happening — scripted plant
inputs driving a physics sim, then recorded for analysis.

Rename scope:
- eval/ → simulations/ (tracked as git renames)
- Internal references in run.js and README.md updated
- wiki/modes/mpc.md link updated

Also fixes a log-write bug noticed during the rename:
- run.js didn't mkdir simulations/logs/ before createWriteStream,
  so the stream opened into a potentially non-existent dir and the
  file never materialised. Added fs.mkdirSync(..., recursive:true).
- end() wasn't awaited, so the process could exit before the stream
  flushed. Now awaits the 'finish' event. Confirmed: 1200 records
  actually land in simulations/logs/<scenario>.jsonl.
- Added simulations/logs/.gitignore so future JSONL artefacts stay
  out of the repo but the dir remains tracked.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-22 17:46:10 +02:00
..

pumpingStation — Documentation

All docs and diagrams for this node live in this folder so they version-lock with the code they describe.

Pages

  • Functional Description — operator-facing reference derived from src/specificClass.js: basin model, net-flow selection, safety interlocks, registration topology.
  • Control modes — one page per control mode (levelbased, flowbased, …) describing how the mode uses the shared basin model to compute demand.

Diagrams

Editable draw.io sources live in diagrams/. See diagrams/README.md for the editing workflow — open .drawio files in draw.io, export to .drawio.svg, commit both.

The basin model is the shared canvas (diagrams/basin-model.drawio.svg); per-mode transfer-function diagrams live under diagrams/modes/.

Part of

This node is a git submodule of EVOLV. The EVOLV superproject has its own wiki/ with platform-level docs (architecture, concepts, shared manuals).