PartialPump
PumpCharacteristics
PumpMonitoring
Base classes used in the Machines package (only of interest to build new component models)
Extends from Modelica.Icons.BasesPackage (Icon for packages containing base classes).
| Name | Description |
|---|---|
| PartialPump
|
Base model for centrifugal pumps |
| PumpCharacteristics
|
Functions for pump characteristics |
| PumpMonitoring
|
Monitoring of pump operation |
Modelica.Fluid.Machines.BaseClasses.PartialPumpBase model for centrifugal pumps
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 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).
Extends from Modelica.Fluid.Interfaces.PartialTwoPort (Partial component with two ports), Modelica.Fluid.Interfaces.PartialLumpedVolume (Lumped volume with mass and energy balance).
| Name | Description |
|---|---|
| replaceable package Medium | Medium in the component |
| Characteristics | |
| nParallel | Number of pumps in parallel |
| replaceable function flowCharacteristic | Head vs. V_flow characteristic at nominal speed and density |
| N_nominal | Nominal rotational speed for flow characteristic [rev/min] |
| rho_nominal | Nominal fluid density for characteristic [kg/m3] |
| use_powerCharacteristic | Use powerCharacteristic (vs. efficiencyCharacteristic) |
| replaceable function powerCharacteristic | Power consumption vs. V_flow at nominal speed and density |
| replaceable function efficiencyCharacteristic | Efficiency vs. V_flow at nominal speed and density |
| Custom Parameters | |
| fluidVolume | Volume [m3] |
| Assumptions | |
| allowFlowReversal | = true to allow flow reversal, false restricts to design direction (port_a -> port_b) |
| checkValve | = true to prevent reverse flow |
| V | Volume inside the pump [m3] |
| Dynamics | |
| energyDynamics | Formulation of energy balance |
| massDynamics | Formulation of mass balance |
| Heat transfer | |
| use_HeatTransfer | = true to use a HeatTransfer model, e.g., for a housing |
| replaceable model HeatTransfer | Wall heat transfer |
| Initialization | |
| p_a_start | Guess value for inlet pressure [Pa] |
| p_b_start | Guess value for outlet pressure [Pa] |
| m_flow_start | Guess value of m_flow = port_a.m_flow [kg/s] |
| checkValveHomotopy | = whether the valve is Closed, Open, or unknown at initialization |
| p_start | Start value of pressure [Pa] |
| use_T_start | = true, use T_start, otherwise h_start |
| T_start | Start value of temperature [K] |
| h_start | Start value of specific enthalpy [J/kg] |
| X_start[Medium.nX] | Start value of mass fractions m_i/m [kg/kg] |
| C_start[Medium.nC] | Start value of trace substances |
| Advanced | |
| Diagnostics | |
| replaceable model Monitoring | Optional pump monitoring |
| Name | Description |
|---|---|
| heatPort | |
| Characteristics | |
| replaceable function flowCharacteristic | Head vs. V_flow characteristic at nominal speed and density |
| replaceable function powerCharacteristic | Power consumption vs. V_flow at nominal speed and density |
| replaceable function efficiencyCharacteristic | Efficiency vs. V_flow at nominal speed and density |
| Assumptions | |
| Heat transfer | |
| replaceable model HeatTransfer | Wall heat transfer |
| Advanced | |
| Diagnostics | |
| replaceable model Monitoring | Optional pump monitoring |