modelPartialPump

Base model for centrifugal pumps

Extends from Volumes.BaseClasses.PartialVolume (Base class for volume models).

Information

This is the base model for pumps.

The model describes a centrifugal pump, or a group of nParallel identical pumps. The pump model is based on the theory of kinematic similarity: the pump characteristics are given for nominal operating conditions (rotational speed and fluid density), and then adapted to actual operating condition, according to the similarity equations.

Pump characteristics

The nominal hydraulic characteristic (head vs. volume flow rate) is given by the the replaceable function flowCharacteristic.

The pump energy balance can be specified in two alternative ways:

  • use_powerCharacteristic = false (default option): the replaceable function efficiencyCharacteristic (efficiency vs. volume flow rate in nominal conditions) is used to determine the efficiency, and then the power consumption. The default is a constant efficiency of 0.8.
  • use_powerCharacteristic = true: the replaceable function powerCharacteristic (power consumption vs. volume flow rate in nominal conditions) is used to determine the power consumption, and then the efficiency. Use powerCharacteristic to specify a non-zero power consumption for zero flow rate.

Several functions are provided in the package PumpCharacteristics to specify the characteristics as a function of some operating points at nominal conditions.

Depending on the value of the checkValve parameter, the model either supports reverse flow conditions, or includes a built-in check valve to avoid flow reversal.

It is possible to take into account the mass and energy storage of the fluid inside the pump by specifying its volume V, and by selecting appropriate dynamic mass and energy balance assumptions (see below); this is recommended to avoid singularities in the computation of the outlet enthalpy in case of zero flow rate. If zero flow rate conditions are always avoided, this dynamic effect can be neglected by leaving the default value V = 0, thus avoiding fast state variables in the model.

Dynamics options

Steady-state mass and energy balances are assumed per default, neglecting the holdup of fluid in the pump; this configuration works well if the flow rate is always positive. Dynamic mass and energy balance can be used by setting the corresponding dynamic parameters. This is recommended to avoid singularities at zero or reversing mass flow rate. If the initial conditions imply non-zero mass flow rate, it is possible to use the SteadyStateInitial condition, otherwise it is recommended to use FixedInitial in order to avoid undetermined initial conditions.

Heat transfer

The Boolean parameter use_HeatTransfer can be set to true if heat exchanged with the environment should be taken into account or to model a housing. This might be desirable if a pump with realistic powerCharacteristic for zero flow operates while a valve prevents fluid flow.

Diagnostics of Cavitation

The replaceable Monitoring submodel can be configured to PumpMonitoringNPSH, in order to compute the Net Positive Suction Head available and check for cavitation, provided a two-phase medium model is used (see Advanced tab).

Parameters

TypeNameDefaultDescription
SI.Densityd_startMedium.density_pTX(p_b_start, T_start, X_start)
SI.VolumeFlowRateV_flow_startm_flow_start/d_start
SI.VolumeFlowRateV_flow_nominalm_flow_nominal/d_nominal
SI.PowerW_nominaldp_nominal*V_flow_nominal
SI.Heighthead_nominaldp_nominal/(d_nominal*Modelica.Constants.g_n)
Initialization › Start Value: Absolute Pressure
Medium.AbsolutePressurep_a_start1e5Pressure at port a
Medium.AbsolutePressurep_b_startp_a_start + dp_nominalPressure at port b
SI.AbsolutePressurep_start (from PartialVolume)Medium.p_defaultPressure
Advanced › Dynamics
DynamicsenergyDynamics (from PartialVolume)Dynamics.DynamicFreeInitialFormulation of energy balances
DynamicsmassDynamics (from PartialVolume)energyDynamicsFormulation of mass balances
DynamicssubstanceDynamics (from PartialVolume)massDynamicsFormulation of substance balances
DynamicstraceDynamics (from PartialVolume)massDynamicsFormulation of trace substance balances
Initialization › Start Value: Temperature
Booleanuse_T_start (from PartialVolume)trueUse T_start if true, otherwise h_start
SI.TemperatureT_start (from PartialVolume)Medium.T_defaultTemperature
Initialization › Start Value: Specific Enthalpy
SI.SpecificEnthalpyh_start (from PartialVolume)Medium.specificEnthalpy_pTX(p_start, T_start, X_start)Specific enthalpy
Initialization › Start Value: Species Mass Fraction
SI.MassFraction[Medium.nX]X_start (from PartialVolume)Medium.X_defaultMass fraction
Initialization › Start Value: Trace Substances
SIadd.ExtraProperty[Medium.nC]C_start (from PartialVolume)fill(0, Medium.nC)Mass-Specific value
Initialization › Start Value: Mass Flow Rate
Medium.MassFlowRatem_flow_start0Mass flow rate through pump
Advanced › Model Structure
BooleanexposeState_atrue=true, p is calculated at port_a else m_flow
BooleanexposeState_bfalse=true, p is calculated at port_b else m_flow
Advanced
BooleancheckValvefalse= true to prevent reverse flow
SI.Accelerationg_nModelica.Constants.g_nGravitational accelaration
Booleanuse_HeatPortfalse=true to toggle heat port
Booleanuse_TraceMassPortfalse=true to toggle trace mass port
Characteristics: Based on single pump nominal conditions
Booleanuse_powerCharacteristicfalse=true then use power characteristic else efficiency
Nominal Conditions: Single pump basis
NonSI.AngularVelocity_rpmN_nominal1500Pump speed
SI.Lengthdiameter_nominal0.1Impeller diameter
SI.PressureDifferencedp_nominal1e5Pressure increase
SI.MassFlowRatem_flow_nominal1Mass flow rate
SI.Densityd_nominalMedium.density_phX(p_b_start, h_start, X_start)Density
Closure Models
SI.MolarMass[Medium.nC]MMsfill(1, Medium.nC)Trace substances molar mass

