Computed measurements explained

Prev Next

Introduction

A computed measurement allows the user to perform mathematical operations on measurements, and then display the result in a widget.


Instructions

A computed measure uses square brackets to use a measurement path as a parameter, and always has the following format:

[gateway|sensor]
[gateway|slave|sensor]

Optionally, you can specify a slave and aggregation:

[gateway|sensor#AVG]
[gateway|slave|sensor#MAX]

You can find more information about aggregation in the article Aggregate functions explained.

You can then use these parameters to perform mathematical calculations.
For example, if you want to multiply an Open Weather humidity reading by 1000:

[openweather|humidity] * 1000

It is also possible to use two or more sensors:

[openweather|humidity] + [openweather|clouds]
[openweather|humidity] + [openweather|clouds] * 2

For the evaluation of mathematical expressions, we use NCalc.
The possibilities with computed measurements are further explained in these articles:

NCalc functies
NCalc operators

Setting up a computed measurement

When adding a new widget, you first choose a data source and a sensor.
By doing so, you have already chosen a gateway (with optional slave) and a sensor for your measurement path.
This way, your computed measurement will already have filled in the measurement path for you, including the square brackets.
If needed, you can add an aggregation type and mathematical operators.