Simple Calculated Field
Simple calculated fields compute a real-time value using a single mathematical expression —
no scripting required. For example, given temperature and humidity telemetry, the expression
243.04 * (ln(humidity/100) + 17.625 * temperature / (243.04 + temperature)) / (17.625 - (ln(humidity/100) + 17.625 * temperature / (243.04 + temperature)))
computes the dew point and stores it as dewPoint the moment new data arrives.
Use Simple when you need:
- Derived sensor metrics (dew point, heat index, power = voltage × current)
- Normalization and scaling (calibration factors, unit conversions)
- Threshold-based values (clamping, simple scoring, deltas)
- Cross-entity calculations (combine device telemetry with asset attributes)
Configuration
Section titled “Configuration”- Open the Calculated fields page.
- Click the + Add calculated field ⇾ Create new calculated field in the top-right corner.
- In General, enter a title, specify the entity the field applies to, and select the Simple type.
- Add Arguments, write the Expression, and configure Output.
- Click Add to save.
Arguments
Section titled “Arguments”Simple fields support Latest telemetry and Attribute argument types. The data source can be the current entity, another Device or Asset, the Customer, the current tenant, or the current owner.
For full argument configuration details, see Calculated Fields — Arguments.
Expression
Section titled “Expression”In the Expression field, write a single mathematical formula that references your arguments
by name (e.g., temperature, humidity).
Supported operations and functions:
| Category | Supported |
|---|---|
| Arithmetic | +, -, *, / |
| Functions | abs, sqrt, pow, min, max, ln, log, ceil, floor, round |
The expression produces one result value, stored under the configured output key.
Output
Section titled “Output”| Field | Description |
|---|---|
| Output type | Time series or Attribute |
| Key | The name under which the computed value is saved |
| Decimals | Optional decimal rounding |
| Use latest timestamp | Time series only — stores the result using the most recent argument timestamp |
For output strategy options, see Calculated Fields — Output Strategy.
Example: Dew Point Calculation
Section titled “Example: Dew Point Calculation”A Smart Device sends temperature (°C) and humidity (%) as telemetry in real time.
Goal: compute dewPoint and store it as a time series key on the same device.
Configuration Steps
Section titled “Configuration Steps”- Open the Calculated fields page.
- Click the + Add calculated field ⇾ Create new calculated field in the top-right corner.
- In General:
- Title: Dew Point
- Entity: Smart Device (or its device profile)
- Type: Simple
- Click Add argument:
- Entity type: Current entity
- Argument type: Latest telemetry
- Time series key:
humidity - Argument name:
humidity
- Add a second argument for
temperaturewith the same settings. - In Expression, enter:
243.04 * (ln(humidity / 100) + 17.625 * temperature / (243.04 + temperature)) /(17.625 - (ln(humidity / 100) + 17.625 * temperature / (243.04 + temperature)))
- In Output:
- Output type: Time series
- Key:
dewPoint
- Click Add.
Result: Each time temperature or humidity is updated, dewPoint is recalculated and stored
as a new telemetry entry on the Smart Device.