Bentley Communities
Bentley Communities
  • Site
  • User
  • Site
  • Search
  • User
OpenGround | gINT | Keynetix
  • Product Communities
OpenGround | gINT | Keynetix
OpenGround Wiki Unit Conversion
    • Sign In
    • -OpenGround Wiki
      • -Applications
        • +Admin Portal
        • +Civil 3D Extension
        • +Data Collector
        • +Data Entry Module
        • +Excel Extension
        • +Launcher
        • -OpenGround Professional
          • Professional Release Notes
          • +Professional How To's
          • +Professional FAQ's
          • +Professional Common Issues
          • -Professional User Guide
            • +Components of the Interface
            • +Working with Projects
            • +Snapshots
            • +User Accounts in Professional
            • +Teams
            • +Data Import
            • +Document Management
            • +Logs
            • +Using the Data Entry Tool
            • +Site Plan Production
            • +Trigger Sets, Grid Views and Report Grids
            • +Working with Location Groups and Saved Searches
            • -Components and Configuration Packs
              • Adding New Fields
              • Adding New Tables
              • +Advanced Calculated Fields
              • Changing a Projects Coordinate System
              • +Components
              • Configuring Default Templates
              • Configuring Template Images
              • Configuring the Model Structure
              • Configuring the Units
              • Coordinate Conversion
              • Creating a Picklist Set
              • Data Entry
              • Data Types
              • Default Locations Styling
              • Editing Units
              • Exporting a Configuration Pack
              • Extension Graph Styles Creation
              • Hiding Empty Tables
              • Import and Export Mapping
              • Importing Coordinate Systems
              • Introduction to Configuration Packs
              • Managing Picklists
              • Managing Report Profiles
              • Merging Project Picklists into a Configuration Pack
              • Pack Options
              • +Picklist Set Validation and Caveats of Use
              • Picklist Sets
              • +Setting Project Extents and Viewing Bounds Styling
              • The Data Dictionary
              • Unit Conversion
              • Using Picklists Sets within a Project
              • Validation Rules
            • Depth Linking
            • Editing Data in Professional
            • Exporting Data
            • +Lab Testing
            • Viewing Data in Professional
            • +Background Mapping
            • BGS Ordering Mapping Bundles
            • +Offices and Joint Venture
            • Replicate Location
        • +Portal Technical Preview
        • +Power BI Connector
        • +Template Studio
        • +Upload Portal
        • +Web API and Task Service
        • +Web Portal
      • +Guides and Learning
      • OpenGround Supported Platforms
      • +How To Contact Support
      • Component Center
      • Events
      • Training Guides
      • +Developer Resources

     
     Questions about this article, topic, or product? Click here. 

    Unit Conversion

    OpenGround Cloud Professional has been updated to include the option to report data in its primary unit value as well as a secondary unit value. This is useful as HBSI now will convert data recorded in the field in one unit and report it in a different unit value.

    An example of this being Canadian Geotechnical Engineers who must work with their drilling teams in Ft and Inches in the field while having to report to the client in metres.

    This results in a situation where the data needs to be imported or typed in a different unit to the one used for reporting.

    Data Import

    AGS already has the concept of units but for CSV there is now an added file called Unit Mappings. This file contains a list of all the groups and fields which contain units and then lists these units. On import this file is read and HBSI will perform the conversion if needed.

    For example, if the data was reported in ft. and the HBSI project is set up in metres, HBSI would read the CSV Unit Mappings file is set in feet and convert the values to metres when imported.

    The below is an example of a CSV units mapping file.

    The result in HBSI is the data is successfully imported and the data stored in the CSV file is converted from ft. to m. (see the image below showing the csv file sample data recorded in ft. and

    HBSI reporting in m having been successfully converted)

    Setting Secondary Units and Switching Views

    Despite unit conversion occurring you may also want the ability to report the data in a secondary unit. This may mean that data is recorded in ft. and reported in metres but you still want to see the recorded ft. values in HBSI or a different unit altogether. It is possible to do this by assigning a secondary unit to each of the fields you wish to report in.

    In the Model Manager select a target group to edit, once the fields that belong to the group are displayed you can see there is a new column called Secondary Units.

    By default, the Secondary Units fields are blank so if you then edit the required field you will be able to select a secondary unit.

    The example below shows the Secondary unit being set as mm. Notice that there is a greyed-out field called "Unit Group". Each unit belongs to a Unit Group (in the example this is length). Unit groups cannot be edited.

    After saving the Depth Top field in the Sample Table will display the primary unit of metres and the Secondary Unit of mm. To switch views, open the grid in HBSI and press the Secondary Units button within the grid tools menu.

    The grid view will update to reflect that you are viewing the field in its secondary units. This can be switched back by pressing the button again.

    Errors that Could Occur with Importing Data

    As OpenGround Cloud Professional has added the concept of unit groups and unit conversion there may be instances where there are errors reported during data importing. It is important to review what these errors are. An example of an error is that HBSI will not allow data recorded in a unit to be imported if the target fields unit group is different from the recorded fields. To expand upon this, below is an example where there is an error in unit mappings CSV and when reviewed it shows that the fields Pocket Pen and Torvane cannot be imported because they are recorded in tsf, which is in the pressure unit group and the target fields in HBSI are set to Kn/m3 which is in the density unit group.

    If this occurs, it is imported to check with whoever sent the data to confirm if the recorded unit groups are correct. To rectify the error will involve changing the primary unit to the same unit group as the file. This may not be advised so it is important to consult. This is one example but there could be many others.

    • Share
    • History
    • More
    • Cancel
    • Stephen Evason Created by Bentley Colleague Stephen Evason
    • When: Tue, May 31 2022 10:19 AM
    • Revisions: 1
    • Comments: 0
    Recommended
    Related
    Communities
    • Home
    • Getting Started
    • Community Central
    • Products
    • Support
    • Secure File Upload
    • Feedback
    Support and Services
    • Home
    • Product Support
    • Downloads
    • Subscription Services Portal
    Training and Learning
    • Home
    • About Bentley Institute
    • My Learning History
    • Reference Books
    Social Media
    •    LinkedIn
    •    Facebook
    •    Twitter
    •    YouTube
    •    RSS Feed
    •    Email

    © 2023 Bentley Systems, Incorporated  |  Contact Us  |  Privacy |  Terms of Use  |  Cookies