.Buildings.Fluid.HeatPumps.ModularReversible.TableData2DLoadDep

Information

This is a model for reversible or non-reversible heat pumps where the capacity and power are interpolated from manufacturer data along three variables.

• Condenser entering or leaving temperature: the choice between the entering or leaving temperature depends on the value of the parameter use_TConOutForTab specified in the parameter record ( Buildings.Fluid.HeatPumps.ModularReversible.Data.TableData2DLoadDep.GenericHeatPump or Buildings.Fluid.Chillers.ModularReversible.Data.TableData2DLoadDep.Generic).
• Evaporator entering or leaving temperature: the choice between the entering or leaving temperature depends on the value of the parameter use_TEvaOutForTab specified in the parameter record.
• Part load ratio (PLR): the part load ratio is used as a proxy variable for the actual capacity modulation observable. A discrete observable such as the number of operating compressors for systems with multiple on/off compressors is converted into a continuous PLR value and the model only approximates the system performance on a time average.

The model includes ideal controls that solve for the HW or CHW supply or return temperature setpoint within the capacity limit. The Boolean parameter use_TLoaLvgForCtl is used for toggling between supply or return temperature control. The default setting use_TLoaLvgForCtl=true corresponds to supply temperature control.

For a comprehensive description of the algorithm and the calculations for capacity and power, please refer to the documentation of Buildings.Fluid.HeatPumps.ModularReversible.RefrigerantCycle.BaseClasses.TableData2DLoadDep. This documentation also details the required format for the performance data file.

Control points

The following input points are available.

• Heat pump on/off command signal: on (Boolean, scalar)
• For reversible heat pumps only (use_rev=true), heat pump switchover signal: hea (Boolean, scalar)
  Set hea=true for heating mode, hea=false for cooling mode.
• HW temperature setpoint: THwSet (real, scalar)
  This is either the supply or return temperature setpoint depending on the value of use_TLoaLvgForCtl.
• For reversible heat pumps only (use_rev=true), CHW temperature setpoint: TChwSet (real, scalar)
  This is either the supply or return temperature setpoint depending on the value of use_TLoaLvgForCtl.

Implementation details

This model introduces structural changes compared to other models within Buildings.Fluid.HeatPumps.ModularReversible.

First, the Boolean parameter use_rev is used for toggling between reversible and non-reversible systems. This differs from other models which require redeclaring the component modeling the reversed cycle.

Second, the model includes new input variables that match the control points found in heat pump onboard controllers (see the previous section for their description).

Contents

Name	Description
RefrigerantCycleHeatPumpHeating	Refrigerant cycle module for the heating mode
RefrigerantCycleHeatPumpCooling	Refrigerant cycle module for the cooling mode

Revisions

• March 23, 2026, by Antoine Gautier:
  Refactored with two separate connectors for HW and CHW temperature setpoints.
  This is for #4507.
• March 21, 2025, by Antoine Gautier:
  First implementation.