Documentation

Units and sub-units

Create units, configure their conversions, and associate them with series.

Updated on September 6, 2026

A unit displays and converts the values in a series. The unit library contains the available templates.

Understand units

A unit groups several compatible sub-units. A duration unit can, for example, include seconds, minutes, and hours.

The base sub-unit is the conversion reference. Its factor is 1. The factor of another sub-unit indicates how many base units it represents: with seconds as the base, the factor for a minute is 60.

A simple counter can remain unitless.

Create a unit

  1. Open Units from the main navigation and select the add action.
  2. Enter the unit name and key.
  3. Add a sub-unit with its key, name, abbreviation, and conversion factor.
  4. Choose the base sub-unit, then save.

The name and abbreviation are displayed in the interface. A sub-unit key must be unique within that unit.

Add or edit a sub-unit

From the unit form, add a sub-unit or select one to edit its details. Its key, name, and abbreviation are required.

Always check the factor against the base sub-unit: an incorrect value produces incorrect conversions in associated series.

Associate a unit with a series

From the unit detail screen, use the association action and select the relevant series. They then use the unit and its base sub-unit.

Disassociating a series removes its unit without deleting the series or its measures.

Delete a unit

Deleting a unit does not delete the series that used it. They remain available but lose the associated unit.

A series template can prepare the required unit automatically.