Callout sets display a summary of information found in a graph, or a set of related statistics that helps contextualize a graph, in cards.
👍 This article will help you:
Learn about the variety of callout options in cards
Understand how callouts are calculated
In cards, select the Callouts field to change the callout set.
Callouts are driven, in part, by the selections you make for each card. For example, if you choose to divide by 'Area', then the values in the callouts will be normalized by area. Callouts are also flexible enough to provide options that don't rely on the other selections you make for each card. For example, you can choose 'Total this period, Total previous period, Difference' as the callout set without having to show the 'Previous period' overlay in the graph.
🚧 Choose the right callout set for the job
Callouts are designed to be flexible by nature. But not all callout sets are the right choice for every data type and metric. For example, a graph of electricity demand with 'Total, Min, Max' as the callout set will sum the interval demand readings for 'Total'. Instead, choose a callout set that averages the interval demand, like 'Average, Min, Max'.
General callouts
Callout set | Conditions & Notes |
None | Hides callouts below the graph. |
Total, Max | Sum of X and maximum value over the main period. |
Total, Min, Max | Sum of X, minimum value, and maximum value over the main period. |
Total, Peak demand | Sum of X and maximum 15-minute resolution peak demand value over the main period. |
Total this period, Total previous period, Difference | Sum of X over the main period and comparison period. |
Total this period, Total same period previous year, Difference | Sum of X over the main period and previous year comparison period. |
Total this period, Average temperature | Sum of X and average temperature over the main period. |
Total this period, Heating degree days | Sum of X and sum of HDD over the main period. |
Total this period, Cooling degree days | Sum of X and sum of CDD over the main period. |
Total, Total [Baseline], Difference | Sum of X and sum of the selected baseline over the main period. Displays if Overlay='Baseline'. |
Average, Min, Max | Average of X, minimum value, and maximum value over the main period. |
Average, Peak demand | Average of X and maximum 15-minute resolution peak demand value over the main period. |
Average this period, Average previous period, Difference | Average of X over the main period and comparison period. |
Average this period, Average same period previous year, Difference | Average of X over the main period and previous year comparison period. |
Average this period, Average temperature | Average of X and average temperature over the main period. |
Average this period, Heating degree days | Average of X and sum of HDD over the main period. |
Average this period, Cooling degree days | Average of X and sum of CDD over the main period. |
Average, Average [Baseline], Difference | Average of X and average of the selected baseline over the main period. Displays if Overlay='Baseline'. |
Min, Max | Minimum value and maximum value over the main period. |
Peak demand | Maximum 15-minute resolution peak demand value over the main period. |
📘 Advanced callout adjustments
Callout adjustments provide users with fine-grained control of how totals, averages, and percent differences are calculated, and help determine how data gaps are handled.
📘 Average callouts when dividing by a trended point
In Building Trends and Building Year-over-Year Trends cards, average callouts for bar charts are computed using the following method, which is more accurate if there are any missing data during the period:
Average = Total main point over selected period / Total trended point over selected period
On the other hand, average callouts for table charts are computed by taking an average of the individual rows in the table, which serves as a summary of the table's contents:
Average = Sum of rows in table / Number of rows in table
Work orders callouts
Callout set | Conditions & Notes |
Work tasks cost, Work tasks | Cost and quantity of all work tasks, adjusted by prior 'Cost type' and 'Problem type' selections. |
Parts cost, Labor cost, Other costs | Component costs of work tasks, adjusted by prior 'Problem type' selection. |
Parts cost, Labor cost | Component costs of work tasks, adjusted by prior 'Problem type' selection. |
Parts cost, Parts work tasks | Parts cost and quantity of work tasks, adjusted by prior 'Problem type' selection. |
Labor cost, Labor work tasks | Labor cost and quantity of work tasks, adjusted by prior 'Problem type' selection. |
Other costs, Other work tasks | Other costs and quantity of work tasks, adjusted by prior 'Problem type' selection. |
Parts work tasks, Labor work tasks, Other work tasks | Quantity of work tasks by component costs, adjusted by prior 'Problem type' selection. |
Parts work tasks, Labor work tasks | Quantity of work tasks by component costs, adjusted by prior 'Problem type' selection. |
📘 Notes on work orders callouts
Work order costs are included in a given period selection if the 'Date charged' for the work task also occurs within the range of the period.
Work order counts are included in a given period selection if the 'Date requested' for the work task also occurs within the range of the period.
Assets callouts
Callout set | Conditions & Notes |
Work tasks cost, Resource use cost | 'Work tasks cost' is the cost type-specific cost across all problem types for the asset(s). 'Resource use cost' is the cost of consumption for the asset's selected point. Note: 'Purchase price' is typically already accounted for among an asset's work tasks, therefore it does not display as a separate callout. |
📘 Notes on assets callouts
If Data type = 'Assets', then work order callout sets that include "counts" are not available.
All assets callout sets are adjusted by prior 'Asset category', 'Asset type', and 'Asset' selections.
'Resource use cost' is only available if the asset is associated with a point.
Projects callouts
Callout set | Conditions & Notes |
Project baseline, Project performance | Sum of the project's baseline over the baseline seed period and sum of X over the project performance period. |
📘 Notes on projects callouts
If Data type = 'Projects' and the selected building includes at least one associated project, then projects callouts will display.
Use the 'Period' field to adjust 'Period start' and 'Period end', similar to those found in callout adjustments for other data types. 'At baseline seed period start date' and 'At performance period end date' are selected by default.