Simulation Architecture#

Software architecture of the simulation orchestration layer in ``hydromodpy.simulation``. The public entry point is the ``Project`` facade in ``hydromodpy/project/facade.py``, instantiated by ``hmp run`` or by user Python code.

Use this section when you want the static orchestration model, the execution-time cycle inside the simulation layer, or a code-oriented walkthrough from TOML to solver outputs.

Pages#

TOML to solver walkthrough

Step-by-step trace of a TOML config from parsing through planner expansion, runner dispatch, and solver invocation.

TOML To Solver Walkthrough
Orchestration class diagram

Static UML view of the planner, runner, adapter, and Project facade relationships.

Simulation Orchestration Class Diagram
Time-cycle diagrams

Execution-time sequence diagrams for steady and transient runs, including checkpointing.

Simulation Time Cycle Diagrams
Comparison workflow internals

Code orchestration behind [workflow].mode = "comparison": child-config generation, audit logic, observable extraction.

Comparison Workflow Architecture
Testbed workflow architecture

Variant matrix expansion, child runner delegation, and the evidence-gathering contract used by mesh and flow testbeds.

Testbed Workflow Architecture