modelPump
Extends from ClaRa.Components.TurboMachines.Pumps.PumpVLE_L2_affinity (A pump for VLE mixtures with a finite fluid volume, based on affinity laws), TransiEnt.Basics.Icons.Pump.
Information
Purpose of model
This model is a combination of a fluid volume L2 and a pump model that can be used to calculate the efficiency and the needed power of a pump. It contains two fluid ports to model the fluid flow through the pump. Both fluid ports should be connected to a port that sets the pressure. The volume flow rate can then be calculated via the given pressure difference. A static mass and momentum balance is used. The specific enthalpy at the outlet of the pump is calculated via an isentropic dependence. There are no changes in composition in this component. The model does not support flow reversal.
Level of detail, physical effects considered, and physical insight
L2 (defined in CodingConventions)
- Thermal inertia
- Variable fluid properties
Limits of validity
Reverse flow is not supported
Interfaces

Governing Equations
References
The model was extended from the ClaRa library. Look there for further documentation or verfication.
Version History
Model was documented by Jan Westphal (j.westphal@tuhh.de) in January 2025
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| Fundamental Definitions | |||
| TILMedia.VLEFluid.Types.BaseVLEFluid | medium (from PumpVLE_L2_affinity) | simCenter.fluid1 | Medium in the component |
| Boolean | useMechanicalPort (from PumpVLE_L2_affinity) | false | True, if a mechenical flange should be used |
| Boolean | steadyStateTorque (from PumpVLE_L2_affinity) | false | True, if steady state mechanical momentum shall be used |
| Basics.Units.RPM | rpm_fixed (from PumpVLE_L2_affinity) | 60 | Constant rotational speed of pump |
| Modelica.Units.SI.Inertia | J (from PumpVLE_L2_affinity) | Moment of Inertia | |
| Basics.Units.RPM | rpm_nom (from PumpVLE_L2_affinity) | Nomial rotational speed | |
| Characteristic Field | |||
| Boolean | useHead (from PumpVLE_L2_affinity) | false | True, if a pump head (height) | False, if pump head (pressure) should be used |
| ClaRa.Basics.Units.VolumeFlowRate | V_flow_max (from PumpVLE_L2_affinity) | 1 | Volume flow where Delta_p/head = 0 for rpm_nom |
| ClaRa.Basics.Units.PressureDifference | Delta_p_max (from PumpVLE_L2_affinity) | 1e5 | Constant pressure difference at flow = 0 for rpm_nom, rho_nom |
| ClaRa.Basics.Units.Length | Head_max (from PumpVLE_L2_affinity) | 10 | Constant head at flow = 0 for rpm_nom |
| ClaRa.Basics.Units.DensityMassSpecific | rho_nom (from PumpVLE_L2_affinity) | TILMedia.VLEFluid.MixtureCompatible.Functions.density_pTxi(medium, 1e5, 293.15, medium.xi_default) | Nominal density related to Delta_p_max |
| Expert Settings | |||
| ClaRa.Basics.Units.VolumeFlowRate | V_flow_eps (from PumpVLE_L2_affinity) | V_flow_max/100 | Minimum volumetric flow rate for which hydraulic characteristic is still scaled with respect to density | For V_flow < abs(V_flow_eps) no density scalling is used. |
| Pump Volume › Fundamental Definitions | |||
| Basics.Units.Volume | volume_fluid (from PumpVLE_L2_affinity) | 0.01 | Volume of fluid |
| Pump Volume › Nominal Values | |||
| Modelica.Units.SI.MassFlowRate | m_flow_nom (from PumpVLE_L2_affinity) | 10 | Nominal mass flow rates at inlet |
| Modelica.Units.SI.Pressure | p_nom (from PumpVLE_L2_affinity) | 1e5 | Nominal pressure |
| Modelica.Units.SI.SpecificEnthalpy | h_nom (from PumpVLE_L2_affinity) | 1e5 | Nominal specific enthalpy |
| Pump Volume › Initialisation | |||
| Modelica.Units.SI.SpecificEnthalpy | h_start (from PumpVLE_L2_affinity) | 1e5 | Start value of outlet specific enthalpy |
| Modelica.Units.SI.Pressure | p_start (from PumpVLE_L2_affinity) | 1e5 | Start value of outlet pressure |
| Integer | initOption (from PumpVLE_L2_affinity) | 0 | Type of initialisation at tube side |
| Boolean | useHomotopy (from PumpVLE_L2_affinity) | simCenter.useHomotopy | True, if homotopy method is used during initialisation |
| Summary and Visualisation | |||
| Boolean | showExpertSummary (from PumpVLE_L2_affinity) | simCenter.showExpertSummary | True, if expert summary should be applied |
| Boolean | showData (from PumpVLE_L2_affinity) | true | True, if a data port containing p,T,h,s,m_flow shall be shown, else false |
| Boolean | contributeToCycleSummary (from PumpVLE_L2_affinity) | simCenter.contributeToCycleSummary | True if component shall contribute to automatic efficiency calculation |
Connectors
Components
| Type | Name | Default | Description |
|---|---|---|---|
| String | complexity (from ComplexityLevel) | "??" | |
| ClaRa.Basics.Interfaces.Connected2SimCenter | connected2SimCenter (from PumpVLE_L2_affinity) | ||
| ClaRa.SimCenter | simCenter (from PumpVLE_L2_affinity) | ||
| Summary | summary (from PumpVLE_L2_affinity) | ||
| Basics.Units.Power | P_shaft (from PumpVLE_L2_affinity) | pump.summary.outline.P_shaft | Mechanicl power at shaft |