generalFunctions

Shared utility library used by all EVOLV Node-RED nodes. This is NOT a Node-RED node itself - it is a dependency library.

Overview

Property	Value
Version	1.0.0
Type	Utility library
Part of	EVOLV

Purpose

generalFunctions provides centralized, reusable functionality for all EVOLV nodes. It is the foundation layer that ensures consistent behavior across the entire platform.

Important: Changes to this library affect ALL 13 EVOLV nodes. Backward compatibility must be verified before any modification.

Exported Modules

Measurement and Signal Processing

Export	Description
`MeasurementContainer`	Signal conditioning with canonical unit conversion
`predict`	TensorFlow.js predictive model interface
`interpolation`	Curve interpolation utilities

Control

Export	Description
`PIDController`	Standard PID controller implementation
`CascadePIDController`	Cascade PID for multi-loop control

Configuration

Export	Description
`configManager`	Node configuration management and persistence
`MenuManager`	Dynamic menu generation for Node-RED editor
`assetApiConfig`	Asset registry API configuration

Data and I/O

Export	Description
`outputUtils`	Standard output formatting (3-port pattern)
`logger`	Structured logging utility
`validation`	Input validation helpers
`loadModel`	Load TensorFlow.js models
`loadCurve`	Load asset performance curves

Physics and Conversion

Export	Description
`convert`	Unit conversion utilities
`coolprop`	CoolProp thermodynamic calculations
`gravity`	Gravity-related calculations

Canonical Units

All internal calculations use these SI-derived units:

Quantity	Canonical Unit
Pressure	Pa (Pascal)
Flow	m3/s (cubic meters per second)
Power	W (Watt)
Temperature	K (Kelvin)

Conversion to/from user-facing units happens at node boundaries using the convert module.

Usage

const {
  MeasurementContainer,
  PIDController,
  configManager,
  MenuManager,
  outputUtils,
  convert,
  logger
} = require('../generalFunctions');

Dependencies

TensorFlow.js - For predictive models
CoolProp - For thermodynamic property calculations

Technical Requirements

Node.js >= 18

Development Notes

This library is included as a git submodule in the main EVOLV repository
All nodes import from ../generalFunctions (relative path within nodes/)
The MenuManager class serves dynamic editor menus via HTTP endpoints
The configManager handles node configuration persistence and migration

Testing

node --test test/basic/*.test.js