recordHeatPump

Record for heat pump model

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

Information

This record provides the set of sizing and operating parameters for heat pump models that can be found within Buildings.Templates.Components.HeatPumps.

Performance data

The design capacity is used to parameterize the heat pump model. The capacity (and power) computed from the external performance data file will be scaled to match the value provided at design conditions.

Also note that placeholder values are assigned to some parameters of the subrecords perCoo and perShc which are used to specify the performance data in cooling mode and SHC mode, respectively. These values should be overwritten for reversible and polyvalent heat pumps. This overwriting happens automatically when redeclaring or reassigning the performance records perCoo and perShc.

Parameters

TypeNameDefaultDescription
Modelica.Units.SI.SpecificHeatCapacitycpChiWat_defaultif typMod == Buildings.Templates.Components.Types.HeatPumpCapability.Polyvalent then cpChiWatPhp_default else cpHeaWat_defaultCHW default specific heat capacity
Modelica.Units.SI.MassFlowRatemSouHea_flow_nominalif typ == Buildings.Templates.Components.Types.HeatPump.WaterToWater then mSouWwHea_flow_nominal else Buildings.Templates.Data.Defaults.ratMFloAirByCapChi*abs(capHea_nominal)Source fluid mass flow rate in heating mode
Modelica.Units.SI.PressureDifferencedpSouHea_nominalif typ == Buildings.Templates.Components.Types.HeatPump.WaterToWater then dpSouWwHea_nominal else Buildings.Templates.Data.Defaults.dpAirChiSource fluid pressure drop in heating mode
Modelica.Units.SI.MassFlowRatemSouCoo_flow_nominalif typ == Buildings.Templates.Components.Types.HeatPump.WaterToWater then mSouWwCoo_flow_nominal else Buildings.Templates.Data.Defaults.ratMFloAirByCapChi*abs(capCoo_nominal)Source fluid mass flow rate in cooling mode
Modelica.Units.SI.PressureDifferencedpSouCoo_nominaldpSouHea_nominal*(mSouCoo_flow_nominal/mSouHea_flow_nominal)^2Source fluid pressure drop in cooling mode
Fluid.HeatPumps.ModularReversible.Data.TableData2DLoadDep.GenericHeatPumpperHea
Fluid.Chillers.ModularReversible.Data.TableData2DLoadDep.GenericperCoo
Fluid.HeatPumps.ModularReversible.Data.TableData2DLoadDepSHC.GenericperPhp
Configuration
Types.HeatPumptypHeat pump source/sink type
Buildings.Templates.Components.Types.HeatPumpCapabilitytypModHeat pump operating mode capability
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 typ == 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
Modelica.Units.SI.MassFlowRatemHeaWat_flow_nominalHW mass flow rate
Modelica.Units.SI.PressureDifferencedpHeaWat_nominalPressure drop at design HW mass flow rate
Modelica.Units.SI.HeatFlowRatecapHea_nominalHeating capacity
Modelica.Units.SI.TemperatureTHeaWatSup_nominal(Highest) HW supply temperature
Modelica.Units.SI.TemperatureTHeaWatRet_nominalTHeaWatSup_nominal - abs(capHea_nominal)/cpHeaWat_default/mHeaWat_flow_nominalHW return temperature
Modelica.Units.SI.MassFlowRatemChiWat_flow_nominalCHW mass flow rate
Modelica.Units.SI.PressureDifferencedpChiWatPhp_nominalPressure drop at design CHW mass flow rate
Modelica.Units.SI.PressureDifferencedpChiWat_nominalif typMod == Buildings.Templates.Components.Types.HeatPumpCapability.Reversible then dpHeaWat_nominal*(mChiWat_flow_nominal/mHeaWat_flow_nominal)^2 elseif typMod == Buildings.Templates.Components.Types.HeatPumpCapability.Polyvalent then dpChiWatPhp_nominal else 0Pressure drop at design CHW mass flow rate
Modelica.Units.SI.HeatFlowRatecapCoo_nominalCooling capacity
Modelica.Units.SI.TemperatureTChiWatSup_nominal(Lowest) CHW supply temperature
Modelica.Units.SI.TemperatureTChiWatRet_nominalif typMod == Buildings.Templates.Components.Types.HeatPumpCapability.Reversible then TChiWatSup_nominal + abs(capCoo_nominal)/cpChiWat_default/mChiWat_flow_nominal else Buildings.Templates.Data.Defaults.TChiWatRetCHW return temperature
Modelica.Units.SI.HeatFlowRatecapHeaShc_nominalHeating capacity in SHC mode
Modelica.Units.SI.HeatFlowRatecapCooShc_nominalCooling capacity in SHC mode
Modelica.Units.SI.TemperatureTSouHea_nominalOAT or source fluid supply temperature (evaporator entering) in heating mode
Modelica.Units.SI.MassFlowRatemSouWwHea_flow_nominalSource fluid mass flow rate in heating mode
Modelica.Units.SI.PressureDifferencedpSouWwHea_nominalSource fluid pressure drop in heating mode
Modelica.Units.SI.TemperatureTSouCoo_nominalOAT or source fluid supply temperature (condenser entering) in cooling mode
Modelica.Units.SI.MassFlowRatemSouWwCoo_flow_nominalSource fluid mass flow rate in cooling mode
Performance data
Modelica.Units.SI.PowerP_min0Minimum power when system is enabled with compressor cycled off

Revisions

  • July 10, 2026, by Antoine Gautier:
    Added the typMod parameter and the performance data records required to support polyvalent heat pumps.
    This is for #4512.
  • March 29, 2024, by Antoine Gautier:
    First implementation.