🚧 Implement continous simulation

2026-10-04 14:50:57 +02:00
parent eb36a2d947
commit 263afc9c1e
13 changed files with 1914 additions and 42 deletions
@@ -0,0 +1,59 @@
+# Example CONTINUOUS (soak) scenario — pump station endurance run.
+#
+# Demonstrates spec §8: long-duration simulation driven by a CSV
+# inflow dataset IN PARALLEL with logic, degradation, invariants and
+# snapshots. Run:
+#
+#   wago-sim run --node config/pump_node.yaml \
+#                --scenario scenarios/pump_soak.yaml \
+#                --report-jsonl out/pump_soak.jsonl
+
+name: pump_soak_8h
+description: "8-hour soak: diurnal inflow, pump wear, level bounds"
+
+mode: continuous
+until: 8h                     # run length (sim time)
+
+# datasets: inflow demand replayed from a historian export (optional;
+# logic-only runs are equally valid — see FR-8.2.13)
+datasets:
+  inflow:
+    file: data/inflow_day.csv
+    interpolation: linear
+    repeat: 1
+
+# aliases (per-type addressing per FR-4.3.11 v1.5)
+inputs:
+  tank_level:  { type: ai, module: 0, channel: 0, scale: 0.1 }   # AI0.0
+  inflow_cmd:  { type: ai, module: 0, channel: 1, scale: 1.0 }  # AI0.1
+
+outputs:
+  pump_relay:  { type: do, module: 0, channel: 0 }              # DO0.0
+
+# aging plant: capacity decays with pump runtime; maintenance alarm
+# expected from the PLC when capacity drops below 75 %
+degradation:
+  pump_capacity:
+    observes: pump_relay
+    model: linear
+    rate: 0.01          # -1% capacity per runtime hour
+    from: 1.0
+    maintenance_at: 0.75
+    diagnosis: { module: 0, channel: 0, value: 0x0001 }
+
+# every-tick conditions; breaches fail the run as bounded episodes
+invariants:
+  - { alias: tank_level, condition: '>= 0',  label: level_floor }
+  - { alias: tank_level, condition: '<= 9000', label: level_brim }
+
+rate_limits:
+  - { alias: tank_level, max_per_hour: 5000 }   # level may not race
+
+snapshot_every: 30m           # periodic state dumps for the report
+
+# scheduled discrete events interleave with the datasets (FR-8.4.6)
+sequence:
+  - at: 4h
+    report: PASS              # mid-run milestone check
+  - at: 7h
+    maintenance_reset: true    # service the pump: capacity restored