State History Widget
Summary
The state history widget visualizes how much time a tag spends in one or more states over a period of time. It is commonly used to analyze machine utilization (OEE) by tracking ‘active’ and ‘idle’ states, or environmental factors such as ‘normal’ and ‘dangerous’ temperature or vibration levels.
Data is presented as a bar chart (indicating percentage time or total time spent in a state each hour) with a text summary table below. The bar chart displays time on the X-Axis with the most recent data displayed on the right, while the summary table shows the latest data at the top. Show or hide states in the bar chart by clicking the legend at the top of the graph.
Examples at a glance
A state history table showing the duration a temperature sensor spent in hot or cold states each hour, over the course of a day.
Common applications
- Visualize how much time a machine spent running or idle to assess overall utilization.
- Instantly identify machines that frequently enter fault states to target maintenance or process changes.
- Reveal gradual increases in time spent in suboptimal states, like partial load or standby, that may otherwise go unnoticed.
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. For this widget, a maximum of 24 hours total can be displayed simultaneously. Please use the previous and next buttons to move the viewed window. | |
| 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. | |
| Display values as | Determines how the widget displays the time spent in each state across the selected time window | |
| Percentage of time | Show the portion of time the tag spent in each state as a percentage of the total time per hour. | |
| Total time | Show the exact duration the tag spent in each state in hours, minutes, and seconds. | |
| Transitions | Show how many times the tag entered or exited each state during the selected time window. | |
| 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. |