Results Viewer

Temporary help page for early beta Results Viewer v0.9

The Results Viewer is a separate application which can be used to view EnergyPlus results stored in one or more eso files. It can be downloaded from the Beta test Download area of the DesignBuilder website. When installed the application allows you to view any results contained within EnergyPlus eso results files. There are 3 ways to open eso results files:

Double-click on an eso file when in Windows Explorer.
From within the Results Viewer use the File > Open eso/data set menu command
By making the appropriate selection on the Program options DesignBuilder will offer to open the eso file at the end of the simulation.

Multiple eso files can be opened at a time. Use the combo box below the toolbar to select the current results set for plotting.

With an eso file open the first view will be something like that shown below.

Note: Although the Results Viewer is still under development and the toolbar icons are not yet included, we are offering it for general use because we believe that DesignBuilder users will find the ability to view HVAC node conditions useful in their work.

Display Results

To show results for a particular interval use the Frequency drop list to select the interval.

Sorting the Reports can be a useful way to help find particular data and can be acheived by clicking on the column headers. For example to see data sorted by "Area" click on the Area header. This will collect together all data for each zone, HVAC component, Environment etc in the list.

To plot a report on a graph use one of these methods:

Select one of the toolbar options Add selected row to current graph or Add selected row to new graph.
Right-click on the item in the grid and select the Add selected row to new graph menu option to add the report to a new graph.
Double-clicking on the report in the grid will add it to the current graph (or if no graph exists it creates a new graph and adds it).

Selecting a graph

If you have more than 1 graph set up you can select the current graph simply by clicking on it. You will see the graph heating highlight in a different blue when selected as shown below.

Menu Commands

You can access a range of options from the toolbar and right-click context menus:

Display grid

Display the data as a grid instead of a graph.

Display graph

Display the data as a graph instead of a grid.

Save grid to CSV

Allows you to save the data as a comma separated values file for loading into a spreadsheet for further analysis.

Copy graphs to another frequency

If you have generated similar data for multiple frequencies then use this tool to use settings for the current frequency and display the same reports using a different frequency.

Change main title

Change the text to be used for the main title for all graphs

Rename graph title

Allows you to change the title for the currently selected graph. To change the name of the current graph right-click on the graph and from the DesignBuilder Options, select the Rename graph title option. Enter the title for the graph in the dialog and press OK.

Remove selected graph

Deletes the current graph. Any data displayed in the graph is unaffected.

Cross hair on/off

Checking this option displayed a cross hair which allows you to create a vertical and horizontal line when you click on a data point. It can be useful to check simultaneous values for a range of reports.

Loading multiple Data sets

You can load as many data sets as required to a single Results Viewer session by using the Open eso/drb menu or toolbar option. A list is maintained of all data sets currently opened in the drop list at the top of the window.

When you have more than one data set open it usually helps to Include the dataset name in the legend. This can be done from the Options dialog.

Options Dialog

The Options dialog is accessed from the Results Viewer Tools top menu option.

Autosave session

Select this option if you would like the session to be saved automatically when closing the Results Viewer.

Display a title for each graph

Selecting this option causes the title of each graph to be displayed for each graph as shown in highlighted areas in the graph below.

To change the name of the current graph right-click on the graph and from the DesignBuilder Options, select the Rename graph title option. Enter the title for the graph in the dialog and press OK.

Include dataset name in legend

If you have more than one data set loaded then you should usually select this option to ensure that the data set name is included in the legend. This can help when comparing results for different simulations.

The output above shows how the dataset name is added to each legend.

Include folder name in dataset name

If you include the dataset name in the legend then do you want the folder name included too? If so check this option. This option is only usually used when the result sets are stored in files with the same name but in different folders.

Zooming

In some cases you may find that too much data is displayed on the X-axis at one time and you need to focus on a section (time period) of the results graph. You can use the mouse to do this simply by dragging a time region of interest. This allows you to zoom in on data for particular days.

To return back to the original "unzoomed" state, choose the Undo zoom right-click menu option.

Sessions

It can take some time to load eso files and to select results so DesignBuilder provides methods to save pre-processed results files and session files to speed loading and setting up reports the next time.

drb results files

When the Results Viewer loads an eso file it automatically generates a drb file with exactly the same data but in a form that can be loaded much more quickly. If you need to view the results again in future you can open the drb file instead of the eso file.

The drb file will have the same filename as the original eso file (apart from the extension). It does not contain any display settings - just the data.

drs results files

You can also save a session file which stores all of your display settings for a graphing session as well as a link to the corresponding drb file(s). Opening the session file will take you back to where you were before saving the session file.

Program options settings

You can configure DesignBuilder to save eso files in various ways as described for the EnergyPlus tab of the Program options. If you plan to use the Results Viewer in favour of the inbuilt DesignBuilder results display then you might use one of the settings configurations below:

	The default option where the eso file is automatically generated and named as eplusout.eso in the DesignBuilder EnergyPlus folder. This eso file will be overwritten each time a simulation or design calculation is run. The eplusout.eso file is automatically loaded to DesignBuilder after the simulation. You may wish to avoid this option if you have generated very large hourly or sub-hourly data sets which could cause long delays or a program crash if loaded.
	The eso file is automatically generated and named and an option provided to open it in the Results viewer. The results data is not automatically loaded to DesignBuilder, which might be a usual option to avoid very large hourly or sub-hourly data sets from being loaded.
	The eso file is automatically generated and you are prompted for a filename for the eso file and asked if you would like to open it in the Results viewer. The results data is not automatically loaded to DesignBuilder, which might be a usual option to avoid very large hourly or sub-hourly data sets from being loaded.
	The eso file is automatically generated and you are prompted for a filename for the eso file and asked if you would like to open it in the Results viewer. The results data is also loaded to DesignBuilder for your convenience. You may wish to avoid this option if you have generated very large hourly or sub-hourly data sets which could cause long delays or a program crash if loaded.