Sustainability & Risk/ Energy

Energy Application: Error Messages

The Energy Management application performs a series of complex calculations that are dependent on the quality of the data entered into the system. In some cases, the quality is related to the information you are entering, such as bill information, but it can also be related to other factors over which you have less control.

For example:

You cannot control the correlation of your energy bill data to the weather model. Your bill data may be accurately entered, but may not correlate well with weather conditions for the selected weather station. This may cause insufficient data for the regression analysis.
There may be data missing from the NOAA data feed.

To help you understand these errors, when debug is turned on, the code logs the result of these anomalous conditions to the log file.

The following table describes the error messages and the warnings you might receive.

Log Messages	Description
Errors
"Error while attempting to calculate balance point, defaulting it to 60."	This error might appear when the application finds insufficient billing or weather data, or an error in the data used to automatically calculate the heating/cooling balance point for a building. In the event of such an error, the application will set the auto-calculated balance point to the default value of 60 degrees Fahrenheit. Ensure that you have at least a year's worth of billing and weather data. If that data exists, consider whether factors other than weather are significantly affecting energy consumption.
"Matrix is singular. Cannot continue regression."	In the unlikely event this message appears, the application will have attempted to perform a regression analysis of data that would result in an irrecoverable math error. Typically, other errors and data tests will warn of problems before this would appear. Factors most likely to influence the appearance of this error include alterations of constants in the java code that determine series size, and other parameters governing the inputs to the regression analysis.
Warnings
"WARN: No service period found for building: [ bl_id ]."	The application has attempted to update weather model data for a building that has no bill data. The routine continues the operation, but will not provide results for the named building. Ensure that bill data is entered for the building before running Update Weather Model Calculations from the Update Calculations task. Or, if you have no bill data, you may optionally remove the weather station assignment from the building and the warning will no longer appear in the log.
"WARN: No data type defined for model. Building = [ bl_id ]. Service start date = [ date_start ]."	No recognized data type (for example, electric demand or gas consumption) exists for the listed building and service period start date. The application will not be able to perform the requested analysis over that time period. The units selected for the bill line do not correlate with units expected by the Java code. For weather model calculations, the bill's bill type and the building’s (bl table record) heating or cooling utility type must be “ELECTRIC”, “GAS – NATURAL”, or “GAS - PROPANE” . These are the only utility types recognized by the out-of the-box code. If you want to do other types of analysis, you would need to modify the code.
"WARN: Invalid regression parameter. Parameter = [ value ]."	The application has encountered a parameter for regression for which it has no guidelines to handle. Data details to help troubleshooting appear in the message.
"WARN: Update Weather Station All List current iteration: [ number ]."	This message does not necessarily indicate a problem, but provides feedback via archibus.log while the application retrieves data from an external resource via ftp.
"WARN: JSON entry for weather station id : [ weather station id ] not found."	The application is unable to find provider data for the Weather Station ID associated with one or more buildings. This may indicate an error in the building's weather station value, or in the entry for the weather agency providing data. This error might have been introduced, for example, through manual entry, or by using building data imports that did not use the forms and methods designed for data import in Web Central, thus opening the possibility of invalid values. Look for instance(s) of the Weather Station ID in the Buildings table, and check to see that both it and the weather source value is correct. Consider assigning a different weather station to the building.
"WARN: Error performing regression, setting result to null."	This warning may appear in response to any of several conditions that prevent valid results for regression analysis of a given data series. If any series data exists, the log will include it at the end to facilitate debugging.
"WARN: Error attempting to calculate outlier. " [Optionally also] "First record of data series: [ series ]"	The application encountered an error when attempting to calculate an outlier among the input data points. If available, the application will report the data series at which the problem occurred. The application continues to progress to evaluate the next available series, and this message may appear multiple times in the log.