Pull develop, merge conflicts

.decent_ci-Linux.yaml

@@ -1,12 +1,12 @@
 compilers:
   - name: "gcc"
-    version: "11.3"
+    version: "11.4"
     cmake_extra_flags: -DLINK_WITH_PYTHON:BOOL=ON -DBUILD_FORTRAN:BOOL=ON -DBUILD_TESTING:BOOL=ON -DENABLE_REGRESSION_TESTING:BOOL=ON -DREGRESSION_BASELINE_PATH:PATH=$REGRESSION_BASELINE -DREGRESSION_SCRIPT_PATH:PATH=$REGRESSION_DIR -DREGRESSION_BASELINE_SHA:STRING=$REGRESSION_BASELINE_SHA -DCOMMIT_SHA:STRING=$COMMIT_SHA -DENABLE_GTEST_DEBUG_MODE:BOOL=OFF -DBUILD_PERFORMANCE_TESTS:BOOL=ON -DVALGRIND_ANALYZE_PERFORMANCE_TESTS:BOOL=ON -DENABLE_PCH:BOOL=OFF
     collect_performance_results: true
     s3_upload_bucket: energyplus
 
   - name: "gcc"
-    version: "11.3"
+    version: "11.4"
     build_type: Debug
     cmake_extra_flags: -DLINK_WITH_PYTHON:BOOL=ON -DBUILD_FORTRAN:BOOL=ON -DBUILD_TESTING:BOOL=ON -DENABLE_REGRESSION_TESTING:BOOL=OFF -DCOMMIT_SHA:STRING=$COMMIT_SHA -DENABLE_COVERAGE:BOOL=ON -DENABLE_GTEST_DEBUG_MODE:BOOL=OFF -DENABLE_PCH:BOOL=OFF
     coverage_enabled: true
@@ -20,7 +20,7 @@ compilers:
     skip_packaging: true
 
   - name: "gcc"
-    version: "11.3"
+    version: "11.4"
     build_type: Debug
     cmake_extra_flags: -DLINK_WITH_PYTHON:BOOL=ON -DBUILD_FORTRAN:BOOL=ON -DBUILD_TESTING:BOOL=ON -DENABLE_REGRESSION_TESTING:BOOL=OFF -DCOMMIT_SHA:STRING=$COMMIT_SHA -DENABLE_COVERAGE:BOOL=ON -DENABLE_GTEST_DEBUG_MODE:BOOL=OFF -DENABLE_PCH:BOOL=OFF
     coverage_enabled: true

README.md

