Merge pull request #9394 from NREL/SpaceHeatBalance

Subdivide Heat Balance by Space
NREL · Jan 9, 2023 · 70df7b9 · 70df7b9 · nrel-bot-3 · Jan 9, 2023
2 parents 0ff3e33 + da9e1cb
commit 70df7b9
Show file tree

Hide file tree

Showing 139 changed files with 16,108 additions and 12,380 deletions.
diff --git a/design/FY2022/NFP-Space Heat Balance.md b/design/FY2022/NFP-Space Heat Balance.md
diff --git a/doc/input-output-reference/src/overview/group-simulation-parameters.tex b/doc/input-output-reference/src/overview/group-simulation-parameters.tex
@@ -469,6 +469,12 @@ \subsubsection{Inputs}\label{inputs-8-023}
 
 Three choices are allowed to select which solution algorithm will be used. The \textbf{ThirdOrderBackwardDifference} selection is the default selection and uses the third order finite difference approximation to solve the zone air energy and moisture balance equations. The \textbf{AnalyticalSolution} selection uses the integration approach to solve the zone air energy and moisture balance equations. The \textbf{EulerMethod} selection uses the first order finite backward difference approximation to solve the zone air energy and moisture balance equations.
 
+\paragraph{Field: Do Space Heat Balance for Sizing}\label{field-do-space-heat-balance-sizing}
+If yes, space-level heat balance will be calculated and reported during sizing. If no, then only zone-level heat balance will be calculated. This field defaults to No. Note that space heat balance is not supported for \hyperref[inputs-hm]{HybridModel:Zone}, \hyperref[roomairmodeltype]{RoomAirModelType} other than Mixing, \hyperref[heatbalancealgorithm]{HeatBalanceAlgorithm} MoisturePenetrationDepthConductionTransferFunction and CombinedHeatAndMoistureFiniteElement.
+
+\paragraph{Field: Do Space Heat Balance for Simulation}\label{field-do-space-heat-balance-simulation}
+If yes, space-level heat balance will be calculated and reported during the simulation. If no, then only zone-level heat balance will be calculated. This field defaults to No.
+
 And, a default IDF example is shown below:
 
 \begin{lstlisting}

diff --git a/doc/input-output-reference/src/overview/group-thermal-zone-description-geometry.tex b/doc/input-output-reference/src/overview/group-thermal-zone-description-geometry.tex
@@ -218,6 +218,54 @@ \subsubsection{Space Thermal Outputs Overview}
   Zone,Sum,Space Total Internal Total Heating Energy {[}J{]}
 \item
   Zone,Average,Space Total Internal Total Heating Rate {[}W{]}
+\item
+  HVAC,Average,Space Air Temperature {[}C{]}
+\item
+  Zone,Average,Space Mean Air Dewpoint Temperature {[}C{]}
+\item
+  Zone,Average,Space Mean Radiant Temperature {[}C{]}
+\item
+  Zone,Average,Space Operative Temperature {[}C{]}
+\item
+  HVAC,Average,Space Air Heat Balance Internal Convective Heat Gain Rate {[}W{]}
+\item
+  HVAC,Average,Space Air Heat Balance Surface Convection Rate {[}W{]}
+\item
+  HVAC,Average,Space Air Heat Balance InterSpace Air Transfer Rate {[}W{]}
+\item
+  HVAC,Average,Space Air Heat Balance Outdoor Air Transfer Rate {[}W{]}
+\item
+  HVAC,Average,Space Air Heat Balance System Air Transfer Rate {[}W{]}
+\item
+  HVAC,Average,Space Air Heat Balance System Convective Heat Gain Rate {[}W{]}
+\item
+  HVAC,Average,Space Air Heat Balance Air Energy Storage Rate {[}W{]}
+\item
+  HVAC,Average,Space Air Heat Balance Deviation Rate {[}W{]}
+\item
+  HVAC,Sum,Space Air System Sensible Heating Energy {[}J{]}
+\item
+  HVAC,Sum,Space Air System Sensible Cooling Energy {[}J{]}
+\item
+  HVAC,Average,Space Air System Sensible Heating Rate {[}W{]}
+\item
+  HVAC,Average,Space Air System Sensible Cooling Rate {[}W{]}
+\item
+  HVAC,Average,Space Air Humidity Ratio{[}kgWater/kgDryAir{]}
+\item
+  HVAC,Average,Space Air Relative Humidity{[}\%{]}
+\item
+  HVAC,Sum,Space Air System Latent Heating Energy {[}J{]}
+\item
+  HVAC,Sum,Space Air System Latent Cooling Energy {[}J{]}
+\item
+  HVAC,Average,Space Air System Latent Heating Rate {[}W{]}
+\item
+  HVAC,Average,Space Air System Latent Cooling Rate {[}W{]}
+\item
+  HVAC,Average,Space Air System Sensible Heat Ratio {[}{]}
+\item
+  HVAC,Average,Space Air Vapor Pressure Difference {[}Pa{]}
 \end{itemize}
 
 \subsubsection{Zone Thermal Outputs Overview}\label{zone-thermal-outputs}
@@ -321,7 +369,7 @@ \subsubsection{Space and Zone Thermal Outputs Details}
 
 \paragraph{Zone Mean Air Temperature {[}C{]}}\label{zone-mean-air-temperature-c}
 
