Line data Source code
1 : // EnergyPlus, Copyright (c) 1996-2025, The Board of Trustees of the University of Illinois,
2 : // The Regents of the University of California, through Lawrence Berkeley National Laboratory
3 : // (subject to receipt of any required approvals from the U.S. Dept. of Energy), Oak Ridge
4 : // National Laboratory, managed by UT-Battelle, Alliance for Sustainable Energy, LLC, and other
5 : // contributors. All rights reserved.
6 : //
7 : // NOTICE: This Software was developed under funding from the U.S. Department of Energy and the
8 : // U.S. Government consequently retains certain rights. As such, the U.S. Government has been
9 : // granted for itself and others acting on its behalf a paid-up, nonexclusive, irrevocable,
10 : // worldwide license in the Software to reproduce, distribute copies to the public, prepare
11 : // derivative works, and perform publicly and display publicly, and to permit others to do so.
12 : //
13 : // Redistribution and use in source and binary forms, with or without modification, are permitted
14 : // provided that the following conditions are met:
15 : //
16 : // (1) Redistributions of source code must retain the above copyright notice, this list of
17 : // conditions and the following disclaimer.
18 : //
19 : // (2) Redistributions in binary form must reproduce the above copyright notice, this list of
20 : // conditions and the following disclaimer in the documentation and/or other materials
21 : // provided with the distribution.
22 : //
23 : // (3) Neither the name of the University of California, Lawrence Berkeley National Laboratory,
24 : // the University of Illinois, U.S. Dept. of Energy nor the names of its contributors may be
25 : // used to endorse or promote products derived from this software without specific prior
26 : // written permission.
27 : //
28 : // (4) Use of EnergyPlus(TM) Name. If Licensee (i) distributes the software in stand-alone form
29 : // without changes from the version obtained under this License, or (ii) Licensee makes a
30 : // reference solely to the software portion of its product, Licensee must refer to the
31 : // software as "EnergyPlus version X" software, where "X" is the version number Licensee
32 : // obtained under this License and may not use a different name for the software. Except as
33 : // specifically required in this Section (4), Licensee shall not use in a company name, a
34 : // product name, in advertising, publicity, or other promotional activities any name, trade
35 : // name, trademark, logo, or other designation of "EnergyPlus", "E+", "e+" or confusingly
36 : // similar designation, without the U.S. Department of Energy's prior written consent.
37 : //
38 : // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR
39 : // IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
40 : // AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
41 : // CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
42 : // CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
43 : // SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
44 : // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
45 : // OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
46 : // POSSIBILITY OF SUCH DAMAGE.
47 :
48 : #ifndef ENERGYPLUS_COILS_COILCOOLINGDXCURVEFITOPERATINGMODE
49 : #define ENERGYPLUS_COILS_COILCOOLINGDXCURVEFITOPERATINGMODE
50 :
51 : #include <string>
52 : #include <vector>
53 :
54 : #include <EnergyPlus/Coils/CoilCoolingDXCurveFitSpeed.hh>
55 : #include <EnergyPlus/DataLoopNode.hh>
56 : #include <EnergyPlus/EnergyPlus.hh>
57 :
58 : namespace EnergyPlus {
59 :
60 : // Forward declarations
61 : struct EnergyPlusData;
62 :
63 : struct CoilCoolingDXCurveFitOperatingModeInputSpecification
64 : {
65 : std::string name;
66 : Real64 gross_rated_total_cooling_capacity = 0.0;
67 : Real64 rated_evaporator_air_flow_rate = 0.0;
68 : Real64 rated_condenser_air_flow_rate = 0.0;
69 : Real64 maximum_cycling_rate = 0.0;
70 : Real64 ratio_of_initial_moisture_evaporation_rate_and_steady_state_latent_capacity = 0.0;
71 : Real64 latent_capacity_time_constant = 0.0;
72 : Real64 nominal_time_for_condensate_removal_to_begin = 0.0;
73 : std::string apply_latent_degradation_to_speeds_greater_than_1;
74 : std::string condenser_type;
75 : Real64 nominal_evap_condenser_pump_power = 0.0;
76 : Real64 nominal_speed_number = 0.0;
77 : std::vector<std::string> speed_data_names;
78 : };
79 :
80 : struct CoilCoolingDXCurveFitOperatingMode
81 : {
82 : std::string object_name = "Coil:Cooling:DX:CurveFit:OperatingMode";
83 : std::string parentName;
84 :
85 : void instantiateFromInputSpec(EnergyPlusData &state, CoilCoolingDXCurveFitOperatingModeInputSpecification input_data);
86 : void size(EnergyPlusData &state);
87 : void oneTimeInit(EnergyPlusData &state);
88 : CoilCoolingDXCurveFitOperatingModeInputSpecification original_input_specs;
89 318 : CoilCoolingDXCurveFitOperatingMode() = default;
90 : explicit CoilCoolingDXCurveFitOperatingMode(EnergyPlusData &state, const std::string &name_to_find);
91 : Real64 getCurrentEvapCondPumpPower(int speedNum);
92 : void CalcOperatingMode(EnergyPlusData &state,
93 : const DataLoopNode::NodeData &inletNode,
94 : DataLoopNode::NodeData &outletNode,
95 : int speedNum,
96 : Real64 speedRatio,
97 : HVAC::FanOp const fanOp,
98 : DataLoopNode::NodeData &condInletNode,
99 : DataLoopNode::NodeData &condOutletNode,
100 : bool singleMode);
101 :
102 : std::string name;
103 : Real64 ratedGrossTotalCap = 0.0; // [W]
104 : Real64 ratedEvapAirFlowRate = 0.0; // [m3/s]
105 : Real64 ratedCondAirFlowRate = 0.0; // [m3/s]
106 : Real64 ratedEvapAirMassFlowRate = 0.0; // [kg/s]
107 : bool ratedGrossTotalCapIsAutosized = false;
108 : bool ratedEvapAirFlowRateIsAutosized = false;
109 :
110 : // Latent degradation model
111 : Real64 timeForCondensateRemoval = 0.0;
112 : Real64 evapRateRatio = 0.0;
113 : Real64 maxCyclingRate = 0.0;
114 : Real64 latentTimeConst = 0.0;
115 : bool latentDegradationActive = false;
116 : bool applyLatentDegradationAllSpeeds = false;
117 :
118 : // results from coil model at speed
119 : // Real64 OpModeOutletTemp = 0.0;
120 : // Real64 OpModeOutletHumRat = 0.0;
121 : // Real64 OpModeOutletEnth = 0.0;
122 : Real64 OpModePower = 0.0;
123 : Real64 OpModeRTF = 0.0;
124 : Real64 OpModeWasteHeat = 0.0;
125 :
126 : Real64 nominalEvaporativePumpPower = 0.0;
127 : int nominalSpeedIndex = 0;
128 :
129 : // each mode can now have EMS overridden evap air flow and total cap
130 : bool ratedAirVolFlowEMSOverrideON = false;
131 : Real64 ratedAirVolFlowEMSOverrideValue = 0.0;
132 : bool ratedTotCapFlowEMSOverrideON = false;
133 : Real64 ratedTotCapFlowEMSOverrideValue = 0.0;
134 :
135 : enum class CondenserType
136 : {
137 : Invalid = -1,
138 : AIRCOOLED,
139 : EVAPCOOLED,
140 : Num
141 : };
142 :
143 : CondenserType condenserType = CondenserType::AIRCOOLED;
144 :
145 : Real64 condInletTemp = 0.0; // condenser inlet node temp or outdoor temp if no condenser node {C}
146 :
147 : std::vector<CoilCoolingDXCurveFitSpeed> speeds;
148 : };
149 :
150 : } // namespace EnergyPlus
151 :
152 : #endif // ENERGYPLUS_COILS_COILCOOLINGDXCURVEFITOPERATINGMODE
|
