Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

New Outdoor Air Details report #8529

Merged
merged 77 commits into from
Feb 19, 2021
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
77 commits
Select commit Hold shift + click to select a range
59114ba
Initial NFP file
JasonGlazer Nov 13, 2019
4c63912
Initial proposed content
JasonGlazer Nov 13, 2019
8b26888
Updated NFP
JasonGlazer Nov 20, 2019
5a97b6c
Merge branch 'develop' into EnhanceOutdoorAirReporting
JasonGlazer Dec 17, 2019
b632fb8
NFP including changes in response to comments received
JasonGlazer Jan 2, 2020
70e13b2
Merge branch 'develop' into EnhanceOutdoorAirReporting
JasonGlazer Jan 23, 2020
243e627
Another update to NFP
JasonGlazer Jan 23, 2020
520ce8a
Merge branch 'develop' into EnhanceOutdoorAirReporting
JasonGlazer Jan 30, 2020
f6e1312
Merge branch 'EnhanceOutdoorAirReporting' of https://github.com/NREL/…
JasonGlazer Jan 30, 2020
da53323
Changed heading "Dynamic Zone Outdoor Airflow - Voz-dyn" to "Dynamic …
JasonGlazer Jan 30, 2020
0ae002b
Merge branch 'develop' into EnhanceOutdoorAirReporting
JasonGlazer Mar 27, 2020
11c3aaa
Initial predefined report variables and column headings
JasonGlazer Mar 27, 2020
fc7d24f
Implement occupant reporting
JasonGlazer Apr 3, 2020
52763c5
Merge branch 'develop' into EnhanceOutdoorAirReporting
JasonGlazer Apr 3, 2020
6f24b04
Mark columns that need to be completed.
JasonGlazer Apr 3, 2020
c8c66a9
Merge branch 'develop' into EnhanceOutdoorAirReporting
JasonGlazer Apr 9, 2020
6e65e11
Add airloop name(s) to each zone row.
JasonGlazer Apr 10, 2020
2dd9928
Reorg new code.
JasonGlazer Apr 10, 2020
fd1a677
Updated NFP to include design documentation.
JasonGlazer Apr 16, 2020
584c793
Fix typo
JasonGlazer Apr 16, 2020
c069a9b
Merge branch 'develop' into EnhanceOutdoorAirReporting
JasonGlazer Apr 30, 2020
2561548
Add Voz for mech vent param table
JasonGlazer May 4, 2020
5187094
Adding some total rows.
JasonGlazer May 4, 2020
448a365
Restructure to not show plenum
JasonGlazer May 4, 2020
bad63ef
Merge branch 'develop' into EnhanceOutdoorAirReporting
JasonGlazer May 5, 2020
bca6f44
Implement Minimum Dynamic Target Ventilation - Voz-dyn-min column
JasonGlazer May 6, 2020
0b75938
Continued work on Total Outdoor Air by Zone subtable
JasonGlazer May 7, 2020
91b152d
Rename variables for clarity and add total rows for some new columns
JasonGlazer May 7, 2020
55ce999
Switch to using standard air density instead of current air density
JasonGlazer May 8, 2020
134b8f6
Merge branch 'develop' into EnhanceOutdoorAirReporting
JasonGlazer May 11, 2020
f62ad1e
Remove old tables
JasonGlazer May 11, 2020
0b4da6f
Related to calculated Voz
JasonGlazer May 13, 2020
0c3d016
Merge branch 'develop' into EnhanceOutdoorAirReporting
JasonGlazer May 13, 2020
84beb29
Merge branch 'develop' into EnhanceOutdoorAirReporting
JasonGlazer Jun 10, 2020
fa1ec06
More fixes from merge conflict.
JasonGlazer Jun 10, 2020
2f9ba36
Merge remote-tracking branch 'remotes/origin/develop' into EnhanceOut…
mjwitte Jul 6, 2020
5133ca3
AFN global data
mjwitte Jul 6, 2020
149a2c0
Add air distribution calculateEz function
mjwitte Jul 6, 2020
e7b6a66
Revert using calculateEz in CalcMechVentController
mjwitte Jul 7, 2020
60ee56d
Merge remote-tracking branch 'remotes/origin/develop' into EnhanceOut…
mjwitte Jul 7, 2020
4dd38f2
OA Report unit test fixes
mjwitte Jul 7, 2020
c8a5672
Merge branch 'develop' into EnhanceOutdoorAirReporting
JasonGlazer Jul 27, 2020
bb3b8df
Merge remote-tracking branch 'remotes/origin/develop' into EnhanceOut…
mjwitte Dec 8, 2020
b513ed2
OA Report - merge cleanup
mjwitte Dec 9, 2020
9d04482
Merge remote-tracking branch 'remotes/origin/develop' into EnhanceOut…
mjwitte Jan 5, 2021
b2dbd16
OA Report - merge repairs
mjwitte Jan 5, 2021
9658c26
OA Report - more merge repairs
mjwitte Jan 5, 2021
e8a60f7
Merge remote-tracking branch 'remotes/origin/develop' into EnhanceOut…
mjwitte Jan 7, 2021
af8e15d
OA Report - fix build warnings
mjwitte Jan 18, 2021
34820d1
Merge remote-tracking branch 'remotes/origin/develop' into EnhanceOut…
mjwitte Jan 18, 2021
82eee65
OA Report - complete OA by zone tables - almost
mjwitte Jan 20, 2021
d3197b3
OA Report - complete OA by zone tables - and other cleanup
mjwitte Jan 22, 2021
7d379b9
Merge remote-tracking branch 'remotes/origin/develop' into EnhanceOut…
mjwitte Jan 28, 2021
57f3c33
OA Report - merge cleanup
mjwitte Jan 28, 2021
004a41a
OA Report - start airloop tables
mjwitte Jan 28, 2021
7e86fed
OA Report - unit test repairs
mjwitte Jan 29, 2021
233e9c2
Merge remote-tracking branch 'remotes/origin/develop' into EnhanceOut…
mjwitte Jan 29, 2021
112e7c6
OA Report - continue airloop tables
mjwitte Jan 30, 2021
46a0f66
Merge remote-tracking branch 'remotes/origin/develop' into EnhanceOut…
mjwitte Feb 2, 2021
1e1955d
Merge remote-tracking branch 'remotes/origin/develop' into EnhanceOut…
mjwitte Feb 11, 2021
b507609
Merge remote-tracking branch 'remotes/origin/develop' into EnhanceOut…
mjwitte Feb 11, 2021
0190e1f
OA Report - Change new report to OA Details and restore old report
mjwitte Feb 11, 2021
22046ab
Shorten Output:Table:SummaryReports from 83 field to 25 in the IDD
mjwitte Feb 11, 2021
1ba4beb
OA Report - fix failures and other cleanup
mjwitte Feb 12, 2021
d7529f9
OA Report - fix row order diffs in LEED summary
mjwitte Feb 12, 2021
ce50351
Merge remote-tracking branch 'remotes/origin/develop' into EnhanceOut…
mjwitte Feb 12, 2021
f774401
Merge remote-tracking branch 'remotes/origin/develop' into EnhanceOut…
mjwitte Feb 15, 2021
415f7bd
OA Report - really fix row order diffs in LEED summary
mjwitte Feb 15, 2021
584533e
OA Report - populate airloop subtables
mjwitte Feb 16, 2021
eb7f102
OA Report - IO reference
mjwitte Feb 17, 2021
13496df
OA Report - delete totals for airloop subtables and other cleanup
mjwitte Feb 17, 2021
0cc3832
Merge remote-tracking branch 'remotes/origin/develop' into EnhanceOut…
mjwitte Feb 17, 2021
2c2412b
OA Report - IO reference new output variables and some other cleanup
mjwitte Feb 18, 2021
2975ee1
OA Report - move implicit array inits to loops
mjwitte Feb 18, 2021
fc571df
OA Report - clean out unused variables
mjwitte Feb 18, 2021
ddbcf51
OA Report - correction and cleanup
mjwitte Feb 18, 2021
f14b842
OA Report - another correction
mjwitte Feb 18, 2021
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
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}
Copy link
Member

Choose a reason for hiding this comment

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

Lots of new ventilation outputs, OK.

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:
Copy link
Member

Choose a reason for hiding this comment

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

OK, so this is the section that describes the new tabular report, if the user enters the OutdoorAirDetails key. I was expecting to find a list of all the possible keys in this section which would need this key added, but I guess that's not here. Just in the IDD itself.


\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