Add UOM mappings for OSIsoft PI tags
- Last UpdatedJan 31, 2025
- 2 minute read
By default, when you add a tag to a tag collection, the Sim Units value uses the unit of measure (UOM) that's currently selected in the simulation for the associated model variable. You can change the Sim Units value to match the Tag Units value as needed. However, if you repeatedly make the same changes, you can instead add a UOM mapping for OSIsoft PI tags. Any defined UOM mappings automatically override the Sim Units value based on the corresponding Tag Units value.
We store the UOM mappings in the External Data UOM Autocomplete.csv file in the AVEVA Process Simulation installation. The location of this file changes based on how you installed AVEVA Process Simulation. The following table shows the possible folder locations for this file.
|
Edition |
Install Location |
Folder |
|---|---|---|
|
Single-user |
Default |
%LocalAppData%\SimSci\SimCentral\Server\Extensions\OSIPIProvider |
|
Single-user |
Custom |
<InstallFolder>\SimCentral\Server\Extensions\OSIPIProvider, where <InstallFolder> is the destination folder that you specified during the install |
|
All-users |
Default |
%ProgramFiles%\SimSci\SimCentral\Server\Extensions\OSIPIProvider |
|
All-users |
Custom |
<InstallFolder>\SimCentral\Server\Extensions\OSIPIProvider, where <InstallFolder> is the destination folder that you specified during the install |
The External Data UOM Autocomplete.csv file that comes along with the install already contains a few example UOM mappings. These examples show the format that you should use when you add your own UOM mappings to the file.
Add UOM mappings
-
In Windows File Explorer, browse to the External Data UOM Autocomplete.csv file, and then open it in any text editor or in Microsoft Excel.
-
At the end of the list of comma separated values, on a new row, enter the Tag Units value, a comma, and the corresponding Sim Units value.
If you opened the .csv file in Microsoft Excel, you do not need to enter the comma to separate the two UOM entries. Instead, ensure that you enter the Tag Units value in column A and the Sim Units value in column B.
-
Repeat step 2 until you've added all the desired UOM mappings.
-
Save and close the file.
We recommend that you always save and use the included .csv file and do not use the Save As option to create a new version of the .csv file. This ensures that the .csv file uses the proper text encoding (UTF-8) so that all special characters, such as the degree symbol, appear correctly in AVEVA Process Simulation.
-
Restart AVEVA Process Simulation if you had it open while you were adding UOM mappings.