recordHeatPumpPlant

Record for heat pump plant

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

Information

This record provides the set of sizing and operating parameters for the heat pump plant models within Buildings.Templates.Plants.HeatPumps.

Most of the parameters should be assigned through the sub-record dedicated to the controller. All parameters that are also needed to parameterize other plant components are propagated from the controller sub-record to the corresponding equipment sub-records. Note that those parameter bindings are not final so they may be overwritten in case a component is parameterized at nominal conditions that differ from the design conditions specified in the controller sub-record.

Only identical heat pumps are currently supported.

The heat pump performance data are provided via the subrecords hp.perHeaHp and hp.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
Buildings.Templates.Plants.HeatPumps.Configuration.HeatPumpPlantcfgConfiguration parameters
Modelica.Units.SI.MassFlowRate[cfg.nPumHeaWatPri]mPumHeaWatPriDed_flow_nominal{if i <= cfg.nHp then (if cfg.have_pumChiWatPriDedHp then hp.mHeaWatHp_flow_nominal else max(hp.mHeaWatHp_flow_nominal, hp.mChiWatHp_flow_nominal)) else hp.mHeaWatPhp_flow_nominal for i in 1:cfg.nPumHeaWatPri}Dedicated primary HW pump mass flow rate
Modelica.Units.SI.MassFlowRate[cfg.nPumChiWatPri]mPumChiWatPriDed_flow_nominal{if i >= cfg.nPumChiWatPri - cfg.nPhp + 1 then hp.mChiWatPhp_flow_nominal else hp.mChiWatHp_flow_nominal for i in 1:cfg.nPumChiWatPri}Dedicated primary CHW pump mass flow rate
Advanced
Stringid""System tag
Controls
Buildings.Templates.Plants.HeatPumps.Components.Data.ControllerctlController
Heat pumps and polyvalent units
Buildings.Templates.Plants.HeatPumps.Components.Data.HeatPumpGrouphpNominal conditions and performance data
Modelica.Units.SI.PressureDifferencedpBalHeaWatHp_nominal0HP HW balancing valve pressure drop at design HW flow
Modelica.Units.SI.PressureDifferencedpBalChiWatHp_nominal0HP CHW balancing valve pressure drop at design CHW flow
Modelica.Units.SI.PressureDifferencedpBalHeaWatPhp_nominal0Polyvalent unit HW balancing valve pressure drop at design HW flow
Modelica.Units.SI.PressureDifferencedpBalChiWatPhp_nominal0Polyvalent unit CHW balancing valve pressure drop at design CHW flow
Primary HW loop
Buildings.Templates.Components.Data.PumpMultiplepumHeaWatPriPrimary HW pumps
Modelica.Units.SI.PressureDifference[cfg.nPumHeaWatPri]dpValCheHeaWat_nominalfill(Buildings.Templates.Data.Defaults.dpValChe, cfg.nPumHeaWatPri)Primary (HW or common HW and CHW) pump check valve pressure drop at design flow rate (selection conditions) – Each unit
Buildings.Templates.Components.Data.ValvevalHeaWatMinBypHW minimum flow bypass valve
Modelica.Units.SI.VolumeVTanHeaWatif cfg.have_heaWat then 4*60*(cfg.nHp*hp.mHeaWatHp_flow_nominal + cfg.nPhp*hp.mHeaWatPhp_flow_nominal)/cfg.rhoHeaWat_default else 0Volume of HW buffer tank
Secondary HW loop
Buildings.Templates.Components.Data.PumpMultiplepumHeaWatSecSecondary HW pumps
Primary CHW loop
Buildings.Templates.Components.Data.PumpMultiplepumChiWatPriPrimary CHW pumps
Modelica.Units.SI.PressureDifference[cfg.nPumChiWatPri]dpValCheChiWat_nominalfill(Buildings.Templates.Data.Defaults.dpValChe, cfg.nPumChiWatPri)Primary CHW pump check valve pressure drop at design flow rate (selection conditions) – Each unit
Buildings.Templates.Components.Data.ValvevalChiWatMinBypCHW minimum flow bypass valve
Modelica.Units.SI.VolumeVTanChiWatif cfg.have_chiWat then 2*60*(cfg.nHp*hp.mChiWatHp_flow_nominal + cfg.nPhp*hp.mChiWatPhp_flow_nominal)/cfg.rhoChiWat_default else 0Volume of HW buffer tank
Secondary CHW loop
Buildings.Templates.Components.Data.PumpMultiplepumChiWatSecSecondary CHW pumps
Sidetream heat recovery chiller
Buildings.Templates.Components.Data.ChillerhrcChiller
Buildings.Templates.Components.Data.PumpSinglepumChiWatHrcHRC CHW pump
Buildings.Templates.Components.Data.PumpSinglepumHeaWatHrcHRC HW pump

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.