modelTableData2DLoadDepSHC
Multipipe system data-based model dependent on source and sink temperature and PLR
Extends from Buildings.Fluid.HeatPumps.ModularReversible.RefrigerantCycle.BaseClasses.PartialHeatPumpCycle (Partial model to allow selection of only heat pump options).
Information
This model serves as a wrapper class to integrate the block Buildings.Fluid.HeatPumps.ModularReversible.RefrigerantCycle.BaseClasses.TableData2DLoadDepSHC into heat pump models. For a complete description of all modeling assumptions, please refer to the documentation of this latter block.
Implementation details
The modeling block
Buildings.Fluid.HeatPumps.ModularReversible.RefrigerantCycle.BaseClasses.TableData2DLoadDepSHC
provides the heat flow rate at both the condenser and evaporator.
Therefore, the current block bypasses the calculation of
QCon_flow from QEva_flow provided by the base class
Buildings.Fluid.HeatPumps.ModularReversible.RefrigerantCycle.BaseClasses.PartialHeatPumpCycle.
Instead, it uses the output variables from the modeling block directly.
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| String | devIde (from PartialRefrigerantCycle) | "" | Indicates the data source, used to warn users about different vapor compression devices in reversible models |
| Boolean | useInHeaPum (from PartialHeatPumpCycle) | =false to indicate that this model is used in a chiller | |
| Integer | nUni | 1 | Number of modules |
| Boolean | use_TLoaLvgForCtl | true | Set to true for leaving temperature control, false for entering temperature control |
| Buildings.Fluid.HeatPumps.ModularReversible.Data.TableData2DLoadDepSHC.Generic | dat | Record with performance data | |
| Modelica.Units.SI.Power | P_min | 0 | Remaining power when system is enabled with all compressors cycled off |
| Nominal condition | |||
| Modelica.Units.SI.Power | PEle_nominal (from PartialRefrigerantCycle) | Nominal electrical power consumption | |
| Modelica.Units.SI.Temperature | TCon_nominal (from PartialRefrigerantCycle) | Nominal temperature at secondary condenser side | |
| Modelica.Units.SI.Temperature | TEva_nominal (from PartialRefrigerantCycle) | Nominal temperature at secondary evaporator side | |
| Modelica.Units.SI.HeatFlowRate | QHea_flow_nominal (from PartialHeatPumpCycle) | Nominal heating capacity | |
| Advanced › Medium properties | |||
| Modelica.Units.SI.SpecificHeatCapacity | cpCon (from PartialRefrigerantCycle) | Evaporator medium specific heat capacity | |
| Modelica.Units.SI.SpecificHeatCapacity | cpEva (from PartialRefrigerantCycle) | Evaporator medium specific heat capacity | |
| Nominal condition - Cooling | |||
| Modelica.Units.SI.HeatFlowRate | QCoo_flow_nominal | Cooling heat flow rate - All modules | |
| Modelica.Units.SI.Temperature | TConCoo_nominal | CHW temperature: leaving if dat.use_TEvaOutForTab=true, entering otherwise | |
| Modelica.Units.SI.Temperature | TEvaCoo_nominal | Condenser cooling fluid temperature: leaving if dat.use_TAmbOutForTab=true, entering otherwise | |
| Nominal condition - SHC | |||
| Modelica.Units.SI.HeatFlowRate | QHeaShc_flow_nominal | Heating heat flow rate - All modules | |
| Modelica.Units.SI.HeatFlowRate | QCooShc_flow_nominal | Cooling heat flow rate - All modules | |
| Advanced › Staging logic | |||
| Real | dtRun | 300 | Minimum stage runtime |
| Real | dtMea | 120 | Load averaging time window |
| Real | SPLR | 0.9 | Staging part load ratio |
| Advanced › Safeties | |||
| Modelica.Units.SI.TemperatureDifference | dTSaf | 2 | Maximum temperature deviation from setpoint before limiting demand for safety (>0) |
Connectors
| Type | Name | Default | Description |
|---|---|---|---|
| Modelica.Blocks.Interfaces.RealOutput | PEle (from PartialRefrigerantCycle) | Electrical Power consumed by the device | |
| Modelica.Blocks.Interfaces.RealOutput | QCon_flow (from PartialRefrigerantCycle) | Heat flow rate through condenser | |
| Buildings.Fluid.HeatPumps.ModularReversible.BaseClasses.RefrigerantMachineControlBus | sigBus (from PartialRefrigerantCycle) | Bus-connector | |
| Modelica.Blocks.Interfaces.RealOutput | QEva_flow (from PartialRefrigerantCycle) | Heat flow rate through evaporator |
Components
| Type | Name | Default | Description |
|---|---|---|---|
| Buildings.Fluid.HeatPumps.ModularReversible.RefrigerantCycle.Frosting.NoFrosting | iceFacCal (from PartialRefrigerantCycle) | ||
| Modelica.Blocks.Math.Add | redQCon (from PartialRefrigerantCycle) | Reduce heat flow to the condenser based on the reduction to the evaporator | |
| Modelica.Blocks.Math.Product | proRedQEva (from PartialRefrigerantCycle) | Reduce heat flow to the evaporator based on the icing factor | |
| Modelica.Blocks.Math.Feedback | feeHeaFloEva (from PartialHeatPumpCycle) | Calculates evaporator heat flow with total energy balance | |
| Buildings.Controls.OBC.CDL.Reals.Sources.Constant[2] | cp | Specific heat capacity | |
| BaseClasses.TableData2DLoadDepSHC | calQUseP | Compute heat flow rate and input power | |
| Buildings.Controls.OBC.CDL.Reals.Sources.Constant | cst | Constant | |
| Buildings.Controls.OBC.CDL.Reals.Add | addQEvaQCon | Add QEva_flow to QCon_flow |
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.