modelPartialHeatPumpGroup

Interface for heat pump group

Information

This partial class provides a standard interface for heat pump group models.

Parameters

TypeNameDefaultDescription
Buildings.Templates.Plants.HeatPumps.Components.Data.HeatPumpGroupdatDesign and operating parameters
Buildings.Templates.Components.Data.HeatPump[nHp]datHpDesign and operating parameters - Each HP
Buildings.Templates.Components.Data.HeatPump[nPhp]datPhpDesign and operating parameters - Each polyvalent HP
Modelica.Units.SI.MassFlowRatemHeaWatHp_flow_nominaldat.mHeaWatHp_flow_nominalDesign HW mass flow rate - Each heat pump
Modelica.Units.SI.HeatFlowRatecapHeaHp_nominaldat.capHeaHp_nominalDesign heating capacity - Each heat pump
Modelica.Units.SI.HeatFlowRateQHeaHp_flow_nominalabs(capHeaHp_nominal)Design heating heat flow rate - Each heat pump
Modelica.Units.SI.PressureDifferencedpHeaWatHp_nominaldat.dpHeaWatHp_nominalDesign HW pressure drop - Each heat pump
Modelica.Units.SI.TemperatureTHeaWatSupHp_nominaldat.THeaWatSupHp_nominalDesign HW supply temperature - Each heat pump
Modelica.Units.SI.TemperatureTHeaWatRetHp_nominaldat.THeaWatRetHp_nominalDesign HW return temperature - Each heat pump
Modelica.Units.SI.PressureDifferencedpChiWatHp_nominaldat.dpChiWatHp_nominalDesign CHW pressure drop - Each heat pump
Modelica.Units.SI.HeatFlowRatecapCooHp_nominaldat.capCooHp_nominalDesign cooling capacity - Each heat pump
Modelica.Units.SI.HeatFlowRateQCooHp_flow_nominal-abs(capCooHp_nominal)Design cooling heat flow rate - Each heat pump
Modelica.Units.SI.TemperatureTChiWatSupHp_nominaldat.TChiWatSupHp_nominalDesign CHW supply temperature - Each heat pump
Modelica.Units.SI.TemperatureTChiWatRetHp_nominaldat.TChiWatRetHp_nominalDesign CHW return temperature - Each heat pump
Modelica.Units.SI.MassFlowRatemSouHeaHp_flow_nominaldat.mSouHeaHp_flow_nominalDesign source fluid mass flow rate in heating mode - Each heat pump
Modelica.Units.SI.PressureDifferencedpSouHeaHp_nominaldat.dpSouHeaHp_nominalDesign source fluid pressure drop in heating mode - Each heat pump
Modelica.Units.SI.MassFlowRatemSouCooHp_flow_nominaldat.mSouCooHp_flow_nominalDesign source fluid mass flow rate in cooling mode - Each heat pump
Modelica.Units.SI.PressureDifferencedpSouCooHp_nominaldat.dpSouCooHp_nominalDesigns source fluid pressure drop in cooling mode - Each heat pump
Modelica.Units.SI.TemperatureTSouCooHp_nominaldat.TSouCooHp_nominalDesign OAT or source fluid supply temperature (condenser entering) in cooling mode - Each heat pump
Modelica.Units.SI.TemperatureTSouHeaHp_nominaldat.TSouHeaHp_nominalDesign OAT or source fluid supply temperature (evaporator entering) in heating mode - Each heat pump
MediumHeaWat.SpecificHeatCapacitycpHeaWat_defaultMediumHeaWat.specificHeatCapacityCp(staHeaWat_default)HW default specific heat capacity
MediumHeaWat.ThermodynamicStatestaHeaWat_defaultMediumHeaWat.setState_pTX(T = THeaWatSupHp_nominal, p = MediumHeaWat.p_default, X = MediumHeaWat.X_default)HW default state
MediumChiWat.SpecificHeatCapacitycpChiWat_defaultMediumChiWat.specificHeatCapacityCp(staChiWat_default)CHW default specific heat capacity
MediumChiWat.ThermodynamicStatestaChiWat_defaultMediumChiWat.setState_pTX(T = TChiWatSupHp_nominal, p = MediumChiWat.p_default, X = MediumChiWat.X_default)CHW default state
MediumSou.SpecificHeatCapacitycpSou_defaultMediumSou.specificHeatCapacityCp(staSou_default)Source fluid default specific heat capacity
MediumSou.ThermodynamicStatestaSou_defaultMediumSou.setState_pTX(T = TSouHeaHp_nominal, p = MediumSou.p_default, X = MediumSou.X_default)Source fluid default state
Configuration
Booleanhave_hptrueSet to true for plants with non-reversible or reversible heat pumps
Booleanhave_phpfalseSet to true for plants with polyvalent heat pumps
IntegernHpNumber of heat pumps (excluding polyvalent units)
IntegernPhp0Number of polyvalent heat pumps
Buildings.Templates.Components.Types.HeatPumptypHpEquipment type
Booleanis_revSet to true for reversible heat pumps, false for heating only
Nominal condition
Modelica.Units.SI.MassFlowRatemChiWatHp_flow_nominaldat.mChiWatHp_flow_nominalDesign CHW mass flow rate - Each heat pump
Dynamics › Conservation equations
Modelica.Fluid.Types.DynamicsenergyDynamicsModelica.Fluid.Types.Dynamics.DynamicFreeInitialType of energy balance: dynamic (3 initialization options) or steady state
Assumptions
BooleanallowFlowReversaltrueLoad side flow reversal: false to simplify equations, assuming, but not enforcing, no flow reversal
BooleanallowFlowReversalSoutrueSource side flow reversal: false to simplify equations, assuming, but not enforcing, no flow reversal
Booleanhave_dpChiHeaWattrueSet to true for CHW/HW pressure drop computed by this model, false for external computation
Booleanhave_dpSoutrueSet to true for source fluid pressure drop computed by this model, false for external computation
Advanced
String[nHp + nPhp]idEqu(if typHp == Buildings.Templates.Components.Types.HeatPump.AirToWater then "AW" elseif typHp == Buildings.Templates.Components.Types.HeatPump.WaterToWater then "WW" else "") .+ {if i > nHp then "HR-" + String(i - nHp) else "HP-" + String(i) for i in 1:nHp + nPhp}Equipment identifier
Advanced › Diagnostics
Booleanshow_Tfalse= true, if actual temperature at port is computed

