Merge branch 'develop' into 5114327-EarthTube1DVerticalEnhancement

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.

doc/input-output-reference/src/overview/group-thermal-zone-description-geometry.tex

@@ -2826,12 +2826,14 @@ \subsection{Surface Output Variables/Reports}\label{surface-output-variablesrepo
 Zone,Average,Surface Outside Face Thermal Radiation to Air Heat Transfer Coefficient [W/m2-K]
 Zone,Average,Surface Outside Face Thermal Radiation to Sky Heat Transfer Coefficient [W/m2-K]
 Zone,Average,Surface Outside Face Thermal Radiation to Ground Heat Transfer Coefficient [W/m2-K]
+Zone,Average,Surface Outside Face Thermal Radiation to Surrounding Surfaces Heat Transfer Coefficient [W/m2-K]
+Zone,Average,Surface Outside Face Surrounding Surfaces Average Temperature [C]
 Zone,Average,Surface Inside Face Exterior Windows Incident Beam Solar Radiation Rate [W]
 Zone,Sum,Surface Inside Face Exterior Windows Incident Beam Solar Radiation Energy [J]
 Zone,Average,Surface Inside Face Exterior Windows Incident Beam Solar Radiation Rate per Area[W/m2]
 Zone,Average,Surface Inside Face Interior Windows Incident Beam Solar Radiation Rate [W]
 Zone,Average,Surface Inside Face Interior Windows Incident Beam Solar Radiation Rate per Area[W/m2]
-Zone, Sum,Surface Inside Face Interior Windows Incident Beam Solar Radiation Energy [J]
+Zone,Sum,Surface Inside Face Interior Windows Incident Beam Solar Radiation Energy [J]
 Zone,Average,Surface Inside Face Initial Transmitted Diffuse Absorbed Solar Radiation Rate [W]
 Zone,Average,Surface Inside Face Initial Transmitted Diffuse Transmitted Out Window Solar Radiation Rate [W]
 Zone,Average,Surface Inside Face Absorbed Shortwave Radiation Rate [W]
@@ -3242,6 +3244,14 @@ \subsubsection{Surface Outside Face Heat Emission to Air Rate {[}W{]}}\label{sur
 
 This is total heat transfer rate between the outside face and the air mass surrounding the surface by convection and thermal radiation.
 
+\subsubsection{Surface Outside Face Thermal Radiation to Surrounding Surfaces Heat Transfer Coefficient {[}W/m2-K{]}}\label{surface-outside-face-thermal-radiation-to-surrounding-surfaces-heat-transfer-coefficient-wm2-k}
+
+This is the coefficient that describes thermal radiation heat transfer between the outside face of an exterior surface and the surrounding surfaces it views. It is the value of ``Hr'' in the classic linearized model for thermal radiation exchange Q = Hr * A * (T\_surf -- T\_srdsurfs) when applied to the surrounding surfaces. Where T\_surf = Surface Outside Face Temperature, and T\_srdsurf = Average temperature of the surrounding surfaces viewed by an exterior surface.
+
+\subsubsection{Surface Outside Face Surrounding Surfaces Average Temperature {[}C{]}}\label{surface-outside-face-surrounding-surfaces-average-temperature-C}
+
+This is the average surface temperature of the surrounding surfaces viewed by an exterior surface, in degrees Celsius. The surrounding surfaces average temperature is a view factor weighed surface temperature of multiple surrounding surfaces seen by an exterior surface. If an exterior surface views a single surrounding surface then the average temperature is the same as the user specified surrounding surface temperature.
+
 \subsubsection{Surface Outside Face Solar Radiation Heat Gain Rate {[}W{]}}\label{surface-outside-face-solar-radiation-heat-gain-rate-w}
 
 \subsubsection{Surface Outside Face Solar Radiation Heat Gain Rate per Area {[}W/m2{]}}\label{surface-outside-face-solar-radiation-heat-gain-rate-per-area-wm2}