Prerequisite: This feature is reserved for users with an administrator role.
This feature allows you to convert the raw value read from an equipment variable into a more meaningful value suited to your needs (e.g., a percentage). This conversion is achieved by applying a multiplication coefficient and/or an offset.
Principle
When scaling is configured for a variable, the final value used or displayed is calculated using the following formula :
Final value = Raw value * Coefficient + Offset
Raw value : The value directly read from the equipment.
Coefficient : A multiplication factor that you define.
Offset : A value added (or subtracted if negative) after the multiplication.
By default, when no scaling is applied, the Coefficient is 1 and the Offset is 0. In this case, Final value = Raw value * 1 + 0, meaning no scaling is applied, and the final value is identical to the raw value.
Note : If the Coefficient is set to 0, scaling is ignored, and the raw value will be used as the final value.
Scaling Configuration
You can define the scaling parameters when editing or creating an equipment variable. Two new optional fields are available :
Coefficient and Offset Calculation Helper Tool
To simplify determining the correct coefficient and offset, a calculation tool is integrated into the variable editing interface. Click on the calculator icon to access it :
Tool Interface :
Input Scale :
Minimum source value: Enter the expected minimum raw value of the variable.
Maximum source value: Enter the expected maximum raw value of the variable.
Output Scale :
Minimum expected value: Enter the desired minimum value you want to obtain after scaling.
Maximum expected value: Enter the desired maximum value you want to obtain after scaling.
The tool calculates and displays the results (Coefficient and Offset) :
You can then apply these calculated values to the variable's configuration fields by clicking on "Assign calculated values".
Note: The formulas used to calculate the coefficient and offset are:
Coefficient = (Maximum expected value - Minimum expected value) / (Maximum source Value - Minimum source value)
Offset = Minimum expected value - Coefficient * Minimum source value