Trend widget (Default Trend)

What is the Trend widget?

Use this widget to view a graph of historical equipment trend data for up to 10 points for a single piece of equipment at the same time.

Note: Trend widget here refers to the Trend widget on the Equipment dashboard, Space dashboard, and the Building Network dashboard. Whenever we have to distinguish the Trend widget from the Trend Study widget, which can appear in the same locations, we use the term Default Trend widget for Equipment, Space, and Building Network widgets.

How do I access the Trend widget?

You can access the Trend widget any time you view a piece of equipment in the Equipment dashboard or when you view a space on the Space dashboard. You can access the Building Network Trend widget in the Building Network dashboard.

Note: If a Trend Study widget appears instead of the Default Trend widget, select Default Trend in the drop-down list under the widget header. You can configure the position of the Default Trend widget in the Trend Study Manager.

What is the layout of the Trend widget?

The following figure shows the layout of the Trend widget.

Table 1. Trend widget callouts
Number	Name	Description
1	Export icon	Exports the trend samples shown in the Trend widget to a .csv file or .pdf file. Note: Export functionality is not available on a tablet or phone.
2	Trend list	The Default Trend widget may not display when you first open the Trend widget. Instead, the widget could show a Trend Study. Use this drop-down menu to select Default Trend. You can configure the drop-down menu in the Trend Study widget and Trend Study Manager.
3	Calendar icon	Shows the trend samples for the date range you select: Last Day, Last 7 Days, Last 30 Days, Last 12 Months, All Time, or a Custom Range.
4	Split Graph icon	Add or remove a second analog graph to split the y-axis to see values of similar ranges on different graphs.
5	Line Graph View icon	Shows the trend samples in a line graph.
6	Bar Graph View icon	Shows the trend samples in a bar graph. The bar graph view is available for analog (numeric) points only.
7	Candlestick Graph View icon	Shows the minimum, maximum, and averages in graphs using statistical candlestick symbols. The candlestick graph is only available when viewing more than seven days of trend data.
8	Settings icon	Click or tap this icon to switch between Raw Data and Aggregate Data. Note: The trend chart needs to be in raw data mode for live trending to work. Live trend data is lost when you switch to Aggregate Data.
9	Change Points icon	Add or remove up to 10 trend series in the Trend widget.
10	Pan and Zoom Bar	Zoom in or out in the trend graph by dragging the left or right date and time markers. Once zoomed in, pan to an earlier or later date and time by scrolling. Note: The pan and zoom bar is not available on tablets or phones. Use pinch-to-zoom gestures to zoom in or out.
11	Short Name and Equipment Name	Shows the short name of the point for which the samples are being displayed in the trend graph.
12	Trend Legend	Shows what point each trend series correlates to. The legend includes the short name of the point, the equipment the point resides on, the line marker and color, and a triangle icon (if the point or equipment is disabled). Tap or click on specific trend legend to highlight the trend series on the trend graph. Doing so also changes the y-axis to reflect that trend series' unit of measure. You can move points between the two graphs by dragging the drag icon in the legend:
13	X-axis	Shows the date and time when the trend samples were taken.
14	Y-axis	Shows the unit of measure and scale of the selected trend series. The y-axis changes depending on the trend series that is selected. On initial load, the y-axis displays the unit of measure and scale of the first trend series available. When viewing analog (numeric) points, binary points, and multi-state points in the same trend graph, the y-axis splits to show the analog point unit of measure on the top portion of the graph and the binary or multi-state point unit of measure on the bottom portion of the graph.

Is there a legend for the Trend widget? For example, what do the lines and markers indicate?

In the Trend widget, the legend shows the short names and the equipment name for the points for which trend samples appear. The legend and trend graph also indicate:

For an analog (numeric) value, the Trend widget plots the values in a continuous line.
For binary or multi-state values, the Trend widget plots the values as a discrete line.
Markers are used to indicate a trend sample occurred and are unique for each trend series shown in the graph. You can change the line colors and markers for trend series in the Metasys System Preferences > Trend Settings tab in SMP.

When a trend extension is disabled, the legend displays a triangle next to the equipment name.

Can I easily identify how a trend series is represented in the Trend widget?

Yes, you can. On a computer platform, a callout appears when you hover over a line. The callout shows the trend samples that share the same time stamp.

On a phone or tablet, a callout appears when you tap a point. The callout shows the trend samples that share the same time stamp.

Figure: Example of callout with averaged data

When a trend sample is averaged, the callout displays an asterisk (*) next to the point name and trend sample value. The message Values Are Being Averaged also appears in the callout.

How many trend series can I see in the Trend widget? How many pieces of equipment can I view trend series from in the Trend widget?

You can select up to 10 trend series (four on mobile devices) from a single piece of equipment or from several pieces of equipment in the served-by chain to display in a single graph in the Trend widget.

How do I add or remove trend series in the Trend widget?

You can select up to 10 trend series to display at a time.

To change or add a point to the Trend widget on a computer:

Click the Change Points icon.
Select the point or points from the list. The list shows points from the piece of equipment you are viewing.
Note: You can view only 10 trend points at a time.
Click APPLY.

To change or add a point to the Trend widget on a tablet or phone:

Tap the Settings icon.
Tap Change Points.
Select the point or points from the list. The list shows points from the piece of equipment you are viewing.
Note: You can view only four trend points at a time.
Tap DONE.

