Creating a Sensor

You can create a sensor from the Equipment or Systems Dashboard.

Access the Sensor View from the Equipment or Systems Dashboard.
Select the Actions button and then select Add Sensor.
The Client, Site, and Equipment or System auto-populate in the Add Sensor window.
Complete the following fields:
- Sensor Name: Enter a unique name.
- Sensor Type: Select the sensor type.
- Data Type: Select the data type. If the data type is Float, you must specify a unit. If the data type is Boolean, String, or Integer, a unit is not required.
- Unit: Select the unit.
- Device: Select the device.
- Agent: Select the agent.
- Device Object: Select the device object.
- Conversion: Select the conversion if you need to convert the raw data to a different data type. (For example, boolean to number.)
Select Create.

Creating a Calculated Sensor

A calculated sensor allows you to create a calculation based on readings obtained from other sensors, which allows more flexibility in how you use your data. This lets you model or abstract any additional analysis that you want and use it in any way a normal sensor can be. A calculated sensor can drive rule faults, calculations, and conditional formatting.

Create the calculated sensor the way you would create any other sensor. Except, when selecting the data source, instead of selecting a device and object from IoT Hub, select a K2A calculation. In the Formula Builder, you can configure the sensors you want to source for the calculation. You can create the output from that calculation will be your new calculated sensor. For a list of available K2A calculations see K2A Sensor Calculations.

Explanation of each function and operator available in the Formula Builder:

The calculated sensor is run for the first time in real-time to get a baseline value for the calculation. After this initial run, it will run on COV like all other calculated sensors.

To create a calculated sensor:

Access the Sensor View from the Equipment or Systems Dashboard.
Select the Actions button and then select Add Sensor. (You can also access the Sensor window by selecting the Sensor selection drop-down, and then selecting Configure > Actions > Add Sensors.)
The Client, Site, and Equipment (or System) auto-populate in the Sensor window and are display-only.
Mark Use Calculation.
When creating a calculated sensor, you have the option to select a K2A Calculation or you can build your own formula.

Using a K2A Sensor Calculation

K2A Sensor Calculations are available formulas where you will need to select the sensors to be used in the formula.

Select a K2A Calculation to display the formula in the Formula Builder section to the right.
Choose each Select Sensor dropdown and select the appropriate sensor, including any external sensors for the current site. (External sensors are created in the Sensor Configuration window. See Configure the Sensor Graph.)
The K2A Calculation may include constants for you to enter or edit.
You can edit or add to the K2A calculation by using the Operators across the top of the formula section and/or the Functions listed to the right of the formula section.
After you have completed your formula, select Test Calculation. You are required to test the calculation prior to saving the calculation.
Select Save.
The calculated sensor displays on your Sensor list.

Building Your Own Formula

You have the ability to create sensor calculations using the Formula Builder functions and operators.

You have the option to use functions to insert a function formula.
- After inserting the optional function, choose each "Select Sensor Type" to select the sensor type associated with the equipment for your formula.
- From the Select Sensor Type drop-down, you can add an external sensor for the current client site. (External sensors are created in the Sensor Configuration window. See Configure the Sensor Graph.)
- You can use the operators across the top of the formula section to build your own formula and/or to add on to the function formula.

After you have completed your formula, select Test Calculation. You are required to test the calculation prior to saving the calculation.
Select Save.
The calculated sensor displays on your Sensor list.

Editing a Sensor

You can edit a sensor on the Equipment or Systems Dashboard in the Sensor Overview page.

Access the Equipment or Systems Dashboard.
From the View dropdown, select Sensors, and then select Overview.
On the Overview page, the Source column provides information on the sensor source.
Select the ellipsis to the right of the Source column and select Edit.
In the Update Entity window, edit the information.
Select Update.

Deleting a Sensor

You can delete a sensor on the Equipment or Systems Dashboard in the Sensor Overview page.

Access the Equipment or Systems Dashboard.
From the View dropdown, select Sensors, and then select Overview.
On the Overview page, the Source column provides information on the sensor source.
Select the ellipsis to the right of the Source column and select Deactivate.
In the Delete Entity window, select Yes.
The sensor is deleted.