Buildings.Fluid.HeatPumps.ModularReversible.Controls.Safety.Data
Package with parameters for safety control blocks
Information
Package with record data to bundle the parameterization of the safety controls into one class.
Extends from Modelica.Icons.MaterialPropertiesPackage (Icon for package containing property classes).
Package Content
| Name | Description |
|---|---|
 Generic
|
Generic record definition for safety control blocks |
| Wuellhorst2021
|
Apply the default values according to the conference publication by Wuellhorst et al. (2021) |
Buildings.Fluid.HeatPumps.ModularReversible.Controls.Safety.Data.Generic
Generic record definition for safety control blocks
Information
Base data definitions with parameters relevant to safety control of refrigerant machines.
Typically, datasheets of manufacturers provide specific values for these assumptions. Some values are harder to get, e.g. the minimum and maximum for on-time or off time.
Extends from Modelica.Icons.Record (Icon for records).
Contents
| Type | Name | Default | Description |
|---|---|---|---|
| On/Off Control | |||
| Boolean | use_minOnTime | =false to ignore minimum on-time constraint | |
| Time | minOnTime | Mimimum on-time [s] | |
| Real | ySetRed | Reduced relative compressor speed to allow longer on-time [1] | |
| Boolean | use_minOffTime | =false to ignore minimum off time | |
| Time | minOffTime | Minimum off time [s] | |
| Boolean | use_maxCycRat | =false to ignore maximum cycle rate constraint | |
| Integer | maxCycRat | Maximum cycle rate | |
| Boolean | onOffMea_start | true | Start value for the on-off signal of the device, true for on |
| Operational Envelope | |||
| Boolean | use_opeEnv | =true to use a the operational envelope | |
| Temperature | tabUppHea[:, 2] | Upper temperature boundary for heating with second column as useful temperature side [K] | |
| Temperature | tabLowCoo[:, 2] | Lower temperature boundary for cooling with second column as useful temperature side [K] | |
| TemperatureDifference | dTHysOpeEnv | 5 | Hysteresis for operational envelopes of both upper and lower boundaries [K] |
| Boolean | use_TConOutHea | true | =true to use condenser outlet temperature for envelope in heating mode, false for inlet |
| Boolean | use_TEvaOutHea | false | =true to use evaporator outlet temperature for envelope in heating mode, false for inlet |
| Boolean | use_TConOutCoo | false | =true to use useful side outlet temperature for envelope in cooling mode, false for inlet |
| Boolean | use_TEvaOutCoo | true | =true to use evaporator outlet temperature for envelope in cooling mode, false for inlet |
| Anti Freeze Control | |||
| Boolean | use_antFre | =true to enable antifreeze control | |
| ThermodynamicTemperature | TAntFre | Limit temperature for antifreeze control [K] | |
| TemperatureDifference | dTHysAntFre | Hysteresis interval width for antifreeze control [K] | |
| Minimal Flow Rates | |||
| Boolean | use_minFlowCtr | =false to disable minimum mass flow rate requirements | |
| Real | r_mEvaMinPer_flow | Percentage of mass flow rate in evaporator required to operate the device | |
| Real | r_mConMinPer_flow | Percentage of mass flow rate in condenser required to operate the device | |
Modelica definition
record Generic "Generic record definition for safety control blocks"
extends Modelica.Icons.Record;
parameter Boolean use_minOnTime
"=false to ignore minimum on-time constraint";
parameter Modelica.Units.SI.Time minOnTime
"Mimimum on-time";
parameter Real ySetRed(unit="1")
"Reduced relative compressor speed to allow longer on-time";
parameter Boolean use_minOffTime
"=false to ignore minimum off time";
parameter Modelica.Units.SI.Time minOffTime
"Minimum off time";
parameter Boolean use_maxCycRat
"=false to ignore maximum cycle rate constraint";
parameter Integer maxCycRat "Maximum cycle rate";
parameter Boolean onOffMea_start=true
"Start value for the on-off signal of the device, true for on";
parameter Boolean use_opeEnv
"=true to use a the operational envelope";
parameter Modelica.Units.SI.Temperature tabUppHea[:,2]
"Upper temperature boundary for heating with second column as useful temperature side";
parameter Modelica.Units.SI.Temperature tabLowCoo[:,2]
"Lower temperature boundary for cooling with second column as useful temperature side";
parameter Modelica.Units.SI.TemperatureDifference dTHysOpeEnv=5
"Hysteresis for operational envelopes of both upper and lower boundaries";
parameter Boolean use_TConOutHea=true
"=true to use condenser outlet temperature for envelope in heating mode, false for inlet";
parameter Boolean use_TEvaOutHea=false
"=true to use evaporator outlet temperature for envelope in heating mode, false for inlet";
parameter Boolean use_TConOutCoo=false
"=true to use useful side outlet temperature for envelope in cooling mode, false for inlet";
parameter Boolean use_TEvaOutCoo=true
"=true to use evaporator outlet temperature for envelope in cooling mode, false for inlet";
parameter Boolean use_antFre
"=true to enable antifreeze control";
parameter Modelica.Units.SI.ThermodynamicTemperature TAntFre
"Limit temperature for antifreeze control";
parameter Modelica.Units.SI.TemperatureDifference dTHysAntFre
"Hysteresis interval width for antifreeze control";
parameter Boolean use_minFlowCtr
"=false to disable minimum mass flow rate requirements";
parameter Real r_mEvaMinPer_flow
"Percentage of mass flow rate in evaporator required to operate the device";
parameter Real r_mConMinPer_flow
"Percentage of mass flow rate in condenser required to operate the device";
end Generic;
Buildings.Fluid.HeatPumps.ModularReversible.Controls.Safety.Data.Wuellhorst2021
Apply the default values according to the conference publication by Wuellhorst et al. (2021)
Information
Default values according to the conference publication by Wuellhorst et. al. https://doi.org/10.3384/ecp21181561.
These values are conservative estimates based on multiple datasheets.
Extends from Generic (Generic record definition for safety control blocks).
Contents
| Type | Name | Default | Description |
|---|---|---|---|
| On/Off Control | |||
| Boolean | use_minOnTime | true | =false to ignore minimum on-time constraint |
| Time | minOnTime | 600 | Mimimum on-time [s] |
| Real | ySetRed | 0.3 | Reduced relative compressor speed to allow longer on-time [1] |
| Boolean | use_minOffTime | true | =false to ignore minimum off time |
| Time | minOffTime | 1200 | Minimum off time [s] |
| Boolean | use_maxCycRat | true | =false to ignore maximum cycle rate constraint |
| Integer | maxCycRat | 3 | Maximum cycle rate |
| Boolean | onOffMea_start | false | Start value for the on-off signal of the device, true for on |
| Operational Envelope | |||
| Boolean | use_opeEnv | true | =true to use a the operational envelope |
| Temperature | tabUppHea[:, 2] | [233.15, 343.15; 313.15, 343... | Upper temperature boundary for heating with second column as useful temperature side [K] |
| Temperature | tabLowCoo[:, 2] | [263.15, 283.15; 333.15, 283... | Lower temperature boundary for cooling with second column as useful temperature side [K] |
| TemperatureDifference | dTHysOpeEnv | 5 | Hysteresis for operational envelopes of both upper and lower boundaries [K] |
| Boolean | use_TConOutHea | true | =true to use condenser outlet temperature for envelope in heating mode, false for inlet |
| Boolean | use_TEvaOutHea | false | =true to use evaporator outlet temperature for envelope in heating mode, false for inlet |
| Boolean | use_TConOutCoo | false | =true to use useful side outlet temperature for envelope in cooling mode, false for inlet |
| Boolean | use_TEvaOutCoo | true | =true to use evaporator outlet temperature for envelope in cooling mode, false for inlet |
| Anti Freeze Control | |||
| Boolean | use_antFre | false | =true to enable antifreeze control |
| ThermodynamicTemperature | TAntFre | 273.15 | Limit temperature for antifreeze control [K] |
| TemperatureDifference | dTHysAntFre | 2 | Hysteresis interval width for antifreeze control [K] |
| Minimal Flow Rates | |||
| Boolean | use_minFlowCtr | true | =false to disable minimum mass flow rate requirements |
| Real | r_mEvaMinPer_flow | 0.1 | Percentage of mass flow rate in evaporator required to operate the device |
| Real | r_mConMinPer_flow | 0.1 | Percentage of mass flow rate in condenser required to operate the device |
Modelica definition
record Wuellhorst2021
"Apply the default values according to the conference publication by Wuellhorst et al. (2021)"
extends Generic(
tabLowCoo=[263.15,283.15; 333.15,283.15],
dTHysAntFre=2,
onOffMea_start=false,
ySetRed=0.3,
r_mConMinPer_flow=0.1,
r_mEvaMinPer_flow=0.1,
use_minFlowCtr=true,
use_maxCycRat=true,
use_minOffTime=true,
use_minOnTime=true,
TAntFre=273.15,
use_antFre=false,
dTHysOpeEnv=5,
use_opeEnv=true,
tabUppHea=[233.15,343.15; 313.15,343.15],
maxCycRat=3,
minOffTime=1200,
minOnTime=600);
end Wuellhorst2021;