Line Chart Widget
Summary
The line chart widget is used to display a series of values over time, and can display multiple tags from multiple data sources or stacks. Choosing a time window appropriate to your data’s sample rate is key, usually 1 to 2 hours maximum. Longer time windows that require large quantities of data will be automatically decimated for ease of visual consumption.
This widget is commonly used to reveal trends in data, and to compare the behavior of multiple devices running simultaneously by layering multiple tags in a single chart.
Examples at a glance
Default view displaying a single tag's values over 24 hours. The data has been decimated to legibly display several weeks of data.
Common applications
- Visualize peaks and valleys in power consumption across multiple machines to reveal patterns of extended idleness.
- Display changes in air pressure over long time periods, making slow leaks easy to identify and repair.
Configuration options
Hover over a widget and click the Configure Widget button (
) to control which tags to include and how data should be handled, such as defining the amount of data to display or scaling up subtle signals to make them easier to use. Once you have selected the tags to be shown, click ‘Next’ to configure data handling options using the properties below.
| Property | Options | Description |
|---|---|---|
| Time Frame | Determine the time window of data to be displayed in the widget. Note that large quantities of data will be displayed in decimated format for visualization purposes. | |
| Moving | Continuously update the current view with the most recent data. | |
| Fixed | Display data within a fixed time window, established from a specific date and time. | |
| Refresh Interval | Determines the frequency with which the widget will refresh the displayed data. Set longer refresh times for widgets that are not checked often. | |
| Auto | Sets the refresh rate automatically, based on the incoming signal. | |
| Set | Specify a refresh rate in seconds, minutes, or hours. | |
| Y-Axis | Define the minimum and maximum values of the Y-Axis. Data above or below these values will be cut off. | |
| Auto | Automatically define the minimum and maximum values of the Y-Axis based on incoming data. | |
| Set | Specify fixed minimum and maximum values for the Y-Axis. | |
| Scale and Offset | Modify the raw data to either scale up the value by a multiplier, or offset the value by a fixed amount. Used to convert units (eg, watts to kW), or to correlate data streams with drastically different scales (eg, °F vs vibrations per second). | |
| Raw | No adjustment. | |
| Custom | Specify a scale factor and/or offset amount. |
Display options
Hover over a widget and click the Display Options button (
) to define conditions that change the way data is displayed, such as changing colors or showing text based on incoming data. Setting up multiple conditions can create widgets that are very dynamic, elevating critical information as data conditions change. See our tutorial on creating your first dashboard for an interface breakdown.
| Property | Description |
|---|---|
| Tag | Select the tag or tag state to configure from the list of incoming data. States will be shown in the format ‘StackName:TagName.State’ |
| Condition | Not currently implemented for this widget type. |
| Trigger Value | Define a Y-axis value at which to add a dotted ‘threshold’ line. |
| Color | Select a color in which to display the line created by the configured Trigger Value. |
| Display Icon | Not currently implemented for this widget type. |
| Display Text | Not currently implemented for this widget type. |
| Background Color | Not currently implemented for this widget type. |