Start Free Trial

Widget Calculations

Widget Calculations let a widget perform arithmetic across the readings of two device attributes and display the result, instead of plotting each attribute on its own. Add (+), subtract (−), multiply (×), or divide (÷) the two attributes to show differences, sums, ratios, and other derived values — for example the gap between two temperatures, or a combined total across two sensors. This page covers how to configure a calculation on each widget type that supports it, the Strict Timestamp Mode option, and what a widget shows when a result cannot be computed.

Where it is available: calculations work on three widget types, each plotting the result differently.
  • Chart — the X-axis is the shared timeline of the two attributes and the Y-axis plots the calculated trend over time.
  • Single Status — shows one calculated value from the latest values of the two attributes.
  • Multi Status — the same latest-value calculation, configurable per Device Attribute section, so calculated and non-calculated rows can be mixed in one table or list.

Single Status Widget

The steps below use a Single Status Gauge as the example. You configure a calculation from the widget’s create or edit screen, in the Attributes section.

  • 1
    Open the widget editor. From your dashboard, open the create or edit screen for the target widget. For a Single Status widget the Attributes section starts in Single Mode with one Device Attribute row.
    The Create Widget dialog for a Single Status Gauge: a left config panel with Widget Title, Widget Type set to Single Status, Style set to Gauge, Minimum and Maximum value, Gauge direction, and an Attributes section with a single Device Attribute 1 row, beside an empty Preview panel on the right.
    The widget editor opens in Single Mode with one Device Attribute row.
  • 2
    Switch to Multi Mode. In the Device Attribute section, click the Mode Switch button (the tag icon) to switch from Single Mode to Multi Mode. Clicking it again returns to Single Mode.
    The same Single Status Gauge editor with the Mode Switch button — a small tag icon at the top-right of the Device Attribute 1 section — highlighted by a red box.
    The Mode Switch (tag) button toggles the Device Attribute section into Multi Mode.
  • 3
    Select an operation type. In Multi Mode, operation buttons appear to the left of the Mode Switch button. Choose addition (+), subtraction (−), multiplication (×), or division (÷). The chosen operation is applied as attribute ① <operation> attribute ②.
    The Device Attribute section in Multi Mode: a row of operation buttons (plus, minus, multiply, divide) appears next to the Mode Switch button, highlighted by a red box, with a tooltip showing the ① + ② formula. Two attribute rows numbered ① and ② are now shown.
    In Multi Mode, pick the operation applied between attribute ① and attribute ②.
  • 4
    Select the target attributes. Two numbered selectors (① and ②) each take a Device and an Attribute. Pick the device and attribute for each side of the calculation. Once both are set, the Preview shows the calculated result.
    The Attributes section with the ① and ② rows filled in, each set to a device and the temperature_celsius attribute (highlighted by a red box). The Preview panel on the right now shows a gauge reading 53.7 °C labelled temperature_celsius + temperature_celsius.
    Set the device and attribute for ① and ②; the Preview updates with the calculated value.
  • 5
    Configure optional settings. Set any style options as needed, such as the Color, the number of Decimal places, and (for a Gauge) Advanced color settings — exactly as you would for a non-calculated widget.
    The lower part of the Attributes section highlighted by a red box, showing the Decimal places selector, a Color picker, and an Advanced color settings checkbox below the ① and ② rows.
    Style options (color, decimal places, and so on) work the same as for a single attribute.
  • 6
    Configure Strict Timestamp Mode. The chain-link button toggles Strict Timestamp Mode, which is ON by default. With it ON, the timestamps of the latest values of ① and ② must match for the result to be computed. With it OFF, each attribute’s own latest value is used regardless of timestamp.
    The Device Attribute section with the chain-link Strict Timestamp Mode button highlighted by a red box, showing a tooltip that reads: Strict timestamp mode is enabled. The timestamps of the latest values for ① and ② must match.
    Strict Timestamp Mode (the chain-link button) is on by default, requiring ① and ② to share a timestamp.
  • 7
    Save and apply. Click Save, then return to the dashboard to confirm the calculated result is displayed on the widget.
    The saved Single Status Gauge on the dashboard, showing a value of 48.4 °C with the label Auto AA:BB:CC:AA:BB:04 temperature_celsius + temperature_celsius and a timestamp beneath it.
    The saved widget shows the calculated value on the dashboard.

When the result can’t be calculated

Uncomputable cases (Single Status): when the calculation cannot be performed, the widget shows an N/A state with the reason rather than a value. The two common cases are:
  • Timestamps don’t match (or data is missing): with Strict Timestamp Mode ON, if the latest values of ① and ② do not share a timestamp, or either attribute has no data, the widget shows N/A(Incomplete).
  • Division by zero: when division (÷) is selected and the divisor is zero, the widget shows N/A(Division by Zero).
A Single Status Gauge displaying N/A(Incomplete) in place of a value, labelled signal_strength_dbm + signal_strength_dbm — the result of a timestamp mismatch or missing data under Strict Timestamp Mode.
Strict Timestamp Mode ON with mismatched timestamps or missing data: N/A(Incomplete).
A Single Status Gauge displaying N/A(Division by Zero) in place of a value, labelled battery_percent / battery_percent — the result of dividing by zero.
Division by zero: N/A(Division by Zero).

