Files
EVOLV/wiki/Archive/architecture-3d-pump-curves.md
znetsixe b8cb889d87 wiki: audit + archive stale pages; refresh Home for 2026-05-11 wave
- Archived 20 pre-refactor pages to wiki/Archive/ with standard banners:
  - All 6 architecture/ pages (old _loadConfig/_setupSpecificClass internals,
    pre-refactor S88 hierarchy, deployment blueprint)
  - All 3 sessions/ logs (Apr-07 + Apr-13 session summaries)
  - findings/open-issues-2026-03.md (issues 1-5 all resolved by refactor)
  - concepts/generalfunctions-api.md (missing BaseDomain/BaseNodeAdapter)
  - concepts/sources-readme.md (empty PDF placeholder, never populated)
  - manuals/nodes/rotatingMachine.md + measurement.md (superseded by per-repo wikis)
  - Top-level SCHEMA.md, index.md, log.md, metrics.md, overview.md,
    knowledge-graph.yaml (all Apr-07 snapshot, pre-refactor)
- Kept wiki/concepts/ domain pages (ASM, PID, pump-affinity, settling, etc.)
- Kept wiki/findings/ proven results (BEP, NCog, curve-non-convexity, stability)
- Kept wiki/manuals/node-red/* (FlowFuse + Node-RED runtime docs, still current)
- Kept wiki/tools/* (utility scripts)
- Updated wiki/Archive.md index with 20 rows
- Fixed wiki/Home.md: Tier 6 was wrongly marked done; corrected to pending;
  Tier 9 updated to reflect 2026-05-11 in-progress wave

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 21:07:48 +02:00

2.2 KiB
Raw Blame History

title, created, updated, status, tags, sources
title created updated status tags sources
3D Pump Curve Architecture 2026-04-07 2026-04-07 proven
predict
curves
interpolation
rotatingMachine
nodes/generalFunctions/src/predict/predict_class.js
nodes/rotatingMachine/src/specificClass.js

⚠️ ARCHIVED — pre-refactor (Tier 14, 2026-05)

This page describes the architecture before the platform refactor. The current page is the per-node wiki on gitea.wbd-rd.nl/RnD or Home.

Kept for historical reference only. Do not update.

3D Pump Curve Prediction

Data Structure

A family of 2D curves indexed by pressure (f-dimension):

  • X-axis: control position (0-100%)
  • Y-axis: flow (nq) or power (np) in canonical units
  • F-dimension: pressure (Pa) — the 3rd dimension

Raw curves are in curve units (m3/h, kW, mbar). _normalizeMachineCurve() converts to canonical (m3/s, W, Pa).

Interpolation

Monotonic cubic spline (Fritsch-Carlson) in both dimensions:

  • X-Y splines: at each discrete pressure level
  • F-splines: across pressure levels for intermediate pressure interpolation

Prediction Flow

predict.y(x):
  1. Clamp x to [currentFxyXMin, currentFxyXMax]
  2. Normalize x to [normMin, normMax]
  3. Evaluate spline at normalized x for current fDimension
  4. Return y in canonical units (m3/s or W)

Unit Conversion Chain

Raw curve (m3/h, kW, mbar)
  → _normalizeMachineCurve → canonical (m3/s, W, Pa)
  → predict class → canonical output
  → MeasurementContainer.getCurrentValue(outputUnit) → output units

No double-conversion. Clean separation: specificClass handles units, predict handles normalization/interpolation.

Three Predict Instances per Machine

  • predictFlow: control % → flow (nq curve)
  • predictPower: control % → power (np curve)
  • predictCtrl: flow → control % (reversed nq curve)

Boundary Behavior

  • Below/above curve X range: flat extrapolation (clamped)
  • Below/above f-dimension range: clamped to min/max pressure level

Performance

  • y(x): O(log n), effectively O(1) for 5-10 data points
  • buildAllFxyCurves: sub-10ms for typical curves
  • Full caching of normalized curves, splines, and calculated curves