Skip To Content

Convert values

For the gauge and indicator elements, authors can indicate that numbers should be converted from one unit to another. This is helpful when your data is in a certain set of units, but you'd like it to display in another set of units without changing your data. There are many specific use cases for this:

  • Length conversions (e.g. miles to kilometers)
  • Weight conversions (e.g. pounds to kilograms)
  • Temperature conversions (e.g. degrees Celsius to Fahrenheit)
  • Power conversions (e.g. watts to kilowatts)
  • Number conversions (e.g. decimal to percent)

In general, value conversion can be represented by the equation y = mx + b. Using this simple formula, a number can be converted to any other number along a straight line.

  • x = the number to be converted
  • m = the conversion factor (slope) to be applied to x
  • b = the offset to be applied (y-axis intercept)
  • y = the number that gets displayed in the dashboard

The Value Conversion setting is in the Data tab for the indicator and gauge. After you enable Value Conversion, two additional settings appear: Factor and Offset.

Value conversion setting

The Factor setting represents the "m" in the equation "y = mx + b" and the Offset setting represents the "b".

The below table provides some examples of what numbers to enter in the Factor and Offset settings to perform value conversions.

Type of conversion

Factor value

Offset value

Number - decimal to percent

100

Leave as 0

Temperature - degrees Celsius to degrees Fahrenheit

1.8

32

Weight – pounds to kilograms

0.45359237

Leave as 0

Note that you can't put fractions into the Factor setting (e.g. "5/9"). You can only enter positive and negative decimals and whole numbers.