ResultsViewer | Getting Started

ResultsViewer displays EnergyPlus output in formats that are more useful than those available directly from the EnergyPlus engine. This application was originally developed to support the needs of researchers at the National Renewable Energy Laboratory, who frequently use detailed EnergyPlus outputs to understand the intricacies of building systems.

ResultsViewer displays time series results, which are produced from EnergyPlus report variable requests. ResultsViewer reads the sqlite database output of the EnergyPlus engine and presents the time series data in line and two-dimensional flood plots. It also displays the html output of EnergyPlus in an internal browser window. ResultsViewer is still an immature product; it will be refined further and results viewing capabilities will be added. 

Quick Start

  1. Request SQLite database output from EnergyPlus (EnergyPlus version 5.0.0 or newer must be used). Include one of the following lines in the idf file:

    Output:SQLite, Simple;

    -or-

    Output:SQLite, SimpleAndTabular;
     
  2. Choose either Simple or SimpleAndTabular. (ResultsViewer does not use tabular data.) Once the database output is requested, all report variable and meter requests will be output to the database. These can be viewed in ResultsViewer.
  3. Click File->Open and browse to an eplusout.sql file in the EnergyPlus output folder. ResultsViewer is packaged with an example file that can be used to explore the software's capabilities; running EnergyPlus is not necessary.
  4. Examine output variables on either of two main views, table view or tree view, on the left.
  5. To plot an item, right click for a context menu or double click for a line plot.
  6. Drag items from each view onto a plot. In a line plot, the data will be added as an additional curve. In a flood plot, the data will be replaced with the dragged item.