modelTableData2DLoadDepSHC
Extends from Modelica.Icons.Example (Icon for runnable examples).
Information
This model validates the hydronics and built-in control logic of Buildings.Fluid.HeatPumps.ModularReversible.TableData2DLoadDepSHC.
The model represents a three-module system where the HW and CHW isolation
valves are modeled using an equivalent actuator.
The actuator model represents the parallel network of the modules'
condenser or evaporator barrels in series with the HW or CHW isolation valves.
It is parameterized with the flow characteristics calculated
by the heat pump model, and controlled by the output variables provided
by this model.
The heat pump operating mode switches between simultaneous heating and cooling,
heating only, and cooling only.
The on/off command starts as true and is switched to
false at the end.
While the heat pump component is subjected to the design HW and CHW differential pressures and return temperatures, the supply temperature setpoints vary, creating a varying load. The validation then consists in verifying that the modules are effectively staged in various modes to adapt to the load. Additionally, it confirms that the isolation valve parameterization and controls result in HW and CHW flow rates that vary linearly with the number of enabled modules on each side.
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| Data.TableData2DLoadDepSHC.Generic | dat | Performance data | |
| Dynamics › Conservation equations | |||
| Modelica.Fluid.Types.Dynamics | energyDynamics | Modelica.Fluid.Types.Dynamics.FixedInitial | Type of energy balance: dynamic (3 initialization options) or steady state |
| Nominal condition | |||
| Modelica.Units.SI.Temperature | THwSup_nominal | 323.15 | HW supply temperature |
| Modelica.Units.SI.Temperature | THwRet_nominal | 315.15 | HW return temperature |
| Modelica.Units.SI.Temperature | TChwSup_nominal | 280.15 | CHW supply temperature |
| Modelica.Units.SI.Temperature | TChwRet_nominal | 285.15 | CHW return temperature |
| Modelica.Units.SI.MassFlowRate | mHw_flow_nominal | QHea_flow_nominal/(THwSup_nominal - THwRet_nominal)/Buildings.Media.Water.cp_const | HW mass flow rate |
| Modelica.Units.SI.MassFlowRate | mChw_flow_nominal | QCoo_flow_nominal/(TChwSup_nominal - TChwRet_nominal)/Buildings.Media.Water.cp_const | CHW mass flow rate |
| Nominal condition - Heating mode | |||
| Modelica.Units.SI.Temperature | TAmbHea_nominal | 268.15 | OA temperature |
| Modelica.Units.SI.HeatFlowRate | QHea_flow_nominal | 58E3 | Heating heat flow rate - Heating mode |
| Modelica.Units.SI.HeatFlowRate | QHeaShc_flow_nominal | 85E3 | Heating heat flow rate - SHC mode |
| Nominal condition - Cooling mode | |||
| Modelica.Units.SI.Temperature | TAmbCoo_nominal | 308.15 | Ambient side fluid temperature — Entering or leaving depending on use_TAmbOutForTab |
| Modelica.Units.SI.HeatFlowRate | QCoo_flow_nominal | -73E3 | Cooling heat flow rate - Cooling mode |
| Modelica.Units.SI.HeatFlowRate | QCooShc_flow_nominal | -65E3 | Cooling heat flow rate - SHC mode |
Connectors
| Type | Name | Default | Description |
|---|---|---|---|
| BoundaryConditions.WeatherData.Bus | weaBus |
Components
| Type | Name | Default | Description |
|---|---|---|---|
| Buildings.Controls.OBC.CDL.Reals.Sources.TimeTable | TChiWatSet | CHW supply or return temperature setpoint | |
| Buildings.Controls.OBC.CDL.Reals.Sources.Sin | THeaWatSet | HW supply or return temperature setpoint | |
| Buildings.Controls.OBC.CDL.Reals.Sources.Constant | THwEnt | Condenser entering HW temperature | |
| Buildings.Controls.OBC.CDL.Reals.Sources.Constant | TChwEnt | Evaporator entering CHW temperature | |
| Buildings.Controls.OBC.CDL.Reals.Sources.Constant | TOut | OA temperature | |
| Buildings.Controls.OBC.CDL.Reals.Min | min1 | ||
| Buildings.Controls.OBC.CDL.Reals.Sources.Constant | THeaWatSupNom | Design HW supply temperature | |
| Buildings.Controls.OBC.CDL.Logical.Sources.TimeTable | onCoo | Cooling on/off command | |
| Buildings.Controls.OBC.CDL.Logical.Sources.TimeTable | onHea | Heating on/off command | |
| Buildings.Fluid.HeatPumps.ModularReversible.TableData2DLoadDepSHC | hp | Multipipe heat pump | |
| Sources.Boundary_pT | hwIn | Boundary conditions of HW at HP inlet | |
| Sources.Boundary_pT | hwOut | Boundary conditions of HW at HP outlet | |
| Sources.Boundary_pT | chwOut | Boundary conditions of CHW at HP outlet | |
| Sources.Boundary_pT | chwIn | Boundary conditions of CHW at HP inlet | |
| Sensors.TemperatureTwoPort | THwSup | HW supply temperature | |
| Sensors.TemperatureTwoPort | THwRet | HW return temperature | |
| Sensors.TemperatureTwoPort | TChwRet | CHW return temperature | |
| Sensors.TemperatureTwoPort | TChwSup | CHW supply temperature | |
| Actuators.Valves.TwoWayTable | valHwIso | Equivalent actuator for modules' condenser barrels and HW isolation valves | |
| Actuators.Valves.TwoWayTable | valChwIso | Equivalent actuator for modules' evaporator barrels and CHW isolation valves | |
| Buildings.Controls.OBC.CDL.Integers.MultiSum | sumNumUni | Total number of enabled modules | |
| Buildings.Controls.OBC.CDL.Utilities.Assert | assMes | Assert condition on number of enabled modules | |
| Buildings.Controls.OBC.CDL.Integers.LessEqualThreshold | intLesEquThr | True if number of enabled modules lower or equal to number of modules |
Contents
| Name | Description |
|---|---|
 Medium |
Revisions
-
March 23, 2026, by Antoine Gautier:
Refactored with two separate connectors for heating and cooling on/off commands.
This is for #4507. -
July 1, 2025, by Antoine Gautier:
First implementation.