Periodic Variables

A Periodic Variable automatically calculates data from a Source Variable at fixed time intervals and stores the result as a new variable — for example, summing energy consumption every 20 minutes, or averaging temperature hourly.

Creating a Periodic Variable

1. From the top bar, click Admin.
2. Click Devices.
3. Select the specific device.
4. Click New Variable.
5. Choose Periodic.

Configure your periodic variable

Field	Description
Name/Label	A descriptive name for this periodic variable (e.g. 20-Min Energy Sum or Hourly Avg Temperature).
Variable ID	A unique identifier for this periodic variable. Letters, numbers, or underscores — no spaces.
Data Type	The variable’s data type.
Unit	The measurement unit for this periodic variable (e.g. kWh, °C, V).
Description	A short description explaining what this periodic variable represents or calculates.
Decimal Precision	The number of decimal places for precision.
Variable Color	The color used to represent this periodic variable in dashboards or widgets.
Tags	Relevant tags for this variable.

Configure your source variable

Field	Description
Source Variable	The variable whose data will be computed periodically.
Window Duration	How long each window lasts — 5, 15, 30, 45, or 60 minutes, or 1 day.
Aggregation	How data should be calculated for each period — Sum, Average, Min, Max, Count, Difference, or Range.

Notes

• Window Duration sets how often the calculation runs — e.g. every 5 minutes, the Periodic Variable recalculates using the most recent window of Source Variable data.
• Aggregation determines how the values within each window are combined:
  • Sum — total of all the values.
  • Average — mean of all the values.
  • Min / Max — smallest or largest value in the window.
  • Count — number of data points in the window.
  • Difference — change between the first and last value in the window.
  • Range — difference between the max and min value in the window.