blockPartialController
Interface class for plant controller
Information
This block serves as an interface class for the plant controller.
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| Real | PLRStaTra | 0.85 | Part load ratio triggering stage transition |
| Real | QChiWat_flow_nominal | QChiWatChi_flow_nominal + QChiWatCasCoo_flow_nominal | Plant cooling design heat flow rate (all units) |
| Real | cp_default | Buildings.Utilities.Psychrometrics.Constants.cpWatLiq | Specific heat capacity of the fluid |
| CHW loop and cooling-only chillers | |||
| Integer | nChi | Number of units operating at design conditions | |
| Integer | nPumChiWat | Number of CHW pumps operating at design conditions | |
| Real | TChiWatSup_nominal | Design (minimum) CHW supply temperature | |
| Real | QChiWatChi_flow_nominal | Cooling design heat flow rate of cooling-only chillers (all units) | |
| Real | mChiWat_flow_nominal | CHW design mass flow rate (all units) | |
| Real | dpChiWatSet_max | Design (maximum) CHW differential pressure setpoint | |
| Real | mChiWatChi_flow_nominal | Chiller CHW design mass flow rate (each unit) | |
| Real | mChiWatChi_flow_min | Chiller CHW minimum mass flow rate (each unit) | |
| Real | mConWatChi_flow_nominal | Chiller CW design mass flow rate (each unit) | |
| Real | dpEvaChi_nominal | Chiller evaporator design pressure drop (each unit) | |
| Real | dpValEvaChi_nominal | Chiller evaporator isolation valve design pressure drop (each unit) | |
| Real | dTLifChi_min | Minimum chiller lift at minimum load | |
| Real | dTLifChi_nominal | Design chiller lift | |
| HW loop and heat recovery chillers | |||
| Integer | nChiHea | Number of units operating at design conditions | |
| Integer | nPumHeaWat | Number of HW pumps operating at design conditions | |
| Real | THeaWatSup_nominal | Design (maximum) HW supply temperature | |
| Real | QChiWatCasCoo_flow_nominal | Cooling design heat flow rate of HRC in cascading cooling mode (all units) | |
| Real | QChiWatCasCoo_flow_nominal_approx | Cooling design heat flow rate of HRC in cascading cooling mode (all units), approximate for scaling | |
| Real | QHeaWat_flow_nominal | Heating design heat flow rate (all units) | |
| Real | mHeaWat_flow_nominal | HW design mass flow rate (all units) | |
| Real | dpHeaWatSet_max | Design (maximum) HW differential pressure setpoint | |
| Real | mChiWatChiHea_flow_nominal | HRC CHW design mass flow rate (each unit) | |
| Real | mChiWatChiHea_flow_min | HRC CHW minimum mass flow rate (each unit) | |
| Real | mConWatChiHea_flow_nominal | HRC CW design mass flow rate (each unit) | |
| Real | mHeaWatChiHea_flow_min | Chiller HW minimum mass flow rate (each unit) | |
| Real | dpEvaChiHea_nominal | Design chiller evaporator pressure drop (each unit) | |
| Real | dpValEvaChiHea_nominal | HRC evaporator isolation valve design pressure drop (each unit) | |
| CW loop, TES tank and heat pumps | |||
| Integer | nHeaPum | Number of heat pumps operating at design conditions | |
| Integer | nPumConWatCon | Number of CW pumps serving condenser barrels at design conditions | |
| Integer | nPumConWatEva | Number of CW pumps serving evaporator barrels at design conditions | |
| Real | QHeaPum_flow_nominal | Heating design heat flow rate of heat pumps (all units) | |
| Real | mConWatCon_flow_nominal | Design total CW mass flow rate through condenser barrels (all units) | |
| Real | mConWatEva_flow_nominal | Design total CW mass flow rate through evaporator barrels (all units) | |
| Real | dpConWatConSet_max | Design (maximum) CW condenser loop differential pressure setpoint | |
| Real | dpConWatEvaSet_max | Design (maximum) CW evaporator loop differential pressure setpoint | |
| Real[2,2] | TTanSet | Tank temperature setpoints: 2 cycles with 2 setpoints | |
| Real | fraUslTan | Useless fraction of TES | |
| Integer | nTTan | 0 | Number of tank temperature points |
| Real[5] | ratFraChaTanLim | {-0.3, -0.2, -0.15, -0.10, -0.08} | Rate of change of tank charge fraction (over 10, 30, 120, 240, and 360') that triggers Charge Assist (<0) |
| Cooling tower loop | |||
| Integer | nCoo | Number of cooling tower cells operating at design conditions | |
| Integer | nPumConWatCoo | Number of CW pumps serving cooling towers at design conditions | |
| Real | dTHexCoo_nominal | Design heat exchanger approach | |
| Dynamics › Motor speed | |||
| Real | riseTime | 30 | Time needed to change motor speed between zero and full speed |
| Dynamics › Time needed to open or close valve | |||
| Real | strokeTime | 120 | Valve stroke time |
Connectors
| Type | Name | Default | Description |
|---|---|---|---|
| Buildings.Controls.OBC.CDL.Interfaces.BooleanInput | u1Coo | Cooling enable signal | |
| Buildings.Controls.OBC.CDL.Interfaces.BooleanInput | u1Hea | Heating enable signal | |
| Buildings.Controls.OBC.CDL.Interfaces.RealInput | TChiWatSupSet | CHW supply temperature setpoint | |
| Buildings.Controls.OBC.CDL.Interfaces.RealInput | THeaWatSupSet | HW supply temperature setpoint | |
| Buildings.Controls.OBC.CDL.Interfaces.RealOutput[nChi] | yValEvaChi | Cooling-only chiller evaporator isolation valve commanded position | |
| Buildings.Controls.OBC.CDL.Interfaces.RealOutput[nChi] | yValConChi | Cooling-only chiller condenser isolation valve commanded position | |
| Buildings.Controls.OBC.CDL.Interfaces.BooleanOutput[nChi] | y1Chi | Cooling-only chiller On/Off command | |
| Buildings.Controls.OBC.CDL.Interfaces.BooleanOutput[nPumChiWat] | y1PumChiWat | CHW pump Start command | |
| Buildings.Controls.OBC.CDL.Interfaces.RealOutput | yPumChiWat | CHW pump speed signal | |
| Buildings.Controls.OBC.CDL.Interfaces.RealOutput[nChiHea] | yValEvaChiHea | HRC evaporator isolation valve commanded position | |
| Buildings.Controls.OBC.CDL.Interfaces.BooleanOutput[nChiHea] | y1ChiHea | HRC On/Off command | |
| Buildings.Controls.OBC.CDL.Interfaces.BooleanOutput[nChiHea] | y1CooChiHea | HRC cooling mode switchover command: true for cooling, false for heating | |
| Buildings.Controls.OBC.CDL.Interfaces.RealOutput[nChiHea] | yValConChiHea | HRC condenser isolation valve commanded position | |
| Buildings.Controls.OBC.CDL.Interfaces.BooleanOutput[nPumHeaWat] | y1PumHeaWat | HW pump Start command | |
| Buildings.Controls.OBC.CDL.Interfaces.RealOutput | yPumHeaWat | HW pump speed signal | |
| Buildings.Controls.OBC.CDL.Interfaces.RealOutput | yValChiWatMinByp | CHW minimum flow bypass valve control signal | |
| Buildings.Controls.OBC.CDL.Interfaces.RealOutput | yValHeaWatMinByp | HW minimum flow bypass valve control signal | |
| Buildings.Controls.OBC.CDL.Interfaces.BooleanOutput[nPumConWatCon] | y1PumConWatCon | CW pump serving condenser barrels Start command | |
| Buildings.Controls.OBC.CDL.Interfaces.RealOutput | yPumConWatCon | CW pump serving condenser barrels Speed command | |
| Buildings.Controls.OBC.CDL.Interfaces.BooleanOutput[nPumConWatEva] | y1PumConWatEva | CW pump serving evaporator barrels Start command | |
| Buildings.Controls.OBC.CDL.Interfaces.RealOutput | yPumConWatEva | CW pump serving evaporator barrels Speed command | |
| Buildings.Controls.OBC.CDL.Interfaces.BooleanOutput[nHeaPum] | y1HeaPum | Heat pump On/Off command | |
| Buildings.Controls.OBC.CDL.Interfaces.RealOutput | THeaPumSet | Heat pump supply temperature setpoint | |
| Buildings.Controls.OBC.CDL.Interfaces.RealOutput | yValBypTan | TES tank bypass valve commanded position | |
| Buildings.Controls.OBC.CDL.Interfaces.BooleanOutput[nCoo] | y1Coo | Cooling tower Start command | |
| Buildings.Controls.OBC.CDL.Interfaces.RealOutput | yCoo | Cooling tower fan speed command | |
| Buildings.Controls.OBC.CDL.Interfaces.BooleanOutput[nPumConWatCoo] | y1PumConWatCoo | Cooling tower pump Start command | |
| Buildings.Controls.OBC.CDL.Interfaces.RealOutput[nChiHea] | TChiHeaSet | HRC supply temperature setpoint | |
| Buildings.Controls.OBC.CDL.Interfaces.BooleanOutput[nChiHea] | y1HeaCooChiHea | HRC direct heat recovery switchover command: true for direct HR, false for cascading | |
| Buildings.Controls.OBC.CDL.Interfaces.RealInput | dpChiWatSet | CHW differential pressure setpoint (for local dp sensor) | |
| Buildings.Controls.OBC.CDL.Interfaces.RealInput | dpHeaWatSet | HW differential pressure setpoint (for local dp sensor) | |
| Buildings.Controls.OBC.CDL.Interfaces.RealInput | dpChiWat | CHW differential pressure (from local dp sensor) | |
| Buildings.Controls.OBC.CDL.Interfaces.RealInput | dpHeaWat | HW differential pressure (from local dp sensor) | |
| Buildings.Controls.OBC.CDL.Interfaces.RealInput | mChiWatPri_flow | Primary CHW mass flow rate | |
| Buildings.Controls.OBC.CDL.Interfaces.RealInput | mHeaWatPri_flow | Primary HW mass flow rate | |
| Buildings.Controls.OBC.CDL.Interfaces.RealInput | dpConWatCon | CW condenser loop differential pressure | |
| Buildings.Controls.OBC.CDL.Interfaces.RealInput | dpConWatEva | CW evaporator loop differential pressure | |
| Buildings.Controls.OBC.CDL.Interfaces.RealInput | mConWatCon_flow | CW condenser loop mass flow rate | |
| Buildings.Controls.OBC.CDL.Interfaces.RealInput | mConWatEva_flow | CW evaporator loop mass flow rate | |
| Buildings.Controls.OBC.CDL.Interfaces.RealInput | TChiWatSup | CHW supply temperature | |
| Buildings.Controls.OBC.CDL.Interfaces.RealInput | TChiWatPriRet | Primary CHW return temperature | |
| Buildings.Controls.OBC.CDL.Interfaces.RealInput | THeaWatPriRet | Primary HW return temperature | |
| Buildings.Controls.OBC.CDL.Interfaces.RealInput[nTTan] | TTan | TES tank temperature | |
| Buildings.Controls.OBC.CDL.Interfaces.RealInput | mConWatHexCoo_flow | CW mass flow rate through secondary (plant) side of HX | |
| Buildings.Controls.OBC.CDL.Interfaces.RealInput | mConWatOutTan_flow | Mass flow rate out of lower port of TES tank (>0 when charging) | |
| Buildings.Controls.OBC.CDL.Interfaces.RealInput[nChi] | mEvaChi_flow | Chiller evaporator barrel mass flow rate | |
| Buildings.Controls.OBC.CDL.Interfaces.RealInput[nChi] | mConChi_flow | Chiller condenser barrel mass flow rate | |
| Buildings.Controls.OBC.CDL.Interfaces.RealInput[nChiHea] | mEvaChiHea_flow | HRC evaporator barrel mass flow rate | |
| Buildings.Controls.OBC.CDL.Interfaces.RealInput[nChiHea] | mConChiHea_flow | HRC condenser barrel mass flow rate | |
| Buildings.Controls.OBC.CDL.Interfaces.RealOutput[nChiHea] | yValEvaSwiHea | HRC evaporator switchover valve commanded position | |
| Buildings.Controls.OBC.CDL.Interfaces.RealOutput[nChiHea] | yValConSwiChiHea | HRC condenser switchover valve commanded position | |
| Buildings.Controls.OBC.CDL.Interfaces.RealInput[nChiHea] | TEvaLvgChiHea | HRC evaporator barrel leaving temperature | |
| Buildings.Controls.OBC.CDL.Interfaces.RealInput | THeaWatSup | HW supply temperature | |
| Buildings.Controls.OBC.CDL.Interfaces.RealOutput | yPumConWatCoo | Cooling tower pump speed command | |
| Buildings.Controls.OBC.CDL.Interfaces.RealInput | TConWatConChiEnt | Chiller and HRC entering CW temperature | |
| Buildings.Controls.OBC.CDL.Interfaces.RealInput | TConWatConChiLvg | Chiller and HRC leaving CW temperature | |
| Buildings.Controls.OBC.CDL.Interfaces.RealInput | TConWatCooSup | Cooling tower loop CW supply temperature | |
| Buildings.Controls.OBC.CDL.Interfaces.RealInput | TConWatCooRet | Cooling tower loop CW return temperature | |
| Buildings.Controls.OBC.CDL.Interfaces.RealInput | TConWatHexCooEnt | HX entering CW temperature | |
| Buildings.Controls.OBC.CDL.Interfaces.RealInput | TConWatHexCooLvg | HX leaving CW temperature | |
| Buildings.Controls.OBC.CDL.Interfaces.RealInput[nChiHea] | TConEntChiHea | HRC condenser barrel entering temperature | |
| Buildings.Controls.OBC.CDL.Interfaces.RealInput[nChiHea] | TConLvgChiHea | HRC condenser barrel leaving temperature | |
| Buildings.Controls.OBC.CDL.Interfaces.RealInput | TConWatEvaEnt | HRC evaporator entering CW temperature | |
| Buildings.Controls.OBC.CDL.Interfaces.RealOutput | yValConWatEvaMix | HRC evaporator CW mixing valve commanded position | |
| Buildings.Controls.OBC.CDL.Interfaces.RealInput | TConWatConRet | Condenser loop CW return temperature | |
| Buildings.Controls.OBC.CDL.Interfaces.RealInput[nChi] | TConLvgChi | Chiller condenser barrel leaving temperature | |
| Buildings.Controls.OBC.CDL.Interfaces.RealOutput | yValConWatByp | CW chiller bypass valve control signal |
Revisions
-
February 24, 2023, by Antoine Gautier:
First implementation.