Panel: Complex Line Chart¶
The Complex Line Chart panel show trends in signal data on a line graph and provides more functionality and configuration options than the Simple Line Chart panel. Visualize multiple signals against thresholds and baselines over configurable periods of time.
Key Functionality¶
- Provides configurable selection buttons for quick access time period views
- Data is down-sampled when time period of view's sampling size is longer than the the actual data reported rate.
- Supports multiple signals.
- Recommended for 20 or less but supports up to 50 with lower performance / usability.
- Number of signals is also limited by signal types, up to 9 different data types can be used.
- Supports up to 2 y-axis. Each dedicated to unique signal data types.
- Pan and zoom. X Axis is always enabled, Y Axis can be turned on.
- Time period selection
- View the value, timestamp, and units when hovering above a line point
- Option to show trend line
- Option to show baseline
- Option to show Min/Max
- Option to show horizontal grid lines
- Option to show/hide legend
- Ability to Export a CSV file or XLS file from the data in chart.
Configuration options¶
Users can configure:
- Y-axis minimum and maximum or auto-scale
- For multiple signal types, allows choosing which of two axis to use (left / right).
- Enable / disable showing thresholds rules If multiple signals are on the chart, it uses the least restrictive thresholds
- Quick Select Time Boxes (up to 5)
- Line gaps (default 3x multiplier applied to Signal's report rate)
The complex line chart supports up to 20 signals which can be selected on the Signal Selection step.
Default View Options¶
| Option | Default | Description |
|---|---|---|
| Panel Title | Name of Signal | Text on the dashboard panel header |
| Default View | Live Mode | The default time period shown |
| Live Mode Time & Points | 30 Minutes 500 Reported Data Points | In Live Mode time view, specify the max number of minutes or hours and max number of points to show. Note that the max is 8 hours and 1000 points. These are configurable based on the fact different signals have different report rates. |
| Display Horizontal Grid lines | Off | When enabled, shows horizontal grid lines. |
| Display Legend | Off | When enabled, shows a legend for the signals on the chart. |
| Data Gaps | Off | When enabled, will show gaps in lines when the data points are greater than the number of times the report rate set. For example, if set to 3 times the report rate and the report rate is 60 seconds, a gap will be shown if two data points are greater than 180 seconds apart. |
| Show Timeline Navigator | On | Show a timeline navigation panel at the bottom of the chart. |
| Display Min/Max | Off | For all Time Modes except Live, data is down-sampled. If turned on, this will show the minimum and maximum values during the down sampled periods in addition to the average. |
| Highlight Key Signal | Off | Will show a specific signal's last value and optionally units at the top of the chart. Optionally can hide if signal is past its timeout setting. |
Time Navigation¶
Allows setting up to 5 selectable time periods in the chart in addition to Live mode.
Data Types¶
Allows setting options for specific signals on the chart.
| Option | Default | Description |
|---|---|---|
| Thresholds | Allows showing one signal's thresholds for one rule on the chart. If there is a threshold for a signal when the chart is created, the threshold will automatically be turned on. (see Condition Rules) | |
| Display Units | Default Unit of Signal | Allows converting the units in the panels. |
| Axis Range | Auto-Generated | Allows setting the Y Axis range. Auto-generated mode will use thresholds or historical values. |
Baselines¶
Allows setting a baseline horizontal line for the chart, for one signal, if any of the signals have a baseline property set.
Thresholds¶
This configuration tab provides a list of threshold rule warning and critical thresholds found for each signal in the line chart. Users can choose to show the threshold, use automated label or custom text on the line, and to show vertical bands for when the signals are in warning and critical states. See Asset Condition Rules for more information.
Options for each signal rule threshold states.
| Option | Default | Description |
|---|---|---|
| Include in Vertical Band | Off | Shows the status as a vertical yellow (warning) or red (critical) band on the chart. |
| Display Horizontal Line | On | Whether to show the specific threshold as a line on the chart using yellow for warning and red for critical lines. |
| Line Label Text | Checked | Checked means it will automatically use the type of threshold and the value to set the label on the threshold line. Example: >40.0°CIf it is unchecked, you can specify your own label text. |
Live Data Mode¶
The complex chart include a live mode which pulls non-sampled data from the signal history, limited by number of total points (500 to 1000) and time up to 2 hours. The chart will never grab more than the number of points set to be sure the data is not down sampled. The chart auto refreshes as new values for the signal come into the platform.
Line Gaps¶
Line gaps are configurable. The default is 3-times the report rate for the signal being displayed, if the signal has a report rate property set. The gap rate can be changed from the default 3x duration in the chart's configuration to a different time multiplier.
Timeout Handling¶
The Complex Line chart does not show timeout status other than the line for the timed out signal(s) will show it hasn't reported.
Export Chart Data¶
The Complex Line Chart allows users to export the data currently in view in the chart. Note that this data may be down-sampled based on the time window. For a full resolution export of data, please use Reports & Exporting.
Thresholds¶
Signals that have threshold rules may have their thresholds shown as lines on the chart. The configuration allows 1 or all thresholds to be plotted for each signal on the chart. The threshold label text can also be configured or left to be automated.
