7.2 Creating an Analysis
To create a new analysis manually, navigate to an element's Analyses tab and click + in the toolbar, or click the + Create New Analysis Manually button in the empty list. This opens the analysis creation form.
The form is divided into four numbered sections that you complete in order: General Information, Trigger, Calculation, and Event.
7.2.1 General Information
| Field | Description |
|---|---|
| Name (required) | A unique name for this analysis. Keep it concise and descriptive — for example, "Hourly Max Voltage" or "Compressor Efficiency". |
| Categories | Optional category tags to organize and filter analyses. You can create new tags inline. |
| Enable analysis upon creation | When checked (default), the analysis starts running immediately after it is saved. Uncheck to create the analysis in a paused state. |
| Recalculate for out-of-order data | When checked, if data arrives late (with a timestamp earlier than already-processed data), the analysis re-runs for the affected window. Useful when sensor data may arrive delayed or out of sequence. |
| Description | Optional free-text description of what this analysis computes and why. |
7.2.2 Trigger
The Trigger section defines when the analysis runs. See Trigger Types for full details on all eight trigger types and their parameters.
All trigger types share two common optional fields:
- Pre-filter — A filter expression applied to the data before the trigger evaluates. Only data rows that satisfy the filter are considered. This is useful for ignoring invalid readings (e.g., filter out zero values before computing averages).
- Fill History — When enabled, the analysis runs over historical data to backfill calculated outputs. Enabling this field reveals two additional options:
- Fill History First — When checked, the analysis processes all historical data before it begins processing new real-time data.
- Start Time — The date and time from which to start the historical backfill.
7.2.3 Calculation
The Calculation section defines what the analysis computes and where the results are stored. See Calculation for full details.
7.2.4 Event
The Event section controls whether the analysis generates an event each time it fires. This section is disabled by default. Enable it by checking the Generate checkbox. See Generating Events for full details.
Saving and Discarding
Click Save to create the analysis. If Enable analysis upon creation was checked, the analysis starts running immediately and appears in the list with Running status.
Click Discard to cancel. A confirmation dialog appears if you have unsaved changes.
The form includes a collapsible User Guide panel on the right side that explains each field as you fill it in.
