Buildings.Fluid.Movers.Preconfigured
Preconfigured mover models
Information
This package contains preconfigured versions for the mover models. The models are identical to the ones in the package Buildings.Fluid.Movers except that most parameters are set to default values.
Extends from Modelica.Icons.Package (Icon for standard packages).
Package Content
| Name | Description |
|---|---|
 UsersGuide
|
User's Guide |
 FlowControlled_dp
|
Fan or pump with ideally controlled head dp as input signal and pre-configured parameters |
 FlowControlled_m_flow
|
Fan or pump with ideally controlled mass flow rate as input signal and pre-configured parameters |
 SpeedControlled_y
|
Fan or pump with ideally controlled normalized speed y as input signal and pre-configured parameters |
 Validation
|
Package for validation models |
Buildings.Fluid.Movers.Preconfigured.FlowControlled_dp
Fan or pump with ideally controlled head dp as input signal and pre-configured parameters
Information
This model is the preconfigured version for Buildings.Fluid.Movers.FlowControlled_dp.
Extends from Buildings.Fluid.Movers.FlowControlled_dp (Fan or pump with ideally controlled head dp as input signal).
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| replaceable package Medium | PartialMedium | Medium in the component | |
| Boolean | addPowerToMedium | true | Set to false to avoid any power (=heat and flow work) being added to medium (may give simpler equations) |
| Boolean | nominalValuesDefineDefaultPressureCurve | true | Set to true to avoid warning if m_flow_nominal and dp_nominal are used to construct the default pressure curve |
| PressureDifference | constantHead | dp_nominal | Constant pump head, used when inputType=Constant [Pa] |
| PressureDifference | heads[:] | dp_nominal*{(per.speeds[i]/p... | Vector of head set points, used when inputType=Stages [Pa] |
| Control | |||
| InputType | inputType | Buildings.Fluid.Types.InputT... | Control input type |
| Nominal condition | |||
| MassFlowRate | m_flow_nominal | Nominal mass flow rate [kg/s] | |
| PressureDifference | dp_nominal | if rho_default < 500 then 50... | Nominal pressure raise, used to normalized the filter if use_inputFilter=true, to set default values of constantHead and heads, and and for default pressure curve if not specified in record per [Pa] |
| Dynamics | |||
| Conservation equations | |||
| Dynamics | energyDynamics | Modelica.Fluid.Types.Dynamic... | Type of energy balance: dynamic (3 initialization options) or steady state |
| Nominal condition | |||
| Time | tau | 1 | Time constant of fluid volume for nominal flow, used if energy or mass balance is dynamic [s] |
| Filtered speed | |||
| Boolean | use_inputFilter | true | = true, if speed is filtered with a 2nd order CriticalDamping filter |
| Time | riseTime | 30 | Rise time of the filter (time to reach 99.6 % of the speed) [s] |
| Init | init | Modelica.Blocks.Types.Init.I... | Type of initialization (no init/steady state/initial state/initial output) |
| PressureDifference | dp_start | 0 | Initial value of pressure raise [Pa] |
| Initialization | |||
| AbsolutePressure | p_start | Medium.p_default | Start value of pressure [Pa] |
| Temperature | T_start | Medium.T_default | Start value of temperature [K] |
| MassFraction | X_start[Medium.nX] | Medium.X_default | Start value of mass fractions m_i/m [kg/kg] |
| ExtraProperty | C_start[Medium.nC] | fill(0, Medium.nC) | Start value of trace substances |
| ExtraProperty | C_nominal[Medium.nC] | fill(1E-2, Medium.nC) | Nominal value of trace substances. (Set to typical order of magnitude.) |
| Assumptions | |||
| Boolean | allowFlowReversal | true | = false to simplify equations, assuming, but not enforcing, no flow reversal |
| Advanced | |||
| MassFlowRate | m_flow_small | 1E-4*abs(_m_flow_nominal) | Small mass flow rate for regularization of zero flow [kg/s] |
| Boolean | prescribeSystemPressure | false | =true, to control mover such that pressure difference is obtained across two remote points in system |
| Diagnostics | |||
| Boolean | show_T | false | = true, if actual temperature at port is computed |
Connectors
| Type | Name | Description |
|---|---|---|
| FluidPort_a | port_a | Fluid connector a (positive design flow direction is from port_a to port_b) |
| FluidPort_b | port_b | Fluid connector b (positive design flow direction is from port_a to port_b) |
| input IntegerInput | stage | Stage input signal for the pressure head |
| output RealOutput | y_actual | Actual normalised fan or pump speed that is used for computations [1] |
| output RealOutput | P | Electrical power consumed [W] |
| HeatPort_a | heatPort | Heat dissipation to environment |
| input RealInput | dpMea | Measurement of pressure difference between two points where the set point should be obtained [Pa] |
| input RealInput | dp_in | Prescribed pressure rise [Pa] |
| output RealOutput | dp_actual | Pressure difference between the mover inlet and outlet [Pa] |
Modelica definition
model FlowControlled_dp "Fan or pump with ideally controlled head dp as input signal and pre-configured parameters"
extends Buildings.Fluid.Movers.FlowControlled_dp(
final per(
pressure(
V_flow=m_flow_nominal/rho_default*{0, 1, 2},
dp=if rho_default < 500
then dp_nominal*{1.12, 1, 0}
else dp_nominal*{1.14, 1, 0.42}),
powerOrEfficiencyIsHydraulic=true,
etaHydMet=Buildings.Fluid.Movers.BaseClasses.Types.HydraulicEfficiencyMethod.EulerNumber,
etaMotMet=Buildings.Fluid.Movers.BaseClasses.Types.MotorEfficiencyMethod.GenericCurve),
final constantHead,
final heads,
final nominalValuesDefineDefaultPressureCurve=true,
final inputType=Buildings.Fluid.Types.InputType.Continuous,
final prescribeSystemPressure=false,
final init=Modelica.Blocks.Types.Init.InitialOutput,
energyDynamics=Modelica.Fluid.Types.Dynamics.FixedInitial);
end FlowControlled_dp;
Buildings.Fluid.Movers.Preconfigured.FlowControlled_m_flow
Fan or pump with ideally controlled mass flow rate as input signal and pre-configured parameters
Information
This model is the preconfigured version for Buildings.Fluid.Movers.FlowControlled_m_flow.
Extends from Buildings.Fluid.Movers.FlowControlled_m_flow (Fan or pump with ideally controlled mass flow rate as input signal).
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| replaceable package Medium | PartialMedium | Medium in the component | |
| Boolean | addPowerToMedium | true | Set to false to avoid any power (=heat and flow work) being added to medium (may give simpler equations) |
| Boolean | nominalValuesDefineDefaultPressureCurve | true | Set to true to avoid warning if m_flow_nominal and dp_nominal are used to construct the default pressure curve |
| MassFlowRate | constantMassFlowRate | m_flow_nominal | Constant pump mass flow rate, used when inputType=Constant [kg/s] |
| MassFlowRate | massFlowRates[:] | m_flow_nominal*{per.speeds[i... | Vector of mass flow rate set points, used when inputType=Stage [kg/s] |
| Control | |||
| InputType | inputType | Buildings.Fluid.Types.InputT... | Control input type |
| Nominal condition | |||
| MassFlowRate | m_flow_nominal | Nominal mass flow rate [kg/s] | |
| PressureDifference | dp_nominal | if rho_default < 500 then 50... | Nominal pressure raise, used for default pressure curve if not specified in record per [Pa] |
| Dynamics | |||
| Conservation equations | |||
| Dynamics | energyDynamics | Modelica.Fluid.Types.Dynamic... | Type of energy balance: dynamic (3 initialization options) or steady state |
| Nominal condition | |||
| Time | tau | 1 | Time constant of fluid volume for nominal flow, used if energy or mass balance is dynamic [s] |
| Filtered speed | |||
| Boolean | use_inputFilter | true | = true, if speed is filtered with a 2nd order CriticalDamping filter |
| Time | riseTime | 30 | Rise time of the filter (time to reach 99.6 % of the speed) [s] |
| Init | init | Modelica.Blocks.Types.Init.I... | Type of initialization (no init/steady state/initial state/initial output) |
| MassFlowRate | m_flow_start | 0 | Initial value of mass flow rate [kg/s] |
| Initialization | |||
| AbsolutePressure | p_start | Medium.p_default | Start value of pressure [Pa] |
| Temperature | T_start | Medium.T_default | Start value of temperature [K] |
| MassFraction | X_start[Medium.nX] | Medium.X_default | Start value of mass fractions m_i/m [kg/kg] |
| ExtraProperty | C_start[Medium.nC] | fill(0, Medium.nC) | Start value of trace substances |
| ExtraProperty | C_nominal[Medium.nC] | fill(1E-2, Medium.nC) | Nominal value of trace substances. (Set to typical order of magnitude.) |
| Assumptions | |||
| Boolean | allowFlowReversal | true | = false to simplify equations, assuming, but not enforcing, no flow reversal |
| Advanced | |||
| MassFlowRate | m_flow_small | 1E-4*abs(_m_flow_nominal) | Small mass flow rate for regularization of zero flow [kg/s] |
| Pressure | dpMax | 2*max(eff.per.pressure.dp) | Maximum pressure allowed to operate the model, if exceeded, the simulation stops with an error [Pa] |
| Diagnostics | |||
| Boolean | show_T | false | = true, if actual temperature at port is computed |
Connectors
| Type | Name | Description |
|---|---|---|
| FluidPort_a | port_a | Fluid connector a (positive design flow direction is from port_a to port_b) |
| FluidPort_b | port_b | Fluid connector b (positive design flow direction is from port_a to port_b) |
| input IntegerInput | stage | Stage input signal for the pressure head |
| output RealOutput | y_actual | Actual normalised fan or pump speed that is used for computations [1] |
| output RealOutput | P | Electrical power consumed [W] |
| HeatPort_a | heatPort | Heat dissipation to environment |
| input RealInput | m_flow_in | Prescribed mass flow rate [kg/s] |
| output RealOutput | m_flow_actual | Actual mass flow rate [kg/s] |
Modelica definition
model FlowControlled_m_flow "Fan or pump with ideally controlled mass flow rate as input signal and pre-configured parameters"
extends Buildings.Fluid.Movers.FlowControlled_m_flow(
final per(
pressure(
V_flow=m_flow_nominal/rho_default*{0, 1, 2},
dp=if rho_default < 500
then dp_nominal*{1.12, 1, 0}
else dp_nominal*{1.14, 1, 0.42}),
powerOrEfficiencyIsHydraulic=true,
etaHydMet=Buildings.Fluid.Movers.BaseClasses.Types.HydraulicEfficiencyMethod.EulerNumber,
etaMotMet=Buildings.Fluid.Movers.BaseClasses.Types.MotorEfficiencyMethod.GenericCurve),
final constantMassFlowRate,
final massFlowRates,
final nominalValuesDefineDefaultPressureCurve=true,
final inputType=Buildings.Fluid.Types.InputType.Continuous,
final init=Modelica.Blocks.Types.Init.InitialOutput,
energyDynamics=Modelica.Fluid.Types.Dynamics.FixedInitial);
end FlowControlled_m_flow;
Buildings.Fluid.Movers.Preconfigured.SpeedControlled_y
Fan or pump with ideally controlled normalized speed y as input signal and pre-configured parameters
Information
This model is the preconfigured version for Buildings.Fluid.Movers.SpeedControlled_y.
Extends from Buildings.Fluid.Movers.SpeedControlled_y (Fan or pump with ideally controlled normalized speed y as input signal).
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| replaceable package Medium | PartialMedium | Medium in the component | |
| Boolean | addPowerToMedium | true | Set to false to avoid any power (=heat and flow work) being added to medium (may give simpler equations) |
| Control | |||
| InputType | inputType | Buildings.Fluid.Types.InputT... | Control input type |
| Nominal condition | |||
| MassFlowRate | m_flow_nominal | Nominal mass flow rate for configuration of pressure curve [kg/s] | |
| PressureDifference | dp_nominal | Nominal pressure head for configuration of pressure curve [Pa] | |
| Dynamics | |||
| Conservation equations | |||
| Dynamics | energyDynamics | Modelica.Fluid.Types.Dynamic... | Type of energy balance: dynamic (3 initialization options) or steady state |
| Nominal condition | |||
| Time | tau | 1 | Time constant of fluid volume for nominal flow, used if energy or mass balance is dynamic [s] |
| Filtered speed | |||
| Boolean | use_inputFilter | true | = true, if speed is filtered with a 2nd order CriticalDamping filter |
| Time | riseTime | 30 | Rise time of the filter (time to reach 99.6 % of the speed) [s] |
| Init | init | Modelica.Blocks.Types.Init.I... | Type of initialization (no init/steady state/initial state/initial output) |
| Real | y_start | 0 | Initial value of speed [1] |
| Initialization | |||
| AbsolutePressure | p_start | Medium.p_default | Start value of pressure [Pa] |
| Temperature | T_start | Medium.T_default | Start value of temperature [K] |
| MassFraction | X_start[Medium.nX] | Medium.X_default | Start value of mass fractions m_i/m [kg/kg] |
| ExtraProperty | C_start[Medium.nC] | fill(0, Medium.nC) | Start value of trace substances |
| ExtraProperty | C_nominal[Medium.nC] | fill(1E-2, Medium.nC) | Nominal value of trace substances. (Set to typical order of magnitude.) |
| Assumptions | |||
| Boolean | allowFlowReversal | true | = false to simplify equations, assuming, but not enforcing, no flow reversal |
| Advanced | |||
| MassFlowRate | m_flow_small | 1E-4*abs(_m_flow_nominal) | Small mass flow rate for regularization of zero flow [kg/s] |
| Diagnostics | |||
| Boolean | show_T | false | = true, if actual temperature at port is computed |
Connectors
| Type | Name | Description |
|---|---|---|
| FluidPort_a | port_a | Fluid connector a (positive design flow direction is from port_a to port_b) |
| FluidPort_b | port_b | Fluid connector b (positive design flow direction is from port_a to port_b) |
| input IntegerInput | stage | Stage input signal for the pressure head |
| output RealOutput | y_actual | Actual normalised fan or pump speed that is used for computations [1] |
| output RealOutput | P | Electrical power consumed [W] |
| HeatPort_a | heatPort | Heat dissipation to environment |
| input RealInput | y | Constant normalized rotational speed [1] |
Modelica definition
model SpeedControlled_y "Fan or pump with ideally controlled normalized speed y as input signal and pre-configured parameters"
extends Buildings.Fluid.Movers.SpeedControlled_y(
final per(
pressure(
V_flow=m_flow_nominal/rho_default*{0, 1, 2},
dp=if rho_default < 500
then dp_nominal*{1.12, 1, 0}
else dp_nominal*{1.14, 1, 0.42}),
powerOrEfficiencyIsHydraulic=true,
etaHydMet=Buildings.Fluid.Movers.BaseClasses.Types.HydraulicEfficiencyMethod.EulerNumber,
etaMotMet=Buildings.Fluid.Movers.BaseClasses.Types.MotorEfficiencyMethod.GenericCurve),
final inputType=Buildings.Fluid.Types.InputType.Continuous,
final init=Modelica.Blocks.Types.Init.InitialOutput,
energyDynamics=Modelica.Fluid.Types.Dynamics.FixedInitial);
parameter Modelica.Units.SI.MassFlowRate m_flow_nominal(
final min=Modelica.Constants.small)
"Nominal mass flow rate for configuration of pressure curve";
parameter Modelica.Units.SI.PressureDifference dp_nominal(
final min=Modelica.Constants.small)
"Nominal pressure head for configuration of pressure curve";
end SpeedControlled_y;