Waterside economizer coil new feature CoilSystem:Cooling:Water

doc/engineering-reference/src/loop-equipment-sizing-and-other-design-data/component-sizing.tex

@@ -534,6 +534,12 @@ \subsubsection{Coil Depth}\label{coil-depth}
 \emph{Depth\(_{coil}\)} = \emph{Depth\(_{tube\, spacing}\)} * \emph{N\(_{tube\, rows}\)}
 \end{equation}
 
+
+\subsection{CoilSystem:Cooling:Water}\label{coilsystemcoolingwater}
+
+The sizing of water cooling coil componets wrapped in this coil system is done in function \textit{SizeWaterCoil} of module \textit{WaterCoils}. See componment sizing sections for \textit{Coil:Cooling:Water} and \textit{Coil:Cooling:Water:detailedGeometry}.
+
+
 \subsection{Coil:Cooling:WaterToAirHeatPump:EquationFit Sizing}\label{coilcoolingwatertoairheatpumpequationfit-sizing}
 
 The sizing is done in subroutine \emph{SizeHVACWaterToAir}.

idd/Energy+.idd.in

@@ -49467,13 +49467,107 @@ Coil:Cooling:Water:DetailedGeometry,
   A7 , \field Condensate Collection Water Storage Tank Name
        \type object-list
        \object-list WaterStorageTankNames
-  N17; \field Design Water Temperature Difference
+  N17, \field Design Water Temperature Difference
        \type real
        \units deltaC
        \minimum> 0.0
        \note This input field is optional. If specified, it is used for sizing the Design Water Flow Rate.
        \note If blank or omitted, the Loop Design Temperature Difference value specified in Sizing:Plant
        \note object is used for sizing the Design Water Flow Rate.
+  N18; \field Design Inlet Water Temperature
+       \type real
+       \units C
+       \autosizable
+       \default autosize
+       \minimum> 0
+       \note This input field is optional. If specified, it is used for sizing the coil Design Geomtery
+       \note Parameters. If blank or omitted, the Design Loop Exit Temperature value specified in 
+       \note Sizing:Plant object is used for sizing the coil Design Geomtery Parameters.  
+
+CoilSystem:Cooling:Water,
+       \memo Virtual container component that consists of a water cooling coil
+       \memo and its associated controls. This control object supports the
+       \memo available water coil types and may be placed directly on an
+       \memo air loop branch or in an outdoor air equipment list.
+       \min-fields 6
+   A1, \field Name
+       \required-field
+       \type alpha
+       \reference-class-name validBranchEquipmentTypes
+       \reference validBranchEquipmentNames
+       \reference-class-name validOASysEquipmentTypes
+       \reference validOASysEquipmentNames
+   A2, \field Air Inlet Node Name
+       \required-field
+       \type node
+   A3, \field Air Outlet Node Name
+       \required-field
+       \type node
+   A4, \field Availability Schedule Name
+       \note Availability schedule name for this system. Schedule value > 0
+       \note means the system is available.
+       \note If this field is blank, the system is always available.
+       \type object-list
+       \object-list ScheduleNames
+   A5, \field Cooling Coil Object Type
+       \type choice
+       \required-field
+       \key Coil:Cooling:Water
+       \key Coil:Cooling:Water:DetailedGeometry
+       \key CoilSystem:Cooling:Water:HeatExchangerAssisted
+   A6, \field Cooling Coil Name
+       \required-field
+       \type object-list
+       \object-list CoolingCoilsWater
+   A7, \field Dehumidification Control Type
+       \type choice
+       \key None
+       \key Multimode
+       \key CoolReheat
+       \default None
+       \note None = meet sensible load only
+       \note Multimode = activate water coil and meet sensible load.       
+       \note If no sensible load exists, and Run on Latent Load = Yes, and a latent
+       \note load exists, the coil will operate to meet the latent load.
+       \note If the latent load cannot be met the heat exchanger will be activated.
+       \note IF Run on Latent Load = No, the heat exchanger will always be active.
+       \note This control mode either switches the coil mode or allows the heat exchanger to 
+       \note be turned on and off based on the zone dehumidification requirements. Valid 
+       \note only with cooling coil type CoilSystem:Cooling:Water:HeatExchangerAssisted.   
+       \note CoolReheat = cool beyond the dry-bulb setpoint as required to meet the 
+       \note humidity setpoint. Valid with all cooling coil types. When a heat exchanger 
+       \note assisted cooling coil is used, the heat exchanger is locked on at all times.      
+       \note For all dehumidification controls, the max
+       \note humidity setpoint on the Sensor Node is used.
+       \note SetpointManager:SingleZone:Humidity:Maximum,
+       \note SetpointManager:MultiZone:Humidity:Maximum, or
+       \note SetpointManager:MultiZone:MaximumHumidity:Average, and
+       \note SetpointManager:OutdoorAirPretreat (optional) objects.
+   A8, \field Run on Sensible Load
+       \type choice
+       \key Yes
+       \key No
+       \default Yes
+       \note If Yes, unit will run if there is a sensible load.
+       \note If No, unit will not run if there is only a sensible load.
+       \note Dehumidification controls will be active if specified.
+   A9, \field Run on Latent Load
+       \type choice
+       \key Yes
+       \key No
+       \default No
+       \note If Yes, unit will run if there is a latent load.
+       \note even if there is no sensible load.
+       \note If No, unit will not run if there is only a latent load.
+       \note Dehumidification controls will be active if specified.
+   N1; \field Minimum Air To Water Temperature Offset
+       \note Coil will turn on as required when inlet air temperature is above
+       \note water temperature by amount of offset. To model a waterside
+       \note economizer connect to condenser loop and increase offset as desired.
+       \type real
+       \units deltaC  
+       \minimum 0.0
+       \default 0.0 
 
 Coil:Cooling:DX,
        \memo New general DX cooling coil supporting on or more speeds and one or or operating  modes.
