znetsixe 056f4a8d3e fix: bump 3 submodules — levelBased hold-zone bug, MGC unit math, schema + slim npm packs
Submodule pointer updates:
- generalFunctions @ ae30cef
    feat(pumpingStation schema): add holdLevel + deadZoneKeepAlivePercent;
    slim npm pack
- machineGroupControl @ aeb938c
    feat(setDemand): surface specificClass.setDemand(value, unit='%')
    + slim npm pack
- pumpingStation @ 2e4ad8d
    fix(levelBased): drop hold zone, route through MGC.setDemand, add
    holdLevel + integrator variant pick; slim npm pack

Cross-submodule summary:
- pumpingStation level-based control now sends percent demand to MGC via
  the new MGC.setDemand entry point — was calling handleInput with a raw
  percent, which the dispatcher interpreted as canonical m³/s and pegged
  the group at 100 %.
- Ramp foot is no longer pinned at inflowLevel. Default is startLevel
  (0 % at startLevel = MGC flow.min, matching operator mental model). New
  optional holdLevel raises the 0 %-foot for an explicit hold band.
- Predicted-volume integrator now picks the best-available variant per
  side (measured first, then predicted) so a real upstream sensor +
  predicted pump outflow both feed the basin balance.
- Each submodule grew a .npmignore mirroring its .gitignore plus the
  dev-only trees (test/, wiki/, .claude/, …). Per-submodule pack sizes
  dropped — pumpingStation went 1.5 MB → 57 kB.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-19 22:22:52 +02:00

EVOLV — Edge-Layer Evolution for Optimized Virtualization

Node-RED custom nodes package voor de automatisering van afvalwaterzuiveringsinstallaties. Ontwikkeld door het R&D-team van Waterschap Brabantse Delta. Volgt de ISA-88 (S88) batch control standaard.

Nodes

Node Functie S88-niveau
rotatingMachine Individuele pomp/compressor/blower aansturing Equipment
machineGroupControl Multi-pomp optimalisatie (BEP-Gravitation) Unit
pumpingStation Pompgemaal met hydraulische context Unit
valve Individuele klep modellering Equipment
valveGroupControl Klep groep coordinatie Unit
reactor Biologische reactor (ASM kinetiek) Unit
settler Nabezinker / slibscheiding Unit
monster Multi-parameter biologische monitoring Equipment
measurement Sensor signaalconditionering Control Module
diffuser Beluchting aansturing Equipment
dashboardAPI InfluxDB telemetrie + FlowFuse dashboards
generalFunctions Gedeelde bibliotheek (predict, PID, convert, etc.)

Architectuur

Elke node volgt een drie-lagen patroon:

  1. Entry file (<naam>.js) — registratie bij Node-RED, admin endpoints
  2. nodeClass (src/nodeClass.js) — Node-RED adapter (tick loop, routing, status)
  3. specificClass (src/specificClass.js) — pure domeinlogica (fysica, toestandsmachines)

Drie output-poorten per node: Port 0 = procesdata, Port 1 = InfluxDB telemetrie, Port 2 = registratie/besturing.

Installatie

git clone --recurse-submodules https://gitea.wbd-rd.nl/RnD/EVOLV.git
cd EVOLV
npm install

Submodules updaten:

git submodule update --remote --merge

Enkel bouwblok installeren in Node-RED:

mkdir -p ~/.node-red/nodes
cp -r nodes/<bouwblok-naam> ~/.node-red/nodes/

Testen

# Alle nodes
bash scripts/test-all.sh

# Specifieke node
node --test nodes/<nodeName>/test/basic/*.test.js
node --test nodes/<nodeName>/test/integration/*.test.js
node --test nodes/<nodeName>/test/edge/*.test.js

Documentatie

  • wiki/ — Projectwiki met architectuur, bevindingen en metrics (index)
  • CLAUDE.md — Claude Code projectgids
  • manuals/node-red/ — FlowFuse en Node-RED referentiedocumentatie
  • .agents/ — Agent skills, beslissingen en function-anchors

Licentie

Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0)

Gebruik, aanpassing en verspreiding is toegestaan voor niet-commerciele doeleinden, mits naamsvermelding naar Waterschap Brabantse Delta. Voor commercieel gebruik is voorafgaande toestemming vereist.

Contact

rdlab@brabantsedelta.nl

Description
No description provided
Readme 33 MiB
Languages
JavaScript 40%
HTML 39.4%
Shell 13.4%
Python 6%
Dockerfile 1.2%