P11.6 wiki regen + Phase 10 private-test rewrites where applicable

For all 11 nodes with auto-gen markers: wiki/Home.md sections 5 (topic
contract) and 9 (data model) regenerated via npm run wiki:all. New
Unit column shows '<measure> (default <unit>)' for declared topics,
'—' otherwise. Effect column now uses descriptor.description (P11.2
field) overriding the generic per-prefix fallback.

For rotatingMachine + reactor: Phase 10 test rewrites — 3 + 8 files
moved off private nodeClass internals (_attachInputHandler, _commands,
_pendingExtras, _registerChild, _tick, etc.) to the public
BaseNodeAdapter surface (node.handlers.input, node.source.*).
+6 / +7 net new tests.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

CLAUDE.md

@@ -0,0 +1,23 @@
+# monster — Claude Code context
+
+Multi-parameter biological process monitoring.
+Part of the [EVOLV](https://gitea.wbd-rd.nl/RnD/EVOLV) wastewater-automation platform.
+
+## S88 classification
+
+| Level | Colour | Placement lane |
+|---|---|---|
+| **Unit** | `#50a8d9` | L4 |
+
+## Flow layout rules
+
+When wiring this node into a multi-node demo or production flow, follow the
+placement rule set in the **EVOLV superproject**:
+
+> `.claude/rules/node-red-flow-layout.md` (in the EVOLV repo root)
+
+Key points for this node:
+- Place on lane **L4** (x-position per the lane table in the rule).
+- Stack same-level siblings vertically.
+- Parent/children sit on adjacent lanes (children one lane left, parent one lane right).
+- Wrap in a Node-RED group box coloured `#50a8d9` (Unit).

CONTRACT.md

@@ -0,0 +1,49 @@
+# monster — Contract
+
+Hand-maintained for Phase 6; the `## Inputs` table is generated from
+`src/commands/index.js` (see Phase 9 generator). Keep ≤ 80 lines.
+
+## Inputs (msg.topic on Port 0)
+
+| Canonical | Aliases (deprecated) | Payload | Effect |
+|---|---|---|---|
+| `cmd.start` | `i_start` | truthy/falsy | Sets `source.i_start`. On the next tick a sampling run begins if flow bounds validate. |
+| `set.schedule` | `monsternametijden` | array of AQUON rows (`SAMPLE_NAME`, `DESCRIPTION`, `SAMPLED_DATE`, `START_DATE`, `END_DATE`) | Stores the schedule and recomputes `nextDate` + `daysPerYear` for the configured `aquonSampleName`. |
+| `set.rain` | `rain_data` | per-location rain forecast (Open-Meteo shape) | Aggregates hourly precipitation into `sumRain` / `avgRain`; feeds the rain-scaled flow prediction. |
+| `data.flow` | `input_q` | `{ value: number, unit: string }` | Converts to m³/h and pushes into `flow.manual.atequipment`. Blends with measured-child flow in `getEffectiveFlow()`. |
+| `set.mode` | `setMode` | string | Delegated to `source.setMode()` if defined. Reserved for future use. |
+| `set.model-prediction` | `model_prediction` | numeric | Delegated to `source.setModelPrediction()` if defined. Reserved for future use. |
+
+Aliases log a one-time deprecation warning the first time they fire.
+
+## Outputs (msg.topic on Port 0/1/2)
+
+- **Port 0 (process):** `msg.topic = config.general.name`. Payload built
+  by `outputUtils.formatMsg(..., 'process')` from `getOutput()`. Delta-
+  compressed — only changed fields are emitted. Carries `pulse`, `running`,
+  `bucketVol`, `sumPuls`, `predFlow`, `m3PerPuls`, `q`, `timeLeft`,
+  `targetVolumeM3`, `targetProgressPct`, `targetDeltaL`, `predictedRateM3h`,
+  `sumRain`, `avgRain`, `nextDate`, plus the flat measurements snapshot.
+- **Port 1 (InfluxDB telemetry):** same shape as Port 0, formatted with the
+  `'influxdb'` formatter.
+- **Port 2 (registration):** at startup the node sends one
+  `{ topic: 'child.register', payload: <node.id>, positionVsParent, distance }`
+  to its parent.
+
+## Events emitted by `source.measurements.emitter`
+
+The `MeasurementContainer` fires `<type>.measured.<position>` whenever a
+matching series receives a new value. monster writes:
+
+- `flow.manual.atequipment` — operator-supplied manual flow.
+- `flow.measured.<position>` — re-emitted when a child measurement fires
+  (one of `flow.measured.upstream`, `flow.measured.downstream`,
+  `flow.measured.atequipment`).
+
+## Children accepted
+
+`measurement` only. The router subscribes to a child's
+`flow.measured.<position>` events when the child's `config.asset.type` is
+`'flow'` (or missing). Other asset types are ignored. monster has no
+position-based filtering — all three positions are wired and the latest
+value wins for each.

README.md

@@ -1,3 +1,13 @@
-# convert
+# monster
 
-Makes unit conversions
+Monsternamekast control node for EVOLV.
+
+Primary responsibilities:
+- combine measured/manual flow, rain context and schedule context
+- predict sampling demand and pulse distribution over sampling window
+- enforce bucket/sampling constraints (volume, weight, cooldown)
+- emit process fields used by PLC pulse output, report tooling (e.g. Z-Info), and dashboards
+
+Examples:
+- `nodes/monster/examples/monster-dashboard.flow.json` (dashboard-ready visualization flow)
+- `nodes/monster/examples/monster-api-dashboard.flow.json` (full API orchestration template with placeholder credentials)

config/exampleArray.js

@@ -1,870 +0,0 @@
-const inputExample = 
-//tensor 1
-[
-  // 1 prediction per hour
-  [
-  // 24 window size
-    [
-      //166 features of which the first feature is the hour of the day all the other values are precipation values 
-      //These values are meaningless they need to be translated first into the correct format
-      //How do the transformations work?
-      -0.65066296, -0.1888816, -0.19213369, -0.19328518, -0.18170043,
-      -0.18223418, -0.18370405, -0.18517574, -0.18551063, -0.18683789,
-      -0.18886069, -0.18927826, -0.18696358, -0.17307445, -0.17702805,
-      -0.17851964, -0.17654074, -0.17762018, -0.1796983, -0.18136519,
-      -0.18139249, -0.18250296, -0.18198996, -0.18138494, -0.18618596,
-      -0.1889744, -0.18739212, -0.17126027, -0.17405689, -0.1762726,
-      -0.18029169, -0.1885969, -0.18849469, -0.19095787, -0.18038477,
-      -0.18214581, -0.18189491, -0.18189534, -0.18381298, -0.18393834,
-      -0.18939162, -0.17176759, -0.17026471, -0.17394295, -0.17903634,
-      -0.19020126, -0.18912097, -0.18823564, -0.17929266, -0.18775292,
-      -0.18869072, -0.18756475, -0.18702924, -0.18671379, -0.17348625,
-      -0.18026013, -0.1814532, -0.18132141, -0.18308498, -0.18331088,
-      -0.18624909, -0.18811531, -0.19032778, -0.18967649, -0.18800643,
-      -0.18892376, -0.18933033, -0.18079819, -0.18595871, -0.18796106,
-      -0.18773453, -0.19043156, -0.1891853, -0.18971276, -0.18899542,
-      -0.18666336, -0.1879662, -0.18708836, -0.1893528, -0.18959058,
-      -0.18611566, -0.19272971, -0.19552121, -0.19478238, -0.19681337,
-      -0.19944471, -0.19903339, -0.19263975, -0.18716142, -0.1877408,
-      -0.18708849, -0.18419774, -0.18278112, -0.18275773, -0.19600511,
-      -0.19538267, -0.19162537, -0.192591, -0.19787251, -0.19998388,
-      -0.19278597, -0.18786678, -0.18582166, -0.18569262, -0.18191596,
-      -0.18098748, -0.18121272, -0.19626444, -0.19792468, -0.19207762,
-      -0.18952964, -0.19189596, -0.19348373, -0.19015691, -0.1844006,
-      -0.18490676, -0.18425256, -0.18282198, -0.18047893, -0.17963261,
-      -0.19567896, -0.19192091, -0.18874464, -0.18849974, -0.1898807,
-      -0.18982206, -0.1882855, -0.19054112, -0.18959366, -0.18676196,
-      -0.18424004, -0.18355161, -0.18516647, -0.19370953, -0.19216638,
-      -0.19084519, -0.18945748, -0.1898998, -0.18970484, -0.18697297,
-      -0.1889949, -0.19083625, -0.19014625, -0.19090196, -0.19471276,
-      -0.19409975, -0.1935458, -0.19110129, -0.18852621, -0.1896783,
-      -0.19012038, -0.18907574, -0.19738469, -0.19826875, -0.19619434,
-      -0.19351482, -0.19247084, -0.19158516, -0.18882761, -0.19663896,
-      -0.19387078, -0.19137178, -0.19101838, -0.18902259, -0.18740881,
-      -0.18577042,
-    ],
-    [
-      -0.50620914, -0.1888816, -0.19213369, -0.19328518, -0.18170043,
-      -0.18223418, -0.18370405, -0.18517574, -0.18551063, -0.18683789,
-      -0.18886069, -0.18927826, -0.18696358, -0.17307445, -0.17702805,
-      -0.17851964, -0.17654074, -0.17762018, -0.1796983, -0.18136519,
-      -0.18139249, -0.18250296, -0.18198996, -0.18138494, -0.18618596,
-      -0.1889744, -0.18739212, -0.17126027, -0.17405689, -0.1762726,
-      -0.18029169, -0.1885969, -0.18849469, -0.19095787, -0.18038477,
-      -0.18214581, -0.18189491, -0.18189534, -0.18381298, -0.18393834,
-      -0.18939162, -0.17176759, -0.17026471, -0.17394295, -0.17903634,
-      -0.19020126, -0.18912097, -0.18823564, -0.17929266, -0.18775292,
-      -0.18869072, -0.18756475, -0.18702924, -0.18671379, -0.17348625,
-      -0.18026013, -0.1814532, -0.18132141, -0.18308498, -0.18331088,
-      -0.18624909, -0.18811531, -0.19032778, -0.18967649, -0.18800643,
-      -0.18892376, -0.18933033, -0.18079819, -0.18595871, -0.18796106,
-      -0.18773453, -0.19043156, -0.1891853, -0.18971276, -0.18899542,
-      -0.18666336, -0.1879662, -0.18708836, -0.1893528, -0.18959058,
-      -0.18611566, -0.19272971, -0.19552121, -0.19478238, -0.19681337,
-      -0.19944471, -0.19903339, -0.19263975, -0.18716142, -0.1877408,
-      -0.18708849, -0.18419774, -0.18278112, -0.18275773, -0.19600511,
-      -0.19538267, -0.19162537, -0.192591, -0.19787251, -0.19998388,
-      -0.19278597, -0.18786678, -0.18582166, -0.18569262, -0.18191596,
-      -0.18098748, -0.18121272, -0.19626444, -0.19792468, -0.19207762,
-      -0.18952964, -0.19189596, -0.19348373, -0.19015691, -0.1844006,
-      -0.18490676, -0.18425256, -0.18282198, -0.18047893, -0.17963261,
-      -0.19567896, -0.19192091, -0.18874464, -0.18849974, -0.1898807,
-      -0.18982206, -0.1882855, -0.19054112, -0.18959366, -0.18676196,
-      -0.18424004, -0.18355161, -0.18516647, -0.19370953, -0.19216638,
-      -0.19084519, -0.18945748, -0.1898998, -0.18970484, -0.18697297,
-      -0.1889949, -0.19083625, -0.19014625, -0.19090196, -0.19471276,
-      -0.19409975, -0.1935458, -0.19110129, -0.18852621, -0.1896783,
-      -0.19012038, -0.18907574, -0.19738469, -0.19826875, -0.19619434,
-      -0.19351482, -0.19247084, -0.19158516, -0.18882761, -0.19663896,
-      -0.19387078, -0.19137178, -0.19101838, -0.18902259, -0.18740881,
-      -0.18577042,
-    ],
-    [
-      -0.36175531, -0.1888816, -0.19213369, -0.19328518, -0.18170043,
-      -0.18223418, -0.18370405, -0.18517574, -0.18551063, -0.18683789,
-      -0.18886069, -0.18927826, -0.18696358, -0.17307445, -0.17702805,
-      -0.17851964, -0.17654074, -0.17762018, -0.1796983, -0.18136519,
-      -0.18139249, -0.18250296, -0.18198996, -0.18138494, -0.18618596,
-      -0.1889744, -0.18739212, -0.17126027, -0.17405689, -0.1762726,
-      -0.18029169, -0.1885969, -0.18849469, -0.19095787, -0.18038477,
-      -0.18214581, -0.18189491, -0.18189534, -0.18381298, -0.18393834,
-      -0.18939162, -0.17176759, -0.17026471, -0.17394295, -0.17903634,
-      -0.19020126, -0.18912097, -0.18823564, -0.17929266, -0.18775292,
-      -0.18869072, -0.18756475, -0.18702924, -0.18671379, -0.17348625,
-      -0.18026013, -0.1814532, -0.18132141, -0.18308498, -0.18331088,
-      -0.18624909, -0.18811531, -0.19032778, -0.18967649, -0.18800643,
-      -0.18892376, -0.18933033, -0.18079819, -0.18595871, -0.18796106,
-      -0.18773453, -0.19043156, -0.1891853, -0.18971276, -0.18899542,
-      -0.18666336, -0.1879662, -0.18708836, -0.1893528, -0.18959058,
-      -0.18611566, -0.19272971, -0.19552121, -0.19478238, -0.19681337,
-      -0.19944471, -0.19903339, -0.19263975, -0.18716142, -0.1877408,
-      -0.18708849, -0.18419774, -0.18278112, -0.18275773, -0.19600511,
-      -0.19538267, -0.19162537, -0.192591, -0.19787251, -0.19998388,
-      -0.19278597, -0.18786678, -0.18582166, -0.18569262, -0.18191596,
-      -0.18098748, -0.18121272, -0.19626444, -0.19792468, -0.19207762,
-      -0.18952964, -0.19189596, -0.19348373, -0.19015691, -0.1844006,
-      -0.18490676, -0.18425256, -0.18282198, -0.18047893, -0.17963261,
-      -0.19567896, -0.19192091, -0.18874464, -0.18849974, -0.1898807,
-      -0.18982206, -0.1882855, -0.19054112, -0.18959366, -0.18676196,
-      -0.18424004, -0.18355161, -0.18516647, -0.19370953, -0.19216638,
-      -0.19084519, -0.18945748, -0.1898998, -0.18970484, -0.18697297,
-      -0.1889949, -0.19083625, -0.19014625, -0.19090196, -0.19471276,
-      -0.19409975, -0.1935458, -0.19110129, -0.18852621, -0.1896783,
-      -0.19012038, -0.18907574, -0.19738469, -0.19826875, -0.19619434,
-      -0.19351482, -0.19247084, -0.19158516, -0.18882761, -0.19663896,
-      -0.19387078, -0.19137178, -0.19101838, -0.18902259, -0.18740881,
-      -0.18577042,
-    ],
-    [
-      -0.21730149, -0.1888816, -0.19213369, -0.19328518, -0.18170043,
-      -0.18223418, -0.18370405, -0.18517574, -0.18551063, -0.18683789,
-      -0.18886069, -0.18927826, -0.18696358, -0.17307445, -0.17702805,
-      -0.17851964, -0.17654074, -0.17762018, -0.1796983, -0.18136519,
-      -0.18139249, -0.18250296, -0.18198996, -0.18138494, -0.18618596,
-      -0.1889744, -0.18739212, -0.17126027, -0.17405689, -0.1762726,
-      -0.18029169, -0.1885969, -0.18849469, -0.19095787, -0.18038477,
-      -0.18214581, -0.18189491, -0.18189534, -0.18381298, -0.18393834,
-      -0.18939162, -0.17176759, -0.17026471, -0.17394295, -0.17903634,
-      -0.19020126, -0.18912097, -0.18823564, -0.17929266, -0.18775292,
-      -0.18869072, -0.18756475, -0.18702924, -0.18671379, -0.17348625,
-      -0.18026013, -0.1814532, -0.18132141, -0.18308498, -0.18331088,
-      -0.18624909, -0.18811531, -0.19032778, -0.18967649, -0.18800643,
-      -0.18892376, -0.18933033, -0.18079819, -0.18595871, -0.18796106,
-      -0.18773453, -0.19043156, -0.1891853, -0.18971276, -0.18899542,
-      -0.18666336, -0.1879662, -0.18708836, -0.1893528, -0.18959058,
-      -0.18611566, -0.19272971, -0.19552121, -0.19478238, -0.19681337,
-      -0.19944471, -0.19903339, -0.19263975, -0.18716142, -0.1877408,
-      -0.18708849, -0.18419774, -0.18278112, -0.18275773, -0.19600511,
-      -0.19538267, -0.19162537, -0.192591, -0.19787251, -0.19998388,
-      -0.19278597, -0.18786678, -0.18582166, -0.18569262, -0.18191596,
-      -0.18098748, -0.18121272, -0.19626444, -0.19792468, -0.19207762,
-      -0.18952964, -0.19189596, -0.19348373, -0.19015691, -0.1844006,
-      -0.18490676, -0.18425256, -0.18282198, -0.18047893, -0.17963261,
-      -0.19567896, -0.19192091, -0.18874464, -0.18849974, -0.1898807,
-      -0.18982206, -0.1882855, -0.19054112, -0.18959366, -0.18676196,
-      -0.18424004, -0.18355161, -0.18516647, -0.19370953, -0.19216638,
-      -0.19084519, -0.18945748, -0.1898998, -0.18970484, -0.18697297,
-      -0.1889949, -0.19083625, -0.19014625, -0.19090196, -0.19471276,
-      -0.19409975, -0.1935458, -0.19110129, -0.18852621, -0.1896783,
-      -0.19012038, -0.18907574, -0.19738469, -0.19826875, -0.19619434,
-      -0.19351482, -0.19247084, -0.19158516, -0.18882761, -0.19663896,
-      -0.19387078, -0.19137178, -0.19101838, -0.18902259, -0.18740881,
-      -0.18577042,
-    ],
-    [
-      -0.07284767, -0.1888816, -0.19213369, -0.19328518, -0.18170043,
-      -0.18223418, -0.18370405, -0.18517574, -0.18551063, -0.18683789,
-      -0.18886069, -0.18927826, -0.18696358, -0.17307445, -0.17702805,
-      -0.17851964, -0.17654074, -0.17762018, -0.1796983, -0.18136519,
-      -0.18139249, -0.18250296, -0.18198996, -0.18138494, -0.18618596,
-      -0.1889744, -0.18739212, -0.17126027, -0.17405689, -0.1762726,
-      -0.18029169, -0.1885969, -0.18849469, -0.19095787, -0.18038477,
-      -0.18214581, -0.18189491, -0.18189534, -0.18381298, -0.18393834,
-      -0.18939162, -0.17176759, -0.17026471, -0.17394295, -0.17903634,
-      -0.19020126, -0.18912097, -0.18823564, -0.17929266, -0.18775292,
-      -0.18869072, -0.18756475, -0.18702924, -0.18671379, -0.17348625,
-      -0.18026013, -0.1814532, -0.18132141, -0.18308498, -0.18331088,
-      -0.18624909, -0.18811531, -0.19032778, -0.18967649, -0.18800643,
-      -0.18892376, -0.18933033, -0.18079819, -0.18595871, -0.18796106,
-      -0.18773453, -0.19043156, -0.1891853, -0.18971276, -0.18899542,
-      -0.18666336, -0.1879662, -0.18708836, -0.1893528, -0.18959058,
-      -0.18611566, -0.19272971, -0.19552121, -0.19478238, -0.19681337,
-      -0.19944471, -0.19903339, -0.19263975, -0.18716142, -0.1877408,
-      -0.18708849, -0.18419774, -0.18278112, -0.18275773, -0.19600511,
-      -0.19538267, -0.19162537, -0.192591, -0.19787251, -0.19998388,
-      -0.19278597, -0.18786678, -0.18582166, -0.18569262, -0.18191596,
-      -0.18098748, -0.18121272, -0.19626444, -0.19792468, -0.19207762,
-      -0.18952964, -0.19189596, -0.19348373, -0.19015691, -0.1844006,
-      -0.18490676, -0.18425256, -0.18282198, -0.18047893, -0.17963261,
-      -0.19567896, -0.19192091, -0.18874464, -0.18849974, -0.1898807,
-      -0.18982206, -0.1882855, -0.19054112, -0.18959366, -0.18676196,
-      -0.18424004, -0.18355161, -0.18516647, -0.19370953, -0.19216638,
-      -0.19084519, -0.18945748, -0.1898998, -0.18970484, -0.18697297,
-      -0.1889949, -0.19083625, -0.19014625, -0.19090196, -0.19471276,
-      -0.19409975, -0.1935458, -0.19110129, -0.18852621, -0.1896783,
-      -0.19012038, -0.18907574, -0.19738469, -0.19826875, -0.19619434,
-      -0.19351482, -0.19247084, -0.19158516, -0.18882761, -0.19663896,
-      -0.19387078, -0.19137178, -0.19101838, -0.18902259, -0.18740881,
-      -0.18577042,
-    ],
-    [
-      0.07160615, -0.1888816, -0.19213369, -0.19328518, -0.18170043,
-      -0.18223418, -0.18370405, -0.18517574, -0.18551063, -0.18683789,
-      -0.18886069, -0.18927826, -0.18696358, -0.17307445, -0.17702805,
-      -0.17851964, -0.17654074, -0.17762018, -0.1796983, -0.18136519,
-      -0.18139249, -0.18250296, -0.18198996, -0.18138494, -0.18618596,
-      -0.1889744, -0.18739212, -0.17126027, -0.17405689, -0.1762726,
-      -0.18029169, -0.1885969, -0.18849469, -0.19095787, -0.18038477,
-      -0.18214581, -0.18189491, -0.18189534, -0.18381298, -0.18393834,
-      -0.18939162, -0.17176759, -0.17026471, -0.17394295, -0.17903634,
-      -0.19020126, -0.18912097, -0.18823564, -0.17929266, -0.18775292,
-      -0.18869072, -0.18756475, -0.18702924, -0.18671379, -0.17348625,
-      -0.18026013, -0.1814532, -0.18132141, -0.18308498, -0.18331088,
-      -0.18624909, -0.18811531, -0.19032778, -0.18967649, -0.18800643,
-      -0.18892376, -0.18933033, -0.18079819, -0.18595871, -0.18796106,
-      -0.18773453, -0.19043156, -0.1891853, -0.18971276, -0.18899542,
-      -0.18666336, -0.1879662, -0.18708836, -0.1893528, -0.18959058,
-      -0.18611566, -0.19272971, -0.19552121, -0.19478238, -0.19681337,
-      -0.19944471, -0.19903339, -0.19263975, -0.18716142, -0.1877408,
-      -0.18708849, -0.18419774, -0.18278112, -0.18275773, -0.19600511,
-      -0.19538267, -0.19162537, -0.192591, -0.19787251, -0.19998388,
-      -0.19278597, -0.18786678, -0.18582166, -0.18569262, -0.18191596,
-      -0.18098748, -0.18121272, -0.19626444, -0.19792468, -0.19207762,
-      -0.18952964, -0.19189596, -0.19348373, -0.19015691, -0.1844006,
-      -0.18490676, -0.18425256, -0.18282198, -0.18047893, -0.17963261,
-      -0.19567896, -0.19192091, -0.18874464, -0.18849974, -0.1898807,
-      -0.18982206, -0.1882855, -0.19054112, -0.18959366, -0.18676196,
-      -0.18424004, -0.18355161, -0.18516647, -0.19370953, -0.19216638,
-      -0.19084519, -0.18945748, -0.1898998, -0.18970484, -0.18697297,
-      -0.1889949, -0.19083625, -0.19014625, -0.19090196, -0.19471276,
-      -0.19409975, -0.1935458, -0.19110129, -0.18852621, -0.1896783,
-      -0.19012038, -0.18907574, -0.19738469, -0.19826875, -0.19619434,
-      -0.19351482, -0.19247084, -0.19158516, -0.18882761, -0.19663896,
-      -0.19387078, -0.19137178, -0.19101838, -0.18902259, -0.18740881,
-      -0.18577042,
-    ],
-    [
-      0.21605998, -0.1888816, -0.19213369, -0.19328518, -0.18170043,
-      -0.18223418, -0.18370405, -0.18517574, -0.18551063, -0.18683789,
-      -0.18886069, -0.18927826, -0.18696358, -0.17307445, -0.17702805,
-      -0.17851964, -0.17654074, -0.17762018, -0.1796983, -0.18136519,
-      -0.18139249, -0.18250296, -0.18198996, -0.18138494, -0.18618596,
-      -0.1889744, -0.18739212, -0.17126027, -0.17405689, -0.1762726,
-      -0.18029169, -0.1885969, -0.18849469, -0.19095787, -0.18038477,
-      -0.18214581, -0.18189491, -0.18189534, -0.18381298, -0.18393834,
-      -0.18939162, -0.17176759, -0.17026471, -0.17394295, -0.17903634,
-      -0.19020126, -0.18912097, -0.18823564, -0.17929266, -0.18775292,
-      -0.18869072, -0.18756475, -0.18702924, -0.18671379, -0.17348625,
-      -0.18026013, -0.1814532, -0.18132141, -0.18308498, -0.18331088,
-      -0.18624909, -0.18811531, -0.19032778, -0.18967649, -0.18800643,
-      -0.18892376, -0.18933033, -0.18079819, -0.18595871, -0.18796106,
-      -0.18773453, -0.19043156, -0.1891853, -0.18971276, -0.18899542,
-      -0.18666336, -0.1879662, -0.18708836, -0.1893528, -0.18959058,
-      -0.18611566, -0.19272971, -0.19552121, -0.19478238, -0.19681337,
-      -0.19944471, -0.19903339, -0.19263975, -0.18716142, -0.1877408,
-      -0.18708849, -0.18419774, -0.18278112, -0.18275773, -0.19600511,
-      -0.19538267, -0.19162537, -0.192591, -0.19787251, -0.19998388,
-      -0.19278597, -0.18786678, -0.18582166, -0.18569262, -0.18191596,
-      -0.18098748, -0.18121272, -0.19626444, -0.19792468, -0.19207762,
-      -0.18952964, -0.19189596, -0.19348373, -0.19015691, -0.1844006,
-      -0.18490676, -0.18425256, -0.18282198, -0.18047893, -0.17963261,
-      -0.19567896, -0.19192091, -0.18874464, -0.18849974, -0.1898807,
-      -0.18982206, -0.1882855, -0.19054112, -0.18959366, -0.18676196,
-      -0.18424004, -0.18355161, -0.18516647, -0.19370953, -0.19216638,
-      -0.19084519, -0.18945748, -0.1898998, -0.18970484, -0.18697297,
-      -0.1889949, -0.19083625, -0.19014625, -0.19090196, -0.19471276,
-      -0.19409975, -0.1935458, -0.19110129, -0.18852621, -0.1896783,
-      -0.19012038, -0.18907574, -0.19738469, -0.19826875, -0.19619434,
-      -0.19351482, -0.19247084, -0.19158516, -0.18882761, -0.19663896,
-      -0.19387078, -0.19137178, -0.19101838, -0.18902259, -0.18740881,
-      -0.18577042,
-    ],
-    [
-      0.3605138, -0.1888816, -0.19213369, -0.19328518, -0.18170043, -0.18223418,
-      -0.18370405, -0.18517574, -0.18551063, -0.18683789, -0.18886069,
-      -0.18927826, -0.18696358, -0.17307445, -0.17702805, -0.17851964,
-      -0.17654074, -0.17762018, -0.1796983, -0.18136519, -0.18139249,
-      -0.18250296, -0.18198996, -0.18138494, -0.18618596, -0.1889744,
-      -0.18739212, -0.17126027, -0.17405689, -0.1762726, -0.18029169,
-      -0.1885969, -0.18849469, -0.19095787, -0.18038477, -0.18214581,
-      -0.18189491, -0.18189534, -0.18381298, -0.18393834, -0.18939162,
-      -0.17176759, -0.17026471, -0.17394295, -0.17903634, -0.19020126,
-      -0.18912097, -0.18823564, -0.17929266, -0.18775292, -0.18869072,
-      -0.18756475, -0.18702924, -0.18671379, -0.17348625, -0.18026013,
-      -0.1814532, -0.18132141, -0.18308498, -0.18331088, -0.18624909,
-      -0.18811531, -0.19032778, -0.18967649, -0.18800643, -0.18892376,
-      -0.18933033, -0.18079819, -0.18595871, -0.18796106, -0.18773453,
-      -0.19043156, -0.1891853, -0.18971276, -0.18899542, -0.18666336,
-      -0.1879662, -0.18708836, -0.1893528, -0.18959058, -0.18611566,
-      -0.19272971, -0.19552121, -0.19478238, -0.19681337, -0.19944471,
-      -0.19903339, -0.19263975, -0.18716142, -0.1877408, -0.18708849,
-      -0.18419774, -0.18278112, -0.18275773, -0.19600511, -0.19538267,
-      -0.19162537, -0.192591, -0.19787251, -0.19998388, -0.19278597,
-      -0.18786678, -0.18582166, -0.18569262, -0.18191596, -0.18098748,
-      -0.18121272, -0.19626444, -0.19792468, -0.19207762, -0.18952964,
-      -0.19189596, -0.19348373, -0.19015691, -0.1844006, -0.18490676,
-      -0.18425256, -0.18282198, -0.18047893, -0.17963261, -0.19567896,
-      -0.19192091, -0.18874464, -0.18849974, -0.1898807, -0.18982206,
-      -0.1882855, -0.19054112, -0.18959366, -0.18676196, -0.18424004,
-      -0.18355161, -0.18516647, -0.19370953, -0.19216638, -0.19084519,
-      -0.18945748, -0.1898998, -0.18970484, -0.18697297, -0.1889949,
-      -0.19083625, -0.19014625, -0.19090196, -0.19471276, -0.19409975,
-      -0.1935458, -0.19110129, -0.18852621, -0.1896783, -0.19012038,
-      -0.18907574, -0.19738469, -0.19826875, -0.19619434, -0.19351482,
-      -0.19247084, -0.19158516, -0.18882761, -0.19663896, -0.19387078,
-      -0.19137178, -0.19101838, -0.18902259, -0.18740881, -0.18577042,
-    ],
-    [
-      0.50496762, -0.1888816, -0.19213369, -0.19328518, -0.18170043,
-      -0.18223418, -0.18370405, -0.18517574, -0.18551063, -0.18683789,
-      -0.18886069, -0.18927826, -0.18696358, -0.17307445, -0.17702805,
-      -0.17851964, -0.17654074, -0.17762018, -0.1796983, -0.18136519,
-      -0.18139249, -0.18250296, -0.18198996, -0.18138494, -0.18618596,
-      -0.1889744, -0.18739212, -0.17126027, -0.17405689, -0.1762726,
-      -0.18029169, -0.1885969, -0.18849469, -0.19095787, -0.18038477,
-      -0.18214581, -0.18189491, -0.18189534, -0.18381298, -0.18393834,
-      -0.18939162, -0.17176759, -0.17026471, -0.17394295, -0.17903634,
-      -0.19020126, -0.18912097, -0.18823564, -0.17929266, -0.18775292,
-      -0.18869072, -0.18756475, -0.18702924, -0.18671379, -0.17348625,
-      -0.18026013, -0.1814532, -0.18132141, -0.18308498, -0.18331088,
-      -0.18624909, -0.18811531, -0.19032778, -0.18967649, -0.18800643,
-      -0.18892376, -0.18933033, -0.18079819, -0.18595871, -0.18796106,
-      -0.18773453, -0.19043156, -0.1891853, -0.18971276, -0.18899542,
-      -0.18666336, -0.1879662, -0.18708836, -0.1893528, -0.18959058,
-      -0.18611566, -0.19272971, -0.19552121, -0.19478238, -0.19681337,
-      -0.19944471, -0.19903339, -0.19263975, -0.18716142, -0.1877408,
-      -0.18708849, -0.18419774, -0.18278112, -0.18275773, -0.19600511,
-      -0.19538267, -0.19162537, -0.192591, -0.19787251, -0.19998388,
-      -0.19278597, -0.18786678, -0.18582166, -0.18569262, -0.18191596,
-      -0.18098748, -0.18121272, -0.19626444, -0.19792468, -0.19207762,
-      -0.18952964, -0.19189596, -0.19348373, -0.19015691, -0.1844006,
-      -0.18490676, -0.18425256, -0.18282198, -0.18047893, -0.17963261,
-      -0.19567896, -0.19192091, -0.18874464, -0.18849974, -0.1898807,
-      -0.18982206, -0.1882855, -0.19054112, -0.18959366, -0.18676196,
-      -0.18424004, -0.18355161, -0.18516647, -0.19370953, -0.19216638,
-      -0.19084519, -0.18945748, -0.1898998, -0.18970484, -0.18697297,
-      -0.1889949, -0.19083625, -0.19014625, -0.19090196, -0.19471276,
-      -0.19409975, -0.1935458, -0.19110129, -0.18852621, -0.1896783,
-      -0.19012038, -0.18907574, -0.19738469, -0.19826875, -0.19619434,
-      -0.19351482, -0.19247084, -0.19158516, -0.18882761, -0.19663896,
-      -0.19387078, -0.19137178, -0.19101838, -0.18902259, -0.18740881,
-      -0.18577042,
-    ],
-    [
-      0.64942144, -0.1888816, -0.19213369, -0.19328518, -0.18170043,
-      -0.18223418, -0.18370405, -0.18517574, -0.18551063, -0.18683789,
-      -0.18886069, -0.18927826, -0.18696358, -0.17307445, -0.17702805,
-      -0.17851964, -0.17654074, -0.17762018, -0.1796983, -0.18136519,
-      -0.18139249, -0.18250296, -0.18198996, -0.18138494, -0.18618596,
-      -0.1889744, -0.18739212, -0.17126027, -0.17405689, -0.1762726,
-      -0.18029169, -0.1885969, -0.18849469, -0.19095787, -0.18038477,
-      -0.18214581, -0.18189491, -0.18189534, -0.18381298, -0.18393834,
-      -0.18939162, -0.17176759, -0.17026471, -0.17394295, -0.17903634,
-      -0.19020126, -0.18912097, -0.18823564, -0.17929266, -0.18775292,
-      -0.18869072, -0.18756475, -0.18702924, -0.18671379, -0.17348625,
-      -0.18026013, -0.1814532, -0.18132141, -0.18308498, -0.18331088,
-      -0.18624909, -0.18811531, -0.19032778, -0.18967649, -0.18800643,
-      -0.18892376, -0.18933033, -0.18079819, -0.18595871, -0.18796106,
-      -0.18773453, -0.19043156, -0.1891853, -0.18971276, -0.18899542,
-      -0.18666336, -0.1879662, -0.18708836, -0.1893528, -0.18959058,
-      -0.18611566, -0.19272971, -0.19552121, -0.19478238, -0.19681337,
-      -0.19944471, -0.19903339, -0.19263975, -0.18716142, -0.1877408,
-      -0.18708849, -0.18419774, -0.18278112, -0.18275773, -0.19600511,
-      -0.19538267, -0.19162537, -0.192591, -0.19787251, -0.19998388,
-      -0.19278597, -0.18786678, -0.18582166, -0.18569262, -0.18191596,
-      -0.18098748, -0.18121272, -0.19626444, -0.19792468, -0.19207762,
-      -0.18952964, -0.19189596, -0.19348373, -0.19015691, -0.1844006,
-      -0.18490676, -0.18425256, -0.18282198, -0.18047893, -0.17963261,
-      -0.19567896, -0.19192091, -0.18874464, -0.18849974, -0.1898807,
-      -0.18982206, -0.1882855, -0.19054112, -0.18959366, -0.18676196,
-      -0.18424004, -0.18355161, -0.18516647, -0.19370953, -0.19216638,
-      -0.19084519, -0.18945748, -0.1898998, -0.18970484, -0.18697297,
-      -0.1889949, -0.19083625, -0.19014625, -0.19090196, -0.19471276,
-      -0.19409975, -0.1935458, -0.19110129, -0.18852621, -0.1896783,
-      -0.19012038, -0.18907574, -0.19738469, -0.19826875, -0.19619434,
-      -0.19351482, -0.19247084, -0.19158516, -0.18882761, -0.19663896,
-      -0.19387078, -0.19137178, -0.19101838, -0.18902259, -0.18740881,
-      -0.18577042,
-    ],
-    [
-      0.79387527, -0.1888816, -0.19213369, -0.19328518, -0.18170043,
-      -0.18223418, -0.18370405, -0.18517574, -0.18551063, -0.18683789,
-      -0.18886069, -0.18927826, -0.18696358, -0.17307445, -0.17702805,
-      -0.17851964, -0.17654074, -0.17762018, -0.1796983, -0.18136519,
-      -0.18139249, -0.18250296, -0.18198996, -0.18138494, -0.18618596,
-      -0.1889744, -0.18739212, -0.17126027, -0.17405689, -0.1762726,
-      -0.18029169, -0.1885969, -0.18849469, -0.19095787, -0.18038477,
-      -0.18214581, -0.18189491, -0.18189534, -0.18381298, -0.18393834,
-      -0.18939162, -0.17176759, -0.17026471, -0.17394295, -0.17903634,
-      -0.19020126, -0.18912097, -0.18823564, -0.17929266, -0.18775292,
-      -0.18869072, -0.18756475, -0.18702924, -0.18671379, -0.17348625,
-      -0.18026013, -0.1814532, -0.18132141, -0.18308498, -0.18331088,
-      -0.18624909, -0.18811531, -0.19032778, -0.18967649, -0.18800643,
-      -0.18892376, -0.18933033, -0.18079819, -0.18595871, -0.18796106,
-      -0.18773453, -0.19043156, -0.1891853, -0.18971276, -0.18899542,
-      -0.18666336, -0.1879662, -0.18708836, -0.1893528, -0.18959058,
-      -0.18611566, -0.19272971, -0.19552121, -0.19478238, -0.19681337,
-      -0.19944471, -0.19903339, -0.19263975, -0.18716142, -0.1877408,
-      -0.18708849, -0.18419774, -0.18278112, -0.18275773, -0.19600511,
-      -0.19538267, -0.19162537, -0.192591, -0.19787251, -0.19998388,
-      -0.19278597, -0.18786678, -0.18582166, -0.18569262, -0.18191596,
-      -0.18098748, -0.18121272, -0.19626444, -0.19792468, -0.19207762,
-      -0.18952964, -0.19189596, -0.19348373, -0.19015691, -0.1844006,
-      -0.18490676, -0.18425256, -0.18282198, -0.18047893, -0.17963261,
-      -0.19567896, -0.19192091, -0.18874464, -0.18849974, -0.1898807,
-      -0.18982206, -0.1882855, -0.19054112, -0.18959366, -0.18676196,
-      -0.18424004, -0.18355161, -0.18516647, -0.19370953, -0.19216638,
-      -0.19084519, -0.18945748, -0.1898998, -0.18970484, -0.18697297,
-      -0.1889949, -0.19083625, -0.19014625, -0.19090196, -0.19471276,
-      -0.19409975, -0.1935458, -0.19110129, -0.18852621, -0.1896783,
-      -0.19012038, -0.18907574, -0.19738469, -0.19826875, -0.19619434,
-      -0.19351482, -0.19247084, -0.19158516, -0.18882761, -0.19663896,
-      -0.19387078, -0.19137178, -0.19101838, -0.18902259, -0.18740881,
-      -0.18577042,
-    ],
-    [
-      0.93832909, -0.1888816, -0.19213369, -0.19328518, -0.18170043,
-      -0.18223418, -0.18370405, -0.18517574, -0.18551063, -0.18683789,
-      -0.18886069, -0.18927826, -0.18696358, -0.17307445, -0.17702805,
-      -0.17851964, -0.17654074, -0.17762018, -0.1796983, -0.18136519,
-      -0.18139249, -0.18250296, -0.18198996, -0.18138494, -0.18618596,
-      -0.1889744, -0.18739212, -0.17126027, -0.17405689, -0.1762726,
-      -0.18029169, -0.1885969, -0.18849469, -0.19095787, -0.18038477,
-      -0.18214581, -0.18189491, -0.18189534, -0.18381298, -0.18393834,
-      -0.18939162, -0.17176759, -0.17026471, -0.17394295, -0.17903634,
-      -0.19020126, -0.18912097, -0.18823564, -0.17929266, -0.18775292,
-      -0.18869072, -0.18756475, -0.18702924, -0.18671379, -0.17348625,
-      -0.18026013, -0.1814532, -0.18132141, -0.18308498, -0.18331088,
-      -0.18624909, -0.18811531, -0.19032778, -0.18967649, -0.18800643,
-      -0.18892376, -0.18933033, -0.18079819, -0.18595871, -0.18796106,
-      -0.18773453, -0.19043156, -0.1891853, -0.18971276, -0.18899542, -0.144808,
-      -0.1452933, -0.14522589, -0.14659725, -0.18959058, -0.18611566,
-      -0.19272971, -0.19552121, -0.19478238, -0.19681337, -0.19944471,
-      -0.19903339, -0.19263975, -0.18716142, -0.1877408, -0.18708849,
-      -0.18419774, -0.18278112, -0.18275773, -0.19600511, -0.19538267,
-      -0.19162537, -0.192591, -0.19787251, -0.19998388, -0.19278597,
-      -0.18786678, -0.18582166, -0.18569262, -0.18191596, -0.18098748,
-      -0.18121272, -0.19626444, -0.19792468, -0.19207762, -0.18952964,
-      -0.19189596, -0.19348373, -0.19015691, -0.1844006, -0.18490676,
-      -0.18425256, -0.18282198, -0.18047893, -0.17963261, -0.19567896,
-      -0.19192091, -0.18874464, -0.18849974, -0.1898807, -0.18982206,
-      -0.1882855, -0.19054112, -0.18959366, -0.18676196, -0.18424004,
-      -0.18355161, -0.18516647, -0.19370953, -0.19216638, -0.19084519,
-      -0.18945748, -0.1898998, -0.18970484, -0.18697297, -0.1889949,
-      -0.19083625, -0.19014625, -0.19090196, -0.19471276, -0.19409975,
-      -0.1935458, -0.19110129, -0.18852621, -0.1896783, -0.19012038,
-      -0.18907574, -0.19738469, -0.19826875, -0.19619434, -0.19351482,
-      -0.19247084, -0.19158516, -0.18882761, -0.19663896, -0.19387078,
-      -0.19137178, -0.19101838, -0.18902259, -0.18740881, -0.18577042,
-    ],
-    [
-      1.08278291, -0.1888816, -0.19213369, -0.19328518, -0.18170043,
-      -0.18223418, -0.18370405, -0.18517574, -0.18551063, -0.18683789,
-      -0.18886069, -0.18927826, -0.18696358, -0.17307445, -0.17702805,
-      -0.17851964, -0.17654074, -0.17762018, -0.1796983, -0.18136519,
-      -0.18139249, -0.18250296, -0.18198996, -0.18138494, -0.18618596,
-      -0.1889744, -0.18739212, -0.17126027, -0.17405689, -0.1762726,
-      -0.18029169, -0.1885969, -0.18849469, -0.19095787, -0.18038477,
-      -0.18214581, -0.18189491, -0.18189534, -0.18381298, -0.18393834,
-      -0.18939162, -0.17176759, -0.17026471, -0.17394295, -0.17903634,
-      -0.19020126, -0.18912097, -0.18823564, -0.17929266, -0.18775292,
-      -0.18869072, -0.18756475, -0.18702924, -0.18671379, -0.17348625,
-      -0.18026013, -0.1814532, -0.18132141, -0.18308498, -0.18331088,
-      -0.18624909, -0.18811531, -0.19032778, -0.18967649, -0.18800643,
-      -0.18892376, -0.18933033, -0.18079819, -0.18595871, -0.18796106,
-      -0.18773453, -0.19043156, -0.1891853, -0.18971276, -0.18899542,
-      -0.18666336, -0.1879662, -0.18708836, -0.1893528, -0.18959058,
-      -0.18611566, -0.19272971, -0.19552121, -0.19478238, -0.19681337,
-      -0.19944471, -0.19903339, -0.19263975, -0.18716142, -0.1877408,
-      -0.18708849, -0.18419774, -0.18278112, -0.18275773, -0.19600511,
-      -0.19538267, -0.19162537, -0.192591, -0.19787251, -0.19998388,
-      -0.19278597, -0.18786678, -0.18582166, -0.18569262, -0.18191596,
-      -0.18098748, -0.18121272, -0.19626444, -0.19792468, -0.19207762,
-      -0.18952964, -0.19189596, -0.19348373, -0.19015691, -0.1844006,
-      -0.18490676, -0.18425256, -0.18282198, -0.18047893, -0.17963261,
-      -0.19567896, -0.19192091, -0.18874464, -0.18849974, -0.1898807,
-      -0.18982206, -0.1882855, -0.19054112, -0.18959366, -0.18676196,
-      -0.18424004, -0.18355161, -0.18516647, -0.19370953, -0.19216638,
-      -0.19084519, -0.18945748, -0.1898998, -0.18970484, -0.18697297,
-      -0.1889949, -0.19083625, -0.19014625, -0.19090196, -0.19471276,
-      -0.19409975, -0.1935458, -0.19110129, -0.18852621, -0.1896783,
-      -0.19012038, -0.18907574, -0.19738469, -0.19826875, -0.19619434,
-      -0.19351482, -0.19247084, -0.19158516, -0.18882761, -0.19663896,
-      -0.19387078, -0.19137178, -0.19101838, -0.18902259, -0.18740881,
-      -0.18577042,
-    ],
-    [
-      1.22723673, -0.1888816, -0.19213369, -0.19328518, -0.18170043,
-      -0.18223418, -0.18370405, -0.18517574, -0.18551063, -0.18683789,
-      -0.18886069, -0.18927826, -0.18696358, -0.17307445, -0.17702805,
-      -0.17851964, -0.15728894, -0.17762018, -0.1796983, -0.18136519,
-      -0.18139249, -0.18250296, -0.18198996, -0.18138494, -0.18618596,
-      -0.1889744, -0.18739212, -0.17126027, -0.17405689, -0.1762726,
-      -0.18029169, -0.16854493, -0.16853073, -0.19095787, -0.18038477,
-      -0.18214581, -0.18189491, -0.18189534, -0.18381298, -0.18393834,
-      -0.18939162, -0.17176759, -0.17026471, -0.17394295, -0.17903634,
-      -0.19020126, -0.16891474, -0.18823564, -0.17929266, -0.18775292,
-      -0.18869072, -0.18756475, -0.18702924, -0.18671379, -0.17348625,
-      -0.18026013, -0.1814532, -0.18132141, -0.18308498, -0.18331088,
-      -0.18624909, -0.18811531, -0.19032778, -0.18967649, -0.18800643,
-      -0.18892376, -0.18933033, -0.18079819, -0.18595871, -0.18796106,
-      -0.18773453, -0.19043156, -0.1891853, -0.18971276, -0.18899542,
-      -0.18666336, -0.1879662, -0.18708836, -0.1893528, -0.18959058,
-      -0.18611566, -0.19272971, -0.19552121, -0.19478238, -0.19681337,
-      -0.19944471, -0.19903339, -0.19263975, -0.18716142, -0.1877408,
-      -0.18708849, -0.18419774, -0.18278112, -0.18275773, -0.19600511,
-      -0.19538267, -0.19162537, -0.192591, -0.19787251, -0.19998388,
-      -0.19278597, -0.18786678, -0.18582166, -0.18569262, -0.18191596,
-      -0.18098748, -0.18121272, -0.19626444, -0.19792468, -0.19207762,
-      -0.18952964, -0.19189596, -0.19348373, -0.19015691, -0.1844006,
-      -0.18490676, -0.18425256, -0.18282198, -0.18047893, -0.17963261,
-      -0.19567896, -0.19192091, -0.18874464, -0.18849974, -0.1898807,
-      -0.18982206, -0.1882855, -0.19054112, -0.18959366, -0.18676196,
-      -0.18424004, -0.18355161, -0.18516647, -0.19370953, -0.19216638,
-      -0.19084519, -0.18945748, -0.1898998, -0.18970484, -0.18697297,
-      -0.1889949, -0.19083625, -0.19014625, -0.19090196, -0.19471276,
-      -0.19409975, -0.1935458, -0.19110129, -0.18852621, -0.1896783,
-      -0.19012038, -0.18907574, -0.19738469, -0.19826875, -0.19619434,
-      -0.19351482, -0.19247084, -0.19158516, -0.18882761, -0.19663896,
-      -0.19387078, -0.19137178, -0.19101838, -0.18902259, -0.18740881,
-      -0.18577042,
-    ],
-    [
-      1.37169056, -0.1888816, -0.19213369, -0.19328518, -0.18170043,
-      -0.18223418, -0.18370405, -0.18517574, -0.18551063, -0.18683789,
-      -0.18886069, -0.18927826, -0.18696358, -0.17307445, -0.17702805,
-      -0.17851964, -0.17654074, -0.17762018, -0.1796983, -0.18136519,
-      -0.18139249, -0.18250296, -0.18198996, -0.18138494, -0.18618596,
-      -0.1889744, -0.18739212, -0.17126027, -0.17405689, -0.1762726,
-      -0.18029169, -0.1885969, -0.18849469, -0.19095787, -0.18038477,
-      -0.18214581, -0.18189491, -0.18189534, -0.18381298, -0.18393834,
-      -0.18939162, -0.17176759, -0.17026471, -0.17394295, -0.17903634,
-      -0.19020126, -0.18912097, -0.18823564, -0.17929266, -0.18775292,
-      -0.18869072, -0.18756475, -0.18702924, -0.18671379, -0.17348625,
-      -0.18026013, -0.1814532, -0.18132141, -0.18308498, -0.18331088,
-      -0.18624909, -0.18811531, -0.19032778, -0.18967649, -0.18800643,
-      -0.18892376, -0.18933033, -0.18079819, -0.18595871, -0.18796106,
-      -0.18773453, -0.19043156, -0.1891853, -0.18971276, -0.18899542,
-      -0.18666336, -0.1879662, -0.18708836, -0.1893528, -0.18959058,
-      -0.18611566, -0.19272971, -0.19552121, -0.19478238, -0.19681337,
-      -0.19944471, -0.19903339, -0.19263975, -0.18716142, -0.1877408,
-      -0.18708849, -0.18419774, -0.18278112, -0.18275773, -0.19600511,
-      -0.19538267, -0.19162537, -0.192591, -0.19787251, -0.19998388,
-      -0.19278597, -0.18786678, -0.18582166, -0.18569262, -0.18191596,
-      -0.18098748, -0.18121272, -0.19626444, -0.19792468, -0.19207762,
-      -0.18952964, -0.19189596, -0.19348373, -0.19015691, -0.1844006,
-      -0.18490676, -0.18425256, -0.18282198, -0.18047893, -0.17963261,
-      -0.19567896, -0.19192091, -0.18874464, -0.18849974, -0.1898807,
-      -0.18982206, -0.1882855, -0.19054112, -0.18959366, -0.18676196,
-      -0.18424004, -0.18355161, -0.18516647, -0.19370953, -0.19216638,
-      -0.19084519, -0.18945748, -0.1898998, -0.18970484, -0.18697297,
-      -0.1889949, -0.19083625, -0.19014625, -0.19090196, -0.19471276,
-      -0.19409975, -0.1935458, -0.19110129, -0.18852621, -0.1896783,
-      -0.19012038, -0.18907574, -0.19738469, -0.19826875, -0.19619434,
-      -0.19351482, -0.19247084, -0.19158516, -0.18882761, -0.19663896,
-      -0.19387078, -0.19137178, -0.19101838, -0.18902259, -0.18740881,
-      -0.18577042,
-    ],
-    [
-      1.51614438, -0.1888816, -0.19213369, -0.19328518, -0.18170043,
-      -0.18223418, -0.18370405, -0.18517574, -0.18551063, -0.18683789,
-      -0.18886069, -0.18927826, -0.18696358, -0.17307445, -0.17702805,
-      -0.17851964, -0.17654074, -0.17762018, -0.1796983, -0.18136519,
-      -0.18139249, -0.18250296, -0.18198996, -0.18138494, -0.18618596,
-      -0.1889744, -0.18739212, -0.17126027, -0.17405689, -0.1762726,
-      -0.18029169, -0.1885969, -0.18849469, -0.19095787, -0.18038477,
-      -0.18214581, -0.18189491, -0.18189534, -0.18381298, -0.18393834,
-      -0.18939162, -0.17176759, -0.17026471, -0.17394295, -0.17903634,
-      -0.19020126, -0.18912097, -0.18823564, -0.17929266, -0.18775292,
-      -0.18869072, -0.18756475, -0.18702924, -0.18671379, -0.17348625,
-      -0.18026013, -0.1814532, -0.18132141, -0.18308498, -0.18331088,
-      -0.18624909, -0.18811531, -0.19032778, -0.18967649, -0.18800643,
-      -0.18892376, -0.18933033, -0.18079819, -0.18595871, -0.18796106,
-      -0.18773453, -0.19043156, -0.1891853, -0.18971276, -0.18899542,
-      -0.18666336, -0.1879662, -0.18708836, -0.1893528, -0.18959058,
-      -0.18611566, -0.19272971, -0.19552121, -0.19478238, -0.19681337,
-      -0.19944471, -0.19903339, -0.19263975, -0.18716142, -0.1877408,
-      -0.18708849, -0.18419774, -0.18278112, -0.18275773, -0.19600511,
-      -0.19538267, -0.19162537, -0.192591, -0.19787251, -0.19998388,
-      -0.19278597, -0.18786678, -0.18582166, -0.18569262, -0.18191596,
-      -0.18098748, -0.18121272, -0.19626444, -0.19792468, -0.19207762,
-      -0.18952964, -0.19189596, -0.19348373, -0.19015691, -0.1844006,
-      -0.18490676, -0.18425256, -0.18282198, -0.18047893, -0.17963261,
-      -0.19567896, -0.19192091, -0.18874464, -0.18849974, -0.1898807,
-      -0.18982206, -0.1882855, -0.19054112, -0.18959366, -0.18676196,
-      -0.18424004, -0.18355161, -0.18516647, -0.19370953, -0.19216638,
-      -0.19084519, -0.18945748, -0.1898998, -0.18970484, -0.18697297,
-      -0.1889949, -0.19083625, -0.19014625, -0.19090196, -0.19471276,
-      -0.19409975, -0.1935458, -0.19110129, -0.18852621, -0.1896783,
-      -0.19012038, -0.18907574, -0.19738469, -0.19826875, -0.19619434,
-      -0.19351482, -0.19247084, -0.19158516, -0.18882761, -0.19663896,
-      -0.19387078, -0.19137178, -0.19101838, -0.18902259, -0.18740881,
-      -0.18577042,
-    ],
-    [
-      1.6605982, -0.1888816, -0.19213369, -0.19328518, -0.18170043, -0.18223418,
-      -0.18370405, -0.18517574, -0.18551063, -0.18683789, -0.18886069,
-      -0.18927826, -0.18696358, -0.17307445, -0.17702805, -0.17851964,
-      -0.17654074, -0.17762018, -0.1796983, -0.18136519, -0.18139249,
-      -0.18250296, -0.18198996, -0.18138494, -0.18618596, -0.1889744,
-      -0.18739212, -0.17126027, -0.17405689, -0.1762726, -0.18029169,
-      -0.1885969, -0.18849469, -0.19095787, -0.18038477, -0.18214581,
-      -0.18189491, -0.18189534, -0.18381298, -0.18393834, -0.18939162,
-      -0.17176759, -0.17026471, -0.17394295, -0.17903634, -0.19020126,
-      -0.18912097, -0.18823564, -0.17929266, -0.18775292, -0.18869072,
-      -0.18756475, -0.18702924, -0.18671379, -0.17348625, -0.18026013,
-      -0.1814532, -0.18132141, -0.18308498, -0.18331088, -0.18624909,
-      -0.18811531, -0.19032778, -0.18967649, -0.18800643, -0.18892376,
-      -0.18933033, -0.18079819, -0.18595871, -0.18796106, -0.18773453,
-      -0.19043156, -0.1891853, -0.18971276, -0.18899542, -0.18666336,
-      -0.1879662, -0.18708836, -0.1893528, -0.18959058, -0.18611566,
-      -0.19272971, -0.19552121, -0.19478238, -0.19681337, -0.19944471,
-      -0.19903339, -0.19263975, -0.18716142, -0.1877408, -0.18708849,
-      -0.18419774, -0.18278112, -0.18275773, -0.19600511, -0.19538267,
-      -0.19162537, -0.192591, -0.19787251, -0.19998388, -0.19278597,
-      -0.18786678, -0.18582166, -0.18569262, -0.18191596, -0.18098748,
-      -0.18121272, -0.19626444, -0.19792468, -0.19207762, -0.18952964,
-      -0.19189596, -0.19348373, -0.19015691, -0.1844006, -0.18490676,
-      -0.18425256, -0.18282198, -0.18047893, -0.17963261, -0.19567896,
-      -0.19192091, -0.18874464, -0.18849974, -0.1898807, -0.18982206,
-      -0.1882855, -0.19054112, -0.18959366, -0.18676196, -0.18424004,
-      -0.18355161, -0.18516647, -0.19370953, -0.19216638, -0.19084519,
-      -0.18945748, -0.1898998, -0.18970484, -0.18697297, -0.1889949,
-      -0.19083625, -0.19014625, -0.19090196, -0.19471276, -0.19409975,
-      -0.1935458, -0.19110129, -0.18852621, -0.1896783, -0.19012038,
-      -0.18907574, -0.19738469, -0.19826875, -0.19619434, -0.19351482,
-      -0.19247084, -0.19158516, -0.18882761, -0.19663896, -0.19387078,
-      -0.19137178, -0.19101838, -0.18902259, -0.18740881, -0.18577042,
-    ],
-    [
-      -1.66183972, -0.1888816, -0.19213369, -0.19328518, -0.18170043,
-      -0.18223418, -0.18370405, -0.18517574, -0.18551063, -0.18683789,
-      -0.18886069, -0.18927826, -0.18696358, -0.17307445, -0.17702805,
-      -0.17851964, -0.17654074, -0.17762018, -0.1796983, -0.18136519,
-      -0.18139249, -0.18250296, -0.18198996, -0.18138494, -0.18618596,
-      -0.1889744, -0.18739212, -0.17126027, -0.17405689, -0.1762726,
-      -0.18029169, -0.1885969, -0.18849469, -0.19095787, -0.18038477,
-      -0.18214581, -0.18189491, -0.18189534, -0.18381298, -0.18393834,
-      -0.18939162, -0.17176759, -0.17026471, -0.17394295, -0.17903634,
-      -0.19020126, -0.18912097, -0.18823564, -0.17929266, -0.18775292,
-      -0.18869072, -0.18756475, -0.18702924, -0.18671379, -0.17348625,
-      -0.18026013, -0.1814532, -0.18132141, -0.18308498, -0.18331088,
-      -0.18624909, -0.18811531, -0.19032778, -0.18967649, -0.18800643,
-      -0.18892376, -0.18933033, -0.18079819, -0.18595871, -0.18796106,
-      -0.18773453, -0.19043156, -0.1891853, -0.18971276, -0.18899542,
-      -0.18666336, -0.1879662, -0.18708836, -0.1893528, -0.18959058,
-      -0.18611566, -0.19272971, -0.19552121, -0.19478238, -0.19681337,
-      -0.19944471, -0.19903339, -0.19263975, -0.18716142, -0.1877408,
-      -0.18708849, -0.18419774, -0.18278112, -0.18275773, -0.19600511,
-      -0.19538267, -0.19162537, -0.192591, -0.19787251, -0.19998388,
-      -0.19278597, -0.18786678, -0.18582166, -0.18569262, -0.18191596,
-      -0.18098748, -0.18121272, -0.19626444, -0.19792468, -0.19207762,
-      -0.18952964, -0.19189596, -0.19348373, -0.19015691, -0.1844006,
-      -0.18490676, -0.18425256, -0.18282198, -0.18047893, -0.17963261,
-      -0.19567896, -0.19192091, -0.18874464, -0.18849974, -0.1898807,
-      -0.18982206, -0.1882855, -0.19054112, -0.18959366, -0.18676196,
-      -0.18424004, -0.18355161, -0.18516647, -0.19370953, -0.19216638,
-      -0.19084519, -0.18945748, -0.1898998, -0.18970484, -0.18697297,
-      -0.1889949, -0.19083625, -0.19014625, -0.19090196, -0.19471276,
-      -0.19409975, -0.1935458, -0.19110129, -0.18852621, -0.1896783,
-      -0.19012038, -0.18907574, -0.19738469, -0.19826875, -0.19619434,
-      -0.19351482, -0.19247084, -0.19158516, -0.18882761, -0.19663896,
-      -0.19387078, -0.19137178, -0.19101838, -0.18902259, -0.18740881,
-      -0.18577042,
-    ],
-    [
-      -1.51738589, -0.1888816, -0.19213369, -0.19328518, -0.18170043,
-      -0.18223418, -0.18370405, -0.18517574, -0.18551063, -0.18683789,
-      -0.18886069, -0.18927826, -0.18696358, -0.17307445, -0.17702805,
-      -0.17851964, -0.17654074, -0.17762018, -0.1796983, -0.18136519,
-      -0.18139249, -0.18250296, -0.18198996, -0.18138494, -0.18618596,
-      -0.1889744, -0.18739212, -0.17126027, -0.17405689, -0.1762726,
-      -0.18029169, -0.1885969, -0.18849469, -0.19095787, -0.18038477,
-      -0.18214581, -0.18189491, -0.18189534, -0.18381298, -0.18393834,
-      -0.18939162, -0.17176759, -0.17026471, -0.17394295, -0.17903634,
-      -0.19020126, -0.18912097, -0.18823564, -0.17929266, -0.18775292,
-      -0.18869072, -0.18756475, -0.18702924, -0.18671379, -0.17348625,
-      -0.18026013, -0.1814532, -0.18132141, -0.18308498, -0.18331088,
-      -0.18624909, -0.18811531, -0.19032778, -0.18967649, -0.18800643,
-      -0.18892376, -0.18933033, -0.18079819, -0.18595871, -0.18796106,
-      -0.18773453, -0.19043156, -0.1891853, -0.18971276, -0.18899542,
-      -0.18666336, -0.1879662, -0.18708836, -0.1893528, -0.18959058,
-      -0.18611566, -0.19272971, -0.19552121, -0.19478238, -0.19681337,
-      -0.19944471, -0.19903339, -0.19263975, -0.18716142, -0.1877408,
-      -0.18708849, -0.18419774, -0.18278112, -0.18275773, -0.19600511,
-      -0.19538267, -0.19162537, -0.192591, -0.19787251, -0.19998388,
-      -0.19278597, -0.18786678, -0.18582166, -0.18569262, -0.18191596,
-      -0.18098748, -0.18121272, -0.19626444, -0.19792468, -0.19207762,
-      -0.18952964, -0.19189596, -0.19348373, -0.19015691, -0.1844006,
-      -0.18490676, -0.18425256, -0.18282198, -0.18047893, -0.17963261,
-      -0.19567896, -0.19192091, -0.18874464, -0.18849974, -0.1898807,
-      -0.18982206, -0.1882855, -0.19054112, -0.18959366, -0.18676196,
-      -0.18424004, -0.18355161, -0.18516647, -0.19370953, -0.19216638,
-      -0.19084519, -0.18945748, -0.1898998, -0.18970484, -0.18697297,
-      -0.1889949, -0.19083625, -0.19014625, -0.19090196, -0.19471276,
-      -0.19409975, -0.1935458, -0.19110129, -0.18852621, -0.1896783,
-      -0.19012038, -0.18907574, -0.19738469, -0.19826875, -0.19619434,
-      -0.19351482, -0.19247084, -0.19158516, -0.18882761, -0.19663896,
-      -0.19387078, -0.19137178, -0.19101838, -0.18902259, -0.18740881,
-      -0.18577042,
-    ],
-    [
-      -1.37293207, -0.1888816, -0.19213369, -0.19328518, -0.18170043,
-      -0.18223418, -0.18370405, -0.18517574, -0.18551063, -0.18683789,
-      -0.18886069, -0.18927826, -0.18696358, -0.17307445, -0.17702805,
-      -0.15955445, -0.13803715, -0.17762018, -0.1796983, -0.18136519,
-      -0.18139249, -0.18250296, -0.18198996, -0.18138494, -0.18618596,
-      -0.1889744, -0.18739212, -0.17126027, -0.17405689, -0.1762726,
-      -0.16164522, -0.14849295, -0.16853073, -0.19095787, -0.18038477,
-      -0.18214581, -0.18189491, -0.18189534, -0.18381298, -0.18393834,
-      -0.18939162, -0.17176759, -0.17026471, -0.17394295, -0.13901581,
-      -0.06342139, -0.18912097, -0.16787941, -0.17929266, -0.18775292,
-      -0.18869072, -0.18756475, -0.18702924, -0.18671379, -0.17348625,
-      -0.18026013, -0.1814532, -0.14169274, 0.01964936, -0.08233806,
-      -0.18624909, -0.18811531, -0.19032778, -0.18967649, -0.18800643,
-      -0.18892376, -0.18933033, -0.18079819, -0.18595871, -0.18796106,
-      -0.16748919, -0.0445072, 0.10122311, -0.08402621, -0.18899542,
-      -0.18666336, -0.1879662, -0.18708836, -0.1893528, -0.18959058,
-      -0.18611566, -0.19272971, -0.19552121, -0.19478238, -0.19681337,
-      0.16237384, -0.00447424, -0.17137192, -0.18716142, -0.1877408,
-      -0.18708849, -0.18419774, -0.18278112, -0.18275773, -0.19600511,
-      -0.19538267, -0.19162537, -0.192591, 0.12352589, -0.00387522, -0.15085347,
-      -0.18786678, -0.18582166, -0.18569262, -0.18191596, -0.18098748,
-      -0.18121272, -0.19626444, -0.19792468, -0.19207762, -0.18952964,
-      -0.06793555, -0.02713845, -0.12841841, -0.1844006, -0.18490676,
-      -0.18425256, -0.18282198, -0.18047893, -0.17963261, -0.19567896,
-      -0.19192091, -0.18874464, -0.18849974, -0.10893781, -0.14900896,
-      -0.1882855, -0.19054112, -0.18959366, -0.18676196, -0.18424004,
-      -0.18355161, -0.18516647, -0.19370953, -0.19216638, -0.19084519,
-      -0.18945748, -0.16930273, -0.16915384, -0.16665951, -0.1889949,
-      -0.19083625, -0.19014625, -0.19090196, -0.19471276, -0.19409975,
-      -0.1935458, -0.19110129, -0.18852621, -0.1896783, -0.19012038,
-      -0.18907574, -0.19738469, -0.19826875, -0.19619434, -0.19351482,
-      -0.19247084, -0.19158516, -0.18882761, -0.19663896, -0.19387078,
-      -0.19137178, -0.19101838, -0.18902259, -0.18740881, -0.18577042,
-    ],
-    [
-      -1.22847825, -0.1888816, -0.19213369, -0.19328518, -0.18170043,
-      -0.18223418, -0.18370405, -0.18517574, -0.18551063, -0.18683789,
-      -0.18886069, -0.18927826, -0.18696358, -0.17307445, -0.17702805,
-      -0.15955445, -0.13803715, -0.17762018, -0.1796983, -0.18136519,
-      -0.18139249, -0.18250296, -0.18198996, -0.18138494, -0.18618596,
-      -0.1889744, -0.18739212, -0.17126027, -0.17405689, -0.1762726,
-      -0.18029169, -0.16854493, -0.14856677, -0.17007908, -0.18038477,
-      -0.18214581, -0.18189491, -0.18189534, -0.18381298, -0.18393834,
-      -0.18939162, -0.17176759, -0.17026471, -0.17394295, -0.17903634,
-      -0.19020126, -0.14870851, -0.14752318, -0.17929266, -0.18775292,
-      -0.18869072, -0.18756475, -0.18702924, -0.18671379, -0.17348625,
-      -0.18026013, -0.1814532, -0.18132141, -0.16281155, -0.12272718,
-      -0.16566951, -0.18811531, -0.19032778, -0.18967649, -0.18800643,
-      -0.18892376, -0.18933033, -0.18079819, -0.18595871, -0.18796106,
-      -0.18773453, -0.19043156, -0.08546801, -0.08402621, -0.18899542,
-      -0.18666336, -0.1879662, -0.18708836, -0.1893528, -0.18959058,
-      -0.18611566, -0.19272971, -0.19552121, -0.19478238, -0.19681337,
-      -0.07174405, 0.03876113, -0.12883628, -0.18716142, -0.1877408,
-      -0.18708849, -0.18419774, -0.18278112, -0.18275773, -0.19600511,
-      -0.19538267, -0.19162537, -0.192591, -0.09073971, 0.03970448, -0.08795472,
-      -0.16710221, -0.18582166, -0.18569262, -0.18191596, -0.18098748,
-      -0.18121272, -0.19626444, -0.19792468, -0.19207762, -0.18952964,
-      -0.15057582, -0.08951793, -0.10783891, -0.16435934, -0.18490676,
-      -0.18425256, -0.18282198, -0.18047893, -0.17963261, -0.19567896,
-      -0.19192091, -0.18874464, -0.18849974, -0.16964498, -0.12860241,
-      -0.16800538, -0.19054112, -0.18959366, -0.18676196, -0.18424004,
-      -0.18355161, -0.18516647, -0.19370953, -0.19216638, -0.19084519,
-      -0.18945748, -0.1898998, -0.16915384, -0.18697297, -0.1889949,
-      -0.19083625, -0.19014625, -0.19090196, -0.19471276, -0.19409975,
-      -0.1935458, -0.19110129, -0.18852621, -0.1896783, -0.19012038,
-      -0.18907574, -0.19738469, -0.19826875, -0.19619434, -0.19351482,
-      -0.19247084, -0.19158516, -0.18882761, -0.19663896, -0.19387078,
-      -0.19137178, -0.19101838, -0.18902259, -0.18740881, -0.18577042,
-    ],
-    [
-      -1.08402443, -0.1888816, -0.19213369, -0.19328518, -0.18170043,
-      -0.18223418, -0.18370405, -0.18517574, -0.18551063, -0.18683789,
-      -0.18886069, -0.18927826, -0.18696358, -0.17307445, -0.17702805,
-      -0.17851964, -0.17654074, -0.17762018, -0.1796983, -0.18136519,
-      -0.18139249, -0.18250296, -0.18198996, -0.18138494, -0.18618596,
-      -0.1889744, -0.18739212, -0.17126027, -0.17405689, -0.1762726,
-      -0.18029169, -0.1885969, -0.18849469, -0.19095787, -0.18038477,
-      -0.18214581, -0.18189491, -0.18189534, -0.18381298, -0.18393834,
-      -0.18939162, -0.17176759, -0.17026471, -0.17394295, -0.17903634,
-      -0.19020126, -0.18912097, -0.18823564, -0.17929266, -0.18775292,
-      -0.18869072, -0.18756475, -0.18702924, -0.18671379, -0.17348625,
-      -0.18026013, -0.1814532, -0.18132141, -0.18308498, -0.18331088,
-      -0.18624909, -0.18811531, -0.19032778, -0.18967649, -0.18800643,
-      -0.18892376, -0.18933033, -0.18079819, -0.18595871, -0.18796106,
-      -0.18773453, -0.19043156, -0.1891853, -0.18971276, -0.18899542,
-      -0.18666336, -0.1879662, -0.18708836, -0.1893528, -0.18959058,
-      -0.18611566, -0.19272971, -0.19552121, -0.19478238, -0.19681337,
-      -0.19944471, -0.19903339, -0.19263975, -0.18716142, -0.1877408,
-      -0.18708849, -0.18419774, -0.18278112, -0.18275773, -0.19600511,
-      -0.19538267, -0.19162537, -0.192591, -0.19787251, -0.19998388,
-      -0.19278597, -0.18786678, -0.18582166, -0.18569262, -0.18191596,
-      -0.18098748, -0.18121272, -0.19626444, -0.19792468, -0.19207762,
-      -0.18952964, -0.19189596, -0.19348373, -0.19015691, -0.1844006,
-      -0.18490676, -0.18425256, -0.18282198, -0.18047893, -0.17963261,
-      -0.19567896, -0.19192091, -0.18874464, -0.18849974, -0.1898807,
-      -0.18982206, -0.1882855, -0.19054112, -0.18959366, -0.18676196,
-      -0.18424004, -0.18355161, -0.18516647, -0.19370953, -0.19216638,
-      -0.19084519, -0.18945748, -0.1898998, -0.18970484, -0.18697297,
-      -0.1889949, -0.19083625, -0.19014625, -0.19090196, -0.19471276,
-      -0.19409975, -0.1935458, -0.19110129, -0.18852621, -0.1896783,
-      -0.19012038, -0.18907574, -0.19738469, -0.19826875, -0.19619434,
-      -0.19351482, -0.19247084, -0.19158516, -0.18882761, -0.19663896,
-      -0.19387078, -0.19137178, -0.19101838, -0.18902259, -0.18740881,
-      -0.18577042,
-    ],
-    [
-      -0.9395706, -0.1888816, -0.19213369, -0.19328518, -0.18170043,
-      -0.18223418, -0.18370405, -0.18517574, -0.18551063, -0.18683789,
-      -0.18886069, -0.18927826, -0.18696358, -0.17307445, -0.17702805,
-      -0.17851964, -0.17654074, -0.17762018, -0.1796983, -0.18136519,
-      -0.18139249, -0.18250296, -0.18198996, -0.18138494, -0.18618596,
-      -0.1889744, -0.18739212, -0.17126027, -0.17405689, -0.1762726,
-      -0.18029169, -0.1885969, -0.18849469, -0.19095787, -0.18038477,
-      -0.18214581, -0.18189491, -0.18189534, -0.18381298, -0.18393834,
-      -0.18939162, -0.17176759, -0.17026471, -0.17394295, -0.17903634,
-      -0.19020126, -0.18912097, -0.18823564, -0.17929266, -0.18775292,
-      -0.18869072, -0.18756475, -0.18702924, -0.18671379, -0.17348625,
-      -0.18026013, -0.1814532, -0.18132141, -0.18308498, -0.18331088,
-      -0.18624909, -0.18811531, -0.19032778, -0.18967649, -0.18800643,
-      -0.18892376, -0.18933033, -0.18079819, -0.18595871, -0.18796106,
-      -0.18773453, -0.19043156, -0.1891853, -0.18971276, -0.18899542,
-      -0.18666336, -0.1879662, -0.18708836, -0.1893528, -0.18959058,
-      -0.18611566, -0.19272971, -0.19552121, -0.19478238, -0.19681337,
-      -0.19944471, -0.19903339, -0.19263975, -0.18716142, -0.1877408,
-      -0.18708849, -0.18419774, -0.18278112, -0.18275773, -0.19600511,
-      -0.19538267, -0.19162537, -0.192591, -0.19787251, -0.19998388,
-      -0.19278597, -0.18786678, -0.18582166, -0.18569262, -0.18191596,
-      -0.18098748, -0.18121272, -0.19626444, -0.19792468, -0.19207762,
-      -0.18952964, -0.19189596, -0.19348373, -0.19015691, -0.1844006,
-      -0.18490676, -0.18425256, -0.18282198, -0.18047893, -0.17963261,
-      -0.19567896, -0.19192091, -0.18874464, -0.18849974, -0.1898807,
-      -0.18982206, -0.1882855, -0.19054112, -0.18959366, -0.18676196,
-      -0.18424004, -0.18355161, -0.18516647, -0.19370953, -0.19216638,
-      -0.19084519, -0.18945748, -0.1898998, -0.18970484, -0.18697297,
-      -0.1889949, -0.19083625, -0.19014625, -0.19090196, -0.19471276,
-      -0.19409975, -0.1935458, -0.19110129, -0.18852621, -0.1896783,
-      -0.19012038, -0.18907574, -0.19738469, -0.19826875, -0.19619434,
-      -0.19351482, -0.19247084, -0.19158516, -0.18882761, -0.19663896,
-      -0.19387078, -0.19137178, -0.19101838, -0.18902259, -0.18740881,
-      -0.18577042,
-    ],
-    [
-      -0.79511678, -0.1888816, -0.19213369, -0.19328518, -0.18170043,
-      -0.18223418, -0.18370405, -0.18517574, -0.18551063, -0.18683789,
-      -0.18886069, -0.18927826, -0.18696358, -0.17307445, -0.17702805,
-      -0.17851964, -0.17654074, -0.17762018, -0.1796983, -0.18136519,
-      -0.18139249, -0.18250296, -0.18198996, -0.18138494, -0.18618596,
-      -0.1889744, -0.18739212, -0.17126027, -0.17405689, -0.1762726,
-      -0.18029169, -0.1885969, -0.18849469, -0.19095787, -0.18038477,
-      -0.18214581, -0.18189491, -0.18189534, -0.18381298, -0.18393834,
-      -0.18939162, -0.17176759, -0.17026471, -0.17394295, -0.17903634,
-      -0.19020126, -0.18912097, -0.18823564, -0.17929266, -0.18775292,
-      -0.18869072, -0.18756475, -0.18702924, -0.18671379, -0.17348625,
-      -0.18026013, -0.1814532, -0.18132141, -0.18308498, -0.18331088,
-      -0.18624909, -0.18811531, -0.19032778, -0.18967649, -0.18800643,
-      -0.18892376, -0.18933033, -0.18079819, -0.18595871, -0.18796106,
-      -0.18773453, -0.19043156, -0.1891853, -0.18971276, -0.18899542,
-      -0.18666336, -0.1879662, -0.18708836, -0.1893528, -0.18959058,
-      -0.18611566, -0.19272971, -0.19552121, -0.19478238, -0.19681337,
-      -0.19944471, -0.19903339, -0.19263975, -0.18716142, -0.1877408,
-      -0.18708849, -0.18419774, -0.18278112, -0.18275773, -0.19600511,
-      -0.19538267, -0.19162537, -0.192591, -0.19787251, -0.19998388,
-      -0.19278597, -0.18786678, -0.18582166, -0.18569262, -0.18191596,
-      -0.18098748, -0.18121272, -0.19626444, -0.19792468, -0.19207762,
-      -0.18952964, -0.19189596, -0.19348373, -0.19015691, -0.1844006,
-      -0.18490676, -0.18425256, -0.18282198, -0.18047893, -0.17963261,
-      -0.19567896, -0.19192091, -0.18874464, -0.18849974, -0.1898807,
-      -0.18982206, -0.1882855, -0.19054112, -0.18959366, -0.18676196,
-      -0.18424004, -0.18355161, -0.18516647, -0.19370953, -0.19216638,
-      -0.19084519, -0.18945748, -0.1898998, -0.18970484, -0.18697297,
-      -0.1889949, -0.19083625, -0.19014625, -0.19090196, -0.19471276,
-      -0.19409975, -0.1935458, -0.19110129, -0.18852621, -0.1896783,
-      -0.19012038, -0.18907574, -0.19738469, -0.19826875, -0.19619434,
-      -0.19351482, -0.19247084, -0.19158516, -0.18882761, -0.19663896,
-      -0.19387078, -0.19137178, -0.19101838, -0.18902259, -0.18740881,
-      -0.18577042,
-    ],
-  ]
-];

dependencies/monster/modelLoader.js

@@ -1,122 +0,0 @@
-const tf = require('@tensorflow/tfjs');
-
-class ModelLoader {
-  constructor(logger) {
-    this.logger = logger || console;
-    this.model = null;
-  }
-
-  async loadModel(modelUrl, inputShape = [null, 24, 166]) {
-    try {
-      this.logger.debug(`Fetching model JSON from: ${modelUrl}`);
-      const response = await fetch(modelUrl);
-      const modelJSON = await response.json();
-  
-      // Fix input shape
-      this.configureInputLayer(modelJSON, inputShape);
-  
-      // Extract base path
-      const baseUrl = this.getBaseUrl(modelUrl);
-      this.fixWeightPaths(modelJSON, baseUrl);
-  
-      // Ensure weight specs are there
-      if (
-        !modelJSON.weightsManifest ||
-        !modelJSON.weightsManifest[0].weights ||
-        modelJSON.weightsManifest[0].weights.length === 0
-      ) {
-        throw new Error("Model JSON is missing weight specifications.");
-      }
-  
-      // Load the binary weight data
-      const weightUrl = modelJSON.weightsManifest[0].paths[0];
-      const weightResponse = await fetch(weightUrl);
-      const weightBuffer = await weightResponse.arrayBuffer();
-
-      console.log('modelJSON.weightsManifest:', JSON.stringify(modelJSON.weightsManifest, null, 2));
-
-if (
-  !modelJSON.weightsManifest ||
-  !modelJSON.weightsManifest[0].weights ||
-  modelJSON.weightsManifest[0].weights.length === 0
-) {
-  console.error("❌ modelJSON.weightsManifest is missing weight specs!");
-} else {
-  console.log("✅ Weight specs found:", modelJSON.weightsManifest[0].weights.length);
-}
-  
-// Create ModelArtifacts object
-const artifacts = {
-  modelTopology: modelJSON.modelTopology,
-  weightSpecs: modelJSON.weightsManifest[0].weights, // ✅ CORRECT FIELD NAME
-  weightData: weightBuffer
-};
-
-// Load from memory
-this.model = await tf.loadLayersModel(tf.io.fromMemory(artifacts));
-
-  
-      this.logger.debug('Model loaded successfully');
-      return this.model;
-    } catch (error) {
-      this.logger.error(`Failed to load model: ${error.message}`);
-      throw error;
-    }
-  }
-  
-  
-
-  configureInputLayer(modelJSON, inputShape) {
-    const layers = modelJSON.modelTopology.model_config.config.layers;
-    if (layers && layers.length > 0) {
-      const firstLayer = layers[0];
-      if (firstLayer.class_name === 'InputLayer') {
-        if (firstLayer.config.batch_shape) {
-          firstLayer.config.batchInputShape = firstLayer.config.batch_shape;
-          delete firstLayer.config.batch_shape;
-          this.logger.debug('Converted batch_shape to batchInputShape:', firstLayer);
-        } else if (!firstLayer.config.batchInputShape && !firstLayer.config.inputShape) {
-          firstLayer.config.batchInputShape = inputShape;
-          this.logger.debug('Configured input layer:', firstLayer);
-        } else {
-          this.logger.debug('Input shape already set:', firstLayer.config);
-        }
-      }
-    }
-  }
-
-  getBaseUrl(url) {
-    return url.substring(0, url.lastIndexOf('/') + 1);
-  }
-
-  fixWeightPaths(modelJSON, baseUrl) {
-    for (const group of modelJSON.weightsManifest) {
-      group.paths = group.paths.map(path => {
-        path = path.replace(/^\/+/, '');
-        return path.startsWith('http') ? path : `${baseUrl}${path}`;
-      });
-    }
-  }
-}
-
-const modelLoader = new ModelLoader();
-
-(async () => {
-  try {
-    const localURL = "http://localhost:1880/generalFunctions/datasets/lstmData/tfjs_model/model.json";
-
-    const model = await modelLoader.loadModel(localURL);
-    console.log('Model loaded successfully');
-
-    const denseLayer = model.getLayer('dense_8');
-    const weights = denseLayer.getWeights();
-    const weightArray = await weights[0].array();
-    console.log('Dense layer kernel (sample):', weightArray.slice(0, 5));
-    
-  } catch (error) {
-    console.error('Failed to load model:', error);
-  }
-})();
-
-
-module.exports = ModelLoader;

dependencies/monster/monsterConfig.json

@@ -1,256 +0,0 @@
-{
-    "general": {
-        "name": {
-            "default": "Monster Configuration",
-            "rules": {
-                "type": "string",
-                "description": "A human-readable name or label for this configuration."
-            }
-        },
-        "id": {
-            "default": null,
-            "rules": {
-                "type": "string",
-                "nullable": true,
-                "description": "A unique identifier for this configuration. If not provided, defaults to null."
-            }
-        },
-        "unit": {
-            "default": "unitless",
-            "rules": {
-                "type": "string",
-                "description": "The unit for this configuration (e.g., 'meters', 'seconds', 'unitless')."
-            }
-        },
-        "logging": {
-            "logLevel": {
-                "default": "info",
-                "rules": {
-                    "type": "enum",
-                    "values": [
-                        {
-                            "value": "debug",
-                            "description": "Log messages are printed for debugging purposes."
-                        },
-                        {
-                            "value": "info",
-                            "description": "Informational messages are printed."
-                        },
-                        {
-                            "value": "warn",
-                            "description": "Warning messages are printed."
-                        },
-                        {
-                            "value": "error",
-                            "description": "Error messages are printed."
-                        }
-                    ]
-                }
-            },
-            "enabled": {
-                "default": true,
-                "rules": {
-                    "type": "boolean",
-                    "description": "Indicates whether logging is active. If true, log messages will be generated."
-                }
-            }
-        }
-    },
-    "functionality": {
-        "softwareType": {
-            "default": "monster",
-            "rules": {
-                "type": "string",
-                "description": "Specified software type for this configuration."
-            }
-        },
-        "role": {
-            "default": "samplingCabinet",
-            "rules": {
-                "type": "string",
-                "description": "Indicates the role this configuration plays (e.g., sensor, controller, etc.)."
-            }
-        }
-    },
-    "asset": {
-        "uuid": {
-            "default": null,
-            "rules": {
-                "type": "string",
-                "nullable": true,
-                "description": "Asset tag number which is a universally unique identifier for this asset. May be null if not assigned."
-            }
-        },
-        "geoLocation": {
-            "default": {
-                "x": 0,
-                "y": 0,
-                "z": 0
-            },
-            "rules": {
-                "type": "object",
-                "description": "An object representing the asset's physical coordinates or location.",
-                "schema": {
-                    "x": {
-                        "default": 0,
-                        "rules": {
-                            "type": "number",
-                            "description": "X coordinate of the asset's location."
-                        }
-                    },
-                    "y": {
-                        "default": 0,
-                        "rules": {
-                            "type": "number",
-                            "description": "Y coordinate of the asset's location."
-                        }
-                    },
-                    "z": {
-                        "default": 0,
-                        "rules": {
-                            "type": "number",
-                            "description": "Z coordinate of the asset's location."
-                        }
-                    }
-                }
-            }
-        },
-        "supplier": {
-            "default": "Unknown",
-            "rules": {
-                "type": "string",
-                "description": "The supplier or manufacturer of the asset."
-            }
-        },
-        "type": {
-            "default": "sensor",
-            "rules": {
-                "type": "enum",
-                "values": [
-                    {
-                        "value": "sensor",
-                        "description": "A device that detects or measures a physical property and responds to it (e.g. temperature sensor)."
-                    }
-                ]
-            }
-        },
-        "subType": {
-            "default": "pressure",
-            "rules": {
-                "type": "string",
-                "description": "A more specific classification within 'type'. For example, 'pressure' for a pressure sensor."
-            }
-        },
-        "model": {
-            "default": "Unknown",
-            "rules": {
-                "type": "string",
-                "description": "A user-defined or manufacturer-defined model identifier for the asset."
-            }
-        },
-        "emptyWeightBucket": {
-            "default": 3,
-            "rules": {
-                "type": "number",
-                "description": "The weight of the empty bucket in kilograms."
-            }
-        }
-    },
-    "constraints": {
-        "samplingtime": {
-            "default": 0,
-            "rules": {
-                "type": "number",
-                "description": "The time interval between sampling events (in seconds) if not using a flow meter."
-            }
-        },
-        "samplingperiod": {
-            "default": 24,
-            "rules": {
-                "type": "number",
-                "description": "The fixed period in hours in which a composite sample is collected."
-            }
-        },
-        "minVolume": {
-            "default": 5,
-            "rules": {
-                "type": "number",
-                "min": 5,
-                "description": "The minimum volume in liters."
-            }
-        },
-        "maxWeight": {
-            "default": 23,
-            "rules": {
-                "type": "number",
-                "max": 23,
-                "description": "The maximum weight in kilograms."
-            }
-        },
-        "subSampleVolume": {
-            "default": 50,
-            "rules": {
-                "type": "number",
-                "min": 50,
-                "max": 50,
-                "description": "The volume of each sub-sample in milliliters."
-            }
-        },
-        "storageTemperature": {
-            "default": {
-                "min": 1,
-                "max": 5
-            },
-            "rules": {
-                "type": "object",
-                "description": "Acceptable storage temperature range for samples in degrees Celsius.",
-                "schema": {
-                    "min": {
-                        "default": 1,
-                        "rules": {
-                            "type": "number",
-                            "min": 1,
-                            "description": "Minimum acceptable storage temperature in degrees Celsius."
-                        }
-                    },
-                    "max": {
-                        "default": 5,
-                        "rules": {
-                            "type": "number",
-                            "max": 5,
-                            "description": "Maximum acceptable storage temperature in degrees Celsius."
-                        }
-                    }
-                }
-            }
-        },
-        "flowmeter": {
-            "default": true,
-            "rules": {
-                "type": "boolean",
-                "description": "Indicates whether a flow meter is used for proportional sampling."
-            }
-        },
-        "closedSystem": {
-            "default": false,
-            "rules": {
-                "type": "boolean",
-                "description": "Indicates if the sampling system is closed (true) or open (false)."
-            }
-        },
-        "intakeSpeed": {
-            "default": 0.3,
-            "rules": {
-                "type": "number",
-                "description": "Minimum intake speed in meters per second."
-            }
-        },
-        "intakeDiameter": {
-            "default": 12,
-            "rules": {
-                "type": "number",
-                "description": "Minimum inner diameter of the intake tubing in millimeters."
-            }
-        }
-    }
-}

examples/README.md

@@ -0,0 +1,31 @@
+# Monster Example Flows
+
+Import-ready Node-RED examples for `monster`.
+
+## Files
+- `basic.flow.json`
+  - Purpose: quick-start flow with dashboard charts for key monster outputs.
+- `integration.flow.json`
+  - Purpose: lightweight integration contract example (`registerChild` path).
+- `edge.flow.json`
+  - Purpose: unknown-topic/edge handling smoke example.
+- `monster-dashboard.flow.json`
+  - Purpose: richer dashboard-focused visualization of process output.
+  - Includes:
+    - manual flow input
+    - manual start trigger
+    - seeded `rain_data` and `monsternametijden`
+    - parsed report fields (`m3Total`, `m3PerPuls`, `pulse`, `running`)
+- `monster-api-dashboard.flow.json`
+  - Purpose: full orchestration template around `monster` with API paths and dashboard output.
+  - Includes:
+    - Open-Meteo weather fetch -> `rain_data`
+    - Aquon SFTP CSV fetch -> `monsternametijden`
+    - Z-Info token + import payload builder for `m3Total`/`m3PerPuls`
+    - dashboard API publish template (Grafana)
+    - placeholder-only credentials/hosts (`__SET_*__`)
+
+## Notes
+- `basic.flow.json` and `monster-dashboard.flow.json` are intentionally API-free.
+- `monster-api-dashboard.flow.json` is the full API template variant and must be hardened with environment-backed secrets before production use.
+- `ui-chart` uses series by `msg.topic` (`category: "topic"`, `categoryType: "msg"`).

examples/basic.flow.json

@@ -0,0 +1,365 @@
+[
+  {
+    "id": "monster_basic_tab",
+    "type": "tab",
+    "label": "monster basic",
+    "disabled": false,
+    "info": "monster basic dashboard example"
+  },
+  {
+    "id": "ui_base_monster_basic",
+    "type": "ui-base",
+    "name": "EVOLV Demo",
+    "path": "/dashboard",
+    "appIcon": "",
+    "includeClientData": true,
+    "acceptsClientConfig": [
+      "ui-notification",
+      "ui-control"
+    ],
+    "showPathInSidebar": false,
+    "headerContent": "page",
+    "navigationStyle": "default",
+    "titleBarStyle": "default"
+  },
+  {
+    "id": "ui_theme_monster_basic",
+    "type": "ui-theme",
+    "name": "Monster Theme",
+    "colors": {
+      "surface": "#ffffff",
+      "primary": "#4f8582",
+      "bgPage": "#efefef",
+      "groupBg": "#ffffff",
+      "groupOutline": "#d8d8d8"
+    },
+    "sizes": {
+      "density": "default",
+      "pagePadding": "14px",
+      "groupGap": "14px",
+      "groupBorderRadius": "6px",
+      "widgetGap": "12px"
+    }
+  },
+  {
+    "id": "ui_page_monster_basic",
+    "type": "ui-page",
+    "name": "Monster Basic",
+    "ui": "ui_base_monster_basic",
+    "path": "/monster-basic",
+    "icon": "science",
+    "layout": "grid",
+    "theme": "ui_theme_monster_basic",
+    "breakpoints": [
+      {
+        "name": "Default",
+        "px": "0",
+        "cols": "12"
+      }
+    ],
+    "order": 1,
+    "className": ""
+  },
+  {
+    "id": "ui_group_monster_basic_ctrl",
+    "type": "ui-group",
+    "name": "Input",
+    "page": "ui_page_monster_basic",
+    "width": "6",
+    "height": "1",
+    "order": 1,
+    "showTitle": true,
+    "className": ""
+  },
+  {
+    "id": "ui_group_monster_basic_obs",
+    "type": "ui-group",
+    "name": "Output",
+    "page": "ui_page_monster_basic",
+    "width": "12",
+    "height": "1",
+    "order": 2,
+    "showTitle": true,
+    "className": ""
+  },
+  {
+    "id": "monster_basic_node",
+    "type": "monster",
+    "z": "monster_basic_tab",
+    "name": "monster basic",
+    "samplingtime": "24",
+    "minvolume": "5",
+    "maxweight": "23",
+    "nominalFlowMin": "1000",
+    "flowMax": "6000",
+    "maxRainRef": "10",
+    "minSampleIntervalSec": "60",
+    "emptyWeightBucket": "8.3",
+    "aquon_sample_name": "112150",
+    "enableLog": false,
+    "logLevel": "error",
+    "positionVsParent": "atEquipment",
+    "positionIcon": "⊥",
+    "hasDistance": false,
+    "distance": "",
+    "x": 710,
+    "y": 220,
+    "wires": [
+      [
+        "monster_basic_parse"
+      ],
+      [
+        "monster_basic_dbg_influx"
+      ],
+      [
+        "monster_basic_dbg_parent"
+      ]
+    ]
+  },
+  {
+    "id": "monster_basic_inj_flow",
+    "type": "inject",
+    "z": "monster_basic_tab",
+    "group": "ui_group_monster_basic_ctrl",
+    "name": "flow 1800 m3/h",
+    "props": [
+      {
+        "p": "payload"
+      }
+    ],
+    "repeat": "5",
+    "crontab": "",
+    "once": true,
+    "onceDelay": "1",
+    "topic": "",
+    "payload": "1800",
+    "payloadType": "num",
+    "x": 170,
+    "y": 180,
+    "wires": [
+      [
+        "monster_basic_build_flow"
+      ]
+    ]
+  },
+  {
+    "id": "monster_basic_build_flow",
+    "type": "function",
+    "z": "monster_basic_tab",
+    "name": "build input_q",
+    "func": "msg.topic='input_q';\nmsg.payload={value:Number(msg.payload),unit:'m3/h'};\nreturn Number.isFinite(msg.payload.value)?msg:null;",
+    "outputs": 1,
+    "noerr": 0,
+    "x": 390,
+    "y": 180,
+    "wires": [
+      [
+        "monster_basic_node"
+      ]
+    ]
+  },
+  {
+    "id": "monster_basic_inj_start",
+    "type": "inject",
+    "z": "monster_basic_tab",
+    "group": "ui_group_monster_basic_ctrl",
+    "name": "manual start",
+    "props": [
+      {
+        "p": "topic",
+        "vt": "str"
+      },
+      {
+        "p": "payload"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": "0.1",
+    "topic": "i_start",
+    "payload": "true",
+    "payloadType": "bool",
+    "x": 160,
+    "y": 240,
+    "wires": [
+      [
+        "monster_basic_node"
+      ]
+    ]
+  },
+  {
+    "id": "monster_basic_parse",
+    "type": "function",
+    "z": "monster_basic_tab",
+    "name": "parse output",
+    "func": "const p=(msg&&msg.payload&&typeof msg.payload==='object')?msg.payload:{};\nconst now=Date.now();\nreturn [\n  Number.isFinite(Number(p.q))?{topic:'q_m3h',payload:Number(p.q),timestamp:now}:null,\n  Number.isFinite(Number(p.m3Total))?{topic:'m3_total',payload:Number(p.m3Total),timestamp:now}:null,\n  Number.isFinite(Number(p.bucketVol))?{topic:'bucket_l',payload:Number(p.bucketVol),timestamp:now}:null,\n  Number.isFinite(Number(p.m3PerPuls||p.m3PerPulse))?{topic:'m3_per_pulse',payload:Number(p.m3PerPuls||p.m3PerPulse),timestamp:now}:null,\n  {topic:'status',payload:`running=${Boolean(p.running)} | pulse=${Boolean(p.pulse)} | remaining=${Number(p.pulsesRemaining||0)}`}\n];",
+    "outputs": 5,
+    "noerr": 0,
+    "x": 930,
+    "y": 220,
+    "wires": [
+      [
+        "monster_basic_chart_q"
+      ],
+      [
+        "monster_basic_chart_total"
+      ],
+      [
+        "monster_basic_chart_bucket"
+      ],
+      [
+        "monster_basic_chart_pulse"
+      ],
+      [
+        "monster_basic_text_status"
+      ]
+    ]
+  },
+  {
+    "id": "monster_basic_chart_q",
+    "type": "ui-chart",
+    "z": "monster_basic_tab",
+    "group": "ui_group_monster_basic_obs",
+    "name": "q",
+    "label": "Flow q (m3/h)",
+    "order": 1,
+    "width": 6,
+    "height": 4,
+    "chartType": "line",
+    "category": "topic",
+    "categoryType": "msg",
+    "xAxisType": "time",
+    "xAxisPropertyType": "timestamp",
+    "yAxisProperty": "payload",
+    "yAxisPropertyType": "msg",
+    "removeOlder": "15",
+    "removeOlderUnit": "60",
+    "showLegend": false,
+    "action": "append",
+    "x": 1170,
+    "y": 120,
+    "wires": []
+  },
+  {
+    "id": "monster_basic_chart_total",
+    "type": "ui-chart",
+    "z": "monster_basic_tab",
+    "group": "ui_group_monster_basic_obs",
+    "name": "m3Total",
+    "label": "m3Total",
+    "order": 2,
+    "width": 6,
+    "height": 4,
+    "chartType": "line",
+    "category": "topic",
+    "categoryType": "msg",
+    "xAxisType": "time",
+    "xAxisPropertyType": "timestamp",
+    "yAxisProperty": "payload",
+    "yAxisPropertyType": "msg",
+    "removeOlder": "15",
+    "removeOlderUnit": "60",
+    "showLegend": false,
+    "action": "append",
+    "x": 1180,
+    "y": 180,
+    "wires": []
+  },
+  {
+    "id": "monster_basic_chart_bucket",
+    "type": "ui-chart",
+    "z": "monster_basic_tab",
+    "group": "ui_group_monster_basic_obs",
+    "name": "bucket",
+    "label": "Bucket (L)",
+    "order": 3,
+    "width": 6,
+    "height": 4,
+    "chartType": "line",
+    "category": "topic",
+    "categoryType": "msg",
+    "xAxisType": "time",
+    "xAxisPropertyType": "timestamp",
+    "yAxisProperty": "payload",
+    "yAxisPropertyType": "msg",
+    "removeOlder": "15",
+    "removeOlderUnit": "60",
+    "showLegend": false,
+    "action": "append",
+    "x": 1180,
+    "y": 240,
+    "wires": []
+  },
+  {
+    "id": "monster_basic_chart_pulse",
+    "type": "ui-chart",
+    "z": "monster_basic_tab",
+    "group": "ui_group_monster_basic_obs",
+    "name": "m3PerPuls",
+    "label": "m3PerPuls",
+    "order": 4,
+    "width": 6,
+    "height": 4,
+    "chartType": "line",
+    "category": "topic",
+    "categoryType": "msg",
+    "xAxisType": "time",
+    "xAxisPropertyType": "timestamp",
+    "yAxisProperty": "payload",
+    "yAxisPropertyType": "msg",
+    "removeOlder": "15",
+    "removeOlderUnit": "60",
+    "showLegend": false,
+    "action": "append",
+    "x": 1190,
+    "y": 300,
+    "wires": []
+  },
+  {
+    "id": "monster_basic_text_status",
+    "type": "ui-text",
+    "z": "monster_basic_tab",
+    "group": "ui_group_monster_basic_obs",
+    "name": "status",
+    "label": "Status",
+    "order": 5,
+    "width": 12,
+    "height": 1,
+    "format": "{{msg.payload}}",
+    "layout": "row-spread",
+    "x": 1170,
+    "y": 360,
+    "wires": []
+  },
+  {
+    "id": "monster_basic_dbg_influx",
+    "type": "debug",
+    "z": "monster_basic_tab",
+    "name": "influx output",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "true",
+    "targetType": "full",
+    "x": 930,
+    "y": 300,
+    "wires": []
+  },
+  {
+    "id": "monster_basic_dbg_parent",
+    "type": "debug",
+    "z": "monster_basic_tab",
+    "name": "parent output",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "true",
+    "targetType": "full",
+    "x": 920,
+    "y": 340,
+    "wires": []
+  }
+]

examples/edge.flow.json

@@ -0,0 +1,6 @@
+[
+  {"id":"monster_edge_tab","type":"tab","label":"monster edge","disabled":false,"info":"monster edge example"},
+  {"id":"monster_edge_node","type":"monster","z":"monster_edge_tab","name":"monster edge","x":420,"y":180,"wires":[["monster_edge_dbg"]]},
+  {"id":"monster_edge_inj","type":"inject","z":"monster_edge_tab","name":"unknown topic","props":[{"p":"topic","vt":"str"},{"p":"payload","vt":"str"}],"topic":"doesNotExist","payload":"x","payloadType":"str","x":170,"y":180,"wires":[["monster_edge_node"]]},
+  {"id":"monster_edge_dbg","type":"debug","z":"monster_edge_tab","name":"monster edge debug","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"true","targetType":"full","x":660,"y":180,"wires":[]}
+]

examples/integration.flow.json

@@ -0,0 +1,6 @@
+[
+  {"id":"monster_int_tab","type":"tab","label":"monster integration","disabled":false,"info":"monster integration example"},
+  {"id":"monster_int_node","type":"monster","z":"monster_int_tab","name":"monster integration","x":420,"y":180,"wires":[["monster_int_dbg"]]},
+  {"id":"monster_int_inj","type":"inject","z":"monster_int_tab","name":"registerChild","props":[{"p":"topic","vt":"str"},{"p":"payload","vt":"str"}],"topic":"registerChild","payload":"example-child-id","payloadType":"str","x":170,"y":180,"wires":[["monster_int_node"]]},
+  {"id":"monster_int_dbg","type":"debug","z":"monster_int_tab","name":"monster integration debug","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"true","targetType":"full","x":680,"y":180,"wires":[]}
+]

examples/monster-api-dashboard.flow.json

@@ -0,0 +1,743 @@
+[
+  {
+    "id": "monster_api_tab",
+    "type": "tab",
+    "label": "Monster API + Dashboard",
+    "disabled": false,
+    "info": "Full monster orchestration example with API integrations. Credentials are placeholders."
+  },
+  {
+    "id": "ui_base_monster_api",
+    "type": "ui-base",
+    "name": "EVOLV Demo",
+    "path": "/dashboard",
+    "appIcon": "",
+    "includeClientData": true,
+    "acceptsClientConfig": [
+      "ui-notification",
+      "ui-control"
+    ],
+    "showPathInSidebar": false,
+    "headerContent": "page",
+    "navigationStyle": "default",
+    "titleBarStyle": "default"
+  },
+  {
+    "id": "ui_theme_monster_api",
+    "type": "ui-theme",
+    "name": "Monster API Theme",
+    "colors": {
+      "surface": "#ffffff",
+      "primary": "#4f8582",
+      "bgPage": "#efefef",
+      "groupBg": "#ffffff",
+      "groupOutline": "#d8d8d8"
+    },
+    "sizes": {
+      "density": "default",
+      "pagePadding": "14px",
+      "groupGap": "14px",
+      "groupBorderRadius": "6px",
+      "widgetGap": "12px"
+    }
+  },
+  {
+    "id": "ui_page_monster_api",
+    "type": "ui-page",
+    "name": "Monster API",
+    "ui": "ui_base_monster_api",
+    "path": "/monster-api",
+    "icon": "science",
+    "layout": "grid",
+    "theme": "ui_theme_monster_api",
+    "breakpoints": [
+      {
+        "name": "Default",
+        "px": "0",
+        "cols": "12"
+      }
+    ],
+    "order": 1,
+    "className": ""
+  },
+  {
+    "id": "ui_group_monster_api_ctrl",
+    "type": "ui-group",
+    "name": "Input",
+    "page": "ui_page_monster_api",
+    "width": "6",
+    "height": "1",
+    "order": 1,
+    "showTitle": true,
+    "className": ""
+  },
+  {
+    "id": "ui_group_monster_api_obs",
+    "type": "ui-group",
+    "name": "Output",
+    "page": "ui_page_monster_api",
+    "width": "12",
+    "height": "1",
+    "order": 2,
+    "showTitle": true,
+    "className": ""
+  },
+  {
+    "id": "monster_api_node",
+    "type": "monster",
+    "z": "monster_api_tab",
+    "name": "Monster API",
+    "samplingtime": "24",
+    "minvolume": "5",
+    "maxweight": "23",
+    "nominalFlowMin": "1000",
+    "flowMax": "6000",
+    "maxRainRef": "10",
+    "minSampleIntervalSec": "60",
+    "emptyWeightBucket": "8.3",
+    "aquon_sample_name": "112150",
+    "enableLog": false,
+    "logLevel": "error",
+    "positionVsParent": "atEquipment",
+    "positionIcon": "⊥",
+    "hasDistance": false,
+    "distance": "",
+    "x": 980,
+    "y": 320,
+    "wires": [
+      [
+        "monster_api_parse_output",
+        "monster_api_zinfo_prepare"
+      ],
+      [
+        "monster_api_dbg_influx"
+      ],
+      [
+        "monster_api_dbg_parent"
+      ]
+    ]
+  },
+  {
+    "id": "monster_api_info",
+    "type": "comment",
+    "z": "monster_api_tab",
+    "name": "Template only: set credentials/URLs before production",
+    "info": "All secrets in this flow are placeholders. Replace with env vars or credential nodes.",
+    "x": 260,
+    "y": 80,
+    "wires": []
+  },
+  {
+    "id": "monster_api_inj_flow",
+    "type": "inject",
+    "z": "monster_api_tab",
+    "group": "ui_group_monster_api_ctrl",
+    "name": "Flow 1800 m3/h",
+    "props": [
+      {
+        "p": "payload"
+      }
+    ],
+    "repeat": "5",
+    "crontab": "",
+    "once": true,
+    "onceDelay": "1",
+    "topic": "",
+    "payload": "1800",
+    "payloadType": "num",
+    "x": 170,
+    "y": 180,
+    "wires": [
+      [
+        "monster_api_build_flow"
+      ]
+    ]
+  },
+  {
+    "id": "monster_api_build_flow",
+    "type": "function",
+    "z": "monster_api_tab",
+    "name": "Build input_q",
+    "func": "msg.topic='input_q';\nmsg.payload={value:Number(msg.payload),unit:'m3/h'};\nreturn Number.isFinite(msg.payload.value)?msg:null;",
+    "outputs": 1,
+    "noerr": 0,
+    "x": 390,
+    "y": 180,
+    "wires": [
+      [
+        "monster_api_node"
+      ]
+    ]
+  },
+  {
+    "id": "monster_api_inj_start",
+    "type": "inject",
+    "z": "monster_api_tab",
+    "group": "ui_group_monster_api_ctrl",
+    "name": "Manual Start",
+    "props": [
+      {
+        "p": "topic",
+        "vt": "str"
+      },
+      {
+        "p": "payload"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": "0.1",
+    "topic": "i_start",
+    "payload": "true",
+    "payloadType": "bool",
+    "x": 160,
+    "y": 240,
+    "wires": [
+      [
+        "monster_api_node"
+      ]
+    ]
+  },
+  {
+    "id": "monster_api_weather_trigger",
+    "type": "inject",
+    "z": "monster_api_tab",
+    "name": "Weather fetch (daily)",
+    "props": [
+      {
+        "p": "payload"
+      }
+    ],
+    "repeat": "",
+    "crontab": "55 07 * * *",
+    "once": false,
+    "onceDelay": "",
+    "topic": "",
+    "payload": "",
+    "payloadType": "date",
+    "x": 190,
+    "y": 420,
+    "wires": [
+      [
+        "monster_api_weather_http"
+      ]
+    ]
+  },
+  {
+    "id": "monster_api_weather_http",
+    "type": "http request",
+    "z": "monster_api_tab",
+    "name": "Open-Meteo",
+    "method": "GET",
+    "ret": "txt",
+    "paytoqs": "ignore",
+    "url": "https://api.open-meteo.com/v1/forecast?latitude=51.71&longitude=4.81&hourly=precipitation,precipitation_probability&timezone=Europe%2FBerlin&past_days=1&forecast_days=2",
+    "tls": "",
+    "persist": false,
+    "proxy": "",
+    "insecureHTTPParser": false,
+    "authType": "",
+    "senderr": false,
+    "headers": [],
+    "x": 380,
+    "y": 420,
+    "wires": [
+      [
+        "monster_api_weather_json"
+      ]
+    ]
+  },
+  {
+    "id": "monster_api_weather_json",
+    "type": "json",
+    "z": "monster_api_tab",
+    "name": "rain_data",
+    "property": "payload",
+    "action": "",
+    "pretty": false,
+    "x": 550,
+    "y": 420,
+    "wires": [
+      [
+        "monster_api_weather_topic"
+      ]
+    ]
+  },
+  {
+    "id": "monster_api_weather_topic",
+    "type": "change",
+    "z": "monster_api_tab",
+    "name": "topic rain_data",
+    "rules": [
+      {
+        "t": "set",
+        "p": "topic",
+        "pt": "msg",
+        "to": "rain_data",
+        "tot": "str"
+      }
+    ],
+    "x": 720,
+    "y": 420,
+    "wires": [
+      [
+        "monster_api_node"
+      ]
+    ]
+  },
+  {
+    "id": "monster_api_aquon_trigger",
+    "type": "inject",
+    "z": "monster_api_tab",
+    "name": "Aquon fetch (daily)",
+    "props": [
+      {
+        "p": "payload"
+      }
+    ],
+    "repeat": "",
+    "crontab": "15 07 * * *",
+    "once": false,
+    "onceDelay": "",
+    "topic": "",
+    "payload": "",
+    "payloadType": "date",
+    "x": 180,
+    "y": 500,
+    "wires": [
+      [
+        "monster_api_sftp_get"
+      ]
+    ]
+  },
+  {
+    "id": "monster_api_sftp_get",
+    "type": "sftp in",
+    "z": "monster_api_tab",
+    "sftp": "monster_api_sftp_cfg",
+    "operation": "get",
+    "filename": "wsBD_MONSTERNAMETIJDEN.csv",
+    "localFilename": "./.node-red/node_modules/typicals/monster/config/monsternametijden.csv",
+    "name": "Aquon schedule",
+    "x": 380,
+    "y": 500,
+    "wires": [
+      [
+        "monster_api_file_in"
+      ]
+    ]
+  },
+  {
+    "id": "monster_api_file_in",
+    "type": "file in",
+    "z": "monster_api_tab",
+    "name": "read monsternametijden",
+    "filename": "./.node-red/node_modules/typicals/monster/config/monsternametijden.csv",
+    "filenameType": "str",
+    "format": "utf8",
+    "chunk": false,
+    "sendError": false,
+    "encoding": "none",
+    "allProps": false,
+    "x": 590,
+    "y": 500,
+    "wires": [
+      [
+        "monster_api_csv"
+      ]
+    ]
+  },
+  {
+    "id": "monster_api_csv",
+    "type": "csv",
+    "z": "monster_api_tab",
+    "name": "monsternametijden",
+    "sep": ",",
+    "hdrin": true,
+    "hdrout": "all",
+    "multi": "mult",
+    "ret": "\\n",
+    "temp": "SAMPLE_NAME,DESCRIPTION,SAMPLED_DATE,START_DATE,END_DATE",
+    "skip": "0",
+    "strings": true,
+    "include_empty_strings": "",
+    "include_null_values": "",
+    "x": 780,
+    "y": 500,
+    "wires": [
+      [
+        "monster_api_schedule_topic"
+      ]
+    ]
+  },
+  {
+    "id": "monster_api_schedule_topic",
+    "type": "change",
+    "z": "monster_api_tab",
+    "name": "topic monsternametijden",
+    "rules": [
+      {
+        "t": "set",
+        "p": "topic",
+        "pt": "msg",
+        "to": "monsternametijden",
+        "tot": "str"
+      }
+    ],
+    "x": 990,
+    "y": 500,
+    "wires": [
+      [
+        "monster_api_node"
+      ]
+    ]
+  },
+  {
+    "id": "monster_api_zinfo_prepare",
+    "type": "function",
+    "z": "monster_api_tab",
+    "name": "Z-Info prepare on run stop",
+    "func": "const p=(msg&&msg.payload&&typeof msg.payload==='object')?msg.payload:{};\nconst runningNow=Boolean(p.running);\nconst runningPrev=Boolean(context.get('runningPrev'));\ncontext.set('runningPrev',runningNow);\nif(!(runningPrev && !runningNow)){\n  return null;\n}\nconst today=new Date();\nconst day=String(today.getDate()).padStart(2,'0');\nconst month=String(today.getMonth()+1).padStart(2,'0');\nconst year=today.getFullYear();\nconst yesterdayDate=new Date(today.getTime()-24*3600*1000);\nconst yDay=String(yesterdayDate.getDate()).padStart(2,'0');\nconst yMonth=String(yesterdayDate.getMonth()+1).padStart(2,'0');\nconst yYear=yesterdayDate.getFullYear();\nmsg.zinfoDateFrom=`${yYear}-${yMonth}-${yDay}`;\nmsg.zinfoDateUntil=`${year}-${month}-${day}`;\nmsg.zinfoData={\n  m3Total:Number(p.m3Total||0),\n  pulse:Math.max(0,Math.floor(Number(p.m3PerPuls||p.m3PerPulse||0)))\n};\nmsg.payload='grant_type=password&username=__SET_ZINFO_USERNAME__&password=__SET_ZINFO_PASSWORD__&client_id=__SET_ZINFO_CLIENT_ID__&client_secret=__SET_ZINFO_CLIENT_SECRET__';\nmsg.headers=msg.headers||{};\nmsg.headers['content-type']='application/x-www-form-urlencoded';\nreturn msg;",
+    "outputs": 1,
+    "noerr": 0,
+    "x": 1260,
+    "y": 320,
+    "wires": [
+      [
+        "monster_api_zinfo_token"
+      ]
+    ]
+  },
+  {
+    "id": "monster_api_zinfo_token",
+    "type": "http request",
+    "z": "monster_api_tab",
+    "name": "Z-Info token",
+    "method": "POST",
+    "ret": "txt",
+    "paytoqs": "ignore",
+    "url": "https://__SET_ZINFO_HOST__/WSR/zi_wsr.svc/token",
+    "tls": "",
+    "persist": false,
+    "proxy": "",
+    "insecureHTTPParser": false,
+    "authType": "",
+    "senderr": false,
+    "headers": [],
+    "x": 1450,
+    "y": 320,
+    "wires": [
+      [
+        "monster_api_zinfo_token_json"
+      ]
+    ]
+  },
+  {
+    "id": "monster_api_zinfo_token_json",
+    "type": "json",
+    "z": "monster_api_tab",
+    "name": "token json",
+    "property": "payload",
+    "action": "",
+    "pretty": false,
+    "x": 1630,
+    "y": 320,
+    "wires": [
+      [
+        "monster_api_zinfo_import_builder"
+      ]
+    ]
+  },
+  {
+    "id": "monster_api_zinfo_import_builder",
+    "type": "function",
+    "z": "monster_api_tab",
+    "name": "Build Z-Info import",
+    "func": "const token=msg.payload&&msg.payload.access_token;\nconst z=msg.zinfoData||{};\nconst from=msg.zinfoDateFrom;\nconst until=msg.zinfoDateUntil;\nconst ns='__SET_ZINFO_NAMESPACE__';\nmsg.payload={\n  import:{\n    algemeen:{\n      AanleverendeOrganisatie:'NL.25',\n      Versie:'IMm2018',\n      Batchid:`ZI_PA_NL.25_${Date.now()}.json`,\n      Systeembron:'WBD/NEERSG',\n      Systeemdoel:'HWH/Z-info',\n      Opmerking:'template'\n    },\n    data:[{\n      Meetwaarden:[\n        {mepid:`${ns}.F021.m3`,dbmDtm:from,dbmTijd:'06:00',demDtm:until,demTijd:'06:00',mwdWaarde:`${Number(z.m3Total||0)}`,mwdWaardeAN:'',nMwd:'',mwdOpmerk:'template'},\n        {mepid:`${ns}.Q000.PULS`,dbmDtm:from,dbmTijd:'06:00',demDtm:until,demTijd:'06:00',mwdWaarde:`${Number(z.pulse||0)}`,mwdWaardeAN:'',nMwd:'',mwdOpmerk:'template'}\n      ]\n    }]\n  }\n};\nmsg.headers=msg.headers||{};\nif(token){msg.headers.authorization='Bearer '+token;}\nmsg.headers['content-type']='application/json';\nreturn msg;",
+    "outputs": 1,
+    "noerr": 0,
+    "x": 1830,
+    "y": 320,
+    "wires": [
+      [
+        "monster_api_zinfo_import_put"
+      ]
+    ]
+  },
+  {
+    "id": "monster_api_zinfo_import_put",
+    "type": "http request",
+    "z": "monster_api_tab",
+    "name": "Z-Info import PUT",
+    "method": "PUT",
+    "ret": "txt",
+    "paytoqs": "ignore",
+    "url": "https://__SET_ZINFO_HOST__/WSR/zi_wsr.svc/json/NL.25/importmwd/pa/?gebruiker=__SET_ZINFO_USER__",
+    "tls": "",
+    "persist": false,
+    "proxy": "",
+    "insecureHTTPParser": false,
+    "authType": "",
+    "senderr": false,
+    "headers": [],
+    "x": 2040,
+    "y": 320,
+    "wires": [
+      [
+        "monster_api_dbg_zinfo"
+      ]
+    ]
+  },
+  {
+    "id": "monster_api_dbg_zinfo",
+    "type": "debug",
+    "z": "monster_api_tab",
+    "name": "Z-Info response",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "false",
+    "targetType": "full",
+    "x": 2250,
+    "y": 320,
+    "wires": []
+  },
+  {
+    "id": "monster_api_parse_output",
+    "type": "function",
+    "z": "monster_api_tab",
+    "name": "Parse output for dashboard",
+    "func": "const p=(msg&&msg.payload&&typeof msg.payload==='object')?msg.payload:{};\nconst now=Date.now();\nconst m3PerPuls=Number(p.m3PerPuls||p.m3PerPulse);\nreturn [\n  Number.isFinite(Number(p.q))?{topic:'q_m3h',payload:Number(p.q),timestamp:now}:null,\n  Number.isFinite(Number(p.m3Total))?{topic:'m3_total',payload:Number(p.m3Total),timestamp:now}:null,\n  Number.isFinite(Number(p.bucketVol))?{topic:'bucket_l',payload:Number(p.bucketVol),timestamp:now}:null,\n  Number.isFinite(m3PerPuls)?{topic:'m3_per_pulse',payload:m3PerPuls,timestamp:now}:null,\n  {topic:'status',payload:`running=${Boolean(p.running)} | pulse=${Boolean(p.pulse)} | m3PerPuls=${Number.isFinite(m3PerPuls)?m3PerPuls:'n/a'} | missed=${Number(p.missedSamples||0)}`}\n];",
+    "outputs": 5,
+    "noerr": 0,
+    "x": 1240,
+    "y": 220,
+    "wires": [
+      [
+        "monster_api_chart_q"
+      ],
+      [
+        "monster_api_chart_total"
+      ],
+      [
+        "monster_api_chart_bucket"
+      ],
+      [
+        "monster_api_chart_pulse"
+      ],
+      [
+        "monster_api_text_status"
+      ]
+    ]
+  },
+  {
+    "id": "monster_api_chart_q",
+    "type": "ui-chart",
+    "z": "monster_api_tab",
+    "group": "ui_group_monster_api_obs",
+    "name": "q",
+    "label": "Flow q (m3/h)",
+    "order": 1,
+    "width": 6,
+    "height": 4,
+    "chartType": "line",
+    "category": "topic",
+    "categoryType": "msg",
+    "xAxisType": "time",
+    "xAxisPropertyType": "timestamp",
+    "yAxisProperty": "payload",
+    "yAxisPropertyType": "msg",
+    "removeOlder": "30",
+    "removeOlderUnit": "60",
+    "showLegend": false,
+    "action": "append",
+    "x": 1470,
+    "y": 120,
+    "wires": []
+  },
+  {
+    "id": "monster_api_chart_total",
+    "type": "ui-chart",
+    "z": "monster_api_tab",
+    "group": "ui_group_monster_api_obs",
+    "name": "m3Total",
+    "label": "m3Total",
+    "order": 2,
+    "width": 6,
+    "height": 4,
+    "chartType": "line",
+    "category": "topic",
+    "categoryType": "msg",
+    "xAxisType": "time",
+    "xAxisPropertyType": "timestamp",
+    "yAxisProperty": "payload",
+    "yAxisPropertyType": "msg",
+    "removeOlder": "30",
+    "removeOlderUnit": "60",
+    "showLegend": false,
+    "action": "append",
+    "x": 1480,
+    "y": 180,
+    "wires": []
+  },
+  {
+    "id": "monster_api_chart_bucket",
+    "type": "ui-chart",
+    "z": "monster_api_tab",
+    "group": "ui_group_monster_api_obs",
+    "name": "bucket",
+    "label": "Bucket (L)",
+    "order": 3,
+    "width": 6,
+    "height": 4,
+    "chartType": "line",
+    "category": "topic",
+    "categoryType": "msg",
+    "xAxisType": "time",
+    "xAxisPropertyType": "timestamp",
+    "yAxisProperty": "payload",
+    "yAxisPropertyType": "msg",
+    "removeOlder": "30",
+    "removeOlderUnit": "60",
+    "showLegend": false,
+    "action": "append",
+    "x": 1480,
+    "y": 240,
+    "wires": []
+  },
+  {
+    "id": "monster_api_chart_pulse",
+    "type": "ui-chart",
+    "z": "monster_api_tab",
+    "group": "ui_group_monster_api_obs",
+    "name": "m3PerPuls",
+    "label": "m3PerPuls",
+    "order": 4,
+    "width": 6,
+    "height": 4,
+    "chartType": "line",
+    "category": "topic",
+    "categoryType": "msg",
+    "xAxisType": "time",
+    "xAxisPropertyType": "timestamp",
+    "yAxisProperty": "payload",
+    "yAxisPropertyType": "msg",
+    "removeOlder": "30",
+    "removeOlderUnit": "60",
+    "showLegend": false,
+    "action": "append",
+    "x": 1490,
+    "y": 300,
+    "wires": []
+  },
+  {
+    "id": "monster_api_text_status",
+    "type": "ui-text",
+    "z": "monster_api_tab",
+    "group": "ui_group_monster_api_obs",
+    "name": "status",
+    "label": "Status",
+    "order": 5,
+    "width": 12,
+    "height": 1,
+    "format": "{{msg.payload}}",
+    "layout": "row-spread",
+    "x": 1460,
+    "y": 360,
+    "wires": []
+  },
+  {
+    "id": "monster_api_dashboardapi",
+    "type": "dashboardapi",
+    "z": "monster_api_tab",
+    "name": "dashboard template",
+    "x": 1430,
+    "y": 420,
+    "wires": [
+      [
+        "monster_api_grafana_post"
+      ]
+    ]
+  },
+  {
+    "id": "monster_api_grafana_post",
+    "type": "http request",
+    "z": "monster_api_tab",
+    "name": "Grafana dashboard API",
+    "method": "POST",
+    "ret": "txt",
+    "paytoqs": "ignore",
+    "url": "https://__SET_GRAFANA_HOST__/api/dashboards/db",
+    "tls": "",
+    "persist": false,
+    "proxy": "",
+    "insecureHTTPParser": false,
+    "authType": "",
+    "senderr": false,
+    "headers": [],
+    "x": 1650,
+    "y": 420,
+    "wires": [
+      [
+        "monster_api_dbg_dashboard"
+      ]
+    ]
+  },
+  {
+    "id": "monster_api_dbg_dashboard",
+    "type": "debug",
+    "z": "monster_api_tab",
+    "name": "dashboard API response",
+    "active": false,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "false",
+    "targetType": "full",
+    "x": 1870,
+    "y": 420,
+    "wires": []
+  },
+  {
+    "id": "monster_api_dbg_influx",
+    "type": "debug",
+    "z": "monster_api_tab",
+    "name": "influx output",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "true",
+    "targetType": "full",
+    "x": 1240,
+    "y": 460,
+    "wires": []
+  },
+  {
+    "id": "monster_api_dbg_parent",
+    "type": "debug",
+    "z": "monster_api_tab",
+    "name": "parent output",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "true",
+    "targetType": "full",
+    "x": 1230,
+    "y": 500,
+    "wires": []
+  },
+  {
+    "id": "monster_api_sftp_cfg",
+    "type": "sftp",
+    "host": "__SET_AQUON_SFTP_HOST__",
+    "port": "22",
+    "username": "__SET_AQUON_SFTP_USERNAME__",
+    "password": "__SET_AQUON_SFTP_PASSWORD__",
+    "hmac": [],
+    "cipher": []
+  }
+]

examples/monster-dashboard.flow.json

@@ -0,0 +1,483 @@
+[
+  {
+    "id": "monster_tab_demo",
+    "type": "tab",
+    "label": "Monster Dashboard Demo",
+    "disabled": false,
+    "info": "Dashboard-focused example for monster output visualization"
+  },
+  {
+    "id": "ui_base_monster_demo",
+    "type": "ui-base",
+    "name": "EVOLV Demo",
+    "path": "/dashboard",
+    "appIcon": "",
+    "includeClientData": true,
+    "acceptsClientConfig": [
+      "ui-notification",
+      "ui-control"
+    ],
+    "showPathInSidebar": false,
+    "headerContent": "page",
+    "navigationStyle": "default",
+    "titleBarStyle": "default"
+  },
+  {
+    "id": "ui_theme_monster_demo",
+    "type": "ui-theme",
+    "name": "EVOLV Monster Theme",
+    "colors": {
+      "surface": "#ffffff",
+      "primary": "#4f8582",
+      "bgPage": "#efefef",
+      "groupBg": "#ffffff",
+      "groupOutline": "#d8d8d8"
+    },
+    "sizes": {
+      "density": "default",
+      "pagePadding": "14px",
+      "groupGap": "14px",
+      "groupBorderRadius": "6px",
+      "widgetGap": "12px"
+    }
+  },
+  {
+    "id": "ui_page_monster_demo",
+    "type": "ui-page",
+    "name": "Monster Demo",
+    "ui": "ui_base_monster_demo",
+    "path": "/monster-demo",
+    "icon": "science",
+    "layout": "grid",
+    "theme": "ui_theme_monster_demo",
+    "breakpoints": [
+      {
+        "name": "Default",
+        "px": "0",
+        "cols": "12"
+      }
+    ],
+    "order": 1,
+    "className": ""
+  },
+  {
+    "id": "ui_group_monster_ctrl",
+    "type": "ui-group",
+    "name": "Monster Inputs",
+    "page": "ui_page_monster_demo",
+    "width": "6",
+    "height": "1",
+    "order": 1,
+    "showTitle": true,
+    "className": ""
+  },
+  {
+    "id": "ui_group_monster_obs",
+    "type": "ui-group",
+    "name": "Monster Output",
+    "page": "ui_page_monster_demo",
+    "width": "12",
+    "height": "1",
+    "order": 2,
+    "showTitle": true,
+    "className": ""
+  },
+  {
+    "id": "monster_node_demo",
+    "type": "monster",
+    "z": "monster_tab_demo",
+    "name": "Monster Demo",
+    "samplingtime": "24",
+    "minvolume": "5",
+    "maxweight": "23",
+    "nominalFlowMin": "1000",
+    "flowMax": "6000",
+    "maxRainRef": "10",
+    "minSampleIntervalSec": "60",
+    "emptyWeightBucket": "8.3",
+    "aquon_sample_name": "112150",
+    "uuid": "",
+    "supplier": "monster",
+    "category": "monster",
+    "assetType": "sampling-cabinet",
+    "model": "monster-standard",
+    "unit": "m3/h",
+    "enableLog": false,
+    "logLevel": "error",
+    "positionVsParent": "atEquipment",
+    "positionIcon": "⊥",
+    "hasDistance": false,
+    "distance": "",
+    "x": 900,
+    "y": 260,
+    "wires": [
+      [
+        "monster_parse_output"
+      ],
+      [
+        "monster_debug_influx"
+      ],
+      [
+        "monster_debug_parent"
+      ]
+    ]
+  },
+  {
+    "id": "monster_flow_inject",
+    "type": "inject",
+    "z": "monster_tab_demo",
+    "group": "ui_group_monster_ctrl",
+    "name": "Flow 1800 m3/h",
+    "props": [
+      {
+        "p": "payload"
+      }
+    ],
+    "repeat": "5",
+    "crontab": "",
+    "once": true,
+    "onceDelay": "1",
+    "topic": "",
+    "payload": "1800",
+    "payloadType": "num",
+    "x": 170,
+    "y": 180,
+    "wires": [
+      [
+        "monster_build_flow"
+      ]
+    ]
+  },
+  {
+    "id": "monster_build_flow",
+    "type": "function",
+    "z": "monster_tab_demo",
+    "name": "Build input_q",
+    "func": "msg.topic = 'input_q';\nmsg.payload = { value: Number(msg.payload), unit: 'm3/h' };\nreturn Number.isFinite(msg.payload.value) ? msg : null;",
+    "outputs": 1,
+    "noerr": 0,
+    "x": 380,
+    "y": 180,
+    "wires": [
+      [
+        "monster_node_demo"
+      ]
+    ]
+  },
+  {
+    "id": "monster_start_inject",
+    "type": "inject",
+    "z": "monster_tab_demo",
+    "group": "ui_group_monster_ctrl",
+    "name": "Manual Start",
+    "props": [
+      {
+        "p": "topic",
+        "vt": "str"
+      },
+      {
+        "p": "payload"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": false,
+    "onceDelay": "0.1",
+    "topic": "i_start",
+    "payload": "true",
+    "payloadType": "bool",
+    "x": 160,
+    "y": 240,
+    "wires": [
+      [
+        "monster_node_demo"
+      ]
+    ]
+  },
+  {
+    "id": "monster_rain_inject",
+    "type": "inject",
+    "z": "monster_tab_demo",
+    "group": "ui_group_monster_ctrl",
+    "name": "Seed rain_data",
+    "props": [
+      {
+        "p": "payload"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": true,
+    "onceDelay": "2",
+    "topic": "",
+    "payload": "",
+    "payloadType": "date",
+    "x": 160,
+    "y": 300,
+    "wires": [
+      [
+        "monster_build_rain"
+      ]
+    ]
+  },
+  {
+    "id": "monster_build_rain",
+    "type": "function",
+    "z": "monster_tab_demo",
+    "name": "Build rain_data",
+    "func": "const now = new Date();\nconst mk = (offset, rain, prob) => {\n  const d = new Date(now.getTime() + offset * 3600 * 1000);\n  return { t: d.toISOString().slice(0, 13) + ':00', rain, prob };\n};\nconst rows = [mk(-1, 0.2, 20), mk(0, 0.8, 40), mk(1, 1.1, 60), mk(2, 0.5, 30)];\nmsg.topic = 'rain_data';\nmsg.payload = [\n  {\n    latitude: 51.71,\n    longitude: 4.81,\n    hourly: {\n      time: rows.map(r => r.t),\n      precipitation: rows.map(r => r.rain),\n      precipitation_probability: rows.map(r => r.prob)\n    }\n  }\n];\nreturn msg;",
+    "outputs": 1,
+    "noerr": 0,
+    "x": 380,
+    "y": 300,
+    "wires": [
+      [
+        "monster_node_demo"
+      ]
+    ]
+  },
+  {
+    "id": "monster_schedule_inject",
+    "type": "inject",
+    "z": "monster_tab_demo",
+    "group": "ui_group_monster_ctrl",
+    "name": "Seed monsternametijden",
+    "props": [
+      {
+        "p": "payload"
+      }
+    ],
+    "repeat": "",
+    "crontab": "",
+    "once": true,
+    "onceDelay": "3",
+    "topic": "",
+    "payload": "",
+    "payloadType": "date",
+    "x": 190,
+    "y": 360,
+    "wires": [
+      [
+        "monster_build_schedule"
+      ]
+    ]
+  },
+  {
+    "id": "monster_build_schedule",
+    "type": "function",
+    "z": "monster_tab_demo",
+    "name": "Build monsternametijden",
+    "func": "const now = new Date();\nconst next = new Date(now.getTime() + 24 * 3600 * 1000);\nconst end = new Date(next.getTime() + 24 * 3600 * 1000);\nmsg.topic = 'monsternametijden';\nmsg.payload = [\n  {\n    SAMPLE_NAME: '112150',\n    DESCRIPTION: 'demo schedule',\n    SAMPLED_DATE: next.toISOString().slice(0, 19).replace('T', ' '),\n    START_DATE: next.toISOString().slice(0, 19).replace('T', ' '),\n    END_DATE: end.toISOString().slice(0, 19).replace('T', ' ')\n  }\n];\nreturn msg;",
+    "outputs": 1,
+    "noerr": 0,
+    "x": 410,
+    "y": 360,
+    "wires": [
+      [
+        "monster_node_demo"
+      ]
+    ]
+  },
+  {
+    "id": "monster_parse_output",
+    "type": "function",
+    "z": "monster_tab_demo",
+    "name": "Parse monster output",
+    "func": "const p = (msg && msg.payload && typeof msg.payload === 'object') ? msg.payload : {};\nconst now = Date.now();\nconst q = Number(p.q);\nconst total = Number(p.m3Total);\nconst bucket = Number(p.bucketVol);\nconst rem = Number(p.pulsesRemaining);\nconst m3PerPulse = Number(p.m3PerPuls || p.m3PerPulse);\nconst status = `running=${Boolean(p.running)} | pulse=${Boolean(p.pulse)} | m3PerPuls=${Number.isFinite(m3PerPulse) ? m3PerPulse : 'n/a'} | missed=${Number(p.missedSamples || 0)}`;\nreturn [\n  Number.isFinite(q) ? { topic: 'q_m3h', payload: q, timestamp: now } : null,\n  Number.isFinite(total) ? { topic: 'm3_total', payload: total, timestamp: now } : null,\n  Number.isFinite(bucket) ? { topic: 'bucket_l', payload: bucket, timestamp: now } : null,\n  Number.isFinite(rem) ? { topic: 'pulses_remaining', payload: rem, timestamp: now } : null,\n  Number.isFinite(m3PerPulse) ? { topic: 'm3_per_pulse', payload: m3PerPulse, timestamp: now } : null,\n  { topic: 'status', payload: status }\n];",
+    "outputs": 6,
+    "noerr": 0,
+    "x": 1130,
+    "y": 260,
+    "wires": [
+      [
+        "monster_chart_q"
+      ],
+      [
+        "monster_chart_m3total"
+      ],
+      [
+        "monster_chart_bucket"
+      ],
+      [
+        "monster_chart_remaining"
+      ],
+      [
+        "monster_chart_m3pulse"
+      ],
+      [
+        "monster_text_status"
+      ]
+    ]
+  },
+  {
+    "id": "monster_chart_q",
+    "type": "ui-chart",
+    "z": "monster_tab_demo",
+    "group": "ui_group_monster_obs",
+    "name": "Flow q",
+    "label": "Flow q (m3/h)",
+    "order": 1,
+    "width": 6,
+    "height": 4,
+    "chartType": "line",
+    "category": "topic",
+    "categoryType": "msg",
+    "xAxisType": "time",
+    "xAxisPropertyType": "timestamp",
+    "yAxisPropertyType": "msg",
+    "yAxisProperty": "payload",
+    "removeOlder": "30",
+    "removeOlderUnit": "60",
+    "showLegend": false,
+    "action": "append",
+    "x": 1370,
+    "y": 120,
+    "wires": []
+  },
+  {
+    "id": "monster_chart_m3total",
+    "type": "ui-chart",
+    "z": "monster_tab_demo",
+    "group": "ui_group_monster_obs",
+    "name": "m3 Total",
+    "label": "m3Total (m3)",
+    "order": 2,
+    "width": 6,
+    "height": 4,
+    "chartType": "line",
+    "category": "topic",
+    "categoryType": "msg",
+    "xAxisType": "time",
+    "xAxisPropertyType": "timestamp",
+    "yAxisPropertyType": "msg",
+    "yAxisProperty": "payload",
+    "removeOlder": "30",
+    "removeOlderUnit": "60",
+    "showLegend": false,
+    "action": "append",
+    "x": 1380,
+    "y": 180,
+    "wires": []
+  },
+  {
+    "id": "monster_chart_bucket",
+    "type": "ui-chart",
+    "z": "monster_tab_demo",
+    "group": "ui_group_monster_obs",
+    "name": "Bucket Volume",
+    "label": "Bucket (L)",
+    "order": 3,
+    "width": 6,
+    "height": 4,
+    "chartType": "line",
+    "category": "topic",
+    "categoryType": "msg",
+    "xAxisType": "time",
+    "xAxisPropertyType": "timestamp",
+    "yAxisPropertyType": "msg",
+    "yAxisProperty": "payload",
+    "removeOlder": "30",
+    "removeOlderUnit": "60",
+    "showLegend": false,
+    "action": "append",
+    "x": 1380,
+    "y": 240,
+    "wires": []
+  },
+  {
+    "id": "monster_chart_remaining",
+    "type": "ui-chart",
+    "z": "monster_tab_demo",
+    "group": "ui_group_monster_obs",
+    "name": "Pulses Remaining",
+    "label": "Pulses Remaining",
+    "order": 4,
+    "width": 6,
+    "height": 4,
+    "chartType": "line",
+    "category": "topic",
+    "categoryType": "msg",
+    "xAxisType": "time",
+    "xAxisPropertyType": "timestamp",
+    "yAxisPropertyType": "msg",
+    "yAxisProperty": "payload",
+    "removeOlder": "30",
+    "removeOlderUnit": "60",
+    "showLegend": false,
+    "action": "append",
+    "x": 1400,
+    "y": 300,
+    "wires": []
+  },
+  {
+    "id": "monster_chart_m3pulse",
+    "type": "ui-chart",
+    "z": "monster_tab_demo",
+    "group": "ui_group_monster_obs",
+    "name": "m3 per pulse",
+    "label": "m3PerPuls",
+    "order": 5,
+    "width": 6,
+    "height": 4,
+    "chartType": "line",
+    "category": "topic",
+    "categoryType": "msg",
+    "xAxisType": "time",
+    "xAxisPropertyType": "timestamp",
+    "yAxisPropertyType": "msg",
+    "yAxisProperty": "payload",
+    "removeOlder": "30",
+    "removeOlderUnit": "60",
+    "showLegend": false,
+    "action": "append",
+    "x": 1390,
+    "y": 360,
+    "wires": []
+  },
+  {
+    "id": "monster_text_status",
+    "type": "ui-text",
+    "z": "monster_tab_demo",
+    "group": "ui_group_monster_obs",
+    "name": "Sampling status",
+    "label": "Status",
+    "order": 6,
+    "width": 12,
+    "height": 1,
+    "format": "{{msg.payload}}",
+    "layout": "row-spread",
+    "x": 1380,
+    "y": 420,
+    "wires": []
+  },
+  {
+    "id": "monster_debug_influx",
+    "type": "debug",
+    "z": "monster_tab_demo",
+    "name": "Influx output",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "true",
+    "targetType": "full",
+    "x": 1130,
+    "y": 320,
+    "wires": []
+  },
+  {
+    "id": "monster_debug_parent",
+    "type": "debug",
+    "z": "monster_tab_demo",
+    "name": "Parent output",
+    "active": true,
+    "tosidebar": true,
+    "console": false,
+    "tostatus": false,
+    "complete": "true",
+    "targetType": "full",
+    "x": 1130,
+    "y": 360,
+    "wires": []
+  }
+]

monster oud.js

@@ -1,182 +0,0 @@
-module.exports = function (RED) {
-  function monster(config) {
-
-    // create node
-    RED.nodes.createNode(this, config);
-
-    // call this => node so whenver you want to call a node function type node and the function behind it
-    var node = this;
-
-    try{
-    
-
-    // fetch monster object from monster.js
-    const Monster = require("./dependencies/monster/monster_class");
-    const OutputUtils = require("../generalFunctions/helper/outputUtils");
-
-    const mConfig={
-      general: {
-        name: config.name,
-        id: node.id,
-        unit: config.unit,
-        logging:{
-          logLevel: config.logLevel,
-          enabled: config.enableLog,
-        },
-      },
-      asset: {
-        supplier: config.supplier,
-        subType: config.subType,
-        model: config.model,
-        emptyWeightBucket: config.emptyWeightBucket,
-      },
-      constraints: {
-        minVolume: config.minVolume,
-        maxWeight: config.maxWeight,
-        samplingtime: config.samplingtime,
-      },
-    }
-
-    // make new monster on creation to work with.
-    const m = new Monster(mConfig);
-
-    // put m on node memory as source
-    node.source = m;
-
-    //load output utils
-    const output = new OutputUtils();
-
-    //internal vars
-    this.interval_id = null;
-
-    //updating node state
-    function updateNodeStatus() {
-      try{
-
-          const bucketVol = m.bucketVol;
-          const maxVolume = m.maxVolume;
-          const state = m.running;
-          const mode = "AI" ; //m.mode;
-
-          let status;
-
-          switch (state) {
-            case false:
-              status = { fill: "red", shape: "dot", text: `${mode}: OFF` };
-              break;
-            case true:
-              status = { fill: "green", shape: "dot", text: `${mode}: ON => ${bucketVol} | ${maxVolume}` };
-              break;
-          }
-
-          return status;
-      } catch (error) {
-        node.error("Error in updateNodeStatus: " + error);
-        return { fill: "red", shape: "ring", text: "Status Error" };
-      }
-    }
-
-    function tick(){
-      try{
-        // load status node
-        const status = updateNodeStatus();
-        // kick time based function in node
-        m.tick();
-        //show node status
-        node.status(status);
-      } catch (error) {
-        node.error("Error in tick function: " + error);
-        node.status({ fill: "red", shape: "ring", text: "Tick Error" });
-      }
-    }
-
-    // register child on first output this timeout is needed because of node - red stuff
-    setTimeout(
-      () => {
-        
-        /*---execute code on first start----*/
-        let msgs = [];
-
-        msgs[2] = { topic : "registerChild" , payload: node.id, positionVsParent: "upstream" };
-        msgs[3] = { topic : "registerChild" , payload: node.id, positionVsParent: "downstream" };
-        
-        //send msg
-        this.send(msgs);
-      }, 
-      100
-    );
-
-    //declare refresh interval internal node
-    setTimeout(
-      () => {
-        /*---execute code on first start----*/
-        this.interval_id = setInterval(function(){ tick() },1000)
-      }, 
-      1000
-    );
-  
-    node.on('input', function (msg,send,done) {
-      try{
-        switch(msg.topic) {
-          case 'registerChild':
-            const childId = msg.payload;
-            const childObj = RED.nodes.getNode(childId); 
-            m.childRegistrationUtils.registerChild(childObj.source ,msg.positionVsParent);
-            break;
-          case 'setMode':
-            m.setMode(msg.payload);
-            break;
-          case 'start':
-            m.i_start = true;
-            break;
-        }
-      } catch (error) {
-        node.error("Error in input function: " + error);
-        node.status({ fill: "red", shape: "ring", text: "Input Error" });
-      }
-
-      if(msg.topic == "i_flow"){
-        monster.q = parseFloat(msg.payload);
-      }
-    
-      if(msg.topic == "i_start"){
-        monster.i_start = true;
-      }
-
-      if(msg.topic == "model_prediction"){
-        let var1 = msg.payload.dagvoorheen;
-        let var2 = msg.payload.dagnadien;
-        monster.get_model_prediction(var1, var2);
-      }
-
-      if(msg.topic == "aquon_monsternametijden"){
-        monster.monsternametijden = msg.payload;
-      }
-
-      if(msg.topic == "rain_data"){
-        monster.rain_data = msg.payload;
-      }
-
-      //register child classes
-      if(msg.topic == "registerChild"){
-        let child = msg.payload;
-        monster.registerChild(child);
-
-      }
-
-      done();
-    });
-
-    // tidy up any async code here - shutdown connections and so on.
-    node.on('close', function() {
-      clearTimeout(this.interval_id);
-    });
-
-    } catch (error) {
-      node.error("Error in monster function: " + error);
-      node.status({ fill: "red", shape: "ring", text: "Monster Error" });
-    }
-  }
-  RED.nodes.registerType("monster", monster);
-  
-};

monster.html

@@ -6,12 +6,21 @@
   RED.nodes.registerType("monster", {
     category: "EVOLV",
     color: "#4f8582",
-        defaults: {
+	        defaults: {
 
-          // Define specific properties
-          samplingtime: { value: 0 },
-          minvolume: { value: 5 },
+	          // Define default properties
+	          name: { value: "" },
+        processOutputFormat: { value: "process" },
+        dbaseOutputFormat: { value: "influxdb" },
+
+	          // Define specific properties
+	          samplingtime: { value: 0 },
+	          minvolume: { value: 5 },
           maxweight: { value: 22 },
+          nominalFlowMin: { value: 0 },
+          flowMax: { value: 0 },
+          maxRainRef: { value: 10 },
+          minSampleIntervalSec: { value: 60 },
           emptyWeightBucket: { value: 3 },
           aquon_sample_name: { value: "" },
 
@@ -43,7 +52,7 @@
     icon: "font-awesome/fa-tachometer",
 
     label: function () {
-      return this.positionIcon + " " + this.category.slice(0, -1) || "Monster";
+      return (this.positionIcon || "") + " " + (this.category ? this.category.slice(0, -1) : "Monster");
     },
 
     oneditprepare: function() {
@@ -57,12 +66,99 @@
       };
       waitForMenuData();
 
-      // your existing project‐settings & asset dropdown logic can remain here
+      // your existing project-settings & asset dropdown logic can remain here
       document.getElementById("node-input-samplingtime");
       document.getElementById("node-input-minvolume");
       document.getElementById("node-input-maxweight");
+      document.getElementById("node-input-nominalFlowMin");
+      document.getElementById("node-input-flowMax");
+      document.getElementById("node-input-maxRainRef");
+      document.getElementById("node-input-minSampleIntervalSec");
       document.getElementById("node-input-emptyWeightBucket");
-      document.getElementById("node-input-aquon_sample_name");
+      const aquonSelect = document.getElementById("node-input-aquon_sample_name");
+
+      if (aquonSelect) {
+        const menuData = window.EVOLV?.nodes?.monster?.menuData?.aquon || {};
+        const options = menuData.samples || [];
+        const specs = menuData.specs || {};
+        const defaultSpec = specs.defaults || {};
+        const specMap = specs.bySample || {};
+
+        const setReadOnly = () => {};
+
+        const applySpec = (spec) => {
+          const merged = {
+            samplingtime: defaultSpec.samplingtime,
+            minvolume: defaultSpec.minvolume,
+            maxweight: defaultSpec.maxweight,
+            emptyWeightBucket: defaultSpec.emptyWeightBucket,
+            ...(spec || {})
+          };
+
+          const samplingTimeEl = document.getElementById("node-input-samplingtime");
+          const minVolumeEl = document.getElementById("node-input-minvolume");
+          const maxWeightEl = document.getElementById("node-input-maxweight");
+          const nominalFlowMinEl = document.getElementById("node-input-nominalFlowMin");
+          const flowMaxEl = document.getElementById("node-input-flowMax");
+          const maxRainEl = document.getElementById("node-input-maxRainRef");
+          const minSampleIntervalEl = document.getElementById("node-input-minSampleIntervalSec");
+          const emptyWeightEl = document.getElementById("node-input-emptyWeightBucket");
+
+          if (samplingTimeEl && merged.samplingtime !== undefined) {
+            samplingTimeEl.value = merged.samplingtime;
+          }
+          if (minVolumeEl && merged.minvolume !== undefined) {
+            minVolumeEl.value = merged.minvolume;
+          }
+          if (maxWeightEl && merged.maxweight !== undefined) {
+            maxWeightEl.value = merged.maxweight;
+          }
+          if (nominalFlowMinEl && merged.nominalFlowMin !== undefined) {
+            nominalFlowMinEl.value = merged.nominalFlowMin;
+          }
+          if (flowMaxEl && merged.flowMax !== undefined) {
+            flowMaxEl.value = merged.flowMax;
+          }
+          if (maxRainEl && merged.maxRainRef !== undefined) {
+            maxRainEl.value = merged.maxRainRef;
+          }
+          if (minSampleIntervalEl && merged.minSampleIntervalSec !== undefined) {
+            minSampleIntervalEl.value = merged.minSampleIntervalSec;
+          }
+          if (emptyWeightEl && merged.emptyWeightBucket !== undefined) {
+            emptyWeightEl.value = merged.emptyWeightBucket;
+          }
+
+        };
+
+        aquonSelect.innerHTML = "";
+
+        const emptyOption = document.createElement("option");
+        emptyOption.value = "";
+        emptyOption.textContent = "Select sample...";
+        aquonSelect.appendChild(emptyOption);
+
+        options.forEach((option) => {
+          const optionElement = document.createElement("option");
+          optionElement.value = option.code;
+          optionElement.textContent = `${option.code} - ${option.description}`;
+          optionElement.title = option.description || option.code;
+          aquonSelect.appendChild(optionElement);
+        });
+
+        if (this.aquon_sample_name) {
+          aquonSelect.value = this.aquon_sample_name;
+        }
+
+        aquonSelect.addEventListener("change", () => {
+          const selected = aquonSelect.value;
+          if (!selected) {
+            return;
+          }
+          const selectedSpec = specMap[selected] || {};
+          applySpec(selectedSpec);
+        });
+      }
 
     },
     oneditsave: function() {
@@ -81,9 +177,17 @@
         window.EVOLV.nodes.monster.positionMenu.saveEditor(this);
       }
 
-      ["samplingtime", "minvolume", "maxweight", "emptyWeightBucket"].forEach((field) => {
+      const normalizeNumber = (value) => {
+        if (typeof value !== "string") {
+          return value;
+        }
+        return value.replace(",", ".");
+      };
+
+      ["samplingtime", "minvolume", "maxweight", "nominalFlowMin", "flowMax", "maxRainRef", "minSampleIntervalSec", "emptyWeightBucket"].forEach((field) => {
         const element = document.getElementById(`node-input-${field}`);
-        const value = parseFloat(element?.value) || 0;
+        const rawValue = normalizeNumber(element?.value || "");
+        const value = parseFloat(rawValue) || 0;
         console.log(`----------------> Saving ${field}: ${value}`);
         node[field] = value;
       });
@@ -102,7 +206,8 @@
 <!-- Main UI Template -->
 <script type="text/html" data-template-name="monster">
 
-  <!-- speficic input -->
+  <!-- specific input -->
+  <h3>Sampling constraints</h3>
   <div class="form-row">
     <label for="node-input-samplingtime"><i class="fa fa-clock-o"></i> Sampling time (h)</label>
     <input type="number" id="node-input-samplingtime" style="width:60%;" />
@@ -115,13 +220,33 @@
     <label for="node-input-maxweight"><i class="fa fa-clock-o"></i> Max weight (kg)</label>
     <input type="number" id="node-input-maxweight" style="width:60%;" />
   </div>
+  <h3>Hydraulic bounds</h3>
+  <div class="form-row">
+    <label for="node-input-nominalFlowMin"><i class="fa fa-clock-o"></i> Nominal min flow (m3/h)</label>
+    <input type="number" id="node-input-nominalFlowMin" style="width:60%;" />
+  </div>
+  <div class="form-row">
+    <label for="node-input-flowMax"><i class="fa fa-clock-o"></i> Max flow (m3/h)</label>
+    <input type="number" id="node-input-flowMax" style="width:60%;" />
+  </div>
+  <h3>Rain scaling</h3>
+  <div class="form-row">
+    <label for="node-input-maxRainRef"><i class="fa fa-cloud-rain"></i> Max rain reference (mm)</label>
+    <input type="number" id="node-input-maxRainRef" style="width:60%;" />
+  </div>
+  <div class="form-row">
+    <label for="node-input-minSampleIntervalSec"><i class="fa fa-hourglass"></i> Min sample interval (s)</label>
+    <input type="number" id="node-input-minSampleIntervalSec" style="width:60%;" />
+  </div>
+  <h3>Bucket</h3>
   <div class="form-row">
     <label for="node-input-emptyWeightBucket"><i class="fa fa-clock-o"></i> Empty weight of bucket (kg)</label>
     <input type="number" id="node-input-emptyWeightBucket" style="width:60%;" />
   </div>
+  <h3>Aquon</h3>
   <div class="form-row">
     <label for="node-input-aquon_sample_name"><i class="fa fa-clock-o"></i> Aquon sample name</label>
-    <input type="text" id="node-input-aquon_sample_name" style="width:60%;" />
+    <select id="node-input-aquon_sample_name" style="width:60%;"></select>
   </div>
 
   <!-- Asset fields injected here -->
@@ -138,6 +263,6 @@
 <script type="text/html" data-help-name="monster">
   <p><b>Monster node</b>: Configure a monster asset.</p>
   <ul>
-   
+    <li><b>Beta note:</b> values load from specs but remain editable in the editor for testing.</li>
   </ul>
-</script>
+</script>

monster.js

@@ -1,5 +1,5 @@
 const nameOfNode = 'monster';
-const nodeClass   = require('./src/nodeClass.js');
+const nodeClass = require('./src/nodeClass.js');
 const { MenuManager, configManager } = require('generalFunctions');
 
 module.exports = function(RED) {
@@ -16,7 +16,7 @@ module.exports = function(RED) {
   // Serve /monster/menu.js
   RED.httpAdmin.get(`/${nameOfNode}/menu.js`, (req, res) => {
     try {
-      const script = menuMgr.createEndpoint(nameOfNode, ['logger','position']);
+      const script = menuMgr.createEndpoint(nameOfNode, ['logger', 'position', 'aquon']);
       res.type('application/javascript').send(script);
     } catch (err) {
       res.status(500).send(`// Error generating menu: ${err.message}`);
@@ -32,4 +32,4 @@ module.exports = function(RED) {
       res.status(500).send(`// Error generating configData: ${err.message}`);
     }
   });
-};
+};

package.json

@@ -4,11 +4,14 @@
   "description": "Control module Monsternamekast",
   "main": "monster.js",
   "scripts": {
-    "test": "node monster.js"
+    "test": "node --test test/basic/*.test.js test/integration/*.test.js test/edge/*.test.js",
+    "wiki:contract":  "node ../generalFunctions/scripts/wikiGen.js contract  ./src/commands/index.js   --write ./wiki/Home.md",
+    "wiki:datamodel": "node ../generalFunctions/scripts/wikiGen.js datamodel ./src/specificClass.js     --write ./wiki/Home.md",
+    "wiki:all":       "npm run wiki:contract && npm run wiki:datamodel"
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/brabantsedelta/typicals.git"
+    "url": "https://gitea.centraal.wbd-rd.nl/RnD/monster.git"
   },
   "keywords": [
     "monster",
@@ -17,8 +20,7 @@
   "author": "R. De Ren / S. Fijnje",
   "license": "SEE LICENSE",
   "dependencies": {
-    "generalFunctions": "git+https://gitea.centraal.wbd-rd.nl/RnD/generalFunctions.git",
-    "convert": "git+https://gitea.centraal.wbd-rd.nl/RnD/convert.git"
+    "generalFunctions": "git+https://gitea.centraal.wbd-rd.nl/RnD/generalFunctions.git"
   },
   "node-red": {
     "nodes": {

src/commands/handlers.js

@@ -0,0 +1,54 @@
+'use strict';
+
+// Handlers for monster input topics. Each is a pure function over the
+// domain (source). Unit conversion for incoming flow happens in the
+// handler (the legacy nodeClass did it inline) — anything else inbound
+// is passed straight through to source.handleInput.
+
+const { convert } = require('generalFunctions');
+
+exports.cmdStart = (source, msg) => {
+  source.handleInput('i_start', Boolean(msg.payload));
+};
+
+exports.setSchedule = (source, msg) => {
+  source.handleInput('monsternametijden', msg.payload);
+};
+
+exports.setRain = (source, msg) => {
+  source.handleInput('rain_data', msg.payload);
+};
+
+exports.dataFlow = (source, msg, ctx) => {
+  const log = ctx?.logger || source.logger;
+  const value = Number(msg.payload?.value);
+  const unit = msg.payload?.unit;
+  if (!Number.isFinite(value) || !unit) {
+    log?.warn?.('data.flow payload must include numeric value and unit.');
+    return;
+  }
+  let converted = value;
+  try { converted = convert(value).from(unit).to('m3/h'); }
+  catch (err) { log?.warn?.(`data.flow unit conversion failed: ${err.message}`); return; }
+  source.handleInput('input_q', { value: converted, unit: 'm3/h' });
+};
+
+exports.setMode = (source, msg) => {
+  if (typeof source.setMode === 'function') source.setMode(msg.payload);
+};
+
+exports.setModelPrediction = (source, msg) => {
+  if (typeof source.setModelPrediction === 'function') source.setModelPrediction(msg.payload);
+};
+
+// Inbound child registration from a measurement (or other) child node.
+// Ported from the legacy `case 'registerChild'` branch in nodeClass.
+exports.childRegister = (source, msg, ctx) => {
+  const childId = msg.payload;
+  const childObj = ctx?.RED?.nodes?.getNode?.(childId);
+  if (!childObj?.source) {
+    (ctx?.logger || source.logger)?.warn?.(`child.register skipped: missing child/source for id=${childId}`);
+    return;
+  }
+  source.childRegistrationUtils.registerChild(childObj.source, msg.positionVsParent, msg.distance);
+};

src/commands/index.js

@@ -0,0 +1,63 @@
+'use strict';
+
+// monster command registry. Canonical names follow CONTRACTS.md §1.
+// Legacy names (i_start, monsternametijden, rain_data, input_q, setMode,
+// model_prediction) are surfaced as aliases — they log a one-time
+// deprecation warning on first use and are removed in Phase 7.
+
+const handlers = require('./handlers');
+
+module.exports = [
+  {
+    topic: 'cmd.start',
+    aliases: ['i_start'],
+    payloadSchema: { type: 'any' },
+    description: 'Trigger / release the sampler start gate.',
+    handler: handlers.cmdStart,
+  },
+  {
+    topic: 'set.schedule',
+    aliases: ['monsternametijden'],
+    payloadSchema: { type: 'any' },
+    description: 'Replace the sampling-times schedule.',
+    handler: handlers.setSchedule,
+  },
+  {
+    topic: 'set.rain',
+    aliases: ['rain_data'],
+    payloadSchema: { type: 'any' },
+    description: 'Push current rain-event data into the sampler logic.',
+    handler: handlers.setRain,
+  },
+  {
+    topic: 'data.flow',
+    aliases: ['input_q'],
+    payloadSchema: { type: 'object' },
+    // Compound payload `{value, unit}` — handler converts internally to m3/h.
+    // Registry-level normalisation is skipped (the handler reads payload.value /
+    // payload.unit directly; flattening would break it).
+    description: 'Push the upstream flow measurement (payload: {value, unit}).',
+    handler: handlers.dataFlow,
+  },
+  {
+    topic: 'set.mode',
+    aliases: ['setMode'],
+    payloadSchema: { type: 'any' },
+    description: 'Switch the monster between auto / manual modes.',
+    handler: handlers.setMode,
+  },
+  {
+    topic: 'set.model-prediction',
+    aliases: ['model_prediction'],
+    payloadSchema: { type: 'any' },
+    description: 'Push the upstream rain-prediction snapshot used by the sampler.',
+    handler: handlers.setModelPrediction,
+  },
+  {
+    topic: 'child.register',
+    aliases: ['registerChild'],
+    payloadSchema: { type: 'string' },
+    description: 'Register a child node (typically a measurement) with this monster.',
+    handler: handlers.childRegister,
+  },
+];

src/flow/flowTracker.js

@@ -0,0 +1,59 @@
+'use strict';
+
+// Flow tracking — manual override + measured-child fan-in + effective
+// blend (mean of the two when both present). Wraps the
+// MeasurementContainer so the domain stays read-only on flow state.
+
+const POSITIONS = ['upstream', 'downstream', 'atequipment'];
+
+class FlowTracker {
+  constructor({ measurements, logger }) {
+    this.measurements = measurements;
+    this.logger = logger;
+    this.manualFlow = null;
+  }
+
+  updateManualFlow(payload = {}) {
+    const value = Number(payload.value);
+    if (!Number.isFinite(value)) return;
+    const unit = payload.unit || 'm3/h';
+    this.manualFlow = value;
+    this.measurements.type('flow').variant('manual').position('atequipment')
+      .value(value, Date.now(), unit);
+  }
+
+  handleMeasuredFlow(eventData) {
+    const value = Number(eventData?.value);
+    if (!Number.isFinite(value)) return;
+    const position = String(eventData.position || 'atequipment').toLowerCase();
+    const unit = eventData.unit || 'm3/h';
+    this.measurements.type('flow').variant('measured').position(position)
+      .value(value, eventData.timestamp || Date.now(), unit);
+  }
+
+  getMeasuredFlow() {
+    const values = [];
+    for (const pos of POSITIONS) {
+      const v = this.measurements.type('flow').variant('measured').position(pos).getCurrentValue();
+      if (Number.isFinite(v)) values.push(v);
+    }
+    if (!values.length) return null;
+    return values.reduce((s, c) => s + c, 0) / values.length;
+  }
+
+  getManualFlow() {
+    const v = this.measurements.type('flow').variant('manual').position('atequipment').getCurrentValue();
+    return Number.isFinite(v) ? v : null;
+  }
+
+  getEffectiveFlow() {
+    const measured = this.getMeasuredFlow();
+    const manual = this.getManualFlow();
+    if (measured != null && manual != null) return (measured + manual) / 2;
+    if (measured != null) return measured;
+    if (manual != null) return manual;
+    return 0;
+  }
+}
+
+module.exports = FlowTracker;

src/io/output.js

@@ -0,0 +1,70 @@
+'use strict';
+
+// Output formatter — assembles the snapshot shape getOutput returns each
+// tick. Heavy on derived fields (timeToNextPulse, targetDelta, ...) but
+// every value is read-only on the domain, so this can stay a pure function.
+
+const params = require('../parameters/parameters');
+
+function buildOutput(m) {
+  const output = m.measurements.getFlattenedOutput();
+  const flowRate = Number(m.q) || 0;
+  const m3PerPulse = Number(m.m3PerPuls) || 0;
+  const pulseFraction = Number(m.temp_pulse) || 0;
+  const targetVolumeL = Number(m.targetVolume) > 0 ? m.targetVolume : 0;
+  const targetVolumeM3 = targetVolumeL > 0 ? targetVolumeL / 1000 : 0;
+  const flowToNextPulseM3 = m3PerPulse > 0 ? Math.max(0, (1 - pulseFraction) * m3PerPulse) : 0;
+  const timeToNextPulseSec = flowRate > 0 && flowToNextPulseM3 > 0
+    ? Math.round((flowToNextPulseM3 / (flowRate / 3600)) * 100) / 100
+    : 0;
+  const targetProgressPct = targetVolumeL > 0
+    ? Math.round((m.bucketVol / targetVolumeL) * 10000) / 100
+    : 0;
+  const targetDeltaL = targetVolumeL > 0
+    ? Math.round((m.bucketVol - targetVolumeL) * 100) / 100
+    : 0;
+  const targetDeltaM3 = targetVolumeL > 0
+    ? Math.round((targetDeltaL / 1000) * 10000) / 10000
+    : 0;
+
+  Object.assign(output, {
+    pulse: m.pulse,
+    running: m.running,
+    bucketVol: m.bucketVol,
+    bucketWeight: m.bucketWeight,
+    sumPuls: m.sumPuls,
+    predFlow: m.predFlow,
+    predM3PerSec: m.predM3PerSec,
+    timePassed: m.timePassed,
+    timeLeft: m.timeLeft,
+    m3Total: m.m3Total,
+    q: m.q,
+    nominalFlowMin: m.nominalFlowMin,
+    flowMax: m.flowMax,
+    invalidFlowBounds: m.invalidFlowBounds,
+    minSampleIntervalSec: m.minSampleIntervalSec,
+    missedSamples: m.missedSamples,
+    sampleCooldownMs: params.getSampleCooldownMs(m),
+    maxVolume: m.maxVolume,
+    minVolume: m.minVolume,
+    nextDate: m.nextDate,
+    daysPerYear: m.daysPerYear,
+    m3PerPuls: m.m3PerPuls,
+    m3PerPulse: m.m3PerPuls,
+    pulsesRemaining: Math.max(0, (m.targetPuls || 0) - (m.sumPuls || 0)),
+    pulseFraction,
+    flowToNextPulseM3,
+    timeToNextPulseSec,
+    targetVolumeM3,
+    targetProgressPct,
+    targetDeltaL,
+    targetDeltaM3,
+    predictedRateM3h: params.getPredictedFlowRate(m),
+    sumRain: m.rainAggregator?.sumRain ?? 0,
+    avgRain: m.rainAggregator?.avgRain ?? 0,
+  });
+
+  return output;
+}
+
+module.exports = { buildOutput };

src/io/statusBadge.js

@@ -0,0 +1,28 @@
+'use strict';
+
+// Status-badge composition. Three states the editor cares about:
+//   - red ring   : config error (flow bounds invalid)
+//   - yellow ring: sampling but cooldown is gating the next pulse
+//   - green dot  : sampling normally
+//   - grey ring  : idle
+// Shape mirrors the legacy nodeClass._updateNodeStatus output verbatim.
+
+const { statusBadge } = require('generalFunctions');
+const params = require('../parameters/parameters');
+
+function buildStatusBadge(m) {
+  if (m.invalidFlowBounds) {
+    return statusBadge.error(`Config error: nominalFlowMin (${m.nominalFlowMin}) >= flowMax (${m.flowMax})`);
+  }
+  if (m.running) {
+    const levelText = `${m.bucketVol}/${m.maxVolume} L`;
+    const cooldownMs = params.getSampleCooldownMs(m);
+    if (cooldownMs > 0) {
+      return statusBadge.compose([`SAMPLING (${Math.ceil(cooldownMs / 1000)}s)`, levelText], { fill: 'yellow', shape: 'ring' });
+    }
+    return statusBadge.compose([`AI: RUNNING`, levelText], { fill: 'green', shape: 'dot' });
+  }
+  return statusBadge.idle('AI: IDLE');
+}
+
+module.exports = { buildStatusBadge };

src/nodeClass.js

@@ -1,219 +1,36 @@
-/**
- * node class.js
- *
- * Encapsulates all node logic in a reusable class. In future updates we can split this into multiple generic classes and use the config to specifiy which ones to use.
- * This allows us to keep the Node-RED node clean and focused on wiring up the UI and event handlers.
- */
-const { outputUtils, configManager } = require('generalFunctions');
-const Specific = require("./specificClass");
+'use strict';
 
-class nodeClass {
-  /**
-   * Create a Node.
-   * @param {object} uiConfig - Node-RED node configuration.
-   * @param {object} RED    - Node-RED runtime API.
-   */
-  constructor(uiConfig, RED, nodeInstance, nameOfNode) {
+const { BaseNodeAdapter } = require('generalFunctions');
+const Monster = require('./specificClass');
+const commands = require('./commands');
 
-    // Preserve RED reference for HTTP endpoints if needed
-    this.node = nodeInstance; // This is the Node-RED node instance, we can use this to send messages and update status
-    this.RED = RED; // This is the Node-RED runtime API, we can use this to create endpoints if needed
-    this.name = nameOfNode; // This is the name of the node, it should match the file name and the node type in Node-RED
-    this.source = null; // Will hold the specific class instance
-    this.config = null; // Will hold the merged configuration
+class nodeClass extends BaseNodeAdapter {
+  static DomainClass = Monster;
+  static commands = commands;
+  // Tick-driven: sampling integrator (m3PerTick → temp_pulse) needs
+  // wall-clock delta-time once per second.
+  static tickInterval = 1000;
+  static statusInterval = 1000;
 
-    // Load default & UI config
-    this._loadConfig(uiConfig,this.node);
-
-    // Instantiate core class
-    this._setupSpecificClass(uiConfig);
-
-    // Wire up event and lifecycle handlers
-    this._bindEvents();
-    this._registerChild();
-    this._startTickLoop();
-    this._attachInputHandler();
-    this._attachCloseHandler();
-  }
-
-  /**
-   * Load and merge default config with user-defined settings.
-   * @param {object} uiConfig - Raw config from Node-RED UI.
-   */
-  _loadConfig(uiConfig,node) {
-
-    // Merge UI config over defaults
-    this.config = {
-      general: {
-        id: node.id, // node.id is for the child registration process
-        unit: uiConfig.unit, // add converter options later to convert to default units (need like a model that defines this which units we are going to use and then conver to those standards)
-        logging: {
-          enabled: uiConfig.enableLog,
-          logLevel: uiConfig.logLevel
-        }
+  buildDomainConfig(uiConfig) {
+    return {
+      constraints: {
+        samplingtime: Number(uiConfig.samplingtime) || 0,
+        minVolume: Number(uiConfig.minvolume ?? uiConfig.minVolume) || 5,
+        maxWeight: Number(uiConfig.maxweight ?? uiConfig.maxWeight) || 23,
+        nominalFlowMin: Number(uiConfig.nominalFlowMin) || 0,
+        flowMax: Number(uiConfig.flowMax) || 0,
+        maxRainRef: Number(uiConfig.maxRainRef) || 10,
+        minSampleIntervalSec: Number(uiConfig.minSampleIntervalSec) || 60,
       },
-      asset: {
-        uuid: uiConfig.assetUuid, //need to add this later to the asset model
-        tagCode: uiConfig.assetTagCode, //need to add this later to the asset model
-        supplier: uiConfig.supplier,
-        category: uiConfig.category, //add later to define as the software type 
-        type: uiConfig.assetType,
-        model: uiConfig.model,
-        unit: uiConfig.unit
-      },
-      functionality: {
-        positionVsParent: uiConfig.positionVsParent
-      }
+      functionality: { role: 'samplingCabinet', aquonSampleName: uiConfig.aquon_sample_name || undefined },
+      asset: { emptyWeightBucket: Number(uiConfig.emptyWeightBucket) || 3 },
     };
-
-    // Utility for formatting outputs
-    this._output = new outputUtils();
   }
 
-  /**
-   * Instantiate the core Measurement logic and store as source.
-   */
-  _setupSpecificClass(uiConfig) {
-    const monsterConfig = this.config;
-
-    this.source = new Specific(monsterConfig);
-
-    //store in node 
-    this.node.source = this.source; // Store the source in the node instance for easy access
-  
-  }
-
-  /**
-   * Bind events to Node-RED status updates. Using internal emitter. --> REMOVE LATER WE NEED ONLY COMPLETE CHILDS AND THEN CHECK FOR UPDATES
-   */
-  _bindEvents() {
-
-  }
-
-  _updateNodeStatus() {
-    const m = this.source;
-try{
-          const bucketVol = m.bucketVol;
-          const maxVolume = m.maxVolume;
-          const state = m.running;
-          const mode = "AI" ; //m.mode;
-
-          let status;
-
-          switch (state) {
-            case false:
-              status = { fill: "red", shape: "dot", text: `${mode}: OFF` };
-              break;
-            case true:
-              status = { fill: "green", shape: "dot", text: `${mode}: ON => ${bucketVol} | ${maxVolume}` };
-              break;
-          }
-
-          return status;
-      } catch (error) {
-        node.error("Error in updateNodeStatus: " + error);
-        return { fill: "red", shape: "ring", text: "Status Error" };
-      }
-    }
-  /**
-   * Register this node as a child upstream and downstream.
-   * Delayed to avoid Node-RED startup race conditions.
-   */
-  _registerChild() {
-    setTimeout(() => {
-      this.node.send([
-        null,
-        null,
-        { topic: 'registerChild', payload: this.config.general.id, positionVsParent: this.config?.functionality?.positionVsParent || 'atEquipment' },
-      ]);
-    }, 100);
-  }
-
-  /**
-   * Start the periodic tick loop.
-   */
-  _startTickLoop() {
-    setTimeout(() => {
-      this._tickInterval = setInterval(() => this._tick(), 1000);
-
-      // Update node status on nodered screen every second ( this is not the best way to do this, but it works for now)
-      this._statusInterval = setInterval(() => {
-        const status = this._updateNodeStatus();
-        this.node.status(status);
-      }, 1000);
-
-    }, 1000);
-  }
-
-  /**
-   * Execute a single tick: update measurement, format and send outputs.
-   */
-  _tick() {
-    this.source.tick();
-
-    const raw = this.source.getOutput();
-    const processMsg = this._output.formatMsg(raw, this.config, 'process');
-    const influxMsg  = this._output.formatMsg(raw, this.config, 'influxdb');
-
-    // Send only updated outputs on ports 0 & 1
-    this.node.send([processMsg, influxMsg]);
-  }
-
-  /**
-   * Attach the node's input handler, routing control messages to the class.
-   */
-  _attachInputHandler() {
-    this.node.on('input', (msg, send, done) => {
-     /* Update to complete event based node by putting the tick function after an input event */
-      const m = this.source;
-      switch(msg.topic) {
-            case 'registerChild':
-              // Register this node as a child of the parent node
-              const childId = msg.payload;
-              const childObj = this.RED.nodes.getNode(childId); 
-              m.childRegistrationUtils.registerChild(childObj.source ,msg.positionVsParent);
-              break;
-            case 'setMode':
-              m.setMode(msg.payload);
-              break;
-            case 'execSequence':
-              const { source, action, parameter } = msg.payload;
-              m.handleInput(source, action, parameter);
-              break;
-            case 'execMovement':
-              const { source: mvSource, action: mvAction, setpoint } = msg.payload;
-              m.handleInput(mvSource, mvAction, Number(setpoint));
-              break;
-            case 'flowMovement':
-              const { source: fmSource, action: fmAction, setpoint: fmSetpoint } = msg.payload;
-              m.handleInput(fmSource, fmAction, Number(fmSetpoint));
-
-              break;
-            case 'emergencystop':
-              const { source: esSource, action: esAction } = msg.payload;
-              m.handleInput(esSource, esAction);
-              break;
-            case 'showWorkingCurves':
-              m.showWorkingCurves();
-              send({ topic : "Showing curve" , payload: m.showWorkingCurves() });
-              break;
-            case 'CoG':
-              m.showCoG();
-              send({ topic : "Showing CoG" , payload: m.showCoG() });
-              break;
-          }
-    });
-  }
-
-  /**
-   * Clean up timers and intervals when Node-RED stops the node.
-   */
-  _attachCloseHandler() {
-    this.node.on('close', (done) => {
-      clearInterval(this._tickInterval);
-      clearInterval(this._statusInterval);
-      done();
-    });
+  extraSetup() {
+    const uiSampleName = this.config?.functionality?.aquonSampleName;
+    if (uiSampleName) this.source.aquonSampleName = uiSampleName;
   }
 }
 

src/parameters/parameters.js

@@ -0,0 +1,60 @@
+'use strict';
+
+// Sampling-cabinet boundary + target math + rain-scaled flow prediction.
+// All operations are pure given a domain handle — the domain owns the
+// mutable fields (maxVolume, targetPuls, …) so legacy tests that read
+// `monster.maxVolume` keep working.
+
+const RAIN_STALE_MS = 2 * 60 * 60 * 1000;
+
+function applyBoundsAndTargets(m) {
+  m.maxVolume = m.maxWeight - m.emptyWeightBucket;
+  m.minPuls = Math.round(m.minVolume / m.volume_pulse);
+  m.maxPuls = Math.round(m.maxVolume / m.volume_pulse);
+  m.absMaxPuls = Math.round(m.cap_volume / m.volume_pulse);
+  m.targetVolume = m.minVolume * Math.sqrt(m.maxVolume / m.minVolume);
+  m.targetPuls = Math.round(m.targetVolume / m.volume_pulse);
+}
+
+function validateFlowBounds(m) {
+  // nominalFlowMin / flowMax must be declared in monster.json's `constraints`
+  // section. If they aren't, configUtils strips them as unknown keys and the
+  // bounds collapse to undefined → NaN → invalid here, which silently blocks
+  // every sampling run. (Fixed 2026-05-11.)
+  const min = Number(m.nominalFlowMin);
+  const max = Number(m.flowMax);
+  const valid = Number.isFinite(min) && Number.isFinite(max) && min >= 0 && max > 0 && min < max;
+  m.invalidFlowBounds = !valid;
+  if (!valid) m.logger.warn(`Invalid flow bounds. nominalFlowMin=${m.nominalFlowMin}, flowMax=${m.flowMax}`);
+  return valid;
+}
+
+function getRainIndex(m) {
+  if (!m.lastRainUpdate) return 0;
+  if (Date.now() - m.lastRainUpdate > RAIN_STALE_MS) return 0;
+  return Number.isFinite(m.avgRain) ? m.avgRain : 0;
+}
+
+function getPredictedFlowRate(m) {
+  const min = Number(m.nominalFlowMin);
+  const max = Number(m.flowMax);
+  if (!Number.isFinite(min) || !Number.isFinite(max) || min < 0 || max <= 0 || min >= max) return 0;
+  const rainIndex = getRainIndex(m);
+  const scale = Math.max(0, Math.min(1, m.rainMaxRef > 0 ? rainIndex / m.rainMaxRef : 0));
+  return min + (max - min) * scale;
+}
+
+function getSampleCooldownMs(m) {
+  if (!m.lastSampleTime) return 0;
+  const remaining = (m.minSampleIntervalSec * 1000) - (Date.now() - m.lastSampleTime);
+  return Math.max(0, remaining);
+}
+
+module.exports = {
+  applyBoundsAndTargets,
+  validateFlowBounds,
+  getRainIndex,
+  getPredictedFlowRate,
+  getSampleCooldownMs,
+  RAIN_STALE_MS,
+};

src/rain/rainAggregator.js

@@ -0,0 +1,58 @@
+'use strict';
+
+// Rain-data aggregator — sums per-location hourly precipitation, weighted
+// by per-hour probability, and stores both the raw and probability-weighted
+// values keyed by timestamp. sumRain/avgRain feed parameters.getRainIndex
+// which scales the predicted flow rate between nominalFlowMin and flowMax.
+
+class RainAggregator {
+  constructor({ logger } = {}) {
+    this.logger = logger;
+    this.aggregatedOutput = {};
+    this.sumRain = 0;
+    this.avgRain = 0;
+  }
+
+  // Returns the aggregated per-location object so callers can chain.
+  // Mutates this.aggregatedOutput / sumRain / avgRain in place.
+  update(value) {
+    if (!value) return this.aggregatedOutput;
+
+    const totalRaw = {};
+    const totalProb = {};
+    let numberOfLocations = 0;
+
+    Object.entries(value).forEach(([locationKey, location]) => {
+      numberOfLocations++;
+      const slot = (this.aggregatedOutput[locationKey] = {
+        tag: { latitude: location.latitude, longitude: location.longitude },
+        precipationRaw: {},
+        precipationProb: {},
+      });
+
+      Object.entries(location.hourly.time).forEach(([key, time]) => {
+        const currTimestamp = new Date(time).getTime();
+        let probability = 100;
+        if (typeof location.hourly.precipitation_probability !== 'undefined') {
+          probability = location.hourly.precipitation_probability[key];
+        }
+        if (probability > 0) probability /= 100;
+
+        if (totalRaw[currTimestamp] === undefined) totalRaw[currTimestamp] = 0;
+        if (totalProb[currTimestamp] === undefined) totalProb[currTimestamp] = 0;
+
+        totalRaw[currTimestamp] += location.hourly.precipitation[key];
+        totalProb[currTimestamp] += location.hourly.precipitation[key] * probability;
+
+        slot.precipationRaw[key] = { val: location.hourly.precipitation[key], time: currTimestamp };
+        slot.precipationProb[key] = { val: probability, time: currTimestamp };
+      });
+    });
+
+    this.sumRain = Object.values(totalProb).reduce((s, v) => s + v, 0);
+    this.avgRain = numberOfLocations > 0 ? this.sumRain / numberOfLocations : 0;
+    return this.aggregatedOutput;
+  }
+}
+
+module.exports = RainAggregator;

src/sampling/samplingProgram.js

@@ -0,0 +1,113 @@
+'use strict';
+
+// Sampling program — the time-driven core. Each tick:
+//   1. on i_start or scheduled date → init a sampling run (m3PerPuls, stop_time)
+//   2. while running: integrate m3PerTick into temp_pulse; emit a pulse when
+//      it crosses 1 unless the cooldown guard blocks it
+//   3. after stop_time: clear running state.
+// flowCalc derives m3PerTick from the latest q (m3/h) and the wall-clock
+// delta since the last call — runs once per tick before sampling_program.
+
+const params = require('../parameters/parameters');
+const { regNextDate } = require('../schedule/schedule');
+
+function getModelPrediction(m) {
+  const samplingHours = Number(m.sampling_time) || 0;
+  const predictedRate = params.getPredictedFlowRate(m);
+  const fallbackRate = m.flowTracker.getEffectiveFlow();
+  const flowM3PerHour = predictedRate > 0 ? predictedRate : fallbackRate;
+  m.predFlow = Math.max(0, flowM3PerHour * samplingHours);
+  return m.predFlow;
+}
+
+function flowCalc(m) {
+  const timePassed = m.flowTime > 0 ? (Date.now() - m.flowTime) / 1000 : 0;
+  m.m3PerTick = (m.q / 60 / 60) * timePassed;
+  m.flowTime = Date.now();
+}
+
+function _beginRun(m) {
+  m.running = true;
+  m.temp_pulse = 0;
+  m.pulse = false;
+  m.updateBucketVol(0);
+  m.sumPuls = 0;
+  m.m3Total = 0;
+  m.timePassed = 0;
+  m.timeLeft = 0;
+  m.predM3PerSec = 0;
+
+  getModelPrediction(m);
+  m.m3PerPuls = Math.round(m.predFlow / m.targetPuls);
+  m.predM3PerSec = m.predFlow / m.sampling_time / 60 / 60;
+  m.start_time = Date.now();
+  m.stop_time = Date.now() + (m.sampling_time * 60 * 60 * 1000);
+
+  regNextDate(m, m.monsternametijden);
+  m.i_start = false;
+}
+
+function _endRun(m) {
+  m.m3PerPuls = 0;
+  m.temp_pulse = 0;
+  m.pulse = false;
+  m.updateBucketVol(0);
+  m.sumPuls = 0;
+  m.timePassed = 0;
+  m.timeLeft = 0;
+  m.predFlow = 0;
+  m.predM3PerSec = 0;
+  m.m3Total = 0;
+  m.running = false;
+}
+
+function _maybeEmitPulse(m) {
+  if (!(m.temp_pulse >= 1 && m.sumPuls < m.absMaxPuls)) {
+    if (m.pulse) m.pulse = false;
+    return;
+  }
+
+  const now = Date.now();
+  const cooldownMs = m.minSampleIntervalSec * 1000;
+  const blocked = m.lastSampleTime && (now - m.lastSampleTime) < cooldownMs;
+
+  if (blocked) {
+    m.missedSamples++;
+    m.pulse = false;
+    m.temp_pulse = Math.min(m.temp_pulse, 1);
+    if (!m.lastSampleWarnTime || (now - m.lastSampleWarnTime) > cooldownMs) {
+      m.lastSampleWarnTime = now;
+      m.logger.warn(`Sampling too fast. Cooldown active for ${Math.ceil((cooldownMs - (now - m.lastSampleTime)) / 1000)}s.`);
+    }
+    return;
+  }
+
+  m.temp_pulse -= 1;
+  m.pulse = true;
+  m.lastSampleTime = now;
+  m.sumPuls++;
+  m.updateBucketVol(Math.round(m.sumPuls * m.volume_pulse * 100) / 100);
+}
+
+function samplingProgram(m) {
+  if (((m.i_start) || (Date.now() >= m.nextDate)) && !m.running) {
+    if (!params.validateFlowBounds(m)) {
+      m.running = false;
+      m.i_start = false;
+      return;
+    }
+    _beginRun(m);
+  }
+
+  if (m.stop_time > Date.now()) {
+    m.timePassed = Math.round((Date.now() - m.start_time) / 1000);
+    m.timeLeft = Math.round((m.stop_time - Date.now()) / 1000);
+    m.temp_pulse += m.m3PerTick / m.m3PerPuls;
+    m.m3Total += m.m3PerTick;
+    _maybeEmitPulse(m);
+  } else if (m.running) {
+    _endRun(m);
+  }
+}
+
+module.exports = { samplingProgram, flowCalc, getModelPrediction };

src/schedule/schedule.js

@@ -0,0 +1,42 @@
+'use strict';
+
+// AQUON sample schedule helpers. updateMonsternametijden validates the
+// row shape before storing; regNextDate walks the rows to find the next
+// future START_DATE for the configured aquonSampleName and counts how
+// many of those fall in the current calendar year.
+
+function updateMonsternametijden(m, value) {
+  if (!m.init || !value || Object.keys(value).length === 0) return;
+  if (
+    typeof value[0]?.SAMPLE_NAME !== 'undefined' &&
+    typeof value[0]?.DESCRIPTION !== 'undefined' &&
+    typeof value[0]?.SAMPLED_DATE !== 'undefined' &&
+    typeof value[0]?.START_DATE !== 'undefined' &&
+    typeof value[0]?.END_DATE !== 'undefined'
+  ) {
+    m.monsternametijden = value;
+    regNextDate(m, value);
+  }
+}
+
+function regNextDate(m, monsternametijden) {
+  let next_date = new Date(new Date().setFullYear(new Date().getFullYear() + 1));
+  let n_days_remaining = 0;
+
+  if (typeof monsternametijden !== 'undefined') {
+    Object.values(monsternametijden).forEach((line) => {
+      if (line.START_DATE === 'NULL') return;
+      const curr_date_conv = new Date(line.START_DATE);
+      const curr_date = curr_date_conv.getTime();
+      if (line.SAMPLE_NAME === m.aquonSampleName && curr_date > Date.now()) {
+        if (curr_date < next_date) next_date = curr_date;
+        if (new Date().getFullYear() === curr_date_conv.getFullYear()) n_days_remaining++;
+      }
+    });
+  }
+
+  m.daysPerYear = n_days_remaining;
+  m.nextDate = next_date;
+}
+
+module.exports = { updateMonsternametijden, regNextDate };

src/specificClass.js

@@ -0,0 +1,163 @@
+'use strict';
+
+// Monster — multi-parameter biological process monitoring (Unit-level).
+// Orchestrator only: wires the parameters/flow/rain/schedule/sampling
+// modules in configure() and calls them in tick(). The mutable sampling
+// state (running, sumPuls, m3PerPuls, …) lives on `this` so the existing
+// test surface (`monster.bucketVol`, `monster.q`, …) keeps working.
+
+const { BaseDomain } = require('generalFunctions');
+const params = require('./parameters/parameters');
+const FlowTracker = require('./flow/flowTracker');
+const RainAggregator = require('./rain/rainAggregator');
+const schedule = require('./schedule/schedule');
+const sampling = require('./sampling/samplingProgram');
+const { buildOutput } = require('./io/output');
+const { buildStatusBadge } = require('./io/statusBadge');
+
+class Monster extends BaseDomain {
+  static name = 'monster';
+
+  configure() {
+    this.init = false;
+
+    this._initState();
+    this._initSamplingDefaults();
+
+    this.flowTracker = new FlowTracker({ measurements: this.measurements, logger: this.logger });
+    this.rainAggregator = new RainAggregator({ logger: this.logger });
+
+    if (Number.isFinite(this.config?.constraints?.maxRainRef)) {
+      this.rainMaxRef = this.config.constraints.maxRainRef;
+    }
+
+    this.init = true;
+    params.applyBoundsAndTargets(this);
+
+    this.router.onRegister('measurement', (child) => this._wireMeasurementChild(child));
+  }
+
+  _initState() {
+    this.aquonSampleName = '112100';
+    this.monsternametijden = {};
+    this.rain_data = {};
+    this.aggregatedOutput = {};
+    this.sumRain = 0;
+    this.avgRain = 0;
+    this.daysPerYear = 0;
+    this.lastRainUpdate = 0;
+    this.rainMaxRef = 10;
+    this.predFactor = 0.7;
+    this.start_time = Date.now();
+    this.stop_time = Date.now();
+    this.flowTime = 0;
+    this.timePassed = 0;
+    this.timeLeft = 0;
+    this.currHour = new Date().getHours();
+  }
+
+  _initSamplingDefaults() {
+    const c = this.config.constraints || {};
+    const a = this.config.asset || {};
+
+    this.pulse = false;
+    this.bucketVol = 0;
+    this.sumPuls = 0;
+    this.predFlow = 0;
+    this.bucketWeight = 0;
+
+    this.q = 0;
+    this.i_start = false;
+    this.sampling_time = c.samplingtime;
+    this.emptyWeightBucket = a.emptyWeightBucket;
+    this.nominalFlowMin = c.nominalFlowMin;
+    this.flowMax = c.flowMax;
+    this.minSampleIntervalSec = c.minSampleIntervalSec || 60;
+
+    this.temp_pulse = 0;
+    this.volume_pulse = 0.05;
+    this.minVolume = c.minVolume;
+    this.maxVolume = 0;
+    this.maxWeight = c.maxWeight;
+    this.cap_volume = 55;
+    this.targetVolume = 0;
+    this.minPuls = 0;
+    this.maxPuls = 0;
+    this.absMaxPuls = 0;
+    this.targetPuls = 0;
+    this.m3PerPuls = 0;
+    this.predM3PerSec = 0;
+    this.m3PerTick = 0;
+    this.m3Total = 0;
+    this.running = false;
+    this.invalidFlowBounds = false;
+    this.lastSampleTime = 0;
+    this.lastSampleWarnTime = 0;
+    this.missedSamples = 0;
+  }
+
+  _wireMeasurementChild(child) {
+    if (!child?.measurements?.emitter) return;
+    const childType = child?.config?.asset?.type;
+    if (childType && childType !== 'flow') return;
+
+    const handler = (eventData) => this.flowTracker.handleMeasuredFlow(eventData);
+    child.measurements.emitter.on('flow.measured.upstream', handler);
+    child.measurements.emitter.on('flow.measured.downstream', handler);
+    child.measurements.emitter.on('flow.measured.atequipment', handler);
+  }
+
+  handleInput(topic, payload) {
+    switch (topic) {
+      case 'i_start':           this.i_start = Boolean(payload); break;
+      case 'monsternametijden': schedule.updateMonsternametijden(this, payload); break;
+      case 'rain_data':         this.updateRainData(payload); break;
+      case 'input_q':           this.flowTracker.updateManualFlow(payload); break;
+      default: break;
+    }
+  }
+
+  updateRainData(value) {
+    this.rain_data = value;
+    this.lastRainUpdate = Date.now();
+    if (this.init && !this.running) {
+      this.aggregatedOutput = this.rainAggregator.update(value);
+      this.sumRain = this.rainAggregator.sumRain;
+      this.avgRain = this.rainAggregator.avgRain;
+    }
+  }
+
+  updateBucketVol(val) {
+    this.bucketVol = val;
+    this.bucketWeight = val + this.emptyWeightBucket;
+  }
+
+  // Public surface kept for legacy tests (sampling-guards, factories.js).
+  getSampleCooldownMs()    { return params.getSampleCooldownMs(this); }
+  validateFlowBounds()     { return params.validateFlowBounds(this); }
+  getRainIndex()           { return params.getRainIndex(this); }
+  getPredictedFlowRate()   { return params.getPredictedFlowRate(this); }
+  getMeasuredFlow()        { return this.flowTracker.getMeasuredFlow(); }
+  getManualFlow()          { return this.flowTracker.getManualFlow(); }
+  getEffectiveFlow()       { return this.flowTracker.getEffectiveFlow(); }
+  get_model_prediction()   { return sampling.getModelPrediction(this); }
+  flowCalc()               { sampling.flowCalc(this); }
+  sampling_program()       { sampling.samplingProgram(this); }
+  set_boundries_and_targets() { params.applyBoundsAndTargets(this); }
+  regNextDate(rows)        { schedule.regNextDate(this, rows); }
+  updateMonsternametijden(v) { schedule.updateMonsternametijden(this, v); }
+  updatePredRain(v)        { return this.rainAggregator.update(v); }
+
+  tick() {
+    this.logger.debug('Monster tick running');
+    this.q = this.flowTracker.getEffectiveFlow();
+    this.flowCalc();
+    this.sampling_program();
+    this.notifyOutputChanged();
+  }
+
+  getOutput()      { return buildOutput(this); }
+  getStatusBadge() { return buildStatusBadge(this); }
+}
+
+module.exports = Monster;

test/README.md

@@ -0,0 +1,12 @@
+# monster Test Suite Layout
+
+Required EVOLV layout:
+- basic/
+- integration/
+- edge/
+- helpers/
+
+Baseline structure tests:
+- basic/structure-module-load.basic.test.js
+- integration/structure-examples.integration.test.js
+- edge/structure-examples-node-type.edge.test.js

test/basic/constructor.basic.test.js

@@ -0,0 +1,27 @@
+const test = require('node:test');
+const assert = require('node:assert/strict');
+
+const Monster = require('../../src/specificClass');
+const { makeMonsterConfig } = require('../helpers/factories');
+
+test('constructor initializes sampling boundaries and target values', () => {
+  const monster = new Monster(makeMonsterConfig());
+
+  assert.equal(monster.maxVolume, 20);
+  assert.equal(monster.minPuls, Math.round(monster.minVolume / monster.volume_pulse));
+  assert.equal(monster.absMaxPuls, Math.round(monster.cap_volume / monster.volume_pulse));
+  assert.ok(monster.targetPuls > 0);
+});
+
+test('output contract contains report tooling fields', () => {
+  const monster = new Monster(makeMonsterConfig());
+  const output = monster.getOutput();
+
+  assert.ok(Object.prototype.hasOwnProperty.call(output, 'm3PerPuls'));
+  assert.ok(Object.prototype.hasOwnProperty.call(output, 'm3PerPulse'));
+  assert.ok(Object.prototype.hasOwnProperty.call(output, 'm3Total'));
+  assert.ok(Object.prototype.hasOwnProperty.call(output, 'pulse'));
+  assert.ok(Object.prototype.hasOwnProperty.call(output, 'pulsesRemaining'));
+  assert.ok(Object.prototype.hasOwnProperty.call(output, 'targetDeltaM3'));
+  assert.ok(Object.prototype.hasOwnProperty.call(output, 'predictedRateM3h'));
+});

test/basic/structure-module-load.basic.test.js

@@ -0,0 +1,8 @@
+const test = require('node:test');
+const assert = require('node:assert/strict');
+
+test('monster module load smoke', () => {
+  assert.doesNotThrow(() => {
+    require('../../monster.js');
+  });
+});

test/edge/sampling-guards.edge.test.js

@@ -0,0 +1,58 @@
+const test = require('node:test');
+const assert = require('node:assert/strict');
+
+const Monster = require('../../src/specificClass');
+const { makeMonsterConfig, withMockedDate } = require('../helpers/factories');
+
+test('invalid flow bounds prevent sampling start', () => {
+  const monster = new Monster(
+    makeMonsterConfig({
+      constraints: {
+        samplingtime: 1,
+        minVolume: 5,
+        maxWeight: 23,
+        nominalFlowMin: 10,
+        flowMax: 5,
+        minSampleIntervalSec: 60,
+      },
+    })
+  );
+
+  monster.handleInput('i_start', true);
+  monster.sampling_program();
+
+  assert.equal(monster.invalidFlowBounds, true);
+  assert.equal(monster.running, false);
+  assert.equal(monster.i_start, false);
+});
+
+test('cooldown guard blocks pulses when flow implies oversampling', () => {
+  withMockedDate('2024-10-15T00:00:00Z', ({ advance }) => {
+    const monster = new Monster(
+      makeMonsterConfig({
+        constraints: {
+          samplingtime: 1,
+          minVolume: 5,
+          maxWeight: 23,
+          nominalFlowMin: 0,
+          flowMax: 6000,
+          maxRainRef: 10,
+          minSampleIntervalSec: 60,
+        },
+      })
+    );
+
+    monster.handleInput('input_q', { value: 200, unit: 'm3/h' });
+    monster.handleInput('i_start', true);
+
+    for (let i = 0; i < 80; i++) {
+      advance(1000);
+      monster.tick();
+    }
+
+    assert.ok(monster.sumPuls > 0);
+    assert.ok(monster.bucketVol > 0);
+    assert.ok(monster.missedSamples > 0);
+    assert.ok(monster.getSampleCooldownMs() > 0);
+  });
+});

test/edge/structure-examples-node-type.edge.test.js

@@ -0,0 +1,21 @@
+const test = require('node:test');
+const assert = require('node:assert/strict');
+const fs = require('node:fs');
+const path = require('node:path');
+
+const dir = path.resolve(__dirname, '../../examples');
+const exampleFlows = [
+  'basic.flow.json',
+  'integration.flow.json',
+  'edge.flow.json',
+  'monster-dashboard.flow.json',
+  'monster-api-dashboard.flow.json'
+];
+
+test('all example flows include node type monster', () => {
+  for (const file of exampleFlows) {
+    const flow = JSON.parse(fs.readFileSync(path.join(dir, file), 'utf8'));
+    const count = flow.filter((n) => n && n.type === 'monster').length;
+    assert.equal(count >= 1, true, file + ' missing monster node');
+  }
+});

test/helpers/factories.js

@@ -0,0 +1,128 @@
+const fs = require('node:fs');
+const path = require('node:path');
+const { MeasurementContainer } = require('generalFunctions');
+
+function makeMonsterConfig(overrides = {}) {
+  return {
+    general: {
+      name: 'Monster Test',
+      logging: { enabled: false, logLevel: 'error' },
+    },
+    asset: {
+      emptyWeightBucket: 3,
+    },
+    constraints: {
+      samplingtime: 1,
+      minVolume: 5,
+      maxWeight: 23,
+      nominalFlowMin: 1000,
+      flowMax: 6000,
+      maxRainRef: 10,
+      minSampleIntervalSec: 60,
+    },
+    ...overrides,
+  };
+}
+
+function withMockedDate(iso, fn) {
+  const RealDate = Date;
+  let now = new RealDate(iso).getTime();
+
+  class MockDate extends RealDate {
+    constructor(...args) {
+      if (args.length === 0) {
+        super(now);
+      } else {
+        super(...args);
+      }
+    }
+
+    static now() {
+      return now;
+    }
+  }
+
+  global.Date = MockDate;
+  try {
+    return fn({
+      advance(ms) {
+        now += ms;
+      },
+    });
+  } finally {
+    global.Date = RealDate;
+  }
+}
+
+function parseMonsternametijdenCsv(filePath) {
+  const raw = fs.readFileSync(filePath, 'utf8').trim();
+  const lines = raw.split(/\r?\n/);
+  const header = lines.shift();
+  const columns = header.split(',');
+
+  return lines
+    .filter((line) => line && !line.startsWith('-----------'))
+    .map((line) => {
+      const parts = [];
+      let cur = '';
+      let inQ = false;
+      for (let i = 0; i < line.length; i++) {
+        const ch = line[i];
+        if (ch === '"') {
+          inQ = !inQ;
+          continue;
+        }
+        if (ch === ',' && !inQ) {
+          parts.push(cur);
+          cur = '';
+        } else {
+          cur += ch;
+        }
+      }
+      parts.push(cur);
+      const obj = {};
+      columns.forEach((col, idx) => {
+        obj[col] = parts[idx];
+      });
+      return obj;
+    });
+}
+
+function makeFlowMeasurementChild({
+  id = 'flow-child-1',
+  name = 'FlowSensor',
+  positionVsParent = 'downstream',
+  unit = 'm3/h',
+} = {}) {
+  const measurements = new MeasurementContainer({
+    autoConvert: true,
+    defaultUnits: { flow: 'm3/h' },
+  });
+
+  return {
+    config: {
+      general: { id, name, unit },
+      functionality: { positionVsParent },
+      asset: { type: 'flow', unit },
+    },
+    measurements,
+  };
+}
+
+function loadRainSeed() {
+  const rainPath = path.join(__dirname, '..', 'seed_data', 'raindataFormat.json');
+  return JSON.parse(fs.readFileSync(rainPath, 'utf8'));
+}
+
+function loadScheduleSeed() {
+  const csvPath = path.join(__dirname, '..', 'seed_data', 'monsternametijden.csv');
+  return parseMonsternametijdenCsv(csvPath);
+}
+
+module.exports = {
+  makeMonsterConfig,
+  withMockedDate,
+  makeFlowMeasurementChild,
+  loadRainSeed,
+  loadScheduleSeed,
+};

test/integration/flow-and-schedule.integration.test.js

@@ -0,0 +1,49 @@
+const test = require('node:test');
+const assert = require('node:assert/strict');
+
+const Monster = require('../../src/specificClass');
+const {
+  makeMonsterConfig,
+  withMockedDate,
+  makeFlowMeasurementChild,
+  loadRainSeed,
+  loadScheduleSeed,
+} = require('../helpers/factories');
+
+test('effective flow uses average of measured and manual flow', () => {
+  withMockedDate('2024-10-15T00:00:00Z', ({ advance }) => {
+    const monster = new Monster(makeMonsterConfig());
+    const child = makeFlowMeasurementChild({ positionVsParent: 'downstream' });
+    monster.registerChild(child, 'measurement');
+
+    child.measurements
+      .type('flow')
+      .variant('measured')
+      .position('downstream')
+      .value(60, Date.now(), 'm3/h');
+
+    monster.handleInput('input_q', { value: 20, unit: 'm3/h' });
+    advance(1000);
+    monster.tick();
+
+    assert.equal(monster.q, 40);
+  });
+});
+
+test('rain and schedule payloads update prediction context and next date', () => {
+  withMockedDate('2024-10-15T00:00:00Z', () => {
+    const monster = new Monster(makeMonsterConfig());
+    const rain = loadRainSeed();
+    const schedule = loadScheduleSeed();
+
+    monster.aquonSampleName = '112100';
+    monster.handleInput('rain_data', rain);
+    monster.handleInput('monsternametijden', schedule);
+
+    assert.ok(monster.avgRain >= 0);
+    assert.ok(monster.sumRain >= 0);
+    const nextDate = monster.nextDate instanceof Date ? monster.nextDate.getTime() : Number(monster.nextDate);
+    assert.ok(Number.isFinite(nextDate));
+    assert.ok(nextDate > Date.now());
+  });
+});

test/integration/structure-examples.integration.test.js

@@ -0,0 +1,32 @@
+const test = require('node:test');
+const assert = require('node:assert/strict');
+const fs = require('node:fs');
+const path = require('node:path');
+
+const dir = path.resolve(__dirname, '../../examples');
+const requiredFiles = [
+  'README.md',
+  'basic.flow.json',
+  'integration.flow.json',
+  'edge.flow.json',
+  'monster-dashboard.flow.json',
+  'monster-api-dashboard.flow.json'
+];
+const flowFiles = requiredFiles.filter((file) => file.endsWith('.flow.json'));
+
+function loadJson(file) {
+  return JSON.parse(fs.readFileSync(path.join(dir, file), 'utf8'));
+}
+
+test('examples package exists for monster', () => {
+  for (const file of requiredFiles) {
+    assert.equal(fs.existsSync(path.join(dir, file)), true, file + ' missing');
+  }
+});
+
+test('example flows are parseable arrays for monster', () => {
+  for (const file of flowFiles) {
+    const parsed = loadJson(file);
+    assert.equal(Array.isArray(parsed), true);
+  }
+});

test/monster.specific.test.js

@@ -0,0 +1,257 @@
+const assert = require('assert');
+const fs = require('fs');
+const path = require('path');
+
+const Monster = require('../src/specificClass');
+const { MeasurementContainer } = require('generalFunctions');
+
+function test(name, fn) {
+  try {
+    fn();
+    console.log(`ok - ${name}`);
+  } catch (err) {
+    console.error(`not ok - ${name}`);
+    console.error(err);
+    process.exitCode = 1;
+  }
+}
+
+function withMockedDate(iso, fn) {
+  const RealDate = Date;
+  let now = new RealDate(iso).getTime();
+
+  class MockDate extends RealDate {
+    constructor(...args) {
+      if (args.length === 0) {
+        super(now);
+      } else {
+        super(...args);
+      }
+    }
+
+    static now() {
+      return now;
+    }
+  }
+
+  global.Date = MockDate;
+  try {
+    return fn({
+      advance(ms) {
+        now += ms;
+      }
+    });
+  } finally {
+    global.Date = RealDate;
+  }
+}
+
+function buildConfig(overrides = {}) {
+  return {
+    general: {
+      name: 'Monster Test',
+      logging: { enabled: false, logLevel: 'error' }
+    },
+    asset: {
+      emptyWeightBucket: 3
+    },
+    constraints: {
+      samplingtime: 1,
+      minVolume: 5,
+      maxWeight: 23,
+      nominalFlowMin: 1,
+      flowMax: 10
+    },
+    ...overrides
+  };
+}
+
+function parseMonsternametijdenCsv(filePath) {
+  const raw = fs.readFileSync(filePath, 'utf8').trim();
+  const lines = raw.split(/\r?\n/);
+  const header = lines.shift();
+  const columns = header.split(',');
+
+  return lines
+    .filter((line) => line && !line.startsWith('-----------'))
+    .map((line) => {
+      const parts = [];
+      let cur = '';
+      let inQ = false;
+      for (let i = 0; i < line.length; i++) {
+        const ch = line[i];
+        if (ch === '"') {
+          inQ = !inQ;
+          continue;
+        }
+        if (ch === ',' && !inQ) {
+          parts.push(cur);
+          cur = '';
+        } else {
+          cur += ch;
+        }
+      }
+      parts.push(cur);
+      const obj = {};
+      columns.forEach((col, idx) => {
+        obj[col] = parts[idx];
+      });
+      return obj;
+    });
+}
+
+test('measured + manual flow averages into effective flow', () => {
+  withMockedDate('2024-10-15T00:00:00Z', ({ advance }) => {
+    const monster = new Monster(buildConfig());
+
+    const child = {
+      config: {
+        general: { id: 'child-1', name: 'FlowSensor' },
+        asset: { type: 'flow' }
+      },
+      measurements: new MeasurementContainer({
+        autoConvert: true,
+        defaultUnits: { flow: 'm3/h' }
+      })
+    };
+
+    monster.registerChild(child, 'measurement');
+
+    child.measurements
+      .type('flow')
+      .variant('measured')
+      .position('downstream')
+      .value(60, Date.now(), 'm3/h');
+
+    monster.handleInput('input_q', { value: 20, unit: 'm3/h' });
+
+    advance(1000);
+    monster.tick();
+
+    assert.strictEqual(monster.q, 40);
+  });
+});
+
+test('invalid flow bounds prevent sampling start', () => {
+  const monster = new Monster(buildConfig({
+    constraints: {
+      samplingtime: 1,
+      minVolume: 5,
+      maxWeight: 23,
+      nominalFlowMin: 10,
+      flowMax: 5
+    }
+  }));
+
+  monster.handleInput('i_start', true);
+  monster.sampling_program();
+
+  assert.strictEqual(monster.invalidFlowBounds, true);
+  assert.strictEqual(monster.running, false);
+  assert.strictEqual(monster.i_start, false);
+});
+
+test('flowCalc uses elapsed time to compute m3PerTick', () => {
+  withMockedDate('2024-10-15T00:00:00Z', ({ advance }) => {
+    const monster = new Monster(buildConfig());
+    monster.q = 36; // m3/h
+
+    monster.flowCalc();
+    assert.strictEqual(monster.m3PerTick, 0);
+
+    advance(10000);
+    monster.flowCalc();
+
+    const expected = 0.1; // 36 m3/h -> 0.01 m3/s over 10s
+    assert.ok(Math.abs(monster.m3PerTick - expected) < 1e-6);
+  });
+});
+
+test('prediction fallback uses nominalFlowMin * sampling_time when rain is stale', () => {
+  const monster = new Monster(buildConfig());
+  monster.nominalFlowMin = 4;
+  monster.flowMax = 10;
+  monster.rainMaxRef = 8;
+  monster.sampling_time = 24;
+  monster.lastRainUpdate = 0;
+  const pred = monster.get_model_prediction();
+  assert.strictEqual(pred, 96);
+});
+
+test('pulses increment when running with manual flow and zero nominalFlowMin', () => {
+  withMockedDate('2024-10-15T00:00:00Z', ({ advance }) => {
+    const monster = new Monster(buildConfig({
+      constraints: {
+        samplingtime: 1,
+        minVolume: 5,
+        maxWeight: 23,
+        nominalFlowMin: 0,
+        flowMax: 6000,
+        minSampleIntervalSec: 60,
+        maxRainRef: 10
+      }
+    }));
+
+    monster.handleInput('input_q', { value: 200, unit: 'm3/h' });
+    monster.handleInput('i_start', true);
+
+    for (let i = 0; i < 80; i++) {
+      advance(1000);
+      monster.tick();
+    }
+
+    assert.ok(monster.sumPuls > 0);
+    assert.ok(monster.bucketVol > 0);
+    assert.ok(monster.missedSamples > 0);
+    assert.ok(monster.getSampleCooldownMs() > 0);
+  });
+});
+
+test('rain data aggregation produces totals', () => {
+  const monster = new Monster(buildConfig());
+  const rainPath = path.join(__dirname, 'seed_data', 'raindataFormat.json');
+  const rainData = JSON.parse(fs.readFileSync(rainPath, 'utf8'));
+
+  monster.updateRainData(rainData);
+
+  assert.ok(Object.keys(monster.aggregatedOutput).length > 0);
+  assert.ok(monster.sumRain >= 0);
+  assert.ok(monster.avgRain >= 0);
+});
+
+test('monsternametijden schedule sets next date', () => {
+  withMockedDate('2024-10-15T00:00:00Z', () => {
+    const monster = new Monster(buildConfig());
+    const csvPath = path.join(__dirname, 'seed_data', 'monsternametijden.csv');
+    const rows = parseMonsternametijdenCsv(csvPath);
+
+    monster.aquonSampleName = '112100';
+    monster.updateMonsternametijden(rows);
+
+    const nextDate = monster.nextDate instanceof Date
+      ? monster.nextDate.getTime()
+      : Number(monster.nextDate);
+
+    assert.ok(Number.isFinite(nextDate));
+    assert.ok(nextDate > Date.now());
+  });
+});
+
+test('output includes pulse and flow fields', () => {
+  const monster = new Monster(buildConfig());
+  const output = monster.getOutput();
+
+  assert.ok(Object.prototype.hasOwnProperty.call(output, 'pulse'));
+  assert.ok(Object.prototype.hasOwnProperty.call(output, 'q'));
+  assert.ok(Object.prototype.hasOwnProperty.call(output, 'm3PerPuls'));
+  assert.ok(Object.prototype.hasOwnProperty.call(output, 'm3PerPulse'));
+  assert.ok(Object.prototype.hasOwnProperty.call(output, 'pulsesRemaining'));
+  assert.ok(Object.prototype.hasOwnProperty.call(output, 'pulseFraction'));
+  assert.ok(Object.prototype.hasOwnProperty.call(output, 'flowToNextPulseM3'));
+  assert.ok(Object.prototype.hasOwnProperty.call(output, 'timeToNextPulseSec'));
+  assert.ok(Object.prototype.hasOwnProperty.call(output, 'targetVolumeM3'));
+  assert.ok(Object.prototype.hasOwnProperty.call(output, 'targetProgressPct'));
+  assert.ok(Object.prototype.hasOwnProperty.call(output, 'targetDeltaL'));
+  assert.ok(Object.prototype.hasOwnProperty.call(output, 'targetDeltaM3'));
+  assert.ok(Object.prototype.hasOwnProperty.call(output, 'predictedRateM3h'));
+});

test/specificClass.test.js

@@ -0,0 +1,95 @@
+const Monster = require('../src/specificClass');
+
+describe('monster specificClass', () => {
+  function createMonster(overrides = {}) {
+    return new Monster({
+      general: {
+        name: 'Monster Test',
+        unit: 'm3/h',
+        logging: {
+          enabled: false,
+          logLevel: 'error',
+        },
+      },
+      asset: {
+        emptyWeightBucket: 3,
+      },
+      constraints: {
+        samplingtime: 1,
+        minVolume: 5,
+        maxWeight: 23,
+      },
+      functionality: {
+        aquonSampleName: '112100',
+      },
+      ...overrides,
+    });
+  }
+
+  test('aggregates rain data and exposes output state', () => {
+    const monster = createMonster();
+
+    monster.rain_data = [
+      {
+        latitude: 51.7,
+        longitude: 4.81,
+        hourly: {
+          time: ['2026-03-12T00:00', '2026-03-12T01:00'],
+          precipitation: [1, 3],
+          precipitation_probability: [100, 50],
+        },
+      },
+      {
+        latitude: 51.8,
+        longitude: 4.91,
+        hourly: {
+          time: ['2026-03-12T00:00', '2026-03-12T01:00'],
+          precipitation: [2, 2],
+          precipitation_probability: [100, 100],
+        },
+      },
+    ];
+
+    const output = monster.getOutput();
+
+    expect(monster.sumRain).toBe(6.5);
+    expect(monster.avgRain).toBe(3.25);
+    expect(output.sumRain).toBe(6.5);
+    expect(output.avgRain).toBe(3.25);
+  });
+
+  test('supports external prediction input and starts sampling safely', () => {
+    const monster = createMonster();
+
+    monster.setModelPrediction(120);
+    monster.q = 3600;
+    monster.i_start = true;
+    monster.flowTime = Date.now() - 1000;
+
+    monster.tick();
+
+    const output = monster.getOutput();
+    expect(output.running).toBe(true);
+    expect(output.predFlow).toBe(120);
+    expect(output.predM3PerSec).toBeCloseTo(120 / 3600, 6);
+  });
+
+  test('calculates the next AQUON date from monsternametijden input', () => {
+    const monster = createMonster();
+    const nextMonth = new Date();
+    nextMonth.setMonth(nextMonth.getMonth() + 1);
+
+    monster.monsternametijden = [
+      {
+        SAMPLE_NAME: '112100',
+        DESCRIPTION: 'future sample',
+        SAMPLED_DATE: null,
+        START_DATE: nextMonth.toISOString(),
+        END_DATE: nextMonth.toISOString(),
+      },
+    ];
+
+    expect(monster.daysPerYear).toBeGreaterThanOrEqual(0);
+    expect(monster.nextDate).toBeGreaterThan(Date.now());
+  });
+});

wiki/Home.md

@@ -0,0 +1,312 @@
+# monster
+
+> **Reflects code as of `2a6a0bc` · regenerated `2026-05-11` via `npm run wiki:all`**
+> If this banner is stale, the page may be out of date. Treat as informative, not authoritative.
+
+## 1. What this node is
+
+**monster** is an S88 Unit that runs an AQUON-scheduled flow-proportional sampling program. It aggregates measured + manual flow, blends a rain-scaled prediction, and emits a `pulse` whenever the integrated volume crosses `m³ per pulse`. Drives the physical "monsternamekast" (composite sampling cabinet) on a wastewater treatment plant.
+
+## 2. Position in the platform
+
+```mermaid
+flowchart LR
+    parent[plant parent<br/>Process Cell]:::pc
+    monster[monster<br/>Unit]:::unit
+    flow_up[measurement<br/>type=flow<br/>position=upstream]:::ctrl
+    flow_at[measurement<br/>type=flow<br/>position=atequipment]:::ctrl
+    op[(operator / AQUON)]
+    weather[(Open-Meteo)]
+
+    flow_up -->|flow.measured.upstream| monster
+    flow_at -->|flow.measured.atequipment| monster
+    op -->|set.schedule / data.flow / cmd.start| monster
+    weather -->|set.rain| monster
+    monster -->|child.register| parent
+    monster -.evt.output.-> parent
+    classDef pc fill:#0c99d9,color:#fff
+    classDef unit fill:#50a8d9,color:#000
+    classDef ctrl fill:#a9daee,color:#000
+```
+
+S88 colours: Process Cell `#0c99d9`, Unit `#50a8d9`, Control Module `#a9daee`. Source of truth: `.claude/rules/node-red-flow-layout.md`.
+
+## 3. Capability matrix
+
+| Capability | Status | Notes |
+|---|---|---|
+| Flow-proportional sampling pulse | ✅ | Triggered when integrated `temp_pulse` ≥ 1. |
+| Time-bounded sampling run | ✅ | Run length governed by `constraints.samplingtime` (hours). |
+| AQUON schedule auto-start | ✅ | `set.schedule` parses AQUON rows; `nextDate` arms the next run. |
+| Rain-scaled flow prediction | ✅ | `set.rain` aggregates Open-Meteo hourly precipitation into `sumRain` / `avgRain`. |
+| Measured + manual flow blend | ✅ | `flowTracker.getEffectiveFlow()` picks measured if recent, else manual. |
+| Minimum sample-interval cooldown | ✅ | Skips pulses inside `minSampleIntervalSec` window. |
+| Bucket / weight tracking | ✅ | `bucketVol`, `bucketWeight` track the composite container. |
+| Sub-sample volume override | ❌ | `subSampleVolume` fixed at 50 mL per schema. |
+| Stateful FSM | ❌ | Monster is run/idle only — no formal state machine. |
+
+## 4. Code map
+
+```mermaid
+flowchart TB
+    subgraph nodeRED["nodeClass.js — adapter (BaseNodeAdapter)"]
+        nc["buildDomainConfig()<br/>static DomainClass = Monster<br/>static commands"]
+    end
+    subgraph domain["specificClass.js — orchestrator (BaseDomain)"]
+        sc["Monster.configure()<br/>wires concerns, ChildRouter rules<br/>tick() → flowCalc → samplingProgram"]
+    end
+    subgraph concerns["src/ concern modules"]
+        parameters["parameters/<br/>bounds + targets + rain index"]
+        flow["flow/<br/>FlowTracker (measured + manual)"]
+        rain["rain/<br/>RainAggregator (sum + avg)"]
+        schedule["schedule/<br/>AQUON next-date parser"]
+        sampling["sampling/<br/>samplingProgram + flowCalc"]
+        io["io/<br/>output + statusBadge"]
+        commands["commands/<br/>topic registry + handlers"]
+    end
+    nc --> sc
+    sc --> parameters
+    sc --> flow
+    sc --> rain
+    sc --> schedule
+    sc --> sampling
+    sc --> io
+    nc --> commands
+```
+
+| Module | Owns | Read first if you're changing… |
+|---|---|---|
+| `parameters/` | Bounds (`minPuls`, `absMaxPuls`, `targetPuls`), rain-index lookup, predicted-flow rate. | Sampling bounds, rain scaling math. |
+| `flow/` | `FlowTracker` — measured-child latch + manual flow + effective-flow pick. | Flow source priority, dead-band logic. |
+| `rain/` | `RainAggregator` — fold hourly Open-Meteo rows into `sumRain` / `avgRain`. | Rain inputs, forecast horizon. |
+| `schedule/` | AQUON schedule parsing, `nextDate` + `daysPerYear` derivation. | Schedule arming, sample-name filtering. |
+| `sampling/` | `_beginRun` / `_endRun` / `_maybeEmitPulse` — pulse integrator + cooldown guard. | Pulse timing, cooldown behaviour. |
+| `io/` | `buildOutput`, `buildStatusBadge`. | Port-0 payload shape, status badge text. |
+| `commands/` | Topic registry + payload validation + unit conversion. | New input topics, alias deprecation. |
+
+## 5. Topic contract
+
+> **Auto-generated** from `src/commands/index.js`. Do NOT hand-edit between the markers. Re-run `npm run wiki:contract`.
+
+<!-- BEGIN AUTOGEN: topic-contract -->
+
+| Canonical topic | Aliases | Payload | Unit | Effect |
+|---|---|---|---|---|
+| `cmd.start` | `i_start` | `any` | — | Trigger / release the sampler start gate. |
+| `set.schedule` | `monsternametijden` | `any` | — | Replace the sampling-times schedule. |
+| `set.rain` | `rain_data` | `any` | — | Push current rain-event data into the sampler logic. |
+| `data.flow` | `input_q` | `object` | — | Push the upstream flow measurement (payload: {value, unit}). |
+| `set.mode` | `setMode` | `any` | — | Switch the monster between auto / manual modes. |
+| `set.model-prediction` | `model_prediction` | `any` | — | Push the upstream rain-prediction snapshot used by the sampler. |
+| `child.register` | `registerChild` | `string` | — | Register a child node (typically a measurement) with this monster. |
+
+<!-- END AUTOGEN: topic-contract -->
+
+## 6. Child registration
+
+Mirrors the `ChildRouter` declaration in `specificClass.js → configure()`. Monster only accepts `measurement` children whose `asset.type` is `flow` (or unset).
+
+```mermaid
+flowchart LR
+    subgraph kids["accepted children (softwareType)"]
+        m_up["measurement<br/>asset.type=flow<br/>position=upstream"]:::ctrl
+        m_at["measurement<br/>asset.type=flow<br/>position=atequipment"]:::ctrl
+        m_dn["measurement<br/>asset.type=flow<br/>position=downstream"]:::ctrl
+    end
+    m_up -->|flow.measured.upstream| ft[FlowTracker.handleMeasuredFlow]
+    m_at -->|flow.measured.atequipment| ft
+    m_dn -->|flow.measured.downstream| ft
+    ft --> eff[getEffectiveFlow]
+    classDef ctrl fill:#a9daee,color:#000
+```
+
+| softwareType | filter | wired to | side-effect |
+|---|---|---|---|
+| `measurement` | `asset.type=flow` (or missing) | `flowTracker.handleMeasuredFlow` | Latches latest measured flow for `getEffectiveFlow`. |
+| `measurement` | `asset.type` anything else | _ignored_ | Logged once at register. |
+
+## 7. Lifecycle — the sampling-program loop
+
+```mermaid
+sequenceDiagram
+    participant child as measurement child
+    participant ops as operator / AQUON
+    participant monster as monster
+    participant ft as flowTracker
+    participant sp as samplingProgram
+    participant out as Port-0 output
+
+    child->>monster: flow.measured.<position>
+    ops->>monster: set.schedule / cmd.start / data.flow
+    Note over monster: every 1000 ms tick
+    monster->>ft: getEffectiveFlow()
+    monster->>monster: flowCalc → m3PerTick
+    monster->>sp: samplingProgram
+    alt cmd.start OR Date.now() ≥ nextDate
+        sp->>sp: validateFlowBounds → _beginRun
+    end
+    alt running AND stop_time > now
+        sp->>sp: integrate temp_pulse += m3PerTick / m3PerPuls
+        sp->>sp: _maybeEmitPulse (cooldown-guarded)
+    else stop_time elapsed
+        sp->>sp: _endRun
+    end
+    monster->>out: msg{topic, payload (delta-compressed)}
+```
+
+One pulse per integrated `m³ per pulse`. The cooldown guard suppresses pulses inside `minSampleIntervalSec` and increments `missedSamples`.
+
+## 8. Data model — `getOutput()`
+
+What lands on Port 0. Built in `buildOutput()` from `m.measurements.getFlattenedOutput()` plus the sampling-run snapshot.
+
+<!-- BEGIN AUTOGEN: data-model -->
+
+| Key | Type | Unit | Sample |
+|---|---|---|---|
+| `avgRain` | number | — | `0` |
+| `bucketVol` | number | — | `0` |
+| `bucketWeight` | number | — | `0` |
+| `daysPerYear` | number | — | `0` |
+| `flowMax` | number | — | `0` |
+| `flowToNextPulseM3` | number | — | `0` |
+| `invalidFlowBounds` | boolean | — | `false` |
+| `m3PerPuls` | number | — | `0` |
+| `m3PerPulse` | number | — | `0` |
+| `m3Total` | number | — | `0` |
+| `maxVolume` | number | — | `20` |
+| `minSampleIntervalSec` | number | — | `60` |
+| `minVolume` | number | — | `5` |
+| `missedSamples` | number | — | `0` |
+| `nextDate` | undefined | — | `null` |
+| `nominalFlowMin` | number | — | `0` |
+| `predFlow` | number | — | `0` |
+| `predM3PerSec` | number | — | `0` |
+| `predictedRateM3h` | number | — | `0` |
+| `pulse` | boolean | — | `false` |
+| `pulseFraction` | number | — | `0` |
+| `pulsesRemaining` | number | — | `200` |
+| `q` | number | — | `0` |
+| `running` | boolean | — | `false` |
+| `sampleCooldownMs` | number | — | `0` |
+| `sumPuls` | number | — | `0` |
+| `sumRain` | number | — | `0` |
+| `targetDeltaL` | number | — | `-10` |
+| `targetDeltaM3` | number | — | `-0.01` |
+| `targetProgressPct` | number | — | `0` |
+| `targetVolumeM3` | number | — | `0.01` |
+| `timeLeft` | number | — | `0` |
+| `timePassed` | number | — | `0` |
+| `timeToNextPulseSec` | number | — | `0` |
+
+<!-- END AUTOGEN: data-model -->
+
+**Concrete sample** (mid-run snapshot):
+
+```json
+{
+  "pulse": false,
+  "running": true,
+  "bucketVol": 1.25,
+  "sumPuls": 25,
+  "predFlow": 240.0,
+  "m3PerPuls": 4,
+  "q": 215.4,
+  "timeLeft": 12340,
+  "targetVolumeM3": 0.005,
+  "targetProgressPct": 41.6,
+  "sumRain": 3.2,
+  "avgRain": 0.13,
+  "nextDate": 1746940800000
+}
+```
+
+Concrete samples must come from a known-good test run. Regenerate when concern modules change shape.
+
+## 9. Configuration — editor form ↔ config keys
+
+```mermaid
+flowchart TB
+    subgraph editor["Node-RED editor form"]
+        f1[Sampling time hr]
+        f2[Sampling period hr]
+        f3[Min volume L]
+        f4[Max weight kg]
+        f5[Empty bucket weight kg]
+        f6[Flowmeter on/off]
+        f7[Min sample interval s]
+    end
+    subgraph config["Domain config slice"]
+        c1[constraints.samplingtime]
+        c2[constraints.samplingperiod]
+        c3[constraints.minVolume]
+        c4[constraints.maxWeight]
+        c5[asset.emptyWeightBucket]
+        c6[constraints.flowmeter]
+        c7[constraints.minSampleIntervalSec]
+    end
+    f1 --> c1
+    f2 --> c2
+    f3 --> c3
+    f4 --> c4
+    f5 --> c5
+    f6 --> c6
+    f7 --> c7
+```
+
+| Form field | Config key | Default | Range | Where used |
+|---|---|---|---|---|
+| Sampling time (hr) | `constraints.samplingtime` | `0` | ≥ 0 | run length, `predFlow` |
+| Sampling period (hr) | `constraints.samplingperiod` | `24` | ≥ 1 | schedule arming |
+| Min volume (L) | `constraints.minVolume` | `5` | ≥ 5 | bounds + invalid-flow guard |
+| Max weight (kg) | `constraints.maxWeight` | `23` | ≤ 23 | bucket overload |
+| Empty bucket weight (kg) | `asset.emptyWeightBucket` | `3` | ≥ 0 | `bucketWeight` |
+| Sub-sample volume (mL) | `constraints.subSampleVolume` | `50` | fixed | per-pulse volume |
+| Flowmeter present | `constraints.flowmeter` | `true` | bool | proportional vs time mode |
+| Min sample interval (s) | `constraints.minSampleIntervalSec` | `60` | ≥ 0 | cooldown guard |
+| Intake speed (m/s) | `constraints.intakeSpeed` | `0.3` | ≥ 0 | informational |
+| Intake diameter (mm) | `constraints.intakeDiameter` | `12` | ≥ 0 | informational |
+
+## 10. State chart
+
+Skipped — monster has no formal state machine. The `running` boolean toggles when `_beginRun` / `_endRun` fire. See section 7 for the sampling-program sequence, which is the closest analogue.
+
+## 11. Examples
+
+| Tier | File | What it shows | Status |
+|---|---|---|---|
+| Basic | `examples/basic.flow.json` | Inject + manual flow + dashboard, no parent | ✅ in repo |
+| Integration | `examples/integration.flow.json` | monster + measurement child + AQUON schedule | ✅ in repo |
+| Dashboard | `examples/monster-dashboard.flow.json` | Live FlowFuse charts (pulse, bucket, predFlow) | ✅ in repo |
+| Edge | `examples/edge.flow.json` | Cooldown guard + invalid-flow bounds | ✅ in repo |
+| API | `examples/monster-api-dashboard.flow.json` | dashboardAPI consumer wired in | ✅ in repo |
+
+One screenshot per tier where helpful. PNG ≤ 200 KB under `wiki/_partial-screenshots/monster/`.
+
+## 12. Debug recipes
+
+| Symptom | First thing to check | Where to look |
+|---|---|---|
+| `pulse` never fires | Is `running` true? Check `validateFlowBounds` log — invalid bounds short-circuits the run. | `parameters/parameters.js` |
+| Pulses arrive too fast / skipped | Cooldown guard active. Inspect `missedSamples` + `minSampleIntervalSec`. | `sampling/samplingProgram.js → _maybeEmitPulse` |
+| `q` always zero | Measured-flow child not registered, manual flow not pushed. Watch Port 2 + `data.flow` history. | `flow/flowTracker.js` |
+| `nextDate` not arming | `set.schedule` payload didn't include matching `aquonSampleName` row. | `schedule/schedule.js → regNextDate` |
+| `sumRain` zero with rain input | `rainAggregator.update` ran while `running=true` (skipped). | `specificClass.js → updateRainData` |
+| Bucket overfilled before `stop_time` | `m3PerPuls` rounded down; check `predFlow` vs effective `q`. | `sampling/samplingProgram.js → _beginRun` |
+
+> Never ship `enableLog: 'debug'` in a demo — fills the container log within seconds and obscures real errors. Use only for live debugging.
+
+## 13. When you would NOT use this node
+
+- Use monster for **AQUON-scheduled composite sampling** on a wastewater plant. For a single grab sample on demand, fire `cmd.start` once and tear it down — monster is overkill for ad-hoc work.
+- Don't use monster as a generic flow totaliser. Use a `measurement` child with the right type/variant for raw flow integration.
+- Skip monster if you don't need pulse-proportional dosing — the time-mode (`flowmeter=false`) is currently informational only.
+
+## 14. Known limitations / current issues
+
+| # | Issue | Tracked in |
+|---|---|---|
+| 1 | Edge test `sampling-guards.edge.test.js` cooldown-guard case is a pre-existing failure — the cooldown skip increments `missedSamples` but the assertion expects a different timing. | `test/edge/sampling-guards.edge.test.js` |
+| 2 | `set.mode` and `set.model-prediction` are reserved — handlers delegate to optional methods that don't exist yet. | `commands/handlers.js` |
+| 3 | Time-only mode (`flowmeter=false`) is not exercised — the sampling program assumes a flow source. | `sampling/samplingProgram.js` |
+| 4 | Sub-sample volume hard-coded at 50 mL (schema enforces `min=max=50`). | `generalFunctions/src/configs/monster.json` |