Gauge Widget
Summary
The gauge widget shows the latest value from a single tag, and renders it as a gauge with upper and lower values. Additional thresholds can be added to a gauge by configuring a tag’s range properties (applies everywhere that tag is used), or by configuring a gauge widget’s display options (applies to that widget only). Details on setting range properties are available here.
Examples at a glance
Default view displaying the most recent value with minimum range set to zero and maximum set to 100.
Common applications
- Monitor multiple attributes of complex machines at a glance across unrelated units and scales, such as a turbine’s power output (kW), speed (rmp), fuel pressure (psi), and exhaust temperature(°F).
- Observe real-time activity across multiple devices when prototyping and testing new production flows or machine settings.
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 |
|---|---|---|
| Range | Defines the upper and lower values of the widget. | |
| Minimum | Define the lower boundary value. | |
| Maximum | Define the upper boundary value. | |
| Metric | Enables data smoothing. Used to remove noise from data. | |
| Snapshot | No smoothing; Shows the most recent value. | |
| Maximum | Average the maximum values over a number of samples. | |
| Minimum | Average the lowest values over a number of samples. | |
| Refresh | 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. | |
| 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 | Define the logic conditions under which your chosen settings will take effect relative to the Trigger Value. |
| Trigger Value | Define the threshold at which your chosen settings will take effect relative to the Condition setting. |
| Color | Select the display color for the section of the gauge defined by the Condition and 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. |