-From the code definition, the zone mean air temperature is the average temperature of the air temperatures at the system timestep. Remember that the zone heat balance represents a ``well stirred'' model for a zone, therefore there is only one mean air temperature to represent the air temperature for the zone.
+From the code definition, the zone mean air temperature is the average temperature of the air temperatures at the system timestep. Remember that the zone heat balance represents a ``well stirred'' model for a zone, therefore there is only one mean air temperature to represent the air temperature for the zone unless a non-mixing RoomAirModel is specified.
 
 \paragraph{Zone Air Temperature {[}C{]}}\label{zone-air-temperature-c}
 

diff --git a/doc/input-output-reference/src/overview/group-zone-controls-thermostats.tex b/doc/input-output-reference/src/overview/group-zone-controls-thermostats.tex
@@ -222,6 +222,18 @@ \subsubsection{Outputs}\label{outputs-042}
   HVAC,Average,Zone System Predicted Sensible Load to Heating Setpoint Heat Transfer Rate {[}W{]}
 \item
   HVAC,Average,Zone System Predicted Sensible Load to Cooling Setpoint Heat Transfer Rate {[}W{]}
+\item
+  HVAC,Average,Space Predicted Sensible Load to Setpoint Heat Transfer Rate {[}W{]}
+\item
+  HVAC,Average,Space Predicted Sensible Load to Heating Setpoint Heat Transfer Rate {[}W{]}
+\item
+  HVAC,Average,Space Predicted Sensible Load to Cooling Setpoint Heat Transfer Rate {[}W{]}
+\item
+  HVAC,Average,Space System Predicted Sensible Load to Setpoint Heat Transfer Rate {[}W{]}
+\item
+  HVAC,Average,Space System Predicted Sensible Load to Heating Setpoint Heat Transfer Rate {[}W{]}
+\item
+  HVAC,Average,Space System Predicted Sensible Load to Cooling Setpoint Heat Transfer Rate {[}W{]}
 \item
   Zone,Average,Zone Thermostat Control Type {[]}
 \item
@@ -858,6 +870,18 @@ \subsubsection{Outputs}\label{outputs-2-027}
   HVAC,Average,Zone System Predicted Moisture Load to Humidifying Setpoint Moisture Transfer Rate {[}kgWater/s{]}
 \item
   HVAC,Average,Zone System Predicted Moisture Load to Dehumidifying Setpoint Moisture Transfer Rate {[}kgWater/s{]}
+\item
+  HVAC,Average,Zone Predicted Moisture Load Moisture Transfer Rate {[}kgWater/s{]}
+\item
+  HVAC,Average,Space Predicted Moisture Load to Humidifying Setpoint Moisture Transfer Rate {[}kgWater/s{]}
+\item
+  HVAC,Average,Space Predicted Moisture Load to Dehumidifying Setpoint Moisture Transfer Rate {[}kgWater/s{]}
+\item
+  HVAC,Average,Space System Predicted Moisture Load Moisture Transfer Rate {[}kgWater/s{]}
+\item
+  HVAC,Average,Space System Predicted Moisture Load to Humidifying Setpoint Moisture Transfer Rate {[}kgWater/s{]}
+\item
+  HVAC,Average,Space System Predicted Moisture Load to Dehumidifying Setpoint Moisture Transfer Rate {[}kgWater/s{]}
 \end{itemize}
 
 \paragraph{Zone Predicted Moisture Load Moisture Transfer Rate {[}kgWater/s{]}}

diff --git a/doc/input-output-reference/src/overview/input-output-descriptions.tex b/doc/input-output-reference/src/overview/input-output-descriptions.tex
@@ -107,6 +107,16 @@ \subsection{Output Descriptions}\label{output-descriptions}
   HVAC,Average,Zone Air Temperature {[}C{]}
 \item
   HVAC,Average,Zone Thermostat Air Temperature {[}C{]}
+\item
+  HVAC,Sum,Space Air System Sensible Heating Energy {[}J{]}
+\item
+  HVAC,Sum,Space Air System Sensible Cooling Energy {[}J{]}
+\item
+  HVAC,Average,Space Air System Sensible Heating Rate {[}W{]}
+\item
+  HVAC,Average,Space Air System Sensible Cooling Rate {[}W{]}
+\item
+  HVAC,Average,Space Air Temperature {[}C{]}
 \end{itemize}
 
 Note that the \textbf{eplusout.mdd} file is similar, but meters are only available at the Zone timestep.

diff --git a/idd/Energy+.idd.in b/idd/Energy+.idd.in
@@ -771,16 +771,29 @@ HeatBalanceSettings:ConductionFiniteDifference,
        \maximum 0.01
 
 ZoneAirHeatBalanceAlgorithm,
-       \memo Determines which algorithm will be used to solve the zone air heat balance.
+       \memo Controls the zone/space air heat balance.
        \unique-object
        \format singleLine
-       \min-fields 1
-  A1 ; \field Algorithm
+       \min-fields 2
+  A1 , \field Algorithm
+       \note Determines which algorithm will be used to solve the air heat balance.
        \type choice
        \key ThirdOrderBackwardDifference
        \key AnalyticalSolution
        \key EulerMethod
        \default ThirdOrderBackwardDifference
+  A2 , \field Do Space Heat Balance for Sizing
+       \note If yes, space heat balance will be calculated and reported during sizing.
+       \type choice
+       \key No
+       \key Yes
+       \default No
+  A3 ; \field Do Space Heat Balance for Simulation
+       \note If yes, space heat balance will be calculated and reported during simulation.
+       \type choice
+       \key No
+       \key Yes
+       \default No
 
 ZoneAirContaminantBalance,
        \memo Determines which contaminant concentration will be simulates.