modelPerformanceCurve

Cubic spline of a characteristic curve of head vs. volume flow rate

Extends from PartialFlowChar (Base class for pump flow characteristics. Extending class solves for head.).

Information

Pump head characteristic in the form head = affinityLaw * f(V_flow, V_flow_curve, head_curve, N/N_nominal), solving for head given volumetric flow. The affinity-law factor used here is affinityLaw = (N/N_nominal)² (diameter/diameter_nominal)², applied to the head output only.

If checkValve = true, a parametric s abscissa with a homotopy transition is used so that reverse flow is suppressed below the closing point of the curve. The homotopy fallback expression at s = 0 uses head_start, evaluated once at parameter time from the same curve.

The spline tangents d_curve are computed once as a final parameter and passed to Functions.PerformanceCurve on every call (including the head_start parameter evaluation). This keeps splineDerivatives out of the time-derivative chain and enables analytic Jacobians.

Parameters

TypeNameDefaultDescription
SI.VolumeFlowRate[:]V_flow_curve{0, V_flow_nominal, 1.5*V_flow_nominal}Volume flow rate nominal operating points (single pump)
SI.Height[size(V_flow_curve, 1)]head_curve{2*head_nominal, head_nominal, 0}Pump head nominal operating points
Real[size(V_flow_curve, 1)]d_curveTRANSFORM.Math.splineDerivatives(x = V_flow_curve, y = head_curve, ensureMonotonicity = TRANSFORM.Math.isMonotonic(x = head_curve, strict = false))Spline tangents at the support points (precomputed once for analytic derivative)
SI.Heighthead_startFunctions.PerformanceCurve(V_flow_start, V_flow_curve, head_curve, d_curve, N_nominal/N_nominal)Used for simplified initialization model
Internal Interface › Nominal Operating Parameters
Modelica.Units.NonSI.AngularVelocity_rpmN_nominal (from PartialCharacteristic)Pump speed
SI.Lengthdiameter_nominal (from PartialCharacteristic)Impeller Diameter
SI.VolumeFlowRateV_flow_nominal (from PartialCharacteristic)Nominal volumetric flow rate
SI.Heighthead_nominal (from PartialFlowChar)Nominal head
Internal Interface › Initialization
SI.VolumeFlowRateV_flow_start (from PartialCharacteristic)

Components

TypeNameDefaultDescription
Medium.ThermodynamicStatestate (from PartialCharacteristic)Thermodynamic state
SI.VolumeFlowRateV_flow (from PartialCharacteristic)Mass flow rate
Modelica.Units.NonSI.AngularVelocity_rpmN (from PartialCharacteristic)Pump speed
SI.Lengthdiameter (from PartialCharacteristic)Impeller Diameter
SItf.NonDimaffinityLaw (from PartialCharacteristic)Affinity law for scaling
BooleancheckValve (from PartialFlowChar)=true then no reverse flow
SI.Heighthead (from PartialFlowChar)Pump pressure head
RealsCurvilinear abscissa for the flow curve in parametric form (either volume flow rate or head)