Merge branch 'develop' into 5114327-EarthTube1DVerticalEnhancement

.decent_ci-Windows.yaml

@@ -2,5 +2,5 @@ compilers:
   - name: Visual Studio
     version: 16
     architecture: Win64
-    cmake_extra_flags: -DBUILD_FORTRAN:BOOL=ON -DBUILD_TESTING:BOOL=ON -DCOMMIT_SHA=%COMMIT_SHA% -DENABLE_GTEST_DEBUG_MODE:BOOL=OFF -DLINK_WITH_PYTHON=ON
+    cmake_extra_flags: -DBUILD_FORTRAN:BOOL=ON -DBUILD_TESTING:BOOL=ON -DCOMMIT_SHA=%COMMIT_SHA% -DENABLE_GTEST_DEBUG_MODE:BOOL=OFF -DLINK_WITH_PYTHON=ON -DPython_EXECUTABLE:PATH=C:/Users/elee/AppData/Local/Programs/Python/Python311/python.exe
     skip_regression: true

design/FY2023/NFP-evapCoolerRHcontrol.md

@@ -0,0 +1,153 @@
+
+Enhancement of Evaporative Cooler in EnergyPlus
+================
+
+**Yujie Xu, Tianzhen Hong**
+
+**Lawrence Berkeley National Laboratory***
+
+ - Original Date: Apr 7, 2023
+ - Modified Date: Apr 11, 2023
+
+## Justification for Feature Update
+
+As global climate change continues, the frequency, duration and intensity of heatwaves could increase. As an affordable and energy efficient cooling option [1], evaporative cooling could become more prevalent in the future, especially in hot and dry climates. As a result, it is crucial to provide accurate and more user-friendly simulation support for prototyping new evaporative coolers and their applications. With this motivation, this EnergyPlus feature is proposed to provide an additional relative humidity-driven control option.
+
+![zoneEvapCoolerDiagram](zoneEvapCoolerDiagram.png)
+<p style="text-align: center;"> Figure 1. Conceptual diagram of a direct evaporative cooler [source](https://basc.pnnl.gov/resource-guides/evaporative-cooling-systems#edit-group-description) (left), an example of a zone-level direct evaporative cooler[source](https://www.nytimes.com/wirecutter/blog/do-swamp-coolers-work/) (right).</p>
+
+The enhancement was motivated by discussions with the CBE research group at UC Berkeley: Hui Zhang, Roberto Rugani, and Maria Andre.
+
+## Overview ##
+
+The introduction of excessive moisture is one of the potential issues of direct evaporative coolers. A humidity control could become useful in preventing the evaporative cooler from raising indoor humidity to an uncomfortable level. Currently, the direct evaporative cooler can be controlled with the sensor node temperature using AvailabilityManagers (*AvailabilityManager:LowTemperatureTurnOff* or *AvailabilityManager:HighTemperatureTurnOn*). This feature proposes to add a relative humidity (RH) control to shut down the evaporative cooler when the indoor relative humidity is too high.
+
+We plan to enhance the zone level evaporative cooler object, *ZoneHVAC:EvaporativeCoolerUnit*. This is a compound object that combines a fan and one
+Each evaporative cooler in this object can be a direct or indirect. This feature will add some additional fields to this zone-level object, allowing user to specify a relative-humidity threshold above which the unit will be turned off.
+
+## Approach
+
+To enable a high-relative-humidity-cutoff control, a field will be added to the *ZoneHVAC:EvaporativeCoolerUnit* object. See Section IDD object change for details.
+
+## Testing/Validation/Data Source(s)
+
+This feature will be tested and demonstrated with a test file derived from StripMallZoneEvapCooler.idf. Manual check of the time-step EnergyPlus simulation results will be conducted to confirm the added feature is working correctly. 
+
+## IDD Object changes
+
+A field (N4) will be added to the ZoneHVAC:EvaporativeCoolerUnit
+
+    ZoneHVAC:EvaporativeCoolerUnit,
+        \memo Zone evaporative cooler. Forced-convection cooling-only unit with supply fan,
+        \memo 100% outdoor air supply. Optional relief exhaust node
+        \min-fields 15
+    A1 , \field Name
+        \required-field
+        \reference ZoneEquipmentNames
+    A2 , \field Availability Schedule Name
+        \note Availability schedule name for this system. Schedule value > 0 means the system is available.
+        \note If this field is blank, the system is always available.
+        \type object-list
+        \object-list ScheduleNames
+    A3,  \field Availability Manager List Name
+        \note Enter the name of an AvailabilityManagerAssignmentList object.
+        \type object-list
+        \object-list SystemAvailabilityManagerLists
+    A4 , \field Outdoor Air Inlet Node Name
+        \required-field
+        \type node
+        \note this is an outdoor air node
+    A5 , \field Cooler Outlet Node Name
+        \required-field
+        \type node
+        \note this is a zone inlet node
+    A6 , \field Zone Relief Air Node Name
+        \type node
+        \note this is a zone exhaust node, optional if flow is being balanced elsewhere
+    A7 , \field Supply Air Fan Object Type
+        \required-field
+        \type choice
+        \key Fan:SystemModel
+        \key Fan:ComponentModel
+        \key Fan:ConstantVolume
+        \key Fan:OnOff
+        \key Fan:VariableVolume
+    A8 , \field Supply Air Fan Name
+        \required-field
+        \type object-list
+        \object-list Fans
+    N1 , \field Design Supply Air Flow Rate
+        \required-field
+        \units m3/s
+        \minimum> 0
+        \autosizable
+    A9 , \field Fan Placement
+        \required-field
+        \type choice
+        \key BlowThrough
+        \key DrawThrough
+    A10, \field Cooler Unit Control Method
+        \required-field
+        \type choice
+        \key ZoneTemperatureDeadbandOnOffCycling
+        \key ZoneCoolingLoadOnOffCycling
+        \key ZoneCoolingLoadVariableSpeedFan
+    N2 , \field Throttling Range Temperature Difference
+        \note used for ZoneTemperatureDeadbandOnOffCycling hystersis range for thermostatic control
+        \type real
+        \units deltaC
+        \default 1.0
+        \minimum> 0.0
+    N3 , \field Cooling Load Control Threshold Heat Transfer Rate
+        \type real
+        \units W
+        \default 100.0
+        \note Sign convention is that positive values indicate a cooling load
+        \minimum> 0.0
+    A11, \field First Evaporative Cooler Object Type
+        \required-field
+        \type choice
+        \key EvaporativeCooler:Direct:CelDekPad
+        \key EvaporativeCooler:Direct:ResearchSpecial
+        \key EvaporativeCooler:Indirect:CelDekPad
+        \key EvaporativeCooler:Indirect:WetCoil
+        \key EvaporativeCooler:Indirect:ResearchSpecial
+    A12, \field First Evaporative Cooler Object Name
+        \required-field
+        \type object-list
+        \object-list EvapCoolerNames
+    A13, \field Second Evaporative Cooler Object Type
+        \note optional, used for direct/indirect configurations
+        \note second cooler must be immediately downstream of first cooler, if present
+        \type choice
+        \key EvaporativeCooler:Direct:CelDekPad
+        \key EvaporativeCooler:Direct:ResearchSpecial
+        \key EvaporativeCooler:Indirect:CelDekPad
+        \key EvaporativeCooler:Indirect:WetCoil
+        \key EvaporativeCooler:Indirect:ResearchSpecial
+    A14, \field Second Evaporative Cooler Name
+        \note optional, used for direct/indirect configurations
+        \type object-list
+        \object-list EvapCoolerNames
+    A15, \field Design Specification ZoneHVAC Sizing Object Name
+        \note Enter the name of a DesignSpecificationZoneHVACSizing object.
+        \type object-list
+        \object-list DesignSpecificationZoneHVACSizingName
+    N4; \field Shut Off Relative Humidity
+        \note Zone relative humidity above which the evap cooler is shut off.
+        \type real
+        \minimum 0.00
+        \maximum 100.00
+        \units percent
+
+## Proposed additions to Meters:
+
+N/A
+
+## Proposed Report Variables:
+
+N/A
+
+## References
+
+[1] https://www.energy.gov/energysaver/evaporative-coolers <br>

doc/engineering-reference/src/simulation-models-encyclopedic-reference-001/coils.tex

@@ -1661,7 +1661,7 @@ \subsubsection{Standard Rating of Single-Speed DX Cooling Coils}\label{standard-
 
 For single-speed direct expansion cooling coils in Unitary air conditioners and heat pumps, the following industry standard ratings are calculated and reported according to the industry standards listed below:
 
-ANSI/AHRI 210/240 Performance Rating of Unitary Air-conditioning & Air-source Heat Pump Equipment
+ANSI/AHRI 210/240 Performance Rating of Unitary Air-conditioning and Air-source Heat Pump Equipment
 For small single-speed direct expansion (DX) cooling coils, the industry standard ratings of Standard Rating Cooling Capacity, Energy Efficiency Ratio (EER), Integrated Energy Efficiency Ratio (IEER), and Seasonal Energy Efficiency Ratio (SEER) are calculated and reported according to two versions of the ANSI/AHRI Standard 210-240 (AHRI 2017 and AHRI 2023). These ratings apply to unitary air conditioners and air-source unitary heat pumps with air-cooled condensers and standard rating cooling capacities under 19 kW (\textless{}65,000 Btu/hr). The equations presented in the next two sections are from the 2017 version of the standard.  Equations for the 2023 standard rating calculations are detailed in the standard (section 11). The reader can download the standard document to view these details from AHRI(https://www.ahrinet.org/search-standards/ahri-210240-2023-2020-performance-rating-unitary-air-conditioning-air-source-heat). 
 
 AHRI Standard 340/360 Performance Rating for Commercial and Industrial Unitary Air Conditioning and Heat Pump Equipment
@@ -1672,7 +1672,7 @@ \subsubsection{Standard Rating of Single-Speed DX Cooling Coils}\label{standard-
 Standard Ratings Reporting
 The values for these Standard Ratings are reported in the eplusout.eio output file (Ref. OutputDetailsAndExamples.pdf) and also in the predefined tabular output reports (Output:Table:SummaryReports object, '2017 Standard Ratings for DX Coils' and '2023 Standard Ratings for DX Coils'). 
 
-\subsubsection{Standard Rating Cooling Capacity}\label{standard-rating-cooling-capacity}
+\subsubsection{Standard Rating Cooling Capacity}
 
 The standard rating cooling capacity (AHRI 2017) is calculated as follows: