recordHeatPumpGroup

Extends from Modelica.Icons.Record (Icon for records).

Information

This record provides the set of parameters for heat pump group models that can be found within Buildings.Templates.Plants.HeatPumps.Components.HeatPumpGroups.

Only identical heat pumps are currently supported.

The heat pump performance data are provided via the subrecords perHeaHp and perCooHp for the heating mode and the cooling mode, respectively. For the required format of the performance data files, please refer to the documentation of the block Buildings.Fluid.HeatPumps.ModularReversible.RefrigerantCycle.BaseClasses.TableData2DLoadDep.

Parameters

TypeNameDefaultDescription
Modelica.Units.SI.SpecificHeatCapacitycpChiWat_defaultif have_php then cpChiWatPhp_default else cpHeaWat_defaultCHW default specific heat capacity
Modelica.Units.SI.MassFlowRatemSouHeaHp_flow_nominalif have_hp then (if typHp == Buildings.Templates.Components.Types.HeatPump.WaterToWater then mSouWwHeaHp_flow_nominal else Buildings.Templates.Data.Defaults.ratMFloAirByCapChi*abs(capHeaHp_nominal)) else 1Source fluid mass flow rate in heating mode - Each unit
Modelica.Units.SI.PressureDifferencedpSouHeaHp_nominalif typHp == Buildings.Templates.Components.Types.HeatPump.WaterToWater then dpSouWwHeaHp_nominal else Buildings.Templates.Data.Defaults.dpAirChiSource fluid pressure drop in heating mode - Each unit
Modelica.Units.SI.MassFlowRatemSouCooHp_flow_nominalif typHp == Buildings.Templates.Components.Types.HeatPump.WaterToWater then mSouWwCooHp_flow_nominal else Buildings.Templates.Data.Defaults.ratMFloAirByCapChi*abs(capCooHp_nominal)Source fluid mass flow rate in cooling mode - Each unit
Modelica.Units.SI.PressureDifferencedpSouCooHp_nominaldpSouHeaHp_nominal*(mSouCooHp_flow_nominal/mSouHeaHp_flow_nominal)^2Source fluid pressure drop in cooling mode - Each unit
Fluid.HeatPumps.ModularReversible.Data.TableData2DLoadDep.GenericHeatPumpperHeaHp
Fluid.Chillers.ModularReversible.Data.TableData2DLoadDep.GenericperCooHp
Modelica.Units.SI.MassFlowRatemSouHeaPhp_flow_nominalif have_php then (if typHp == Buildings.Templates.Components.Types.HeatPump.WaterToWater then mSouWwHeaPhp_flow_nominal else Buildings.Templates.Data.Defaults.ratMFloAirByCapChi*abs(capHeaPhp_nominal)) else 1Source fluid mass flow rate in heating mode - Each unit
Modelica.Units.SI.PressureDifferencedpSouHeaPhp_nominalif have_php and typHp == Buildings.Templates.Components.Types.HeatPump.WaterToWater then dpSouWwHeaPhp_nominal else Buildings.Templates.Data.Defaults.dpAirChiSource fluid pressure drop in heating mode - Each unit
Modelica.Units.SI.MassFlowRatemSouCooPhp_flow_nominalif typHp == Buildings.Templates.Components.Types.HeatPump.WaterToWater then mSouWwCooPhp_flow_nominal else Buildings.Templates.Data.Defaults.ratMFloAirByCapChi*abs(capCooPhp_nominal)Source fluid mass flow rate in cooling mode - Each unit
Modelica.Units.SI.PressureDifferencedpSouCooPhp_nominaldpSouHeaPhp_nominal*(mSouCooPhp_flow_nominal/mSouHeaPhp_flow_nominal)^2Source fluid pressure drop in cooling mode - Each unit
Configuration
Buildings.Templates.Components.Types.HeatPumptypHpEquipment type
Booleanhave_hpSet to true for plants with non-reversible or reversible heat pumps
Booleanhave_phpSet to true for plants with polyvalent heat pumps
Booleanis_revSet to true for reversible heat pumps, false for heating only
Modelica.Units.SI.SpecificHeatCapacitycpHeaWat_defaultBuildings.Utilities.Psychrometrics.Constants.cpWatLiqHW default specific heat capacity
Modelica.Units.SI.SpecificHeatCapacitycpChiWatPhp_defaultcpHeaWat_defaultCHW default specific heat capacity
Modelica.Units.SI.SpecificHeatCapacitycpSou_defaultif typHp == Buildings.Templates.Components.Types.HeatPump.AirToWater then Buildings.Utilities.Psychrometrics.Constants.cpAir else Buildings.Utilities.Psychrometrics.Constants.cpWatLiqSource fluid default specific heat capacity
Nominal condition – Heat pumps
Modelica.Units.SI.HeatFlowRatecapHeaHp_nominalHeating capacity - Each unit
Modelica.Units.SI.MassFlowRatemHeaWatHp_flow_nominalHW mass flow rate - Each unit
Modelica.Units.SI.PressureDifferencedpHeaWatHp_nominalPressure drop at design HW mass flow rate - Each unit
Modelica.Units.SI.TemperatureTHeaWatSupHp_nominalHW supply temperature - Each unit
Modelica.Units.SI.TemperatureTHeaWatRetHp_nominalTHeaWatSupHp_nominal - abs(capHeaHp_nominal)/cpHeaWat_default/mHeaWatHp_flow_nominalHW return temperature - Each unit
Modelica.Units.SI.TemperatureTSouHeaHp_nominalOAT or source fluid supply temperature (evaporator entering) in heating mode - Each unit
Modelica.Units.SI.MassFlowRatemSouWwHeaHp_flow_nominalSource fluid mass flow rate in heating mode - Each unit
Modelica.Units.SI.PressureDifferencedpSouWwHeaHp_nominalSource fluid pressure drop in heating mode - Each unit
Modelica.Units.SI.HeatFlowRatecapCooHp_nominalCooling capacity - Each unit
Modelica.Units.SI.MassFlowRatemChiWatHp_flow_nominalCHW mass flow rate - Each unit
Modelica.Units.SI.PressureDifferencedpChiWatHp_nominaldpHeaWatHp_nominal*(mChiWatHp_flow_nominal/mHeaWatHp_flow_nominal)^2Pressure drop at design CHW mass flow rate - Each unit
Modelica.Units.SI.TemperatureTChiWatSupHp_nominal(Lowest) CHW supply temperature - Each unit
Modelica.Units.SI.TemperatureTChiWatRetHp_nominalif is_rev then TChiWatSupHp_nominal + abs(capCooHp_nominal)/cpChiWat_default/mChiWatHp_flow_nominal else Buildings.Templates.Data.Defaults.TChiWatRetCHW return temperature - Each unit
Modelica.Units.SI.TemperatureTSouCooHp_nominalOAT or source fluid supply temperature (condenser entering) in cooling mode - Each unit
Modelica.Units.SI.MassFlowRatemSouWwCooHp_flow_nominalSource fluid mass flow rate in cooling mode - Each unit
Performance data – Heat pumps
Modelica.Units.SI.PowerPHp_min0Minimum power when system is enabled with compressor cycled off - Each unit
Nominal condition – Polyvalent heat pumps
Modelica.Units.SI.HeatFlowRatecapHeaPhp_nominalHeating capacity - Each unit
Modelica.Units.SI.MassFlowRatemHeaWatPhp_flow_nominalHW mass flow rate - Each unit
Modelica.Units.SI.PressureDifferencedpHeaWatPhp_nominalPressure drop at design HW mass flow rate - Each unit
Modelica.Units.SI.TemperatureTHeaWatSupPhp_nominal(Highest) HW supply temperature - Each unit
Modelica.Units.SI.TemperatureTHeaWatRetPhp_nominalTHeaWatSupPhp_nominal - abs(capHeaPhp_nominal)/cpHeaWat_default/mHeaWatPhp_flow_nominalHW return temperature - Each unit
Modelica.Units.SI.TemperatureTSouHeaPhp_nominalTSouHeaHp_nominalOAT or source fluid supply temperature (evaporator entering) in heating mode - Each unit
Modelica.Units.SI.MassFlowRatemSouWwHeaPhp_flow_nominalSource fluid mass flow rate in heating mode - Each unit
Modelica.Units.SI.PressureDifferencedpSouWwHeaPhp_nominalSource fluid pressure drop in heating mode - Each unit
Modelica.Units.SI.HeatFlowRatecapCooPhp_nominalCooling capacity - Each unit
Modelica.Units.SI.MassFlowRatemChiWatPhp_flow_nominalCHW mass flow rate - Each unit
Modelica.Units.SI.PressureDifferencedpChiWatPhp_nominalPressure drop at design CHW mass flow rate - Each unit
Modelica.Units.SI.TemperatureTChiWatSupPhp_nominal(Lowest) CHW supply temperature - Each unit
Modelica.Units.SI.TemperatureTChiWatRetPhp_nominalTChiWatSupPhp_nominal + abs(capCooPhp_nominal)/cpChiWat_default/mChiWatPhp_flow_nominalCHW return temperature - Each unit
Modelica.Units.SI.TemperatureTSouCooPhp_nominalTSouCooHp_nominalOAT or source fluid supply temperature (condenser entering) in cooling mode - Each unit
Modelica.Units.SI.MassFlowRatemSouWwCooPhp_flow_nominalSource fluid mass flow rate in cooling mode - Each unit
Modelica.Units.SI.HeatFlowRatecapHeaShcPhp_nominalHeating capacity in SHC mode - Each unit
Modelica.Units.SI.HeatFlowRatecapCooShcPhp_nominalCooling capacity in SHC mode - Each unit
Performance data – Polyvalent heat pumps
Fluid.HeatPumps.ModularReversible.Data.TableData2DLoadDepSHC.GenericperPhpPerformance data - Each unit
Modelica.Units.SI.PowerPPhp_min0Minimum power when system is enabled with compressor cycled off - Each unit

Revisions

  • July 10, 2026, by Antoine Gautier:
    Refactored for plants with polyvalent heat pumps.
    This is for #4512.
  • March 29, 2024, by Antoine Gautier:
    First implementation.