Skip to content

Commit

Permalink
Merge pull request #8529 from NREL/EnhanceOutdoorAirReporting2
Browse files Browse the repository at this point in the history
New Outdoor Air Details report
  • Loading branch information
Myoldmopar authored Feb 19, 2021
2 parents 3153b0f + f14b842 commit 35dbafc
Show file tree
Hide file tree
Showing 20 changed files with 1,967 additions and 6,128 deletions.
732 changes: 732 additions & 0 deletions design/FY2020/NFP-EnhancedOutdoorAirReporting.md

Large diffs are not rendered by default.

82 changes: 82 additions & 0 deletions doc/input-output-reference/src/overview/group-air-distribution.tex
Original file line number Diff line number Diff line change
Expand Up @@ -160,6 +160,56 @@ \subsubsection{Outputs}\label{outputs-1-001}

Reports the air changes per hour in the zone due to the outside fresh air supplied by mechanical ventilation system.

\paragraph{Zone Target Voz Ventilation Flow Rate {[}m3/s{]}}\label{zone-target-voz-ventilation-flow-rate}
The target ventilation flow rate \(V_{oz-dyn}\) at standard density at the current timestep as defined by the zone Design Specification Outdoor Air Object (\hyperref[designspecificationoutdoorair]{DesignSpecification:OutdoorAir}).

\paragraph{Zone Ventilation Below Target Voz Time {[}hr{]}}\label{zone-ventilation-below-target-voz-time}
The time that the zone total ventilation rate (mechanical ventilation plus natural ventilation) is more than 1\% below the \emph{Zone Target Voz Ventilation Flow Rate}.

\paragraph{Zone Ventilation At Target Voz Time {[}hr{]}}\label{zone-ventilation-at-target-voz-time}
The time that the zone total ventilation rate (mechanical ventilation plus natural ventilation) is within 1\% of the \emph{Zone Target Voz Ventilation Flow Rate}.

\paragraph{Zone Ventilation Above Target Voz Time {[}hr{]}}\label{zone-ventilation-above-target-voz-time}
The time that the zone total ventilation rate (mechanical ventilation plus natural ventilation) is more than 1\% above the \emph{Zone Target Voz Ventilation Flow Rate}.

\paragraph{Zone Ventilation When Unoccupied Time {[}hr{]}}\label{zone-ventilation-when-unoccupied-time}
The time that the zone total ventilation rate (mechanical ventilation plus natural ventilation) is greater than zero when the zone is unoccupied.

\paragraph{Facility Any Zone Ventilation Below Target Voz Time {[}hr{]}}\label{facility-any-zone-ventilation-below-target-voz-time}
The time that any zone's total ventilation rate (mechanical ventilation plus natural ventilation) is more than 1\% below the \emph{Zone Target Voz Ventilation Flow Rate}.

\paragraph{Facility All Zones Ventilation At Target Voz Time {[}hr{]}}\label{facility-all-zones-ventilation-at-target-voz-time}
The time that every zone's total ventilation rate (mechanical ventilation plus natural ventilation) is within 1\% of the \emph{Zone Target Voz Ventilation Flow Rate}.

\paragraph{Facility Any Zone Ventilation Above Target Voz Time {[}hr{]}}\label{facility-any-zone-ventilation-above-target-voz-time}
The time that any zone's total ventilation rate (mechanical ventilation plus natural ventilation) is more than 1\% above the \emph{Zone Target Voz Ventilation Flow Rate}.

\paragraph{Facility Any Zone Ventilation When Unoccupied Time {[}hr{]}}\label{facility-any-zone-ventilation-when-unoccupied-time}
The time that any zone's total ventilation rate (mechanical ventilation plus natural ventilation) is greater than zero when the zone is unoccupied.

\paragraph{Air System Mechanical Ventilation Flow Rate {[}m3/s{]}}\label{air-system-mechanical-ventilation-flow-rate}
The current airloop mechanical ventilation flow rate at standard density.