Multi Status Widget

Configuring a calculation on a Multi Status widget works the same way as on a Single Status widget — the difference is that a Multi Status widget has several Device Attribute sections, and each one can be set independently. You can put a calculation in some sections and leave others as plain single attributes, mixing calculated and non-calculated values in the same table or list.

The Edit Widget dialog for a Multi Status table with three Device Attribute sections (each outlined in red): Device Attribute 1 in Multi Mode with the addition (+) operation and two attribute rows, Device Attribute 2 in Multi Mode with the subtraction (−) operation, and Device Attribute 3 in Single Mode with a single attribute and a Unit selector. The Preview on the right shows a small table of values.
Each Device Attribute section is configured independently — here two calculated sections (+ and −) and one plain single-attribute section.
The saved Multi Status table widget on the dashboard, a two-column grid (A and B) over two rows showing temperature values in Celsius and Fahrenheit, combining calculated and non-calculated cells.
The saved Multi Status widget shows calculated and non-calculated values together.

Chart Widget

On a Chart widget the calculation is plotted as a trend over time: the X-axis is the shared timeline of the two attributes and the Y-axis shows the calculated result. The flow is the same Multi Mode → operation → attributes pattern as above.

Charts have no Strict Timestamp Mode toggle. Because a chart’s X-axis is itself a timeline, charts are always strict — points are only plotted where the two attributes share a timestamp. The chain-link button shown on Single and Multi Status widgets does not appear on a Chart.
  • 1
    Open the widget editor. From your dashboard, open the create or edit screen for the target Chart widget.
    The Create Widget dialog with Widget Type set to Chart and Style set to Line, showing Display Type, Source Data, X-axis (Max points), Y-axis, and an Attributes section with a single Device Attribute 1 row that includes a Statistic selector.
    The Chart editor, opened in Single Mode with one Device Attribute row.
  • 2
    Switch to Multi Mode. In the Attributes section, click the Mode Switch button (the tag icon) to switch from Single Mode to Multi Mode. Clicking it again returns to Single Mode.
    The Chart editor with the Mode Switch button (tag icon) at the top-right of the Device Attribute 1 section highlighted by a red box, showing a Switch to Multi Mode tooltip.
    The Mode Switch (tag) button works the same on a Chart as on a status widget.
  • 3
    Select an operation type. In Multi Mode, the operation buttons appear next to the Mode Switch button — addition (+), subtraction (−), multiplication (×), or division (÷). Note there is no Strict Timestamp Mode button here, as explained above.
    The Chart Attributes section in Multi Mode: operation buttons (plus, minus, multiply, divide) highlighted by a red box with the ① + ② formula tooltip, two attribute rows ① and ②, and no chain-link Strict Timestamp button.
    Pick the operation. A Chart shows no Strict Timestamp button — it is always strict.
  • 4
    Select the target attributes. Set the Device and Attribute for both ① and ②. The Preview plots the calculated series over the shared timeline.
    The Chart Attributes section with the ① and ② rows filled (both humidity_percent, with a Max absolute Statistic), highlighted by a red box. The Preview shows a line chart labelled humidity_percent + humidity_percent.
    With ① and ② set, the Preview plots the calculated trend.
  • 5
    Configure optional settings. Set chart style options such as the Color as needed.
    The lower part of the Chart Attributes section highlighted by a red box, showing the Color picker beneath the ① and ② rows, with the line-chart Preview on the right.
    Chart style options (such as series color) apply as usual.
  • 6
    Save and apply. Click Save, then return to the dashboard to confirm the calculated trend is displayed on the widget.
    The saved Chart widget on the dashboard: a line chart of battery_percent + battery_percent over time, with a hover tooltip showing a point value of 54 at a specific timestamp.
    The saved Chart plots the calculated result over time.

When the result can’t be calculated

Uncomputable cases (Chart): a point that cannot be computed is shown as N/A in the chart’s tooltip rather than being plotted. The same two cases apply:
  • Timestamps don’t match (or data is missing): because the chart is always strict, a point where ① and ② do not share a timestamp (or where data is missing) reads N/A(Incomplete).
  • Division by zero: when division (÷) is selected and the divisor is zero, the point reads N/A(Division by Zero).
A Chart widget with a hover tooltip for a point on the battery_percent + battery_percent series reading N/A(Incomplete), indicating a timestamp mismatch or missing data at that point.
A point with mismatched timestamps or missing data: N/A(Incomplete).
A Chart widget with a hover tooltip for a point on the battery_percent / battery_percent series reading N/A(Division by Zero).
A point where the divisor is zero: N/A(Division by Zero).

Leave a Reply

Your email address will not be published. Required fields are marked *

Start Free Trial

Open external link

You’re leaving Claude to visit an external link:
https://stg-app.neqto.ai/en/dashboards
Cancel
Open link