@@ -60577,6 +60671,7 @@ AirLoopHVAC:UnitarySystem,
        \object-list UnitarySystemPerformaceNames
        \note Enter the name of the performance specification object used to describe the multispeed coil.
 
+
 UnitarySystemPerformance:Multispeed,
        \memo The UnitarySystemPerformance object is used to specify the air flow ratio at each
        \memo operating speed. This object is primarily used for multispeed DX and water coils to allow

src/EnergyPlus/MixedAir.cc

@@ -591,6 +591,34 @@ void SimOAComponent(EnergyPlusData &state,
                                                                                       latOut);
         }
         OACoolingCoil = true;
+    } else if (CompTypeNum == SimAirServingZones::CompType::CoilSystemWater) { // "CoilSystem:Cooling:Water"
+        if (state.dataAirLoop->OutsideAirSys(OASysNum).compPointer[CompIndex] == nullptr) {
+            UnitarySystems::UnitarySys thisSys;
+            state.dataAirLoop->OutsideAirSys(OASysNum).compPointer[CompIndex] =
+                thisSys.factory(state, DataHVACGlobals::UnitarySys_AnyCoilType, CompName, false, 0);
+            UnitarySystems::UnitarySys::checkUnitarySysCoilInOASysExists(state, CompName, 0);
+        }
+        if (Sim) {
+            bool HeatingActive = false;
+            bool CoolingActive = false;
+            Real64 OAUCoilOutTemp = 0.0;
+            bool ZoneEquipFlag = false;
+            Real64 sensOut = 0.0;
+            Real64 latOut = 0.0;
+            state.dataAirLoop->OutsideAirSys(OASysNum).compPointer[CompIndex]->simulate(state,
+                                                                                        CompName,
+                                                                                        FirstHVACIteration,
+                                                                                        AirLoopNum,
+                                                                                        CompIndex,
+                                                                                        HeatingActive,
+                                                                                        CoolingActive,
+                                                                                        CompIndex,
+                                                                                        OAUCoilOutTemp,
+                                                                                        ZoneEquipFlag,
+                                                                                        sensOut,
+                                                                                        latOut);
+        }
+        OACoolingCoil = true;
     } else if (CompTypeNum == SimAirServingZones::CompType::UnitarySystemModel) { // AirLoopHVAC:UnitarySystem
         if (Sim) {
             bool HeatingActive = false;
@@ -1110,6 +1138,12 @@ void GetOutsideAirSysInputs(EnergyPlusData &state)
                     // CheckDXCoolingCoilInOASysExists(state, state.dataAirLoop->OutsideAirSys(OASysNum).ComponentName(CompNum));
                 } else if (SELECT_CASE_var == "COILSYSTEM:HEATING:DX") {
                     state.dataAirLoop->OutsideAirSys(OASysNum).ComponentType_Num(CompNum) = SimAirServingZones::CompType::DXHeatPumpSystem;
+                } else if (SELECT_CASE_var == "COILSYSTEM:COOLING:WATER") {
+                    state.dataAirLoop->OutsideAirSys(OASysNum).ComponentType_Num(CompNum) = SimAirServingZones::CompType::CoilSystemWater;
+                    state.dataAirLoop->OutsideAirSys(OASysNum).ComponentIndex(CompNum) = CompNum;
+                    UnitarySystems::UnitarySys thisSys;
+                    state.dataAirLoop->OutsideAirSys(OASysNum).compPointer[CompNum] = thisSys.factory(
+                        state, DataHVACGlobals::UnitarySys_AnyCoilType, state.dataAirLoop->OutsideAirSys(OASysNum).ComponentName(CompNum), false, 0);
                 } else if (SELECT_CASE_var == "AIRLOOPHVAC:UNITARYSYSTEM") {
                     state.dataAirLoop->OutsideAirSys(OASysNum).ComponentType_Num(CompNum) = SimAirServingZones::CompType::UnitarySystemModel;
                     UnitarySystems::UnitarySys thisSys;

src/EnergyPlus/MixedAir.hh

@@ -101,6 +101,38 @@ namespace MixedAir {
     constexpr int On(1);  // normal coil operation
     constexpr int Off(0); // signal coil shouldn't run
 
+    // component types addressed by this module
+    enum class ComponentType
+    {
+        Unassigned = -1,
+        None,
+        OAMixer_Num,
+        Fan_Simple_CV,
+        Fan_Simple_VAV,
+        WaterCoil_SimpleCool,
+        WaterCoil_Cooling,
+        WaterCoil_SimpleHeat,
+        SteamCoil_AirHeat,
+        WaterCoil_DetailedCool,
+        Coil_ElectricHeat,
+        Coil_GasHeat,
+        WaterCoil_CoolingHXAsst,
+        DXSystem,
+        HeatXchngr,
+        Desiccant,
+        Unglazed_SolarCollector,
+        EvapCooler,
+        PVT_AirBased,
+        Fan_ComponentModel,
+        DXHeatPumpSystem,
+        Coil_UserDefined,
+        Humidifier,
+        Fan_System_Object,
+        UnitarySystemModel,
+        VRFTerminalUnit,
+        CoilSystemWater
+    };
+
     enum class iControllerType
     {
         None,

src/EnergyPlus/SimAirServingZones.cc

@@ -797,6 +797,8 @@ void GetAirPathData(EnergyPlusData &state)
                         PackagedUnit(AirSysNum) = true;
                     } else if (componentType == "COILSYSTEM:HEATING:DX") {
                         PackagedUnit(AirSysNum) = true;
+                    } else if (componentType == "COILSYSTEM:COOLING:WATER") {
+                        PackagedUnit(AirSysNum) = true;
                     } else if (componentType == "AIRLOOPHVAC:UNITARYSYSTEM") {
                         PackagedUnit(AirSysNum) = true;
                     } else if (componentType == "AIRLOOPHVAC:UNITARY:FURNACE:HEATONLY") {
@@ -1244,6 +1246,15 @@ void GetAirPathData(EnergyPlusData &state)
                                             PrimaryAirSystems(AirSysNum).Branch(BranchNum).Comp(CompNum).Name,
                                             false,
                                             0);
+                    } else if (componentType == "COILSYSTEM:COOLING:WATER") {
+                        PrimaryAirSystems(AirSysNum).Branch(BranchNum).Comp(CompNum).CompType_Num = CompType::CoilSystemWater;
+                        UnitarySystems::UnitarySys thisSys;
+                        PrimaryAirSystems(AirSysNum).Branch(BranchNum).Comp(CompNum).compPointer =
+                            thisSys.factory(state,
+                                            DataHVACGlobals::UnitarySys_AnyCoilType,
+                                            PrimaryAirSystems(AirSysNum).Branch(BranchNum).Comp(CompNum).Name,
+                                            false,
+                                            0);
                     } else if (componentType == "AIRLOOPHVAC:UNITARY:FURNACE:HEATONLY") {
                         PrimaryAirSystems(AirSysNum).Branch(BranchNum).Comp(CompNum).CompType_Num = CompType::Furnace_UnitarySys_HeatOnly;
                     } else if (componentType == "AIRLOOPHVAC:UNITARY:FURNACE:HEATCOOL") {
@@ -3641,7 +3652,27 @@ void SimAirLoopComponent(EnergyPlusData &state,
                                   ZoneEquipFlag,
                                   sensOut,
                                   latOut);
-
+        } else if (SELECT_CASE_var == CompType::CoilSystemWater) { // 'CoilSystemCooling:Water'
+            if (CompPointer == nullptr) {
+                UnitarySystems::UnitarySys thisSys;
+                CompPointer = thisSys.factory(state, DataHVACGlobals::UnitarySys_AnyCoilType, CompName, false, 0);
+                // temporary fix for saving pointer, eventually apply to UnitarySystem 16 lines above
+                state.dataAirSystemsData->PrimaryAirSystems(airLoopNum).Branch(branchNum).Comp(compNum).compPointer = CompPointer;
+            }
+            Real64 sensOut = 0.0;
+            Real64 latOut = 0.0;
+            CompPointer->simulate(state,
+                                  CompName,
+                                  FirstHVACIteration,
+                                  AirLoopNum,
+                                  CompIndex,
+                                  HeatingActive,
+                                  CoolingActive,
+                                  OAUnitNum,
+                                  OAUCoilOutTemp,
+                                  ZoneEquipFlag,
+                                  sensOut,
+                                  latOut);
         } else if (SELECT_CASE_var == CompType::Furnace_UnitarySys_HeatOnly || SELECT_CASE_var == CompType::Furnace_UnitarySys_HeatCool) {
             // 'AirLoopHVAC:Unitary:Furnace:HeatOnly', 'AirLoopHVAC:Unitary:Furnace:HeatCool',
             // 'AirLoopHVAC:UnitaryHeatOnly', 'AirLoopHVAC:UnitaryHeatCool'

src/EnergyPlus/SimAirServingZones.hh

@@ -74,6 +74,38 @@ namespace SimAirServingZones {
 
     // CompType numerics -- for this module
     // component types addressed by this module
+    constexpr int OAMixer_Num(1);
+    constexpr int Fan_Simple_CV(2);
+    constexpr int Fan_Simple_VAV(3);
+    constexpr int WaterCoil_SimpleCool(4);
+    constexpr int WaterCoil_Cooling(5);
+    constexpr int WaterCoil_SimpleHeat(6);
+    constexpr int SteamCoil_AirHeat(7);
+    constexpr int WaterCoil_DetailedCool(8);
+    constexpr int Coil_ElectricHeat(9);
+    constexpr int Coil_GasHeat(10);
+    constexpr int WaterCoil_CoolingHXAsst(11);
+    constexpr int DXCoil_CoolingHXAsst(12);
+    constexpr int Coil_DeSuperHeat(13);
+    constexpr int DXSystem(14);
+    constexpr int HeatXchngr(15);
+    constexpr int Desiccant(16);
+    constexpr int Unglazed_SolarCollector(17);
+    constexpr int EvapCooler(18);
+    constexpr int Furnace_UnitarySys_HeatOnly(19);
+    constexpr int Furnace_UnitarySys_HeatCool(20);
+    constexpr int Humidifier(21);
+    constexpr int Duct(22);
+    constexpr int UnitarySystem_BypassVAVSys(23);
+    constexpr int UnitarySystem_MSHeatPump(24);
+    constexpr int Fan_ComponentModel(25);
+    constexpr int DXHeatPumpSystem(26);
+    constexpr int CoilUserDefined(27);
+    constexpr int Fan_System_Object(28);
+    constexpr int UnitarySystemModel(29);
+    constexpr int ZoneVRFasAirLoopEquip(30);
+    constexpr int CoilSystemWater(31);
+
     enum class CompType
     {
         Unassigned = -1,
@@ -108,7 +140,8 @@ namespace SimAirServingZones {
         UnitarySystemModel,
         ZoneVRFasAirLoopEquip,
         PVT_AirBased,
-        VRFTerminalUnit
+        VRFTerminalUnit,
+        CoilSystemWater
     };
 
     void ManageAirLoops(EnergyPlusData &state,

src/EnergyPlus/SystemReports.cc

@@ -3915,6 +3915,7 @@ void CalcSystemEnergyUse(EnergyPlusData &state,
         COILSYSTEM_COOLING_DX,
         COILSYSTEM_COOLING_DX_HEATEXCHANGERASSISTED,
         COILSYSTEM_COOLING_WATER_HEATEXCHANGERASSISTED,
+        COILSYSTEM_COOLING_WATER,
         COILSYSTEM_HEATING_DX,
         DEHUMIDIFIER_DESICCANT_NOFANS,
         DEHUMIDIFIER_DESICCANT_SYSTEM,
@@ -4009,6 +4010,7 @@ void CalcSystemEnergyUse(EnergyPlusData &state,
         {"COILSYSTEM:COOLING:DX", COILSYSTEM_COOLING_DX},
         {"COILSYSTEM:COOLING:DX:HEATEXCHANGERASSISTED", COILSYSTEM_COOLING_DX_HEATEXCHANGERASSISTED},
         {"COILSYSTEM:COOLING:WATER:HEATEXCHANGERASSISTED", COILSYSTEM_COOLING_WATER_HEATEXCHANGERASSISTED},
+        {"COILSYSTEM:COOLING:WATER", COILSYSTEM_COOLING_WATER},
         {"COILSYSTEM:HEATING:DX", COILSYSTEM_HEATING_DX},
         {"DEHUMIDIFIER:DESICCANT:NOFANS", DEHUMIDIFIER_DESICCANT_NOFANS},
         {"DEHUMIDIFIER:DESICCANT:SYSTEM", DEHUMIDIFIER_DESICCANT_SYSTEM},
@@ -4090,6 +4092,7 @@ void CalcSystemEnergyUse(EnergyPlusData &state,
     case COIL_COOLING_WATERTOAIRHEATPUMP_VARIABLESPEEDEQUATIONFIT:
     case COIL_COOLING_DX_VARIABLESPEED:
     case COILSYSTEM_COOLING_WATER_HEATEXCHANGERASSISTED:
+    case COILSYSTEM_COOLING_WATER:
     case COIL_COOLING_WATER_DETAILEDGEOMETRY:
     case COIL_COOLING_WATER:
     case COIL_COOLING_DX_SINGLESPEED_THERMALSTORAGE: