From 8e228739e4e2b4a1a1c896fea6dd4461318c7a16 Mon Sep 17 00:00:00 2001 From: vps1_gitea_admin Date: Wed, 4 Mar 2026 20:16:43 +0000 Subject: [PATCH] Add "Home" --- Home.md | 92 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 92 insertions(+) create mode 100644 Home.md diff --git a/Home.md b/Home.md new file mode 100644 index 0000000..79f74e2 --- /dev/null +++ b/Home.md @@ -0,0 +1,92 @@ +# monster + +Custom Node-RED node for multi-parameter biological process monitoring with automated water sampling. + +## Overview + +| Property | Value | +|----------|-------| +| **Version** | 1.0.5 | +| **Category** | Monitoring | +| **Inputs** | 1 | +| **Outputs** | 3 (process / dbase / parent) | +| **Part of** | [EVOLV](https://gitea.wbd-rd.nl/RnD/EVOLV) | + +## Purpose + +The `monster` node manages automated water sampling systems for biological process monitoring. It handles: + +- **Sampling schedules** with configurable intervals +- **Volume/weight constraints** for sample collection +- **Rain event scaling** - adjusts sampling during rain events +- **Aquon integration** - auto-populates parameter specs from the Aquon laboratory standard +- **Flow-proportional** sampling support + +## Configuration + +### Sampling + +| Field | Unit | Description | +|-------|------|-------------| +| `samplingtime` | h | Base sampling interval | +| `minvolume` | L | Minimum sample volume | +| `maxweight` | kg | Maximum sample weight | +| `emptyWeightBucket` | kg | Empty bucket tare weight | + +### Hydraulic Bounds + +| Field | Unit | Description | +|-------|------|-------------| +| `nominalFlowMin` | m3/h | Minimum nominal flow | +| `flowMax` | m3/h | Maximum flow capacity | + +### Rain Scaling + +| Field | Unit | Description | +|-------|------|-------------| +| `maxRainRef` | mm | Maximum rain reference for scaling | +| `minSampleIntervalSec` | s | Minimum interval between samples during rain | + +### Aquon Integration + +| Field | Description | +|-------|-------------| +| `aquon_sample_name` | Dropdown selection from Aquon standard sample types | + +When an Aquon sample is selected, parameter specifications are automatically applied. + +## Important Integration Notes + +**Measurement assetType:** When connecting `measurement` nodes to `monster`, the measurement's `assetType` must be exactly `"flow"` (not `"flow-electromagnetic"` or other variants). The monster node queries for this exact string. + +## Inputs and Outputs + +### Input (Port 0) +Flow measurements, rain data, control commands. + +### Output Port 0 - Process Data +Sampling state, current volume, next sample time, parameter readings. + +### Output Port 1 - InfluxDB Telemetry +Sampling events and parameter time-series data. + +### Output Port 2 - Registration +Parent communication and measurement node registration. + +## Dependencies + +- [generalFunctions](https://gitea.wbd-rd.nl/RnD/generalFunctions) (MenuManager, configManager) + +## Technical Requirements + +- Node.js >= 18 +- Node-RED >= 3.x +- `measurement` node(s) with `assetType: "flow"` for flow-proportional sampling + +## Testing + +```bash +node --test test/basic/*.test.js +node --test test/integration/*.test.js +node --test test/edge/*.test.js +```