modelAirToWater
Air-to-water heat pump group
Extends from Buildings.Templates.Plants.HeatPumps.Components.Interfaces.PartialHeatPumpGroup (Interface for heat pump group).
Information
This model represents a group of heat pumps.
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| Buildings.Templates.Plants.HeatPumps.Components.Data.HeatPumpGroup | dat (from PartialHeatPumpGroup) | Design and operating parameters | |
| Buildings.Templates.Components.Data.HeatPump[nHp] | datHp (from PartialHeatPumpGroup) | Design and operating parameters - Each heat pump | |
| Modelica.Units.SI.MassFlowRate | mHeaWatHp_flow_nominal (from PartialHeatPumpGroup) | dat.mHeaWatHp_flow_nominal | Design HW mass flow rate - Each heat pump |
| Modelica.Units.SI.HeatFlowRate | capHeaHp_nominal (from PartialHeatPumpGroup) | dat.capHeaHp_nominal | Design heating capacity - Each heat pump |
| Modelica.Units.SI.HeatFlowRate | QHeaHp_flow_nominal (from PartialHeatPumpGroup) | abs(capHeaHp_nominal) | Design heating heat flow rate - Each heat pump |
| Modelica.Units.SI.PressureDifference | dpHeaWatHp_nominal (from PartialHeatPumpGroup) | dat.dpHeaWatHp_nominal | Design HW pressure drop - Each heat pump |
| Modelica.Units.SI.Temperature | THeaWatSupHp_nominal (from PartialHeatPumpGroup) | dat.THeaWatSupHp_nominal | Design HW supply temperature - Each heat pump |
| Modelica.Units.SI.Temperature | THeaWatRetHp_nominal (from PartialHeatPumpGroup) | dat.THeaWatRetHp_nominal | Design HW return temperature - Each heat pump |
| Modelica.Units.SI.PressureDifference | dpChiWatHp_nominal (from PartialHeatPumpGroup) | dat.dpChiWatHp_nominal | Design CHW pressure drop - Each heat pump |
| Modelica.Units.SI.HeatFlowRate | capCooHp_nominal (from PartialHeatPumpGroup) | dat.capCooHp_nominal | Design cooling capacity - Each heat pump |
| Modelica.Units.SI.HeatFlowRate | QCooHp_flow_nominal (from PartialHeatPumpGroup) | -abs(capCooHp_nominal) | Design cooling heat flow rate - Each heat pump |
| Modelica.Units.SI.Temperature | TChiWatSupHp_nominal (from PartialHeatPumpGroup) | dat.TChiWatSupHp_nominal | Design CHW supply temperature - Each heat pump |
| Modelica.Units.SI.Temperature | TChiWatRetHp_nominal (from PartialHeatPumpGroup) | dat.TChiWatRetHp_nominal | Design CHW return temperature - Each heat pump |
| Modelica.Units.SI.MassFlowRate | mSouHeaHp_flow_nominal (from PartialHeatPumpGroup) | dat.mSouHeaHp_flow_nominal | Design source fluid mass flow rate in heating mode - Each heat pump |
| Modelica.Units.SI.PressureDifference | dpSouHeaHp_nominal (from PartialHeatPumpGroup) | dat.dpSouHeaHp_nominal | Design source fluid pressure drop in heating mode - Each heat pump |
| Modelica.Units.SI.MassFlowRate | mSouCooHp_flow_nominal (from PartialHeatPumpGroup) | dat.mSouCooHp_flow_nominal | Design source fluid mass flow rate in cooling mode - Each heat pump |
| Modelica.Units.SI.PressureDifference | dpSouCooHp_nominal (from PartialHeatPumpGroup) | dat.dpSouCooHp_nominal | Designs source fluid pressure drop in cooling mode - Each heat pump |
| Modelica.Units.SI.Temperature | TSouCooHp_nominal (from PartialHeatPumpGroup) | dat.TSouCooHp_nominal | Design OAT or source fluid supply temperature (condenser entering) in cooling mode - Each heat pump |
| Modelica.Units.SI.Temperature | TSouHeaHp_nominal (from PartialHeatPumpGroup) | dat.TSouHeaHp_nominal | Design OAT or source fluid supply temperature (evaporator entering) in heating mode - Each heat pump |
| MediumHeaWat.SpecificHeatCapacity | cpHeaWat_default (from PartialHeatPumpGroup) | MediumHeaWat.specificHeatCapacityCp(staHeaWat_default) | HW default specific heat capacity |
| MediumHeaWat.ThermodynamicState | staHeaWat_default (from PartialHeatPumpGroup) | MediumHeaWat.setState_pTX(T = THeaWatSupHp_nominal, p = MediumHeaWat.p_default, X = MediumHeaWat.X_default) | HW default state |
| MediumChiWat.SpecificHeatCapacity | cpChiWat_default (from PartialHeatPumpGroup) | MediumChiWat.specificHeatCapacityCp(staChiWat_default) | CHW default specific heat capacity |
| MediumChiWat.ThermodynamicState | staChiWat_default (from PartialHeatPumpGroup) | MediumChiWat.setState_pTX(T = TChiWatSupHp_nominal, p = MediumChiWat.p_default, X = MediumChiWat.X_default) | CHW default state |
| MediumSou.SpecificHeatCapacity | cpSou_default (from PartialHeatPumpGroup) | MediumSou.specificHeatCapacityCp(staSou_default) | Source fluid default specific heat capacity |
| MediumSou.ThermodynamicState | staSou_default (from PartialHeatPumpGroup) | MediumSou.setState_pTX(T = TSouHeaHp_nominal, p = MediumSou.p_default, X = MediumSou.X_default) | Source fluid default state |
| Configuration | |||
| Integer | nHp (from PartialHeatPumpGroup) | Number of heat pumps | |
| Buildings.Templates.Components.Types.HeatPump | typ (from PartialHeatPumpGroup) | Equipment type | |
| Boolean | is_rev (from PartialHeatPumpGroup) | Set to true for reversible heat pumps, false for heating only | |
| Nominal condition | |||
| Modelica.Units.SI.MassFlowRate | mChiWatHp_flow_nominal (from PartialHeatPumpGroup) | dat.mChiWatHp_flow_nominal | Design CHW mass flow rate - Each heat pump |
| Dynamics › Conservation equations | |||
| Modelica.Fluid.Types.Dynamics | energyDynamics (from PartialHeatPumpGroup) | Modelica.Fluid.Types.Dynamics.DynamicFreeInitial | Type of energy balance: dynamic (3 initialization options) or steady state |
| Assumptions | |||
| Boolean | allowFlowReversal (from PartialHeatPumpGroup) | true | Load side flow reversal: false to simplify equations, assuming, but not enforcing, no flow reversal |
| Boolean | allowFlowReversalSou (from PartialHeatPumpGroup) | true | Source side flow reversal: false to simplify equations, assuming, but not enforcing, no flow reversal |
| Boolean | have_dpChiHeaWatHp (from PartialHeatPumpGroup) | true | Set to true for HP CHW/HW pressure drop computed by this model, false for external computation |
| Boolean | have_dpSou (from PartialHeatPumpGroup) | true | Set to true for source fluid pressure drop computed by this model, false for external computation |
| Advanced › Diagnostics | |||
| Boolean | show_T (from PartialHeatPumpGroup) | false | = true, if actual temperature at port is computed |
Connectors
| Type | Name | Default | Description |
|---|---|---|---|
| Modelica.Fluid.Interfaces.FluidPorts_b[nHp] | ports_bChiHeaWat (from PartialHeatPumpGroup) | CHW/HW supply | |
| Modelica.Fluid.Interfaces.FluidPorts_a[nHp] | ports_aChiHeaWat (from PartialHeatPumpGroup) | CHW/HW return | |
| Modelica.Fluid.Interfaces.FluidPorts_b[nHp] | ports_bSou (from PartialHeatPumpGroup) | Source fluid return (from heat pumps) | |
| Modelica.Fluid.Interfaces.FluidPorts_a[nHp] | ports_aSou (from PartialHeatPumpGroup) | Source fluid supply (to heat pumps) | |
| Buildings.Templates.Plants.HeatPumps.Interfaces.Bus | bus (from PartialHeatPumpGroup) | Plant control bus | |
| Buildings.BoundaryConditions.WeatherData.Bus | busWea (from PartialHeatPumpGroup) | Weather bus |
Components
| Type | Name | Default | Description |
|---|---|---|---|
| MediumHeaWat.ThermodynamicState[nHp] | sta_aChiHeaWat (from PartialHeatPumpGroup) | MediumHeaWat.setState_phX(ports_aChiHeaWat.p, noEvent(actualStream(ports_aChiHeaWat.h_outflow)), noEvent(actualStream(ports_aChiHeaWat.Xi_outflow))) | CHW/HW medium properties in port_aChiHeaWat |
| MediumHeaWat.ThermodynamicState[nHp] | sta_bChiHeaWat (from PartialHeatPumpGroup) | MediumHeaWat.setState_phX(ports_bChiHeaWat.p, noEvent(actualStream(ports_bChiHeaWat.h_outflow)), noEvent(actualStream(ports_bChiHeaWat.Xi_outflow))) | CHW/HW medium properties in port_bChiHeaWat |
| MediumSou.ThermodynamicState[nHp] | sta_aSou (from PartialHeatPumpGroup) | MediumSou.setState_phX(ports_aSou.p, noEvent(actualStream(ports_aSou.h_outflow)), noEvent(actualStream(ports_aSou.Xi_outflow))) | Source medium properties in port_aSou |
| MediumSou.ThermodynamicState[nHp] | sta_bSou (from PartialHeatPumpGroup) | MediumSou.setState_phX(ports_bSou.p, noEvent(actualStream(ports_bSou.h_outflow)), noEvent(actualStream(ports_bSou.Xi_outflow))) | Source medium properties in port_bSou |
| Buildings.Templates.Components.HeatPumps.AirToWater[nHp] | hp | Heat pump unit |
Revisions
-
August 21, 2025, by Antoine Gautier:
Refactored with load-dependent 2D table data heat pump model.
This is for #4152. -
March 29, 2024, by Antoine Gautier:
First implementation.