\paragraph{Air System Natural Ventilation Flow Rate {[}m3/s{]}}\label{air-system-natural-ventilation-flow-rate}
The sum of the natural ventilation flow rate at standard density at the current timestep for each zone on the airloop. If any zone terminal unit has a Design Specification Air Terminal Sizing Object (\hyperref[designspecificationairterminalsizing]{DesignSpecification:AirTerminal:Sizing}) then the natural ventilation rate for that zone is scaled by the Fraction of Minimum Outdoor Air Flow value.

\paragraph{Air System Target Voz Ventilation Flow Rate {[}m3/s{]}}\label{air-system-target-voz-ventilation-flow-rate}
The sum of the target ventilation flow rates \(V_{oz-dyn}\) at standard density at the current timestep for each zone on the airloop. If any zone terminal unit has a Design Specification Air Terminal Sizing Object (\hyperref[designspecificationairterminalsizing]{DesignSpecification:AirTerminal:Sizing}) then the target ventilation rate for that zone is scaled by the Fraction of Minimum Outdoor Air Flow value.

\paragraph{Air System Ventilation Below Target Voz Time {[}hr{]}}\label{air-system-ventilation-below-target-voz-time}
The time that the airloop total ventilation rate (mechanical ventilation plus natural ventilation) is more than 1\% below the \emph{Zone Target Voz Ventilation Flow Rate}.

\paragraph{Air System Ventilation At Target Voz Time {[}hr{]}}\label{air-system-ventilation-at-target-voz-time}
The time that the airloop total ventilation rate (mechanical ventilation plus natural ventilation) is within 1\% of the \emph{Zone Target Voz Ventilation Flow Rate}.

\paragraph{Air System Ventilation Above Target Voz Time {[}hr{]}}\label{air-system-ventilation-above-target-voz-time}
The time that the airloop total ventilation rate (mechanical ventilation plus natural ventilation) is more than 1\% above the \emph{Zone Target Voz Ventilation Flow Rate}.

\paragraph{Air System Ventilation When Unoccupied Time {[}hr{]}}\label{air-system-ventilation-when-unoccupied-time}
The time that the airloop total ventilation rate (mechanical ventilation plus natural ventilation) is greater than zero when all of the zones on the airloop are unoccupied.



The example syntax below shows the basic ventilation flow variables reported on an hourly basis.

\begin{itemize}
Expand All @@ -177,6 +227,38 @@ \subsubsection{Outputs}\label{outputs-1-001}
Output:Variable,*,Zone Mechanical Ventilation Current Density Volume,Hourly;
\item
Output:Variable,*, Zone Mechanical Ventilation Air Changes per Hour,Hourly;
\item
Output:Variable,*, Zone Target Voz Ventilation Flow Rate,Hourly;
\item
Output:Variable,*, Zone Ventilation Below Target Voz Time,Hourly;
\item
Output:Variable,*, Zone Ventilation At Target Voz Time,Hourly;
\item
Output:Variable,*, Zone Ventilation Above Target Voz Time,Hourly;
\item
Output:Variable,*, Zone Ventilation When Unoccupied Time,Hourly;
\item
Output:Variable,*, Facility Any Zone Ventilation Below Target Voz Time,Hourly;
\item
Output:Variable,*, Facility All Zones Ventilation At Target Voz Time,Hourly;
\item
Output:Variable,*, Facility Any Zone Ventilation Above Target Voz Time,Hourly;
\item
Output:Variable,*, Facility Any Zone Ventilation When Unoccupied Time,Hourly;
\item
Output:Variable,*, Air System Mechanical Ventilation Flow Rate,Hourly;
\item
Output:Variable,*, Air System Natural Ventilation Flow Rate,Hourly;
\item
Output:Variable,*, Air System Target Voz Ventilation Flow Rate,Hourly;
\item
Output:Variable,*, Air System Ventilation Below Target Voz Time,Hourly;
\item
Output:Variable,*, Air System Ventilation At Target Voz Time,Hourly;
\item
Output:Variable,*, Air System Ventilation Above Target Voz Time,Hourly;
\item
Output:Variable,*, Air System Ventilation When Unoccupied Time,Hourly;
\end{itemize}

