Skip to content
Orion Docs

Start typing to search the docs.

    Talk to usNeed help?Get Started

    Transform sensor data

    Create your first calibration

    Create and check a soft-sensor calibration using a Fahrenheit-to-Celsius worked example.

    The example used is a simple unit conversion: transforming a raw temperature reading from Fahrenheit to Celsius. The same process applies to any calibration regardless of the transformation involved.

    Before following this guide, ensure the soft sensor you want to calibrate has already been created on the device. If you have not yet created a soft sensor, see Create a soft sensor.

    Section titled “Navigate to the calibration”
    1. From the main navigation, select Devices.
    2. Select the device you want to work with.
    3. Select Calibration.
    4. Select the soft sensor you want to calibrate.

    Calibration tab with the Select Sensor dropdown open and the Temp C soft sensor selected; no calibration is set yet

    Understand the starting state

    Section titled “Understand the starting state”

    When you open a calibration for the first time, no groups exist. The calibration will pass the raw value through unchanged until at least one group is added.

    Add a calibration group

    Section titled “Add a calibration group”
    1. Select Create from blank.
    2. Enter a name for the group. For this example, use “Convert to Celsius”.

    Calibration Step Groups for the Temp C soft sensor with the Create from blank buttonNew calibration group named Convert to Celsius, with Add Condition and Add Action buttons

    Configure conditions

    Section titled “Configure conditions”

    For this example, no conditions are required. The conversion should apply to every incoming data point. Leave the conditions section empty and proceed to the action steps.

    If your calibration requires conditions, see Calibration conditions reference for a full description of the available condition types and operators.

    Add action steps

    Section titled “Add action steps”

    Converting Fahrenheit to Celsius requires two steps:

    • Step 1: Subtract 32 from the raw temperature reading.
    • Step 2: Multiply the result of Step 1 by 0.5556 (which is 5 divided by 9).

    Add Step 1

    1. Select Add Action.
    2. Set the left side to Sensor Value and select the raw temperature sensor.
    3. Set the operator to -.
    4. Set the right side to Value and enter 32.

    Convert to Celsius step 1: Air Temperature sensor value minus the constant 32

    Add Step 2

    1. Select Add Action.
    2. Set the left side to Previous Step 1.
    3. Set the operator to *.
    4. Set the right side to Value and enter 0.5556.

    Convert to Celsius steps: Air Temperature minus 32, then the previous step value multiplied by 0.5556

    Save the group

    Section titled “Save the group”

    Once your steps are configured, save the group by selecting Save in the bottom right corner.

    Verify the calibration

    Section titled “Verify the calibration”

    After saving, incoming data points will be processed through the calibration. Check the soft sensor’s displayed value against an expected result to confirm the transformation is working correctly.

    Saved Convert to Celsius group next to a chart of pre-calibrated and calibrated values over two weeks

    Summary

    Section titled “Summary”

    This article walked through the process of setting up a calibration on a soft sensor, using a Fahrenheit to Celsius conversion as an example. The calibration uses a single group with two chained action steps: subtracting 32 from the raw reading and then multiplying by 0.5556. The same structure applies to any calibration regardless of complexity.

    Next Steps

    Section titled “Next Steps”
    • Learn how to build more complex multi-group calibrations: see Working with calibration groups
    • Explore the full range of action step types available: see Action step types reference
    • Reuse your calibration logic across multiple devices: see Using calibration templates
    Section titled “Related articles”