Connectors

TypeNameDefaultDescription
Interfaces.FluidPort_Flowport_a
Interfaces.FluidPort_Flowport_b
HeatAndMassTransfer.Interfaces.HeatPort_StateheatPort
HeatAndMassTransfer.Interfaces.MolePort_StatetraceMassPort

Components

TypeNameDefaultDescription
SI.VolumeV (from PartialVolume)Volume
Medium.BasePropertiesmedium (from PartialVolume)
SI.Massm (from PartialVolume)Mass
SI.InternalEnergyU (from PartialVolume)Internal energy
SI.Mass[Medium.nXi]mXi (from PartialVolume)Species mass
SIadd.ExtraPropertyExtrinsic[Medium.nC]mC (from PartialVolume)Trace substance extrinsic value
SIadd.ExtraPropertyExtrinsicmC_scaled (from PartialVolume)Scaled trace substance for improved numerical stability
SIadd.ExtraProperty[Medium.nC]C (from PartialVolume)Trace substance mass-specific value
SI.MassFlowRatemb (from PartialVolume)0Mass flow rate source/sinks within volumes
SI.HeatFlowRateUb (from PartialVolume)0Energy source/sinks within volumes (e.g., ohmic heating, external convection)
SI.MassFlowRate[Medium.nXi]mXib (from PartialVolume)zeros(Medium.nXi)Species mass flow rates source/sinks within volumes
SIadd.ExtraPropertyFlowRate[Medium.nC]mCb (from PartialVolume)zeros(Medium.nC)Trace flow rate source/sinks within volumes (e.g., chemical reactions, external convection)
SI.Lengthdiameterdiameter_nominalImpeller diameter
SI.PressureDifferencedpport_b.p - port_a.pPressure increase
SI.MassFlowRatem_flowMass flow rate
NonSI.AngularVelocity_rpmNShaft rotational speed
SI.HeightheadPump head
SI.PowerWPower Consumption
SI.PowerW_idealIdeal power consumption
SI.EfficiencyetaEfficiency
SI.VolumeFlowRateV_flowm_flow/medium.dVolume flow rate
FlowCharflowChar
PowerCharpowerChar
EfficiencyCharefficiencyChar

Contents

NameDescription
FlowChar
PowerChar
EfficiencyChar

Revisions

  • 8 Jan 2013 by Rüdiger Franke:
    moved NPSH diagnostics from PartialPump to replaceable sub-model PumpMonitoring.PumpMonitoringNPSH (see ticket #646)
  • Dec 2008 by Rüdiger Franke:
    • Replaced simplified mass and energy balances with rigorous formulation (base class PartialLumpedVolume)
    • Introduced optional HeatTransfer model defining Qb_flow
    • Enabled events when the checkValve is operating to support the opening of a discrete valve before port_a
  • 31 Oct 2005 by Francesco Casella:
    Model added to the Fluid library