\paragraph{Ventilation Load Reports}\label{ventilation-load-reports}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -172,6 +172,27 @@ \subsubsection{Predefined Annual Summary Reports}\label{predefined-annual-summar
Minimum Outside Air During Occupied Hours table shows for each zone the average and nominal number of occupants, the zone volume, the minimum air change rate based on mechanical ventilation, infiltration and simple ventilation during occupied hours.
\end{itemize}
\paragraph{Outdoor Air Details}\label{outdoor-air-details}
The Outdoor Air Details report (key: OutdoorAirDetails) produces a report that includes the following tables:
\begin{itemize}
\item
Mechanical Ventilation Parameters by Zone table shows for each zone the average and nominal number of occupants, the zone volume and area, the design outdoor air flow rate \(V_{oz}\) and the minimum dynamic target ventilation flow rate \(V_{oz-dyn-min}\).
\item
Total Outdoor Air by Zone table shows for each zone the total mechanical ventilation, natural ventilation, total ventilation (mechanical plus natural), infiltration, total ventilation plus infiltration, dynamic target ventilation \(V_{oz-dyn}\), the time when total ventilation is below, at, or above \(V_{oz-dyn}\), and the time ventilation is provided when the zone is unoccupied.
\item
Average Outdoor Air During Occupancy by Zone - Flow Rates table shows for each zone the average flow rates when the zone is occupied for mechanical ventilation, natural ventilation, total ventilation (mechanical plus natural), infiltration, total ventilation plus infiltration, dynamic target ventilation \(V_{oz-dyn}\) and the time when total ventilation is below, at, or above \(V_{oz-dyn}\).
\item
Total Outdoor Air by AirLoop table shows for each airloop the total mechanical ventilation, natural ventilation, total ventilation (mechanical plus natural), sum of the zone dynamic target ventilation \(V_{oz-dyn}\), the time when total ventilation is below, at, or above \(V_{oz-dyn}\), and the time ventilation is provided when all zones are unoccupied.
\item
Average Outdoor Air During Occupancy by AirLoop table shows for each airloop the average flow rates when any zone on the airloop is occupied for mechanical ventilation, natural ventilation, total ventilation (mechanical plus natural), sum of the zone dynamic target ventilation \(V_{oz-dyn}\), and the time when total ventilation is below, at, or above \(V_{oz-dyn}\).
\item
Times for Outdoor Air Limiting Factors During Occupancy table shows for each airloop the time when any zone on the airloop is occupied and various limiting factors control the mechanical ventilation flow rate: no limiting factor, economizer operation, demand controlled ventilation, exhaust flow, high humidity economizer control, night ventilation, limits and scheduled limits, demand limiting, and energy management system override.
\item
Average Outdoor Air For Each Outdoor Air Limiting Factors During Occupancy table shows for each airloop the average mechanical ventilation flow rates when any zone on the airloop is occupied and various limiting factors control the mechanical ventilation flow rate: no limiting factor, economizer operation, demand controlled ventilation, exhaust flow, high humidity economizer control, night ventilation, limits and scheduled limits, demand limiting, and energy management system override.
\end{itemize}
\paragraph{System Summary}\label{system-summary}
The System Summary Report (key: SystemSummary) produces a report that includes the following tables:
Expand Down
Loading

1 comment on commit 35dbafc

@nrel-bot-3
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

develop (Myoldmopar) - x86_64-MacOS-10.15-clang-11.0.0: OK (2316 of 2316 tests passed, 0 test warnings)

Build Badge Test Badge

Please sign in to comment.