Quick Start Guide

Overview

This page guides you through the setup and explains basic use of the Lab and In Situ Tool. 

gINT Professional or Professional Plus must be installed and licensed on your computer to use the Lab and In Situ Tool.

gINT trial download and installation

Download gINT

Download the current release of gINT from https://softwaredownloads.bentley.com/ and log-in using your Bentley Select Username and password, for detailed instructions see How to download gINT from Bentley Website. 

If you need a trial installer of gINT, contact to sales@datgel.com.

Install and activate gINT trial

  1. Installation: 
    1. Ensure you are logged in as a local administrator, or have local administrator credentials ready to use.  Run the file gint########en.exe.
    2. The installation of Connection Client and gINT software starts.
    3. When the Custom Setup install wizard form appears, you should set "gINT Standard User Files" to "Entire feature will be unavailable".  This is the default.
    4. Select the gINT product Professional or Professional Plus
  2. Activation: Ensure you are logged into the Bentley Connection Client (program in system tray). If you don't have a Bentley Systems login, then register one. That could be done using a company email or a personal email.  That later will be a safe way to ensure your use of gINT is not later billed as a Quarterly Term License.

Open gINT

Company Information

First time you open gINT, the Company Information window will pop-up. Only the company name is required.

Later, you may access to this window in the menu Help > Company Information

System Properties

When you click OK in the Company Information window, the System Properties window will pop-up. In this window you store the general system properties.

File Location Defaults

The File Locations Defaults are used to quick save and access to the required gINT files folders. It is useful to configure the folders according your workflow.

  1. If you are trialling the software, you can select the Datgel product\gINT Files folder for all options. 
  2. If you are a gINT and Datgel product user, we recommend the following settings.
    1. Set Project Database and Drawings to the top of the folder hierarchy where you store project data
    2. Set Data Template, Scripts and Custom coordinate to the non-project specific folder on your file server, e.g. R:\gINT-Datgel\. Also store the library here.
    3. Check the box, Allow more than one user to open a file for editing.

Data Entry

  1. Check the box for Omit 'Must Save' prompt when save is required.
  2. Do not check European Numeric Format during Data Entry.  This feature causes errors with scientific notation fields and importing data.  Also ensue Windows has dot . for a decimal place.

gIDraw

If you cannot see the drawing cursor in drawing applications, then check Use small drawing cursor.

Output

  1. Set Unspecified Line Thickness (inches): 0.007
  2. Set Unspecified Point Thickness (inches): 0.01
  3. Set Number of digits to force sci. notation on frame divisions: 9
  4. Check Boundary Line inserted below last text segment at a depth.

DXF Files

No change.

General

  1. If you wish to use Database Design, Report Design etc., you must uncheck Hide Design Applications. This is unchecked by default. 
  2. You may like to adjust the Automatic File Backups option.

You may access to this form in the menu File > System Properties

Datgel Lab and In Situ Tool Installation and Licensing

The Lab and In Situ Tool package download from datgel.com

Package Content

The Download .zip folder contains all you need to install and evaluate the Datgel Lab and In Situ Tool. The content is:

  1. Documentation folder includes:
    1. Example reports
    2. EULA
    3. Links to the product and licensing online user guides
    4. Link to email to support.
  2. gINT Files folder includes:
    1. gINT Project, gINT Library and gINT Data Template files .
      1. "dlst X.XX.X lib trial.glb" or "dlst X.XX.X lib.glb" (gINT library file)
      2. "dlst X.XX.X.gpj" (gINT project file)
      3. "dlst X.XX.X.gdt" (gINT data template)
    2. Correspondence files for import and export of data (.gci and .gcx)
    3. Image sub-folders
  3. Example Data
  4. Installation files folder includes:
    1. Datgel Lab and In Situ Tool installer.

Unzip and copy the content of the folder to your local computer.

Installation

Before Installation

A few basic preparations can help ensure an effortless installation.

  • Make sure that the computer where you plan to install the program meets the minimum hardware and software requirements. Win 7 or later, with at least 4 GB of RAM.
  • Connect your PC to Internet before installation (the process may need a working Internet connection).

The Lab and In Situ Tool requires that the Microsoft .NET 4.8 framework is installed on the PC prior to the installation of the Tool. If your PC does not have this, then it will be automatically downloaded and installed during the Tool installation process.

  • Log into the PC with Administrator privileges before starting installation.
  • It is recommended that you exit out of other applications that maybe running on your PC.
  • Close gINT before you start installation.