Connectors

TypeNameDefaultDescription
Modelica.Fluid.Interfaces.FluidPorts_b[nHp]ports_bChiHeaWatHpCHW/HW supply – Heat pumps
Modelica.Fluid.Interfaces.FluidPorts_a[nHp]ports_aChiHeaWatHpCHW/HW return – Heat pumps
Modelica.Fluid.Interfaces.FluidPorts_b[nHp + nPhp]ports_bSouSource fluid return (from heat pumps)
Modelica.Fluid.Interfaces.FluidPorts_a[nHp + nPhp]ports_aSouSource fluid supply (to heat pumps)
Modelica.Fluid.Interfaces.FluidPorts_b[nPhp]ports_bHeaWatPhpHW supply – Polyvalent heat pumps
Modelica.Fluid.Interfaces.FluidPorts_b[nPhp]ports_bChiWatPhpCHW supply – Polyvalent heat pumps
Modelica.Fluid.Interfaces.FluidPorts_a[nPhp]ports_aHeaWatPhpHW return – Polyvalent heat pumps
Modelica.Fluid.Interfaces.FluidPorts_a[nPhp]ports_aChiWatPhpCHW return – Polyvalent heat pumps
Buildings.Templates.Plants.HeatPumps.Interfaces.BusbusPlant control bus
Buildings.BoundaryConditions.WeatherData.BusbusWeaWeather bus

Components

TypeNameDefaultDescription
MediumSou.ThermodynamicState[nHp + nPhp]sta_aSouMediumSou.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 + nPhp]sta_bSouMediumSou.setState_phX(ports_bSou.p, noEvent(actualStream(ports_bSou.h_outflow)), noEvent(actualStream(ports_bSou.Xi_outflow)))Source medium properties in port_bSou
MediumHeaWat.ThermodynamicState[nHp]sta_aChiHeaWatHpMediumHeaWat.setState_phX(ports_aChiHeaWatHp.p, noEvent(actualStream(ports_aChiHeaWatHp.h_outflow)), noEvent(actualStream(ports_aChiHeaWatHp.Xi_outflow)))Source medium properties in port_aChiHeaWatHp
MediumHeaWat.ThermodynamicState[nHp]sta_bChiHeaWatHpMediumHeaWat.setState_phX(ports_bChiHeaWatHp.p, noEvent(actualStream(ports_bChiHeaWatHp.h_outflow)), noEvent(actualStream(ports_bChiHeaWatHp.Xi_outflow)))Source medium properties in port_bChiHeaWatHp
MediumHeaWat.ThermodynamicState[nPhp]sta_aHeaWatPhpMediumHeaWat.setState_phX(ports_aHeaWatPhp.p, noEvent(actualStream(ports_aHeaWatPhp.h_outflow)), noEvent(actualStream(ports_aHeaWatPhp.Xi_outflow)))Source medium properties in port_aHeaWatPhp
MediumHeaWat.ThermodynamicState[nPhp]sta_bHeaWatPhpMediumHeaWat.setState_phX(ports_bHeaWatPhp.p, noEvent(actualStream(ports_bHeaWatPhp.h_outflow)), noEvent(actualStream(ports_bHeaWatPhp.Xi_outflow)))Source medium properties in port_bHeaWatPhp
MediumChiWat.ThermodynamicState[nPhp]sta_aChiWatPhpMediumChiWat.setState_phX(ports_aChiWatPhp.p, noEvent(actualStream(ports_aChiWatPhp.h_outflow)), noEvent(actualStream(ports_aChiWatPhp.Xi_outflow)))Source medium properties in port_aChiWatPhp
MediumChiWat.ThermodynamicState[nPhp]sta_bChiWatPhpMediumChiWat.setState_phX(ports_bChiWatPhp.p, noEvent(actualStream(ports_bChiWatPhp.h_outflow)), noEvent(actualStream(ports_bChiWatPhp.Xi_outflow)))Source medium properties in port_bChiWatPhp

Contents

NameDescription
MediumHeaWat
MediumChiWat
MediumSou
MediumAir

Revisions

  • July 10, 2026, by Antoine Gautier:
    Refactored to support polyvalent heat pumps.
    This is for #4512.