Unit of measure groups
- Last UpdatedMay 21, 2025
- 2 minute read
- PI System
- PI Server 2018
- PI Server
Beginning with PI AF 2017 R2, units of measure that are included as part of PI AF are mapped to UOM groups, such as Metric and US Customary. Once you have selected which UOM group you prefer to use at your location, you can display all attribute values with units of measure mapped to that UOM group rather than the default UOMs that are defined in attribute templates.
You select which UOM group you prefer in Tools > Options. When no preferred UOM group is selected, all attribute values are displayed with the default UOM defined in attribute templates, unless Use Source Unit-of-Measure for attribute display is also selected. For more information, see Understand customization options.
Sample mappings for a UOM class
As an example, the table below illustrates mappings for the Length UOM class.
|
UOM |
Metric UOM group |
US Customary UOM group |
|---|---|---|
|
centimeter |
inch |
|
|
foot |
meter |
|
|
inch |
centimeter |
|
|
international nautical mile |
||
|
kilometer |
mile |
|
|
meter |
yard |
|
|
millimeter |
sixteenth of an inch |
|
|
sixteenth of an inch |
millimeter |
|
|
yard |
meter |
If a mapping is not defined, such as international nautical mile, a UOM is not mapped and uses the original UOM setting.
UOM database
UOM groups are available to all users and are stored on the PI AF server as part of the UOM database. Each user's UOM group selection in Tools > Options is also stored in the UOM database.
Users with permission to modify the UOM database can modify the UOM groups and mappings, including those shipped by default. For more information, see Configure security for the UOM database.
UOM database import/export
You can import and export UOM groups, as well as their mappings, with File > Export to File and File > Import from File. When you export, ensure that Include All Referenced Objects option is selected.