How do I change the time range for the Trend widget? What time ranges are available?

Click or tap the calendar icon and select from the following options:

Last Day
Last 7 Days
Last 30 Days
Last 12 Months
All Time
Custom Range

Click or tap the calendar icon and then select Custom Range to select a specific date or date range, as well as a specific time.

For analog (numeric) points, live raw data displays when you view seven days or less of trend data.

For analog (numeric) points, averaged data displays when you view greater than seven days of trend data:

When you view greater than seven days to less than two months of trend data, a daily average of data is plotted. You can drill down to a day and to an hour.
When you view two months to one year of trend data, a monthly average of data is plotted. You can drill down to a month, then to a day, and then also to an hour.
When you select a Custom Range greater than one year, or when you select All Time for a customer site that has more than one year of trend data, a yearly average of data is plotted. You can drill down to get an average of months, days, hours, and also raw data. Similarly, you can roll up to the yearly average again.

Note: The raw data limit for analog points is 50,000 samples per point.

For binary points and multi-value points, raw data displays regardless of the date range you select.

Note: The raw data limit for binary points is 50,000 samples per point.

How do I switch from a line graph to a bar graph? How do I switch to a candlestick graph?

Table 2. Graph icons
Icon	Icon name	Description
	Line Graph	By default, the graph displays the trend samples from the last 24 hours in a line graph.
	Bar Graph	The bar graph view is available for analog (numeric) points only.
	Candlestick Graph	The candlestick graph is available when viewing more than seven days' worth of data. The icon is grayed out by default. To see the candlestick graph click or tap the calendar icon. Choose Last 30 days, Last 12 months, All Time or Custom Range.

To view a bar graph in the Trend widget on a computer, click the Bar Graph icon.

To view a bar graph in the Trend widget on a tablet or phone:

Tap the Settings icon.
Tap Change To Bar Graph.

To view a line graph in the Trend widget on a computer, click the Line Graph icon.

To view a line graph in the Trend widget on a tablet or phone:

Tap the Settings icon.
Tap Change To Line Graph.

To view a candlestick graph in the Trend widget on a computer, click the Candlestick Graph icon.

To view a candlestick graph in the Trend widget on a tablet or phone:

Tap the Settings icon.
Tap Change To Candlestick Graph

How do I add another graph in the Trend widget?

Table 3. Split Graph icons
Icon	Icon name
	Split Graph
	Plotted lines

To add another graph in the Trend widget on a computer, click the Split Graph icon.

To add another graph in the Trend widget on a tablet or phone:

Tap the Settings icon.
Tap Add Another Graph.

To remove this other graph, tap the Settings icon and tap Remove Second Graph.

Note: Binary value and multiple value points automatically appear on a separate graph and cannot be combined with analog graphs.

Can I drag points between graphs if I have two graphs?

If you add another graph in the Trend widget (Building Network Trend widget), you can drag analog points between the two graphs. To drag points between graphs:

Select the desired analog point from the Trend legend.
Drag the desired point by its plotted lines to the other graph.

Note: Binary value and multiple value points appear without plotted lines in the Trend legend, because they cannot be dragged to an analog graph.

If you receive data samples during the movement of points, the graphs update automatically, and no data samples are lost.

Do changes made in the Trend widget persist until the end of my user session?

You can navigate away from the Trend widget and when you return to the widget, you can see the last changes made, including changes made to point selection, split y-axis, graph type, and time frame selection.

Note: You lose your changes, if you log out or are logged out, including manual logout, session timeout, or disconnection.

What is live trending?

You can plot real time trend values for any trendable object that does not have a trend extension on its default attribute. This functionality is called live trending. The live trend data is cleared when you log out, when you close or navigate away from the trend chart, or when your session times out.

All trend charts except Trend Study support live trending. The trend chart needs to be in raw data mode for live trending to work.

What do I do if values appear as a thin line and markers are not visible by default?

When you add points where dynamic updates get plotted, the values may appear as a thin line and markers may not be visible by default, even if the Trend widget is maximized. Zoom in to the latest time to see the dynamic updates and values more clearly.

Can I export or print the information that appears in the Trend widget?

You can export information that appears in the Trend widget only on a computer. The export function is not available on tablets or phones.

To export information that appears in the Trend widget, click the export icon. You can export to a .csv file and open the file in any supported spreadsheet software. You can also export to a .pdf file.

The exported .csv file contains raw trend data for the trended points selected. For example, if the Trend widget displays six months of averaged data for DA-T, EFFDAT-SP, DA1-P, and DAP-SP points, the .csv file contains the raw data for those points from the past five months and the current month.

The exported .pdf file contains a snapshot image of the trend graph as it appears in the Trend widget and the data for the points plotted on the trend graph for the duration selected.

Note: With a PDF export, you can export only the raw and average data plotted on the trend graph, whereby the raw data limit is 50,000 samples per point. With a .csv export, you can export all the raw data available, based on the selected date range, whereby the limit is 105,000 samples per point.

To print the trend graph that appears in the Trend widget, click the export icon to export the Trend widget snapshot image and the data for the points plotted on the trend graph to a .pdf file. You can print the .pdf file.

Is the Trend widget supported on all devices?

Yes, the Trend widget is supported on desktop, tablets, and smartphones.