Records for design and operating parameters
Information
This package provides records for design and operating parameters.
Extends from Modelica.Icons.MaterialPropertiesPackage (Icon for package containing property classes).
Package Content
| Name |
Description |
Controller
|
Record for plant controller |
HeatPumpGroup
|
|
Record for plant controller
Information
This record provides the set of parameters for
heat pump plant controllers that can be found within
Buildings.Templates.Plants.HeatPumps.Components.Controls.
Extends from Modelica.Icons.Record (Icon for records).
Contents
| Type | Name | Default | Description |
| HeatPumpPlant | cfg | | Plant configuration parameters |
| Temperature setpoints |
| Temperature | THeaWatSup_nominal | | Maximum HW supply temperature setpoint (design HW supply temperature) [K] |
| Real | THeaWatSupSet_min | | Minimum value to which the HW supply temperature can be reset [K] |
| Temperature | TOutHeaWatLck | Buildings.Templates.Data.Def... | Outdoor air lockout temperature above which the HW loop is prevented from operating [K] |
| Temperature | TChiWatSup_nominal | | Minimum CHW supply temperature setpoint (design CHW supply temperature) [K] |
| Temperature | TChiWatSupSet_max | | Maximum value to which the CHW supply temperature can be reset [K] |
| Temperature | TOutChiWatLck | Buildings.Templates.Data.Def... | Outdoor air lockout temperature below which the CHW loop is prevented from operating [K] |
| Heat pump flow setpoints |
| VolumeFlowRate | VHeaWatHp_flow_nominal | | Design heat pump HW volume flow rate - Each heat pump [m3/s] |
| VolumeFlowRate | VHeaWatHp_flow_min | 1.1*VHeaWatHp_flow_nominal | Minimum heat pump HW volume flow rate - Each heat pump [m3/s] |
| VolumeFlowRate | VChiWatHp_flow_nominal | | Design heat pump CHW volume flow rate - Each heat pump [m3/s] |
| VolumeFlowRate | VChiWatHp_flow_min | 1.1*VChiWatHp_flow_nominal | Minimum heat pump CHW volume flow rate - Each heat pump [m3/s] |
| Capacity |
| HeatFlowRate | capHeaHp_nominal | | Design heat pump heating capacity - Each heat pump [W] |
| VolumeFlowRate | VHeaWatPri_flow_nominal | VHeaWatHp_flow_nominal*cfg.nHp | Design primary HW volume flow rate [m3/s] |
| VolumeFlowRate | VHeaWatSec_flow_nominal | | Design secondary HW volume flow rate [m3/s] |
| HeatFlowRate | capCooHp_nominal | | Design heat pump cooling capacity - Each heat pump [W] |
| VolumeFlowRate | VChiWatPri_flow_nominal | VChiWatHp_flow_nominal*cfg.nHp | Design primary CHW volume flow rate [m3/s] |
| VolumeFlowRate | VChiWatSec_flow_nominal | | Design secondary CHW volume flow rate [m3/s] |
| Information provided by designer |
| PressureDifference | dpHeaWatRemSet_min | 5*6894 | Minimum value to which the HW differential pressure can be reset - Remote sensor [Pa] |
| PressureDifference | dpChiWatRemSet_min | 5*6894 | Minimum value to which the CHW differential pressure can be reset - Remote sensor [Pa] |
| Real | TChiWatSupHrc_min | | Sidestream HRC – Minimum allowable CHW supply temperature [K] |
| Real | THeaWatSupHrc_max | | Sidestream HRC – Maximum allowable HW supply temperature [K] |
| Real | COPHeaHrc_nominal | | Sidestream HRC – Heating COP at design heating conditions [1] |
| Real | capCooHrc_min | | Sidestream HRC – Minimum cooling capacity below which cycling occurs [W] |
| Real | capHeaHrc_min | | Sidestream HRC – Minimum heating capacity below which cycling occurs [W] |
| Information provided by testing, adjusting, and balancing contractor |
| PressureDifference | dpHeaWatRemSet_max[:] | | Maximum HW differential pressure setpoint - Remote sensor [Pa] |
| Real | dpHeaWatLocSet_min | 5*6895 | Minimum HW loop differential pressure setpoint local to the plant [Pa] |
| Real | dpHeaWatLocSet_max | | Maximum HW loop differential pressure setpoint local to the plant [Pa] |
| Real | yPumHeaWatPriSet | | Primary pump speed providing design heat pump flow in heating mode [1] |
| Real | yPumHeaWatPri_min | 0.1 | Primary HW pump minimum speed [1] |
| Real | yPumHeaWatSec_min | 0.1 | Secondary HW pump minimum speed [1] |
| PressureDifference | dpChiWatRemSet_max[:] | | Maximum CHW differential pressure setpoint - Remote sensor [Pa] |
| Real | dpChiWatLocSet_min | 5*6895 | Minimum CHW loop differential pressure setpoint local to the plant [Pa] |
| Real | dpChiWatLocSet_max | | Maximum CHW loop differential pressure setpoint local to the plant [Pa] |
| Real | yPumChiWatPriSet | | Primary pump speed providing design heat pump flow in cooling mode [1] |
| Real | yPumChiWatPri_min | 0.1 | Primary CHW pump minimum speed [1] |
| Real | yPumChiWatSec_min | 0.1 | Secondary CHW pump minimum speed [1] |
| Plant enable |
| Real | schHea[:, 2] | [0, 1; 24*3600, 1] | Heating mode enable schedule |
| Real | schCoo[:, 2] | [0, 1; 24*3600, 1] | Cooling mode enable schedule |
| Equipment staging and rotation |
| Real | staEqu[:, :] | | Staging matrix – Equipment required for each stage [1] |
| Real | plrSta | 0.9 | Staging part load ratio [1] |
Modelica definition
record Controller
extends Modelica.Icons.Record;
parameter Buildings.Templates.Plants.HeatPumps.Configuration.HeatPumpPlant cfg
;
parameter Modelica.Units.SI.Temperature THeaWatSup_nominal(
displayUnit="degC",
start=Buildings.Templates.Data.Defaults.THeaWatSupMed,
final min=273.15)
;
parameter Real THeaWatSupSet_min(
final min=273.15,
start=25 + 273.15,
final unit="K",
displayUnit="degC")
;
parameter Modelica.Units.SI.Temperature TOutHeaWatLck(
displayUnit="degC",
final min=273.15)=Buildings.Templates.Data.Defaults.TOutHeaWatLck
;
parameter Modelica.Units.SI.VolumeFlowRate VHeaWatHp_flow_nominal(
start=0.1,
final min=0)
;
parameter Modelica.Units.SI.VolumeFlowRate VHeaWatHp_flow_min(
start=VHeaWatHp_flow_nominal,
final min=0)=1.1*VHeaWatHp_flow_nominal
;
parameter Modelica.Units.SI.HeatFlowRate capHeaHp_nominal(
start=1,
final min=0)
;
parameter Modelica.Units.SI.VolumeFlowRate VHeaWatPri_flow_nominal(
start=VHeaWatHp_flow_nominal*cfg.nHp,
final min=0)=VHeaWatHp_flow_nominal*cfg.nHp
;
parameter Modelica.Units.SI.VolumeFlowRate VHeaWatSec_flow_nominal(
start=0.01,
final min=0)
;
parameter Modelica.Units.SI.PressureDifference dpHeaWatRemSet_min(
final min=0,
start=5 * 6894)=5 * 6894
;
parameter Modelica.Units.SI.PressureDifference dpHeaWatRemSet_max[:](
start=
fill(Buildings.Templates.Data.Defaults.dpHeaWatRemSet_max, cfg.nSenDpHeaWatRem),
final min=
fill(0, cfg.nSenDpHeaWatRem))
;
parameter Real dpHeaWatLocSet_min(
start=0,
final unit="Pa",
final min=0)=5 * 6895
;
parameter Real dpHeaWatLocSet_max(
start=1E5,
final unit="Pa",
final min=0)
;
parameter Real yPumHeaWatPriSet(
final max=2,
final min=0,
start=1,
final unit="1")
;
parameter Real yPumHeaWatPri_min(
final max=1,
final min=0,
start=0.1,
final unit="1")=0.1
;
parameter Real yPumHeaWatSec_min(
final unit="1",
final min=0,
final max=1)=0.1
;
parameter Modelica.Units.SI.Temperature TChiWatSup_nominal(
displayUnit="degC",
start=Buildings.Templates.Data.Defaults.TChiWatSup,
final min=273.15)
;
parameter Modelica.Units.SI.Temperature TChiWatSupSet_max(
final min=273.15,
start=15 + 273.15,
displayUnit="degC")
;
parameter Modelica.Units.SI.Temperature TOutChiWatLck(
displayUnit="degC",
final min=273.15)=Buildings.Templates.Data.Defaults.TOutChiWatLck
;
parameter Modelica.Units.SI.VolumeFlowRate VChiWatHp_flow_nominal(
start=0.1,
final min=0)
;
parameter Modelica.Units.SI.VolumeFlowRate VChiWatHp_flow_min(
start=VChiWatHp_flow_nominal,
final min=0)=1.1*VChiWatHp_flow_nominal
;
parameter Modelica.Units.SI.HeatFlowRate capCooHp_nominal(
start=1,
final min=0)
;
parameter Modelica.Units.SI.VolumeFlowRate VChiWatPri_flow_nominal(
start=VChiWatHp_flow_nominal*cfg.nHp,
final min=0)=VChiWatHp_flow_nominal*cfg.nHp
;
parameter Modelica.Units.SI.VolumeFlowRate VChiWatSec_flow_nominal(
start=0.01,
final min=0)
;
parameter Modelica.Units.SI.PressureDifference dpChiWatRemSet_min(
final min=0,
start=5 * 6894)=5 * 6894
;
parameter Modelica.Units.SI.PressureDifference dpChiWatRemSet_max[:](
start=
fill(Buildings.Templates.Data.Defaults.dpChiWatRemSet_max, cfg.nSenDpChiWatRem),
final min=
fill(0, cfg.nSenDpChiWatRem))
;
parameter Real dpChiWatLocSet_min(
start=0,
final unit="Pa",
final min=0)=5 * 6895
;
parameter Real dpChiWatLocSet_max(
start=1E5,
final unit="Pa",
final min=0)
;
parameter Real yPumChiWatPriSet(
final max=2,
final min=0,
start=1,
final unit="1")
;
parameter Real yPumChiWatPri_min(
final max=1,
final min=0,
start=0.1,
final unit="1")=0.1
;
parameter Real yPumChiWatSec_min(
final unit="1",
final min=0,
final max=1)=0.1
;
parameter Real schHea[:, 2](start=[
0, 1;
24 * 3600, 1])=[
0, 1;
24 * 3600, 1]
;
parameter Real schCoo[:, 2](start=[
0, 1;
24 * 3600, 1])=[
0, 1;
24 * 3600, 1]
;
parameter Real staEqu[:, :](
each final max=1,
each final min=0,
each final unit="1")
;
parameter Real plrSta(
final max=1,
final min=0,
start=0.9,
final unit="1")=0.9
;
parameter Real TChiWatSupHrc_min(
final min=273.15,
start=4 + 273.15,
final unit="K",
displayUnit="degC")
;
parameter Real THeaWatSupHrc_max(
final min=273.15,
start=60 + 273.15,
final unit="K",
displayUnit="degC")
;
parameter Real COPHeaHrc_nominal(
final min=1.1,
final unit="1",
start=2.8)
;
parameter Real capCooHrc_min(
start=0,
final min=0,
final unit="W")
;
parameter Real capHeaHrc_min(
start=0,
final min=0,
final unit="W")
;
end Controller;
Information
This record provides the set of parameters for heat pump group models
that can be found within
Buildings.Templates.Plants.HeatPumps.Components.HeatPumpGroups.
Only identical heat pumps are currently supported.
The heat pump performance data are provided via the subrecords
perHeaHp and perCooHp for the
heating mode and the cooling mode, respectively.
For the required format of the performance data files,
please refer to the documentation of the block
Buildings.Fluid.HeatPumps.ModularReversible.RefrigerantCycle.BaseClasses.TableData2DLoadDep.
Extends from Modelica.Icons.Record (Icon for records).
Contents
| Type | Name | Default | Description |
| GenericHeatPump | perHeaHp | perHeaHp(devIde="") | Performance data in heating mode |
| Generic | perCooHp | perCooHp(fileName="", PLRSup... | Performance data in cooling mode |
| Power | PHp_min | 0 | Minimum power when system is enabled with compressor cycled off - Each heat pump [W] |
| Configuration |
| Integer | nHp | | Number of heat pumps |
| HeatPump | typ | | Equipment type |
| Boolean | is_rev | | Set to true for reversible heat pumps, false for heating only |
| SpecificHeatCapacity | cpHeaWat_default | Buildings.Utilities.Psychrom... | HW default specific heat capacity [J/(kg.K)] |
| SpecificHeatCapacity | cpSou_default | if typ == Buildings.Template... | Source fluid default specific heat capacity [J/(kg.K)] |
| Nominal condition |
| MassFlowRate | mHeaWatHp_flow_nominal | | HW mass flow rate - Each heat pump [kg/s] |
| PressureDifference | dpHeaWatHp_nominal | | Pressure drop at design HW mass flow rate - Each heat pump [Pa] |
| HeatFlowRate | capHeaHp_nominal | | Heating capacity - Each heat pump [W] |
| Temperature | THeaWatSupHp_nominal | | (Highest) HW supply temperature - Each heat pump [K] |
| MassFlowRate | mChiWatHp_flow_nominal | | CHW mass flow rate - Each heat pump [kg/s] |
| HeatFlowRate | capCooHp_nominal | | Cooling capacity - Each heat pump [W] |
| Temperature | TChiWatSupHp_nominal | | (Lowest) CHW supply temperature - Each heat pump [K] |
| Temperature | TSouHeaHp_nominal | | OAT or source fluid supply temperature (evaporator entering) in heating mode - Each heat pump [K] |
| MassFlowRate | mSouWwHeaHp_flow_nominal | | Source fluid mass flow rate in heating mode - Each heat pump [kg/s] |
| PressureDifference | dpSouWwHeaHp_nominal | | Source fluid pressure drop in heating mode - Each heat pump [Pa] |
| Temperature | TSouCooHp_nominal | | OAT or source fluid supply temperature (condenser entering) in cooling mode - Each heat pump [K] |
| MassFlowRate | mSouWwCooHp_flow_nominal | | Source fluid mass flow rate in cooling mode - Each heat pump [kg/s] |
Modelica definition
record HeatPumpGroup
extends Modelica.Icons.Record;
parameter Integer nHp(
final min=1)
;
parameter Buildings.Templates.Components.Types.HeatPump typ
;
parameter Boolean is_rev
;
parameter Modelica.Units.SI.SpecificHeatCapacity cpHeaWat_default=Buildings.Utilities.Psychrometrics.Constants.cpWatLiq
;
final parameter Modelica.Units.SI.SpecificHeatCapacity cpChiWat_default=
cpHeaWat_default
;
parameter Modelica.Units.SI.SpecificHeatCapacity cpSou_default=
if typ ==
Buildings.Templates.Components.Types.HeatPump.AirToWater
then Buildings.Utilities.Psychrometrics.Constants.cpAir
else Buildings.Utilities.Psychrometrics.Constants.cpWatLiq
;
parameter Modelica.Units.SI.MassFlowRate mHeaWatHp_flow_nominal(
final min=0)
;
parameter Modelica.Units.SI.PressureDifference dpHeaWatHp_nominal(
min=0,
start=Buildings.Templates.Data.Defaults.dpChiWatChi)
;
parameter Modelica.Units.SI.HeatFlowRate capHeaHp_nominal
;
parameter Modelica.Units.SI.Temperature THeaWatSupHp_nominal(
final min=273.15)
;
final parameter Modelica.Units.SI.Temperature THeaWatRetHp_nominal=
THeaWatSupHp_nominal -
abs(capHeaHp_nominal) / cpHeaWat_default /
mHeaWatHp_flow_nominal
;
parameter Modelica.Units.SI.MassFlowRate mChiWatHp_flow_nominal(
start=0,
final min=0)
;
final parameter Modelica.Units.SI.PressureDifference dpChiWatHp_nominal=
dpHeaWatHp_nominal *(mChiWatHp_flow_nominal / mHeaWatHp_flow_nominal) ^ 2
;
parameter Modelica.Units.SI.HeatFlowRate capCooHp_nominal(
start=0)
;
parameter Modelica.Units.SI.Temperature TChiWatSupHp_nominal(
start=Buildings.Templates.Data.Defaults.TChiWatSup,
final min=253.15)
;
final parameter Modelica.Units.SI.Temperature TChiWatRetHp_nominal=
if is_rev
then TChiWatSupHp_nominal +
abs(capCooHp_nominal) / cpChiWat_default /
mChiWatHp_flow_nominal
else Buildings.Templates.Data.Defaults.TChiWatRet
;
parameter Modelica.Units.SI.Temperature TSouHeaHp_nominal(
start=Buildings.Templates.Data.Defaults.TOutHpHeaLow,
final min=220)
;
parameter Modelica.Units.SI.MassFlowRate mSouWwHeaHp_flow_nominal(
start=mHeaWatHp_flow_nominal,
final min=0)
;
parameter Modelica.Units.SI.PressureDifference dpSouWwHeaHp_nominal(
min=0,
start=Buildings.Templates.Data.Defaults.dpChiWatChi)
;
final parameter Modelica.Units.SI.MassFlowRate mSouHeaHp_flow_nominal=
if typ ==
Buildings.Templates.Components.Types.HeatPump.WaterToWater
then mSouWwHeaHp_flow_nominal
else Buildings.Templates.Data.Defaults.ratMFloAirByCapChi *
abs(capHeaHp_nominal)
;
final parameter Modelica.Units.SI.PressureDifference dpSouHeaHp_nominal=
if typ ==
Buildings.Templates.Components.Types.HeatPump.WaterToWater
then dpSouWwHeaHp_nominal
else Buildings.Templates.Data.Defaults.dpAirChi
;
parameter Modelica.Units.SI.Temperature TSouCooHp_nominal(
start=Buildings.Templates.Data.Defaults.TOutHpCoo,
final min=273.15)
;
parameter Modelica.Units.SI.MassFlowRate mSouWwCooHp_flow_nominal(
start=mChiWatHp_flow_nominal,
final min=0)
;
final parameter Modelica.Units.SI.MassFlowRate mSouCooHp_flow_nominal=
if typ ==
Buildings.Templates.Components.Types.HeatPump.WaterToWater
then mSouWwCooHp_flow_nominal
else Buildings.Templates.Data.Defaults.ratMFloAirByCapChi *
abs(capCooHp_nominal)
;
final parameter Modelica.Units.SI.PressureDifference dpSouCooHp_nominal=
dpSouHeaHp_nominal *(mSouCooHp_flow_nominal / mSouHeaHp_flow_nominal) ^ 2
;
replaceable parameter Fluid.HeatPumps.ModularReversible.Data.TableData2DLoadDep.GenericHeatPump
perHeaHp(
devIde="")
constrainedby Buildings.Fluid.HeatPumps.ModularReversible.Data.TableData2DLoadDep.GenericHeatPump(
mCon_flow_nominal=mHeaWatHp_flow_nominal,
mEva_flow_nominal=mSouHeaHp_flow_nominal,
dpCon_nominal=dpHeaWatHp_nominal,
dpEva_nominal=dpSouHeaHp_nominal)
;
replaceable parameter Fluid.Chillers.ModularReversible.Data.TableData2DLoadDep.Generic
perCooHp(
fileName="",
PLRSup={1},
tabLowBou=[TSouCooHp_nominal-30, TChiWatSupHp_nominal; TSouCooHp_nominal+10, TChiWatSupHp_nominal],
devIde="",
use_TConOutForTab=false,
use_TEvaOutForTab=true)
constrainedby Buildings.Fluid.Chillers.ModularReversible.Data.TableData2DLoadDep.Generic(
mCon_flow_nominal=mSouCooHp_flow_nominal,
mEva_flow_nominal=mChiWatHp_flow_nominal,
dpCon_nominal=dpSouCooHp_nominal,
dpEva_nominal=dpChiWatHp_nominal)
;
parameter Modelica.Units.SI.Power PHp_min(
final min=0)=0
;
end HeatPumpGroup;