Quick Start Guide

Overview

This page guides you through setup of the Datgel Output Tool and explains some basic operations. It assumes you have a basic understanding of gINT INPUT and OUTPUT.

gINT

gINT Logs, Professional or Professional Plus must be installed and licensed on your computer to use the Output 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 Output Tool Download

Download the Output Tool package and Datgel Toolbox Installer:

Install Datgel Toolbox

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.
  • Connect your PC to Internet before installation (the process may need a working Internet connection).
  • The Datgel Toolbox program 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.

Installation

  • Run the installer, typically named Datgel.Toolbox.20##.#.#_YYYY-MM-DDTHHmmss.exe.
  • When you come to the Components screen, be sure to select this product, or you can simply install all Components. 
  • The gINT*.exe.config files for gINT versions V8i and 10..# are edited by Datgel software during installation.

Datgel Licensing

Trial Version
  • Datgel's license system is based on a user identity created when you registered on datgel.com, called Datgel ID.
  • When you first download a trial package a limited duration license is assigned to your Datgel ID, which would expire normally after 14 days.
  • When you open the trial product library, the license check will be prompted.  Your default web browser will open and you will be asked to login with your Datgel ID.
  • The trial form will show each session, showing the count down to expire and links to purchase.
  • You can also see the status in the Datgel Licensing Manager app.
Full Version
  • Datgel's license system is based on a user identity created when you registered on datgel.com, called Datgel ID.
  • When you open the product library or otherwise first run the product in that session, the license check will be prompted.  Your default web browser will open and you will be asked to login with your Datgel ID.
  • You can also see the status in the Datgel Licensing Manager app.

Package Content

The Download package zip contains:

  1. Documentation folder includes:
    1. EULA
    2. Links to the product and licensing online user guides
    3. Link to email to support.
  2. gINT Files folder includes:
    1. "dot X.XX.X lib.glb" (gINT library file)

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

Open gINT

  1. Start gINT
  2. When you open gINT if it asked for a library, then browse to the library that you selected for the gINT Object Installer step.
  3. Select File > Open Project. Browse to a project that works with the selected library.

Using the tool

Aim: PDF a set of reports (log and two graphs) collated by PointID

The reports used in the example are in the Datgel DGD Tool.  You can download the trial of the DGD Tool, and use it with the Output Tool.  The Output Tool gINT objects are already merged into the DGD Tool library.

A more common use of Group by Key Set, is to output a non-cored and cored borehole logs.

  1. Launch the Output Tool, by selecting Add-ins > Datgel Output Tool > Output Tool.
  2. Set the configuration like the next image (click to enlarge)

    1. Configuration type: Group By Key Set,
    2. Key Set > Source Table: Point,
    3. Key Set: Select the desired points to be printed - BH 2 and BH 3 in the example
    4. Select the destination file name
    5. Set the Bookmarks. Level 1: Key Set, Level 2: Report Name. If you are using the DGD Tool, you could select Report Caption for Level 2.
  3. Now go to the Reports tab, and set the configuration like the next image. The Report Type and Report Name fields drop-down lists are populated with the reports existing in your library.

    1. Report Type: Log, Report Name: Select a soil borehole log report (IS AU BOREHOLE 1 in the example)
    2. Report Type: Log, Report Name: Select a cored borehole log report (IS AU CORED BOREHOLE 1 in the example)
    3. Report Type: Graph, Report Name: Select your desired report (A L CS MC VS DEPTH BY PTID in the example)
    4. Report Type: Graph, Report Name: Select your desired report (A L CS ATTERBERG BY PTID in the example)
  4. Click on Execute. You will be prompted to save the configuration. Then gINT will print the reports and save the pdf file in the selected folder. The resulting report contains the Log and the Graphs for each PointID, compiled by PointID, with the bookmarks automatically created according to the settings.

Further Tutorials

When you are comfortable with basic operations with the Datgel Output Tool, you can learn about more advanced operations in section Tutorials.

On this page