Some OpenGround data import processes will handle unit conversion if the source value uses a different unit than the destination OpenGround header. These conversions are generally performed automatically without having to include any special expressions in the mapping file. Currently, AGS and CSV imports are the primary formats that handle unit conversion. Note that CSV import will only convert values if the CSV .zip file contains a UnitMappings.csv file (default CSV exports from OpenGround automatically contain this file). See this article for more information.

Other imports may not perform unit conversion automatically, such as for gINT imports or custom CSV imports that do not contain the UnitMappings.csv file. In this case, expressions will need to be included in the mapping file to perform the unit conversion.

In the example below, the SAMP_REC (Sample Recovery Length) value is stored in meters in the gINT Project File. But the target OpenGround header stores the value in millimeters. The mapping below will convert the value from millimeters to meters and round the value to 3 decimal places using the fixed() function.

<field mode="Evaluate" condition="IsDefined('SAMP_REC')" destination="SampleRecoveryLength" expression="fixed(SAMP_REC*1000,3,false)" />