Merge branch 'develop' of https://github.com/NREL/EnergyPlus into #6028…

…-PTAC-heating-coil-undersized-for-ventilation-load-when-zone-design-heating-load-is-zero
NREL · Aug 25, 2017 · 4a9fe52 · 4a9fe52 · nrel-bot-3 · Aug 25, 2017
2 parents 780ff25 + 8bc0338
commit 4a9fe52
Show file tree

Hide file tree

Showing 676 changed files with 1,504 additions and 1,370 deletions.
diff --git a/CMakeLists.txt b/CMakeLists.txt
@@ -9,10 +9,10 @@ endif()
 set( CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/cmake" ${CMAKE_MODULE_PATH} )
 
 set( CMAKE_VERSION_MAJOR 8 )
-set( CMAKE_VERSION_MINOR 7 )
+set( CMAKE_VERSION_MINOR 8 )
 set( CMAKE_VERSION_PATCH 0 )
 
-set( PREV_RELEASE_SHA "198c6a3" )
+set( PREV_RELEASE_SHA "78a111d" )
 
 set( ENERGYPLUS_VERSION "${CMAKE_VERSION_MAJOR}.${CMAKE_VERSION_MINOR}.${CMAKE_VERSION_PATCH}" )
 

diff --git a/cmake/Install.cmake b/cmake/Install.cmake
@@ -136,16 +136,16 @@ INSTALL( DIRECTORY testfiles/ DESTINATION ExampleFiles/
 
 # TODO Remove version from file name or generate
 # These files names are stored in variables because they also appear as start menu shortcuts later.
-set( RULES_XLS Rules8-6-0-to-8-7-0.md )
+set( RULES_XLS Rules8-7-0-to-8-8-0.md )
 install(FILES "${CMAKE_SOURCE_DIR}/release/Bugreprt.txt" DESTINATION "./")
 install(FILES "${CMAKE_SOURCE_DIR}/release/ep.gif" DESTINATION "./")
 install(FILES "${CMAKE_SOURCE_DIR}/release/readme.html" DESTINATION "./")
 install(FILES "${CMAKE_SOURCE_DIR}/src/Transition/InputRulesFiles/${RULES_XLS}" DESTINATION "./")
-install(FILES "${CMAKE_SOURCE_DIR}/src/Transition/OutputRulesFiles/OutputChanges8-6-0-to-8-7-0.md" DESTINATION "./")
+install(FILES "${CMAKE_SOURCE_DIR}/src/Transition/OutputRulesFiles/OutputChanges8-7-0-to-8-8-0.md" DESTINATION "./")
 install(FILES "${CMAKE_SOURCE_DIR}/bin/CurveFitTools/IceStorageCurveFitTool.xlsm" DESTINATION "PreProcess/HVACCurveFitTool/")
-install(FILES "${CMAKE_SOURCE_DIR}/src/Transition/SupportFiles/Report Variables 8-6-0 to 8-7-0.csv" DESTINATION "PreProcess/IDFVersionUpdater/")
-install(FILES "${CMAKE_SOURCE_DIR}/idd/V8-6-0-Energy+.idd" DESTINATION "PreProcess/IDFVersionUpdater/")
-install( FILES "${CMAKE_RUNTIME_OUTPUT_DIRECTORY}/Energy+.idd" DESTINATION "PreProcess/IDFVersionUpdater/" RENAME "V8-7-0-Energy+.idd" )
+install(FILES "${CMAKE_SOURCE_DIR}/src/Transition/SupportFiles/Report Variables 8-7-0 to 8-8-0.csv" DESTINATION "PreProcess/IDFVersionUpdater/")
+install(FILES "${CMAKE_SOURCE_DIR}/idd/V8-7-0-Energy+.idd" DESTINATION "PreProcess/IDFVersionUpdater/")
+install( FILES "${CMAKE_RUNTIME_OUTPUT_DIRECTORY}/Energy+.idd" DESTINATION "PreProcess/IDFVersionUpdater/" RENAME "V8-8-0-Energy+.idd" )
 
 if( WIN32 )
   # calcsoilsurftemp is now built from source, just need to install the batch run script

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
@@ -2401,6 +2401,7 @@ \subsection{Surface Output Variables/Reports}\label{surface-output-variablesrepo
 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]
+Zone,Average,Surface Construction Index []
 \end{lstlisting}
 
 Output variables applicable to all exterior heat transfer surfaces:
@@ -2725,6 +2726,18 @@ \subsubsection{Surface Inside Face Absorbed Shortwave Radiation Rate {[}W{]}}\la
 
 As of Version 2.1, the previous variable plus absorbed shortwave radiation from uniformly distributed initially-reflected diffuse solar, reflected beam solar, and shortwave radiation from lights. This sum is the power of all sources of solar and visible radiation absorbed by the surface at the inside face.
 
+\subsubsection{Surface Construction Index {[]}}\label{surface-construction-index}
+
+The variable reports an index that points to specific Construction. The variable is an additional output variable when Output:Diagnostics, DisplayAdvancedReportVariables; is given in an input file.
+
+In order to find a corresponding construction using the index, following steps are suggested:
+
+1. Find a surface name from Surface Construction Index in the .csv file
+
+2. Search the surface name in lines starting with HeatTransfer Surface in the .eio file
+
+3. The seventh item is the construction name with matched surface name. 
+
 \subsection{Surface Output Variables (exterior heat transfer surfaces)}\label{surface-output-variables-exterior-heat-transfer-surfaces}
 
 \subsubsection{Surface Outside Face Outdoor Air Drybulb Temperature {[}C{]}}\label{surface-outside-face-outdoor-air-drybulb-temperature-c}

diff --git a/doc/title.tex.in b/doc/title.tex.in
@@ -3,7 +3,7 @@
 \makeatletter
 \begin{titlepage}
   \begin{center}
-    {\scshape\LARGE EnergyPlus\texttrademark{} Version 8.7 Documentation \par}
+    {\scshape\LARGE EnergyPlus\texttrademark{} Version ${CMAKE_VERSION_MAJOR}.${CMAKE_VERSION_MINOR}.${CMAKE_VERSION_PATCH} Documentation \par}
     \vspace{1.5cm}
     {\bfseries\huge \@title \par}
     \vspace{1.5cm}
@@ -18,7 +18,7 @@
     {\large Build: ${CMAKE_VERSION_BUILD} \par}
   \end{center}
   {\small
-COPYRIGHT (c) 1996-2016 THE BOARD OF TRUSTEES OF THE UNIVERSITY OF ILLINOIS AND THE REGENTS OF THE UNIVERSITY OF CALIFORNIA THROUGH THE ERNEST ORLANDO LAWRENCE BERKELEY NATIONAL LABORATORY. ALL RIGHTS RESERVED. NO PART OF THIS MATERIAL MAY BE REPRODUCED OR TRANSMITTED IN ANY FORM OR BY ANY MEANS WITHOUT THE PRIOR WRITTEN PERMISSION OF THE UNIVERSITY OF ILLINOIS OR THE ERNEST ORLANDO LAWRENCE BERKELEY NATIONAL LABORATORY. ENERGYPLUS IS A TRADEMARK OF THE US DEPARTMENT OF ENERGY.
+COPYRIGHT (c) 1996-\the\year THE BOARD OF TRUSTEES OF THE UNIVERSITY OF ILLINOIS AND THE REGENTS OF THE UNIVERSITY OF CALIFORNIA THROUGH THE ERNEST ORLANDO LAWRENCE BERKELEY NATIONAL LABORATORY. ALL RIGHTS RESERVED. NO PART OF THIS MATERIAL MAY BE REPRODUCED OR TRANSMITTED IN ANY FORM OR BY ANY MEANS WITHOUT THE PRIOR WRITTEN PERMISSION OF THE UNIVERSITY OF ILLINOIS OR THE ERNEST ORLANDO LAWRENCE BERKELEY NATIONAL LABORATORY. ENERGYPLUS IS A TRADEMARK OF THE US DEPARTMENT OF ENERGY.
   }
 \end{titlepage}
 \makeatother

diff --git a/performance_tests/10zone1vav.idf b/performance_tests/10zone1vav.idf
@@ -8,7 +8,7 @@
 ! Title5= VisualDOE 5.0.0
 ! \group Simulation Parameters
 
-  Version,8.7;
+  Version,8.8;
 
   Building,
     Green Design Tools,      !- Name

diff --git a/performance_tests/20zone1vav.idf b/performance_tests/20zone1vav.idf
@@ -8,7 +8,7 @@
 ! Title5= VisualDOE 5.0.0
 ! \group Simulation Parameters
 
-  Version,8.7;
+  Version,8.8;
 
   Building,
     Green Design Tools,      !- Name

diff --git a/performance_tests/30zone1vav.idf b/performance_tests/30zone1vav.idf
@@ -8,7 +8,7 @@
 ! Title5= VisualDOE 5.0.0
 ! \group Simulation Parameters
 
-  Version,8.7;
+  Version,8.8;
 
   Building,
     Green Design Tools,      !- Name

diff --git a/performance_tests/40zone1vav.idf b/performance_tests/40zone1vav.idf
@@ -8,7 +8,7 @@
 ! Title5= VisualDOE 5.0.0
 ! \group Simulation Parameters
 
-  Version,8.7;
+  Version,8.8;
 
   Building,
     Green Design Tools,      !- Name

diff --git a/performance_tests/50zone1vav.idf b/performance_tests/50zone1vav.idf
@@ -8,7 +8,7 @@
 ! Title5= VisualDOE 5.0.0
 ! \group Simulation Parameters
 
-  Version,8.7;
+  Version,8.8;
 
   Building,
     Green Design Tools,      !- Name

diff --git a/performance_tests/60Zone1PVAV.idf b/performance_tests/60Zone1PVAV.idf
@@ -8,7 +8,7 @@
 ! Title5= VisualDOE 5.0.0
 ! \group Simulation Parameters
 
-  Version,8.7;
+  Version,8.8;
 
   Building,
     Green Design Tools,      !- Name

diff --git a/performance_tests/60Zone1VAV.idf b/performance_tests/60Zone1VAV.idf
@@ -8,7 +8,7 @@
 ! Title5= VisualDOE 5.0.0
 ! \group Simulation Parameters
 
-  Version,8.7;
+  Version,8.8;
 
   Building,
     Green Design Tools,      !- Name

diff --git a/performance_tests/60zone2PVAV.idf b/performance_tests/60zone2PVAV.idf
@@ -8,7 +8,7 @@
 ! Title5= VisualDOE 5.0.0
 ! \group Simulation Parameters
 
-  Version,8.7;
+  Version,8.8;
 
   Building,
     Green Design Tools,      !- Name

diff --git a/performance_tests/60zone3PVAV.idf b/performance_tests/60zone3PVAV.idf
@@ -8,7 +8,7 @@
 ! Title5= VisualDOE 5.0.0
 ! \group Simulation Parameters
 
-  Version,8.7;
+  Version,8.8;
 
   Building,
     Green Design Tools,      !- Name

diff --git a/performance_tests/60zone6PVAV.idf b/performance_tests/60zone6PVAV.idf
@@ -8,7 +8,7 @@
 ! Title5= VisualDOE 5.0.0
 ! \group Simulation Parameters
 
-  Version,8.7;
+  Version,8.8;
 
   Building,
     Green Design Tools,      !- Name

diff --git a/performance_tests/PipingSystem_Underground_FHX.idf b/performance_tests/PipingSystem_Underground_FHX.idf
@@ -53,7 +53,7 @@
 !****** SIMULATION CONTROLS ********************************
 !***********************************************************
 
-  Version,8.7;
+  Version,8.8;
 
   Building,
     FHX House,               !- Name

diff --git a/release/readme.html b/release/readme.html
@@ -1,35 +1,42 @@
 <!DOCTYPE html><html><head><meta charset="utf-8"><title>EnergyPlus README</title><style></style></head><body id="preview">
 <p><img src="ep.gif" alt="ep.gif (6134 bytes)"><br>
-Version 8.7.0<br>
-31 March 2017<br>
+Version 8.8.0<br>
+30 September 2017<br>
 <em>EnergyPlus is a trademark of the US Department of Energy.</em></p>
 <h1><a id="EnergyPlus_8"></a>EnergyPlus</h1>
 <h2><a id="What_it_is_What_it_is_not_10"></a>What it is, What it is not</h2>
 <p>EnergyPlus is a simulation program designed for modeling buildings with all their associated heating, cooling, lighting, ventilating, and other energy flows. EnergyPlus is a stand-alone simulation engine without a ‘user friendly’ graphical interface . . . EnergyPlus reads input and writes output as text files.</p>
 <p>Utilities and tools for creating, editing, and running input files that come with EnergyPlus include IDF Editor and EP-Launch. Many graphical user interfaces for EnergyPlus are available or under development. For the latest tools, please see <a href="https://energyplus.net/interfaces">this EnergyPlus website for third party interfaces</a>.</p>
 <p>A number of third-party tools are available to create EnergyPlus input files (IDF). For the latest tools, please see <a href="https://energyplus.net/input-files">this EnergyPlus website for third party IDF creation tools</a>. Some of these may produce out of date IDF files; you can then use the IDFVersionUpdater program to convert older files to current EnergyPlus version (you may need to use the Multiple Version Conversions set – see below.</p>
-<h2><a id="Whats_going_on_in_V86_18"></a>What’s going on in V8.7?</h2>
-<p>Will there be any considerable difference between version 8.6 and 8.7?</p>
+<h2><a id="Whats_going_on_in_V86_18"></a>What’s going on in V8.8?</h2>
+<p>Will there be any considerable difference between version 8.7 and 8.8?</p>
 <ul>
 <li>Yes… and no. The basic structure of EnergyPlus is still as it has been but there are some significant changes that you will want to be aware of. As always, there are a number of new features and bug fixes. The highlights of features for this version are listed below—see <a href="https://github.com/NREL/EnergyPlus/releases/latest">EnergyPlus Features Page</a> for a complete list of new features added in this and previous versions.</li>
 </ul>
 <p>How about IDF and IDD? Do they remain unchanged?</p>
 <ul>
-<li>There are a few key changes in the V8.7 IDD. For best results, use the transition program to transfer from the earlier V8.6 files. Use the IDFVersionUpdater program for best results.</li>
+<li>There are a few key changes in the V8.8 IDD. For best results, use the transition program to transfer from the earlier V8.7 files. Use the IDFVersionUpdater program for best results.</li>
 </ul>
-<p>Is version 8.7 backward compatible? Can I run v8.6 file in v8.7?</p>
+<p>Is version 8.8 backward compatible? Can I run v8.7 file in v8.8?</p>
 <ul>
 <li>
-<p>There have been changes in the following objects which require conversion. Either read and follow the Rules spreadsheet or use the IDFVersionUpdater utility. The “Rules” spreadsheet that contains information on exact object changes that you can do by hand. The updater program is described more fully in the Auxiliary Programs document. For the v8.7 release, the following objects require conversion (from V8.6):</p>
+<p>There have been changes in the following objects which require conversion. Either read and follow the Rules spreadsheet or use the IDFVersionUpdater utility. The “Rules” spreadsheet that contains information on exact object changes that you can do by hand. The updater program is described more fully in the Auxiliary Programs document. For the v8.8 release, the following objects require conversion (from V8.7):</p>
 <ul>
+<li>AvailabilityManager:NightCycle</li>
+<li>ZoneControl:ContaminantController</li>
+<li>ZoneHVAC:IdealLoadsAirSystem</li>
+<li>Table:TwoIndependentVariables</li>
+<li>Output:Surfaces:List</li>
+<li>SurfaceProperty:ExposedFoundationPerimeter</li>
+<li>Foundation:Kiva:Settings</li>
+<li>UnitarySystemPerformance:Multispeed</li>
+<li>Coil:Cooling:DX:SingleSpeed</li>
+<li>Coil:Cooling:DX:TwoSpeed</li>
 <li>Coil:Cooling:DX:MultiSpeed</li>
-<li>Coil:Heating:DX:MultiSpeed</li>
-<li>CoolingTower:SingleSpeed</li>
-<li>CoolingTower:TwoSpeed</li>
-<li>CoolingTower:VariableSpeed:Merkel</li>
-<li>AirflowNetwork:SimlationControl</li>
-<li>ZoneCapacitanceMultiplier:ResearchSpecial</li>
-<li>WaterHeater:HeatPump:WrappedCondenser</li>
+<li>Coil:Cooling:DX:VariableSpeed</li>
+<li>Coil:Cooling:DX:TwoStageWithHumidityControlMode</li>
+<li>ZoneHVAC:PackagedTerminalHeatPump</li>
+<li>WindowMaterial:Blind:EquivalentLayer</li>
 </ul>
 </li>
 </ul>
@@ -44,7 +51,7 @@ <h2><a id="Documentation_55"></a>Documentation</h2>
 </ul>
 <h2><a id="Weather_Data_63"></a>Weather Data</h2>
 <p>A small subset of weather files that are available on the web site are also installed in the WeatherData folder. EnergyPlus uses these files directly for annual simulations. The Weather Converter program that is part of EnergyPlus can read these weather files and provide .csv (comma separated variable) as well as statistics reports about the included (or other) files.  Weather data for more than 2100 locations in more than 100 countries can be downloaded on the <a href="https://energyplus.net/weather">EnergyPlus Weather Page</a>.</p>
-<h2><a id="Highlights_of_this_release_V860_67"></a>Highlights of this release (V8.7.0)</h2>
+<h2><a id="Highlights_of_this_release_V860_67"></a>Highlights of this release (V8.8.0)</h2>
 <p>The highlights – improved and new features – are displayed by category.</p>
 <h3><a id="Core_changes_to_EnergyPlus_71"></a>Core changes to EnergyPlus</h3>
 <p>There were many bug fixes and new features added for this release.  Some new features were still added, check the installed changelog file for full details.</p>
@@ -54,26 +61,29 @@ <h3><a id="General_75"></a>General</h3>
 </ul>
 <h3><a id="Prominent_New_Features_79"></a>Prominent New Features</h3>
 <ul>
-<li><a href="https://github.com/NREL/EnergyPlus/pull/5705">#5705</a> : Modeling HVAC Operational Faults – Chiller Supply Water Temperature Sensor Offset</li>
-<li><a href="https://github.com/NREL/EnergyPlus/pull/5766">#5766</a> : Modeling HVAC Operational Faults (1) Condenser Supply Water Temperature Sensor Offset (2) Cooling Tower Scaling</li>
-<li><a href="https://github.com/NREL/EnergyPlus/pull/5786">#5786</a> : Modeling HVAC Operational Faults – Coil Supply Air Temperature Sensor Offset</li>
-<li><a href="https://github.com/NREL/EnergyPlus/pull/5901">#5901</a> : Add Kiva foundation heat transfer calculations</li>
-<li><a href="https://github.com/NREL/EnergyPlus/pull/6014">#6014</a> : New fan input object Fan:SystemModel</li>
-<li><a href="https://github.com/NREL/EnergyPlus/pull/6017">#6017</a> : Allow regular expressions as keys for Output:Variable</li>
-<li><a href="https://github.com/NREL/EnergyPlus/pull/5994">#5994</a> : ASHRAE 90.1 SZVAV control for Unitary Systems</li>
-<li><a href="https://github.com/NREL/EnergyPlus/pull/6021">#6021</a> : Include radiatitve heat transfer in airflow network ducts</li>
-<li><a href="https://github.com/NREL/EnergyPlus/pull/5943">#5943</a> : Variable Speed DX Coil Enhancements</li>
-<li><a href="https://github.com/NREL/EnergyPlus/pull/5740">#5740</a> : Fill Plant Equipment Autosizing Gaps</li>
-<li><a href="https://github.com/NREL/EnergyPlus/pull/5797">#5797</a> : Thermostat based on Adaptive Thermal Comfort Model</li>
-<li><a href="https://github.com/NREL/EnergyPlus/pull/5882">#5882</a> : Hybrid Zone Model</li>
-<li><a href="https://github.com/NREL/EnergyPlus/pull/5924">#5924</a> : Allow polygonal windows in AirflowNetwork</li>
+<li><a href="https://github.com/NREL/EnergyPlus/pull/5923">#5923</a> : Add tabular reporting capabilities inspired by Checksum report</li>
+<li><a href="https://github.com/NREL/EnergyPlus/pull/6087">#6087</a> : Enhanced Phase Change Material Simulation</li>
+<li><a href="https://github.com/NREL/EnergyPlus/pull/6103">#6103</a> : Enhance Proportional Demand Control Ventilation (DCV)</li>
+<li><a href="https://github.com/NREL/EnergyPlus/pull/6104">#6104</a> : Allow multiple solvers to find a root in HVAC system simulations</li>
+<li><a href="https://github.com/NREL/EnergyPlus/pull/6108">#6108</a> : Allow up to 10 speeds in UnitarySystemPerformance:Multispeed</li>
+<li><a href="https://github.com/NREL/EnergyPlus/pull/6114">#6114</a> : Glazing enhancements - input glazing properties as a function of incident angle</li>
+<li><a href="https://github.com/NREL/EnergyPlus/pull/6134">#6134</a> : Allow Min/Max Temperature control variable for Outdoor Air Reset SetPointManager</li>
+<li><a href="https://github.com/NREL/EnergyPlus/pull/6150">#6150</a> : Update LEED Summary Report</li>
+<li><a href="https://github.com/NREL/EnergyPlus/pull/6158">#6158</a> : Add user input for DX cooling coil low ambient temp cutout</li>
+<li><a href="https://github.com/NREL/EnergyPlus/pull/6179">#6179</a> : Add option to AvailabilityManager:NightCycle to run just until the zone temperature recovers</li>
+<li><a href="https://github.com/NREL/EnergyPlus/pull/6188">#6188</a> : Enable Building Rotation, Movement, and a Water Boundary Condition</li>
+<li><a href="https://github.com/NREL/EnergyPlus/pull/6210">#6210</a> : Allow AirloopHVAC:ReturnPlenum to be used with Ideal Loads Air System</li>
+<li><a href="https://github.com/NREL/EnergyPlus/pull/6223">#6223</a> : Add DesignSpecification:OutdoorAir field and control to terminal units and fix DOA airflow distribution to ZoneHVAC units</li>
+<li><a href="https://github.com/NREL/EnergyPlus/pull/6227">#6227</a> : Improving Building Energy Simulation in an Urban Context</li>
+<li><a href="https://github.com/NREL/EnergyPlus/pull/6248">#6248</a> : Add air terminal unit sizing option, allow air loops with no return path, and partially allow multiple air loops serving the same zone</li>
+<li><a href="https://github.com/NREL/EnergyPlus/pull/6252">#6252</a> : Add a new field of Per Person Ventilation Rate Mode to AirTerminal:SingleDuct:Uncontrolled and AirTerminal:SingleDuct:Mixer</li>
 </ul>
 <h3><a id="Platforms_90"></a>Platforms</h3>
 <ul>
 <li>Windows 7 &amp; 8</li>
 <li>Linux (Ubuntu 14.04 and compatible) 64 bit versions; (32-bit and RHEL-compatible versions may be available via Helpdesk)</li>
 <li>Mac OSX 10.9 64 bit versions</li>
-<li>EnergyPlus V8.6 has been tested on all of these platforms</li>
+<li>EnergyPlus V8.8 has been tested on all of these platforms</li>
 <li><em>EnergyPlus does intensive computations, and based on configuration, can write massive amounts of data to disk. For best performance, computers should have a ubstantial amount of memory and high speed hard drives.</em></li>
 </ul>
 <p>And many other enhancements throughout.</p>