Buildings.Templates.Components.BaseClasses
Package with base classes for Buildings.Templates.Components
Information
This package contains base classes that are used to construct the models in Buildings.Templates.Components.
Extends from Modelica.Icons.BasesPackage (Icon for packages containing base classes).
Package Content
| Name | Description |
|---|---|
 MoverSpeedControlled_y
|
|
 PartialHeatPumpTableData2DLoadDep
|
Interface for heat pump using load-dependent 2D table data |
Buildings.Templates.Components.BaseClasses.MoverSpeedControlled_y
Information
This is a compiler-friendly version of
Buildings.Fluid.Movers.SpeedControlled_y which facilitates the
propagation of the mover performance curves by binding
_m_flow_nominal to a top-level parameter rather than to an
expression that depends on the performance data record.
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 | |
| Generic | per | redeclare parameter Building... | Record with performance data |
| Boolean | addPowerToMedium | true | Set to false to avoid any power (=heat and flow work) being added to medium (may give simpler equations) |
| MassFlowRate | m_flow_nominal | [kg/s] | |
| Control | |||
| InputType | inputType | Buildings.Fluid.Types.InputT... | Control input type |
| Dynamics | |||
| Conservation equations | |||
| Dynamics | energyDynamics | Modelica.Fluid.Types.Dynamic... | Type of energy balance: dynamic (3 initialization options) or steady state |
| Time | tau | 1 | Time constant of fluid volume for nominal flow, used if energy or mass balance is dynamic [s] |
| Motor speed | |||
| Boolean | use_riseTime | true | Set to true to continuously change motor speed |
| Time | riseTime | 30 | Time needed to change motor speed between zero and full 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] |
| 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 |
| 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 |
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 MoverSpeedControlled_y
extends Buildings.Fluid.Movers.SpeedControlled_y(
final _m_flow_nominal=m_flow_nominal);
parameter Modelica.Units.SI.MassFlowRate m_flow_nominal;
end MoverSpeedControlled_y;
Buildings.Templates.Components.BaseClasses.PartialHeatPumpTableData2DLoadDep
Interface for heat pump using load-dependent 2D table data
Information
This is the base class for heat pump models where the capacity and input
power are computed by interpolating manufacturer data along the condenser
entering or leaving temperature, the evaporator entering or leaving
temperature and the part load ratio. Toggling the Boolean parameter
typMod==Buildings.Templates.Components.Types.HeatPumpCapability.Reversible enables representing either a non-reversible
(heating-only) heat pump or a reversible heat pump.
This model is a wrapper for Buildings.Fluid.HeatPumps.ModularReversible.TableData2DLoadDep, which the user may refer to for the modeling assumptions.
Control points
The following input and output points are available.
-
Heat pump on/off command signal:
y1, DO signal, with a dimensionality of zero -
For reversible heat pumps only (
typMod==Buildings.Templates.Components.Types.HeatPumpCapability.Reversible), heat pump operating mode command signal:y1Hea, DO signal, with a dimensionality of zero
Sety1Hea=truefor heating mode,y1Hea=falsefor cooling mode. -
Heat pump HW supply temperature setpoint:
THeaWatSet, AO signal, with a dimensionality of zero - For reversible heat pumps only (
typMod==Buildings.Templates.Components.Types.HeatPumpCapability.Reversible), Heat pump CHW supply temperature setpoint:TChiWatSet, AO signal, with a dimensionality of zero -
Heat pump status:
y1_actual, DI signal, with a dimensionality of zero
Extends from Buildings.Templates.Components.Interfaces.PartialHeatPump.
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| replaceable package MediumHeaWat | Water | HW medium | |
| replaceable package MediumChiWat | MediumHeaWat | CHW medium | |
| replaceable package MediumSou | Water | Source-side medium | |
| replaceable package MediumAir | Air | Air medium | |
| HeatPump | typ | Heat pump source/sink type | |
| HeatPumpCapability | typMod | Heat pump operating mode capability | |
| HeatPump | dat | Design and operating parameters | |
| Assumptions | |||
| Boolean | allowFlowReversal | true | = false to simplify equations, assuming, but not enforcing, no flow reversal |
| Boolean | allowFlowReversalSou | true | Source side flow reversal: false to simplify equations, assuming, but not enforcing, no flow reversal |
| Boolean | have_dpChiHeaWat | true | Set to true for CHW/HW pressure drop computed by this model, false for external computation |
| Boolean | have_dpSou | true | Set to true for source fluid pressure drop computed by this model, false for external computation |
| 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 |
| Dynamics | |||
| Conservation equations | |||
| Dynamics | energyDynamics | Modelica.Fluid.Types.Dynamic... | Type of energy balance: dynamic (3 initialization options) or steady state |
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) |
| FluidPort_a | port_aChiWat | CHW fluid connector a (positive design flow direction is from port_a to port_b) |
| FluidPort_b | port_bChiWat | CHW fluid connector b (positive design flow direction is from port_a to port_b) |
| FluidPort_a | port_aSou | Source fluid connector a (positive design flow direction is from port_a to port_b) |
| FluidPort_b | port_bSou | Source fluid connector b (positive design flow direction is from port_a to port_b) |
| Bus | bus | Control bus |
| Bus | busWea | Weather bus |
Modelica definition
partial model PartialHeatPumpTableData2DLoadDep
"Interface for heat pump using load-dependent 2D table data"
extends Buildings.Templates.Components.Interfaces.PartialHeatPump;
Controls.StatusEmulator y1_actual
"Compute heat pump status";
Fluid.Sensors.MassFlowRate mHeaWat_flow(
redeclare final package Medium=MediumHeaWat)
"HW mass flow rate";
Fluid.Sensors.TemperatureTwoPort THeaWatEnt(
redeclare final package Medium=MediumHeaWat,
final m_flow_nominal=max(mChiWat_flow_nominal, mHeaWat_flow_nominal))
"HW entering temperature";
Fluid.Sensors.TemperatureTwoPort THeaWatLvg(
redeclare final package Medium=MediumHeaWat,
final m_flow_nominal=max(mChiWat_flow_nominal, mHeaWat_flow_nominal))
"HW leaving temperature";
Fluid.Sensors.TemperatureTwoPort TSouEnt(
redeclare final package Medium=MediumSou,
final m_flow_nominal=mSouHea_flow_nominal)
"Source fluid entering temperature";
Fluid.Sensors.TemperatureTwoPort TSouLvg(
redeclare final package Medium=MediumSou,
final m_flow_nominal=mSouHea_flow_nominal)
"Source fluid leaving temperature";
Buildings.Fluid.HeatPumps.ModularReversible.TableData2DLoadDep hp(
redeclare final package MediumCon=MediumHeaWat,
redeclare final package MediumEva=MediumSou,
final datHea=dat.perHea,
final datCoo=dat.perCoo,
final P_min=dat.P_min,
final use_rev=typMod==Buildings.Templates.Components.Types.HeatPumpCapability.Reversible,
final QCoo_flow_nominal=QCoo_flow_nominal,
final QHea_flow_nominal=QHea_flow_nominal,
final TConHea_nominal=THeaWatSup_nominal,
final TEvaHea_nominal=TSouHea_nominal,
final TConCoo_nominal=TChiWatSup_nominal,
final TEvaCoo_nominal=TSouCoo_nominal,
final allowFlowReversalCon=allowFlowReversal,
final allowFlowReversalEva=allowFlowReversalSou,
final dTCon_nominal=THeaWatSup_nominal - THeaWatRet_nominal,
dTEva_nominal=0,
final dpCon_nominal=if have_dpChiHeaWat then dpHeaWat_nominal else 0,
final dpEva_nominal=if have_dpSou then dpSouHea_nominal else 0,
final energyDynamics=energyDynamics,
final mCon_flow_nominal=mHeaWat_flow_nominal,
final mEva_flow_nominal=mSouHea_flow_nominal,
final show_T=show_T,
use_conCap=false,
use_evaCap=false)
if not typMod == Buildings.Templates.Components.Types.HeatPumpCapability.Polyvalent
"Heat pump";
Buildings.Fluid.HeatPumps.ModularReversible.TableData2DLoadDepSHC php(
redeclare final package MediumCon=MediumHeaWat,
redeclare final package MediumEva=MediumChiWat,
final P_min=dat.P_min,
final QCoo_flow_nominal=QCoo_flow_nominal,
final QHea_flow_nominal=QHea_flow_nominal,
final QHeaShc_flow_nominal=abs(dat.capHeaShc_nominal),
final QCooShc_flow_nominal=-abs(dat.capCooShc_nominal),
final dat=dat.perPhp,
final TConHea_nominal=THeaWatSup_nominal,
final TEvaHea_nominal=TSouHea_nominal,
final TConCoo_nominal=TChiWatSup_nominal,
final TEvaCoo_nominal=TSouCoo_nominal,
final allowFlowReversalCon=allowFlowReversal,
final allowFlowReversalEva=allowFlowReversal,
final dTCon_nominal=THeaWatSup_nominal - THeaWatRet_nominal,
final dTEva_nominal=TChiWatSup_nominal - TChiWatRet_nominal,
final energyDynamics=energyDynamics,
final dpHw_nominal=if have_dpChiHeaWat then dpHeaWat_nominal else 0,
final dpChw_nominal=if have_dpChiHeaWat then dpChiWat_nominal else 0,
final mCon_flow_nominal=mHeaWat_flow_nominal,
final mEva_flow_nominal=mChiWat_flow_nominal,
final show_T=show_T,
use_conCap=false,
use_evaCap=false)
if typMod == Buildings.Templates.Components.Types.HeatPumpCapability.Polyvalent
"Polyvalent heat pump";
Routing.PassThroughFluid pas(redeclare final package Medium=MediumSou)
if typ == Buildings.Templates.Components.Types.HeatPump.AirToWater and
typMod == Buildings.Templates.Components.Types.HeatPumpCapability.Polyvalent
"Direct fluid pass through in case of air-source polyvalent HP";
Buildings.Controls.OBC.CDL.Logical.Or onHeaOrCoo if typMod == Buildings.Templates.Components.Types.HeatPumpCapability.Polyvalent
"Commanded on in cooling or heating mode";
equation
connect(port_a, mHeaWat_flow.port_a);
connect(mHeaWat_flow.port_b, THeaWatEnt.port_a);
connect(THeaWatLvg.port_b, port_b);
connect(TSouLvg.port_b, port_bSou);
connect(THeaWatEnt.port_b, hp.port_a1);
connect(hp.port_b1, THeaWatLvg.port_a);
connect(TSouLvg.port_a, hp.port_b2);
connect(TSouEnt.port_b, hp.port_a2);
connect(y1_actual.y1_actual, bus.y1_actual);
connect(bus.y1, hp.on);
connect(bus.y1Hea, hp.hea);
connect(bus.THeaWatSet, hp.THwSet);
connect(bus.TChiWatSet, hp.TChwSet);
connect(hp.on, y1_actual.y1);
connect(php.port_b1, THeaWatLvg.port_a);
connect(THeaWatEnt.port_b,php. port_a1);
connect(php.port_b2, port_bChiWat);
connect(port_aChiWat,php. port_a2);
connect(busWea,php. weaBus);
connect(TSouEnt.port_b, pas.port_a);
connect(pas.port_b, TSouLvg.port_a);
connect(bus.THeaWatSet,php. THwSet);
connect(bus.TChiWatSet,php. TChwSet);
connect(bus.y1Hea,php. onHea);
connect(bus.y1Coo,php. onCoo);
connect(onHeaOrCoo.y, y1_actual.y1);
connect(php.onHea, onHeaOrCoo.u1);
connect(php.onCoo, onHeaOrCoo.u2);
end PartialHeatPumpTableData2DLoadDep;