The ResultsReader API has many references to variables and variable levels. This section will explain Variables and their details a bit further.
Variables have 2 names:
- an internal name which is used in the APS file. Pass this name to the various reading APIs that are part of the ResultsReader class
- a display name, which is shown in Vista / VistaPro. Attempting to read this from an APS will result in an error.
The variable level (also known as model level flag) is represented by a single character as shown in the table below, together with the corresponding API for reading the data.
Surface level results are available only for those rooms that have detailed output switched on for a surface-level result (Apache Simulation output options: Surface temperatures, External / internal incident solar flux)
Opening level results are available only if Macroflo was included in simulation
.
For more information on reading APS data, and information on how to map a Vista / VistaPro display string to a variable, see the sample on reading APS data.