modelTableData2DLoadDep
Extends from Buildings.Fluid.HeatPumps.ModularReversible.BaseClasses.PartialReversibleRefrigerantMachine.
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_TConOutForTabspecified 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_TEvaOutForTabspecified 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)
Sethea=truefor heating mode,hea=falsefor cooling mode. -
HW temperature setpoint:
THwSet(real, scalar)
This is either the supply or return temperature setpoint depending on the value ofuse_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 ofuse_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).
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| Boolean | use_TLoaLvgForCtl | true | Set to true for leaving temperature control, false for entering temperature control |
| Real | scaFacHea | refCyc.refCycHeaPumHea.scaFac | Scaling factor of heat pump |
| Buildings.Fluid.HeatPumps.ModularReversible.Data.TableData2DLoadDep.GenericHeatPump | datHea | ||
| Buildings.Fluid.Chillers.ModularReversible.Data.TableData2DLoadDep.Generic | datCoo | ||
| Modelica.Units.SI.Power | P_min | 0 | Minimum power when system is enabled with compressor cycled off |
| Nominal condition | |||
| Modelica.Units.SI.HeatFlowRate | QHea_flow_nominal | Nominal heating capacity | |
| Modelica.Units.SI.Temperature | TConHea_nominal | HW temperature: leaving if datHea.use_TConOutForTab=true, entering otherwise | |
| Modelica.Units.SI.Temperature | TEvaHea_nominal | Evaporator heating fluid temperature: leaving if datHea.use_TEvaOutForTab=true, entering otherwise | |
| Nominal condition - Cooling | |||
| Modelica.Units.SI.HeatFlowRate | QCoo_flow_nominal | Nominal cooling capacity | |
| Modelica.Units.SI.Temperature | TConCoo_nominal | CHW temperature: leaving if datCoo.use_TEvaOutForTab=true, entering otherwise | |
| Modelica.Units.SI.Temperature | TEvaCoo_nominal | Condenser cooling fluid temperature: leaving if datCoo.use_TConOutForTab=true, entering otherwise | |
Components
| Type | Name | Default | Description |
|---|---|---|---|
| Modelica.Blocks.Sources.BooleanConstant | conHea | Locks the device in heating mode if designated to be not reversible | |
| Buildings.Fluid.HeatPumps.ModularReversible.BaseClasses.CalculateCommandSignal | calYSet | Calculate command signal from required PLR | |
| Buildings.Controls.OBC.CDL.Interfaces.BooleanInput | on | On/off command: true to enable heat pump, false to disable heat pump | |
| Buildings.Controls.OBC.CDL.Interfaces.RealInput | THwSet | HW temperature setpoint - Supply or return depending on use_TLoaLvgForCtl | |
| Buildings.Controls.OBC.CDL.Interfaces.RealInput | TChwSet | CHW temperature setpoint - Supply or return depending on use_TLoaLvgForCtl | |
| Buildings.Controls.OBC.CDL.Interfaces.BooleanInput | hea | Switchover signal: true for heating, false for cooling | |
| Modelica.Blocks.Interfaces.RealOutput | PLR | Compressor part load ratio | |
| Modelica.Blocks.Sources.BooleanConstant | conHeaBus | Locks the device in heating mode if not reversible - Case with use_busConOnl=true | |
| Buildings.Templates.Plants.Controls.Utilities.PlaceholderReal | phTChwSet | Placeholder value |
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.