@@ -23,7 +23,7 @@ Every commit and every release of EnergyPlus undergoes rigorous testing.
 The testing consists of building EnergyPlus, of course, then there are unit tests, integration tests, API tests, and regression tests.
 Since 2014, most of the testing has been performed by our bots ([Tik-Tok](https://github.com/nrel-bot), [Gort](https://github.com/nrel-bot-2), and [Marvin](https://github.com/nrel-bot-3)), using a fork of the [Decent CI](https://github.com/lefticus/decent_ci) continuous integration system.
 We are now adapting our efforts to use the Github Actions system to handle more of our testing processes.
-In the meantime, while Decent CI is still handling the regression and bulkier testing, results from Decent CI are still available on the testing [dashboard](http://nrel.github.io/EnergyPlusBuildResults/).
+In the meantime, while Decent CI is still handling the regression and bulkier testing, results from Decent CI are still available on the testing [dashboard](https://myoldmopar.github.io/EnergyPlusBuildResults/).
 
 ## Releases
 

datasets/ResidentialACsAndHPsPerfCurves.idf

@@ -154,10 +154,10 @@
 !    ,                        !- Speed 1 Rated COP {W/W}
 !    ,                        !- Speed 1 Rated Air Flow Rate {m3/s}
 !    ,                        !- Rated Evaporator Fan Power Per Volume Flow Rate {W/(m3/s)}
-!    ACHighStageCoolingCAPFTemp, !- Speed 1 Total Cooling Capacity Function of Temperature Curve Name
-!    ACHighStageCoolingCAPFFF,   !- Speed 1 Total Cooling Capacity Function of Flow Fraction Curve Name
-!    ACHighStageCoolingEIRFTemp, !- Speed 1 Energy Input Ratio Function of Temperature Curve Name
-!    ACHighStageCoolingEIRFFF,   !- Speed 1 Energy Input Ratio Function of Flow Fraction Curve Name
+!    ACLowStageCoolingCAPFTemp, !- Speed 1 Total Cooling Capacity Function of Temperature Curve Name
+!    ACLowStageCoolingCAPFFF,   !- Speed 1 Total Cooling Capacity Function of Flow Fraction Curve Name
+!    ACLowStageCoolingEIRFTemp, !- Speed 1 Energy Input Ratio Function of Temperature Curve Name
+!    ACLowStageCoolingEIRFFF,   !- Speed 1 Energy Input Ratio Function of Flow Fraction Curve Name
 !    AC2StageCoolingPLFFPLR,     !- Speed 1 Part Load Fraction Correlation Curve Name
 !    ,                        !- Speed 1 Nominal Time for Condensate Removal to Begin {s}
 !    ,                        !- Speed 1 Ratio of Initial Moisture Evaporation Rate and Steady State Latent Capacity {dimensionless}
@@ -173,10 +173,10 @@
 !    ,                        !- Speed 2 Rated COP {W/W}
 !    ,                        !- Speed 2 Rated Air Flow Rate {m3/s}
 !    ,                        !- Rated Evaporator Fan Power Per Volume Flow Rate {W/(m3/s)}
-!    ACLowStageCoolingCAPFTemp, !- Speed 2 Total Cooling Capacity Function of Temperature Curve Name
-!    ACLowStageCoolingCAPFFF,   !- Speed 2 Total Cooling Capacity Function of Flow Fraction Curve Name
-!    ACLowStageCoolingEIRFTemp, !- Speed 2 Energy Input Ratio Function of Temperature Curve Name
-!    ACLowStageCoolingEIRFFF,   !- Speed 2 Energy Input Ratio Function of Flow Fraction Curve Name
+!    ACHighStageCoolingCAPFTemp, !- Speed 2 Total Cooling Capacity Function of Temperature Curve Name
+!    ACHighStageCoolingCAPFFF,   !- Speed 2 Total Cooling Capacity Function of Flow Fraction Curve Name
+!    ACHighStageCoolingEIRFTemp, !- Speed 2 Energy Input Ratio Function of Temperature Curve Name
+!    ACHighStageCoolingEIRFFF,   !- Speed 2 Energy Input Ratio Function of Flow Fraction Curve Name
 !    AC2StageCoolingPLFFPLR,    !- Speed 2 Part Load Fraction Correlation Curve Name
 !    ,                        !- Speed 2 Nominal Time for Condensate Removal to Begin {s}
 !    ,                        !- Speed 2 Ratio of Initial Moisture Evaporation Rate and steady state Latent Capacity {dimensionless}
@@ -570,10 +570,10 @@
 !    ,                        !- Speed 1 Rated COP {W/W}
 !    ,                        !- Speed 1 Rated Air Flow Rate {m3/s}
 !    ,                        !- Rated Evaporator Fan Power Per Volume Flow Rate {W/(m3/s)}
-!    HPHighStageCoolingCAPFTemp, !- Speed 1 Total Cooling Capacity Function of Temperature Curve Name
-!    HPHighStageCoolingCAPFFF,   !- Speed 1 Total Cooling Capacity Function of Flow Fraction Curve Name
-!    HPHighStageCoolingEIRFTemp, !- Speed 1 Energy Input Ratio Function of Temperature Curve Name
-!    HPHighStageCoolingEIRFFF,   !- Speed 1 Energy Input Ratio Function of Flow Fraction Curve Name
+!    HPLowStageCoolingCAPFTemp, !- Speed 1 Total Cooling Capacity Function of Temperature Curve Name
+!    HPLowStageCoolingCAPFFF,   !- Speed 1 Total Cooling Capacity Function of Flow Fraction Curve Name
+!    HPLowStageCoolingEIRFTemp, !- Speed 1 Energy Input Ratio Function of Temperature Curve Name
+!    HPLowStageCoolingEIRFFF,   !- Speed 1 Energy Input Ratio Function of Flow Fraction Curve Name
 !    HP2StageCoolingPLFFPLR,     !- Speed 1 Part Load Fraction Correlation Curve Name
 !    ,                        !- Speed 1 Nominal Time for Condensate Removal to Begin {s}
 !    ,                        !- Speed 1 Ratio of Initial Moisture Evaporation Rate and Steady State Latent Capacity {dimensionless}
@@ -589,10 +589,10 @@
 !    ,                        !- Speed 2 Rated COP {W/W}
 !    ,                        !- Speed 2 Rated Air Flow Rate {m3/s}
 !    ,                        !- Rated Evaporator Fan Power Per Volume Flow Rate {W/(m3/s)}
-!    HPLowStageCoolingCAPFTemp, !- Speed 2 Total Cooling Capacity Function of Temperature Curve Name
-!    HPLowStageCoolingCAPFFF,   !- Speed 2 Total Cooling Capacity Function of Flow Fraction Curve Name
-!    HPLowStageCoolingEIRFTemp, !- Speed 2 Energy Input Ratio Function of Temperature Curve Name
-!    HPLowStageCoolingEIRFFF,   !- Speed 2 Energy Input Ratio Function of Flow Fraction Curve Name
+!    HPHighStageCoolingCAPFTemp, !- Speed 2 Total Cooling Capacity Function of Temperature Curve Name
+!    HPHighStageCoolingCAPFFF,   !- Speed 2 Total Cooling Capacity Function of Flow Fraction Curve Name
+!    HPHighStageCoolingEIRFTemp, !- Speed 2 Energy Input Ratio Function of Temperature Curve Name
+!    HPHighStageCoolingEIRFFF,   !- Speed 2 Energy Input Ratio Function of Flow Fraction Curve Name
 !    HP2StageCoolingPLFFPLR,    !- Speed 2 Part Load Fraction Correlation Curve Name
 !    ,                        !- Speed 2 Nominal Time for Condensate Removal to Begin {s}
 !    ,                        !- Speed 2 Ratio of Initial Moisture Evaporation Rate and steady state Latent Capacity {dimensionless}
@@ -762,21 +762,21 @@
 !    ,                        !- Speed 1 Rated COP {W/W}
 !    ,                        !- Speed 1 Rated Air Flow Rate {m3/s}
 !    ,                        !- Speed 1 Rated Supply Air Fan Power Per Volume Flow Rate {W/(m3/s)}
-!    HPHighStageHeatingCAPFTemp, !- Speed 1 Total Heating Capacity Function of Temperature Curve Name
-!    HPHighStageHeatingCAPFFF,   !- Speed 1 Total Heating Capacity Function of Flow Fraction Curve Name
-!    HPHighStageHeatingEIRFTemp, !- Speed 1 Energy Input Ratio Function of Temperature Curve Name
-!    HPHighStageHeatingEIRFFF,   !- Speed 1 Energy Input Ratio Function of Flow Fraction Curve Name
+!    HPLowStageHeatingCAPFTemp, !- Speed 1 Total Heating Capacity Function of Temperature Curve Name
+!    HPLowStageHeatingCAPFFF,   !- Speed 1 Total Heating Capacity Function of Flow Fraction Curve Name
+!    HPLowStageHeatingEIRFTemp, !- Speed 1 Energy Input Ratio Function of Temperature Curve Name
+!    HPLowStageHeatingEIRFFF,   !- Speed 1 Energy Input Ratio Function of Flow Fraction Curve Name
 !    HP2StageHeatingPLFFPLR,     !- Speed 1 Part Load Fraction Correlation Curve Name
 !    ,                        !- Speed 1 Rated Waste Heat Fraction of Power Input {dimensionless}
 !    ,                        !- Speed 1 Waste Heat Function of Temperature Curve Name
 !    ,                        !- Speed 2 Rated Total Heating Capacity {W}
 !    ,                        !- Speed 2 Rated COP {W/W}
 !    ,                        !- Speed 2 Rated Air Flow Rate {m3/s}
 !    ,                        !- Speed 2 Rated Supply Air Fan Power Per Volume Flow Rate {W/(m3/s)}
-!    HPLowStageHeatingCAPFTemp, !- Speed 2 Total Heating Capacity Function of Temperature Curve Name
-!    HPLowStageHeatingCAPFFF,   !- Speed 2 Total Heating Capacity Function of Flow Fraction Curve Name
-!    HPLowStageHeatingEIRFTemp, !- Speed 2 Energy Input Ratio Function of Temperature Curve Name
-!    HPLowStageHeatingEIRFFF,   !- Speed 2 Energy Input Ratio Function of Flow Fraction Curve Name
+!    HPHighStageHeatingCAPFTemp, !- Speed 2 Total Heating Capacity Function of Temperature Curve Name
+!    HPHighStageHeatingCAPFFF,   !- Speed 2 Total Heating Capacity Function of Flow Fraction Curve Name
+!    HPHighStageHeatingEIRFTemp, !- Speed 2 Energy Input Ratio Function of Temperature Curve Name
+!    HPHighStageHeatingEIRFFF,   !- Speed 2 Energy Input Ratio Function of Flow Fraction Curve Name
 !    HP2StageHeatingPLFFPLR,    !- Speed 2 Part Load Fraction Correlation Curve Name
 !    ,                        !- Speed 2 Rated Waste Heat Fraction of Power Input {dimensionless}
 !    ;                        !- Speed 2 Waste Heat Function of Temperature Curve Name

doc/engineering-reference/src/surface-heat-balance-manager-processes/outside-surface-heat-balance.tex

@@ -31,7 +31,7 @@ \subsection{External Shortwave Radiation}\label{external-shortwave-radiation}
 
 \subsection{External Longwave Radiation}\label{external-longwave-radiation}
 
-\({q''_{LWR}}\) is a standard radiation exchange formulation between the surface, the sky, and the ground. The radiation heat flux is calculated from the surface absorptivity, surface temperature, sky and ground temperatures, and sky and ground view factors.
+\({q''_{LWR}}\) is a standard radiation exchange formulation between the surface, the sky, the ground, and the surrounding surfaces. The radiation heat flux is calculated from the surface absorptivity, surface temperature, sky, ground and surrounding surfaces temperatures, and sky, ground and surrounding surfaces view factors.
 
 The longwave radiation heat exchange between surfaces is dependent on surface temperatures, spatial relationships between surfaces and surroundings, and material properties of the surfaces. The relevant material properties of the surface, emissivity e and absorptivity a, are complex functions of temperature, angle, and wavelength for each participating surface. However, it is generally agreed that reasonable assumptions for building loads calculations are (Chapman 1984; Lienhard 1981):
 
@@ -43,7 +43,11 @@ \subsection{External Longwave Radiation}\label{external-longwave-radiation}
 \item
   energy flux leaving a surface is evenly distributed across the surface,
 \item
-  the medium within the enclosure is non-participating.
+  the medium within the enclosure is non-participating,
+\item
+  the long-wave emissivity of the surrounding surfaces is assumed to be the same as that of the exterior surface viewing them,
+\item
+  the sum of view factors from an exterior surface to the ground, the sky and the surrounding surfaces must be equal to 1.
 \end{itemize}
 
 These assumptions are frequently used in all but the most critical engineering applications.
@@ -68,24 +72,26 @@ \subsection{External Longwave Radiation}\label{external-longwave-radiation}
 $T_{air}$ & Outside air temperature & $K$ & --- \tabularnewline
 $T_{gnd}$ & Environmental ground surface temperature & $K$ & --- \tabularnewline
 $T_{sky}$ & Sky Effective temperature & $K$ & --- \tabularnewline
+$T_{srd}$ & Surrounding surfaces average temperature & $K$ & --- \tabularnewline
 $F_{gnd}$ & view factor of wall surface to ground surface & --- & 0--1 \tabularnewline
 $F_{sky}$ & View factor of wall surface to sky & --- & 0--1 \tabularnewline
 $F_{air}$ & View factor of wall surface to air & --- & 0--1 \tabularnewline
+$F_{srd}$ & View factor of wall surface to surrounding surfaces & --- & 0--1 \tabularnewline
 $\varepsilon$ & Surface long-wave emissivity & --- & 0--1 \tabularnewline
 $\sigma$ & Stefan-Boltzmann constant & $W/m^2.K^4$ & $5.67 \times 10^{-8}$ \tabularnewline
 \bottomrule
 \end{longtable}
 
-Consider an enclosure consisting of building exterior surface, surrounding ground surface, and sky.~ Using the assumptions above, we can determine the longwave radiative heat flux at the building exterior surface (Walton 1983; McClellan and Pedersen 1997).~ The total longwave radiative heat flux is the sum of components due to radiation exchange with the ground, sky, and air.
+Consider an enclosure consisting of building exterior surface, surrounding ground surface, and sky.~ Using the assumptions above, we can determine the longwave radiative heat flux at the building exterior surface (Walton 1983; McClellan and Pedersen 1997).~ The total longwave radiative heat flux is the sum of components due to radiation exchange with the ground, sky, air, and surrounding surfaces.
 
 \begin{equation}
-{q''_{LWR}} = {q''_{gnd}} + {q''_{sky}} + {q''_{air}}
+{q''_{LWR}} = {q''_{gnd}} + {q''_{sky}} + {q''_{air}} + {q''_{srd}}
 \end{equation}
 
 Applying the Stefan-Boltzmann Law to each component yields:
 
 \begin{equation}
-{q''_{LWR}} = \varepsilon \sigma {F_{gnd}}(T_{gnd}^4 - T_{surf}^4) + \varepsilon \sigma {F_{sky}}(T_{sky}^4 - T_{surf}^4) + \varepsilon \sigma {F_{air}}(T_{air}^4 - T_{surf}^4)
+{q''_{LWR}} = \varepsilon \sigma {F_{gnd}}(T_{gnd}^4 - T_{surf}^4) + \varepsilon \sigma {F_{sky}}(T_{sky}^4 - T_{surf}^4) + \varepsilon \sigma {F_{air}}(T_{air}^4 - T_{surf}^4)  + \varepsilon \sigma {F_{srd}}(T_{srd}^4 - T_{surf}^4)
 \end{equation}
 
 where
@@ -100,6 +106,8 @@ \subsection{External Longwave Radiation}\label{external-longwave-radiation}
 
 F\(_{air}\) = view factor of wall surface to air temperature
 
+F\(_{srd}\) = view factor of wall surface to surrounding surfaces
+
 T\(_{surf}\) = outside surface temperature
 
 T\(_{gnd}\) = ground surface temperature
@@ -108,10 +116,12 @@ \subsection{External Longwave Radiation}\label{external-longwave-radiation}
 
 T\(_{air}\) = air temperature
 
+T\(_{srd}\) = average temperature of the surrounding surfaces
+
 Linearized radiative heat transfer coefficients are introduced to render the above equation more compatible with the heat balance formulation,
 
 \begin{equation}
-{q''_{LWR}} = {h_{r,gnd}}({T_{gnd}} - {T_{surf}}) + {h_{r,sky}}({T_{sky}} - {T_{surf}}) + {h_{r,air}}({T_{air}} - {T_{surf}})
+{q''_{LWR}} = {h_{r,gnd}}({T_{gnd}} - {T_{surf}}) + {h_{r,sky}}({T_{sky}} - {T_{surf}}) + {h_{r,air}}({T_{air}} - {T_{surf}}) + {h_{r,srd}}({T_{srd}} - {T_{surf}})
 \end{equation}
 
 where
@@ -128,6 +138,10 @@ \subsection{External Longwave Radiation}\label{external-longwave-radiation}
 {h_{r,air}} = \frac{{\varepsilon \sigma {F_{air}}(T_{surf}^4 - T_{air}^4)}}{{{T_{surf}} - {T_{air}}}}
 \end{equation}
 
+\begin{equation}
+{h_{r,srd}} = \frac{{\varepsilon \sigma {F_{srd}}(T_{surf}^4 - T_{srd}^4)}}{{{T_{surf}} - {T_{srd}}}}
+\end{equation}
+
 The longwave view factors to ground and sky are calculated with the following expressions (Walton 1983):
 
 \begin{equation}
@@ -177,7 +191,7 @@ \subsubsection{External Longwave Radiation With Multiple Ground Surfaces}\label{
 {q''_{gnd}} = \varepsilon \sigma \sum\limits_{j = 1}^{{N_{gnd}}} {F_{gnd,j}} \left(T_{gnd,j}^4 - T_{surf}^4 \right)
 \end{equation}
 
-The above equation can be recast using average temperature of multiple ground surfaces viewed by an exterior surface as follows:
+The above equation assumes that the building exterior surface and the ground surfaces it views have the same long-wave emissivity and can be recast using average temperature of multiple ground surfaces viewed by an exterior surface as follows:
 
 \begin{equation}
 {q''_{gnd}} = \varepsilon \sigma {F_{gnd,sum}} (T_{gnd,avg}^4 - T_{surf}^4)
@@ -216,6 +230,53 @@ \subsubsection{External Longwave Radiation With Multiple Ground Surfaces}\label{
 h\(_{r,gnd,avg}\) = linearized average radiative heat transfer coefficient between an exterior surface and multiple ground surfaces
 
 
+\subsubsection{External Longwave Radiation With Multiple Surrounding Surfaces}\label{external-longwave-radiation-with-multiple-surrounding-surfaces}
+
+Long-wave radiation exchange of an exterior surface with multiple surrounding surfaces is given by:
+
+\begin{equation}
+{q''_{srd}} = \varepsilon \sigma \sum\limits_{j = 1}^{{N_{srd}}} {F_{srd,j}} \left(T_{srd,j}^4 - T_{surf}^4 \right)
+\end{equation}
+
+The above equation assumes that the building exterior surface and the surrounding surfaces it views have the same long-wave emissivity and can be recast using average temperature of multiple surrounding surfaces viewed by an exterior surface as follows:
+
+\begin{equation}
+{q''_{srd}} = \varepsilon \sigma {F_{srd,sum}} (T_{srd,avg}^4 - T_{surf}^4)
+\end{equation}
+
+\begin{equation}
+{F_{srd,sum}} = \sum\limits_{j = 1}^{{N_{srd}}} {F_{srd,j}}
+\end{equation}
+
+\begin{equation}
+{T_{srd,avg}} = ((\sum\limits_{j = 1}^{{N_{srd}}} {F_{srd,j}} {T_{srd,j}^4}) / {F_{srd,sum}})^{1/4}
+\end{equation}
+
+\begin{equation}
+{h_{r,srd,avg}} = \frac{{\varepsilon \sigma {F_{srd, sum}}(T_{surf}^4 - T_{srd,avg}^4)}}{{{T_{surf}} - {T_{srd,avg}}}}
+\end{equation}
+
+where
+
+$\varepsilon$ = long-wave emittance of an exterior surface
+
+$\sigma$ = Stefan-Boltzmann constant
+
+F\(_{srd,j}\) = view factor of an exterior surface to surrounding surface j
+
+T\(_{srd,j}\) = temperature of surrounding surface j
+
+T\(_{surf}\) = outside temperature of an exterior surface
+
+N\(_{srd}\) = number surrounding surfaces viewed by an exterior surface
+
+T\(_{srd,avg}\) = view factor weighted average surface temperature of multiple surrounding surfaces seen by an exterior surface
+
+F\(_{srd,sum}\) = sum of the view factors of an exterior surfaces to multiple surrounding surfaces 
+
+h\(_{r,srd,avg}\) = linearized average radiative heat transfer coefficient between an exterior surface and multiple surrounding surfaces
+
+
 \subsection{References}\label{references-034}
 
 ASHRAE. 1993. 1993 ASHRAE Handbook -- Fundamentals. Atlanta: American Society of Heating, Refrigerating, and Air-Conditioning Engineers, Inc.