Install DLL Program

  1. Extract the ZIP download, and Browse to the folder \Installation Files
  2. Double click the file named DatgelLabAndInSituTool-#.#.#.#.exe.
  3. Click Run to begin installation.  Follow on the screen instructions when installation begins:
  4. Click Next on the Welcome to the Datgel Lab and In Situ Tool Setup dialog
  5. Scroll and carefully read the License Agreement, and choose option I Agree, and click Next.
    Alternatively choose I Do Not Agree and click Cancel if you disagree with the license agreement. The installation will stop and exit.
  6. On the Select Installation Folder dialog, either accept the default folder (recommended) or select Browse to specify the folder where you want to install the Lab and In Situ Tool Add-In.
    Leave Everyone bulleted to indicate that anyone logged onto the PC can use the Lab and In Situ Tool Add-In.
    Click Next when ready.
     OPTIONAL  Click on Disk Cost to view the disk space statistics. Click OK when done
  7. Click Next to start installation.
  8. Observe the progress bar to monitor installation progress
  9. Click Close when the Installation Complete dialog is displayed.

Open gINT

  1. Start gINT
  2. When you open gINT if it asked for a library, then browse to the downloaded .zip folder and select the library file (.glb).  Otherwise after gINT opens select File > Change Library, and browse to the aforementioned library. Note: the library is locked for the Trial version.
  3. Select File > Open Project. Browse to the downloaded .zip folder and select the project file (.gpj)

License Activation

Once the installation of the Lab and In Situ Tool is completed, you need to activate the license. The steps to follow are different and depend on if you are testing a Trial version or a Full Licensed version.

Trial version Installation and Licensing

Licensing the Trial Version

A Trial License allows you to use the product for a limited time (typically 14 days) and with a limited number of transactions.

  1. Select Add-Ins > Datgel Lab and In Situ Tool > Licensing. From the license Activation prompt, select Activate a software key license or trial license
  2. Select the option for I want to activate a trial license
  3. Click Next
  4. Click Close
  5. Click Finish

For a detailed explanation see https://docs.datgel.com/license-system/user-guide/obtain-a-license#ObtainaLicense-TrialLicense.
If you need to extend the Trial License, see https://docs.datgel.com/license-system/user-guide/obtain-a-license#ObtainaLicense-ExtendaTrialLicense.

Full Licensed version Installation and Licensing

Validate a Single User Hardware Key

Use this procedure if you have received a Hardware Key with your license purchase.

  1. Make a note of the license number and serial number – you need them to complete the installation.
  2. Select Add-Ins > Datgel Lab and In Situ Tool > Licensing.
    Select the option for Use a hardware key license.
    Click Next.

  3. Select the option for I have an active hardware key and need to enter or update the license number, serial number [or server name].
    Click Next.

  4. Select the Contact Details tab and enter relevant information.
  5. Select the License Details tab and enter relevant details in the Single User Hardware Key area.
  6. Click Validate Single User Hardware Key.
  7. Click Close.
    If the license is not validated successfully, check the following:
    1. Serial Number and License Number has been entered correctly
    2. The Hardware Key is attached to your PC and is the correct key for this product
  8. On the Datgel Tool dialog, click Save.
  9. Click Close.

If you need to validate a Network Key License refer to License Administration.
If you are converting from a software licence to a Single User Hardware Key License, you must deactivate the Software Key License first (refer to Deactivate a Single User Software Key License).

Using the tool

Review existing example data

The gINT files included in the package contain some example data that covers all type of calculations and reports included in the Tool. 

Main Group | Point table stores the general information related to the Borehole (Hole depth, coordinates, elevation, etc). Each row is a test location, such as a borehole or test pit. 

Calculations

The Datgel Lab and In Situ Tool includes calculations for a laboratory tests according the most used standards. 

To test the calculations, go to the Lab-Class | Moisture Content table and select the borehole "V-DLST Golden" from the yellow drop-down list. You can see fields related to the Moisture content test.

Delete the existing green fields.

Click Save or Ctrl+S to initiate the calculations. 

Moisture_Content values are calculated and are written into to the fields.

To test the CBR calculation and graph, go to the Lab-Comp Rel | CBR Tests and select the V-DLST Golden.

The table has data for a CBR test.  Note there are other related tables, CBR, CBR Moisture and CBR Soaking.

Go to Add-Ins > Lab and In Situ Tool > CBR Graph, the graph form will open and you will be able to adjust some parameters.

Output a Graph Report

The full Lab and In Situ Tool library contains 58 reports. 

The following example explains how to output a CBR test report. 

  1. Go to OUTPUT | Graphs
  2. Select the L CR CBR PENETRATION report from the object selector (yellow drop-down list).
  3. Select the desired test from the KeySet picker: Click on the  button and select PointID V-DLST-Golden and specimen depth 0.1.

  4. Click on the button and choose the name for new pdf document. Choose the location and click  Save. Choose resolution 600 dpi.
  5. Click  Export and review the report.
  6. Alternatively, click the    button to preview the report. You can review next page using the yellow drop-down list or press F6 button.





On this page