DCT-UG-001 3.11 Datgel CPT Tool User Guide

8/19/2019 DCT-UG-001 3.11 Datgel CPT Tool User Guide

1/250

User Guide

Datgel

CPT Tool gINT Add-In 3.1

DCT-UG-001 - 3.11

September 2014


2/250

DisclaimerThe information in this publication is subject to change without notice and does not represent a commitmenton the part of Datgel Pty Ltd. The software described in this document is furnished under a license agreementor nondisclosure agreement. The software must be used or copied only in accordance with the terms of theagreement.

Every effort was made to ensure accuracy of this information. However, Datgel Pty Ltd makes no warranty asto the correctness of this information or the supplied files.

Printed in Australia. All rights reserved worldwide. No part of this publication may be reproduced in any formor by any means without the prior written consent of Datgel Pty Ltd. Comments are welcome and become theproperty of Datgel Pty Ltd.

All products mentioned are trademarks of the respective producers.

Copyright © Datgel Pty Ltd 2006-2014

Datgel Pty LtdSuite 8, Level 1, The Hub89 - 97 Jones StreetUltimo NSW 2007 Australia

Tel: +61 2 8202 8600Fax: +61 2 8079 5855

Email: [email protected] Website: www.datgel.com

mailto:[email protected]:[email protected]://www.datgel.com/http://www.datgel.com/http://www.datgel.com/mailto:[email protected]


3/250


4/250

CPT Tool gINT Add-In 3.1 DatgelUser Guide ii DCT-UG-001 - 3.11 - September 2014

3.2.23 DG_CPT_TERMINATION .................................................................. ........................................ 33 3.2.24 DG_CPT_TEST_METHOD .......................................................................... .............................. 33 3.2.25 DG_CPT_TRANSFER_SUMMARY_DESC_CONSISTENCY.................................................... 33 3.2.26 DG_CPT_TYPE ................................................... ............................................................. ......... 33 3.2.27 DG_CPT_ZERO_LOCATION ............................................................. ........................................ 33 3.2.28 DG_IMPORT_USER_IMPORT_PARAMETERS ............................................................... ......... 33 3.2.29 DG_LOG_CONSISTENCY_DENSITY .................................................................... ................... 33

4 Processing ................................................................................................................. 35

4.1

Data Import ............................................................................................................................ 35 4.1.1 Tools Menu ........................................................... ............................................................. ......... 35

4.1.2 File Browse Types ................................................................................................... ................... 35 4.1.3 File Types ............................................................. ............................................................. ......... 36 4.1.4 Overwrite Option ............................. ............................................................. .............................. 36 4.1.5 Correspondence File ............................................ ........................................................... ........... 36 4.1.6 Advanced Options .......................................................... ............................................................ 36 4.1.7 Importing Multiple Strokes/Tests into one PointID ...................................................................... 39 4.1.8 Importing only the File Name from the Full File Path ......................................................... ......... 40

4.2 Initiation of the CPT Data Calculation ................................................................................... 40 4.2.1 Primary Table Calculations ...................................................... ................................................... 40 4.2.2 Batch Calculation ............................ ............................................................. .............................. 42 4.2.3 Order of Calculation .. .............................................................. ................................................... 43 4.2.4 Calculation Settings ........................................................ ............................................................ 43

4.2.5

Dissipation Test .............................................................. ............................................................ 45 4.3 CPT Filter ............................................................................................................................... 45

4.4 Groundwater and Overwater Testing .................................................................................... 46 4.4.1 Groundwater Depth for Standard Onshore Testing ........................................................... ......... 46 4.4.2 Overwater Testing ................................................ ............................................................. ......... 46

4.5 Bulk Unit Weight and Void Ratio ........................................................................................... 49 4.6 Depth Correction Due to Inclination ...................................................................................... 49

4.6.1 Applying the Depth Correction due to Inclination Calculation ..................................................... 50

5 Tools and Functions .................................................................................................. 52 5.1 Transfer Description and Consistency Summary .................................................................. 52

5.1.1 Minimum Layer Thickness ......................................................... ................................................. 53 5.1.2 Soil Group Thickness ......................................................................... ........................................ 53 5.1.3 Configuration of description and consistency summary transfer .................. .............................. 54

5.2

Formula Tool .......................................................................................................................... 54 5.2.1 Introduction ........................................................... ............................................................. ......... 54

5.2.2 Formula Toolbar ............................................................. ............................................................ 55 5.2.3 Data Tool Toolbar ........................................................... ............................................................ 56 5.2.4 Formulas Group ........................................ .............................................................. ................... 59 5.2.5 Configuration Group ............................................. ........................................................... ........... 60 5.2.6 Merge/Copy Formulas ............................................................... ................................................. 62

5.3 Data Correction Tool ............................................................................................................. 64 5.3.1 Introduction ........................................................... ............................................................. ......... 64 5.3.2 Formula Toolbar ............................................................. ............................................................ 65 5.3.3 Data Tool Toolbar ........................................................... ............................................................ 66 5.3.4 Formulas Group ........................................ .............................................................. ................... 68 5.3.5 Key Set Group ...................................................... ............................................................. ......... 69 5.3.6 Configuration Group ............................................. ........................................................... ........... 69

5.3.7

Offset and Correction Group ........................................................................ .............................. 70 5.4 Formula Tool and Data Correction Tool Functions ............................................................... 72

5.4.1 Functions ................................................... .............................................................. ................... 72 5.4.2 Special Functions .............................................................................................................. ......... 74

5.5 Unit Conversion ..................................................................................................................... 86 5.5.1 Introduction ........................................................... ............................................................. ......... 86 5.5.2 Project Field Units .............................................................................. ........................................ 86 5.5.3 Library Configuration ....................................................................................................... ........... 87 5.5.4 Unit Conversion of the Current Project ......................................................... .............................. 90

6 Analysis ..................................................................................................................... 92 6.1 Derived Parameters ............................................................................................................... 92

6.1.1 Mechanical Cone Calculations ................................................................................ ................... 93 6.1.2 Friction Ratio Calculation Method ....................................................... ........................................ 94

6.2 Soil Behaviour Type .............................................................................................................. 94 6.2.1

Preconfigured in Library .................. ............................................................. .............................. 94

6.2.2 Creating a New Soil Behaviour Type in a Library .............................................................. ......... 95 6.2.3 Project Soil Behaviour Type .................................................................................... ................... 98

6.3 Correlations ........................................................................................................................... 99


5/250

CPT Tool gINT Add-In 3.1 DatgelUser Guide iii DCT-UG-001 - 3.11 - September 2014

6.3.1 Undrained Shear Strength and Consistency Term ..................................................................... 99 6.3.2 Relative Density and Relative Density Term ............................................................................ 102 6.3.3 Soil Behaviour Type Index ................................. ............................................................... ....... 104 6.3.4 SPT N60 Value ........................................................................................................................ 105 6.3.5 SPT Average N60 Value ......................................................... ................................................. 106 6.3.6 Shear Wave Velocity .................................................... ............................................................ 106 6.3.7 Unit Weight............................................................................................................................... 108 6.3.8 Small-Strain Shear Modulus..................................................................................................... 109

6.3.9

Young’s Modulus ............................................................ .......................................................... 110

6.3.10

Constrained Modulus ........................................................................ ....................................... 111

6.3.11 Coefficient of Volume Change............................. .............................................................. ....... 112 6.3.12 Compression Index ........................................................................... ....................................... 112 6.3.13 Preconsolidation Stress and Overconsolidation Ratio ..................................................... ......... 112 6.3.14 Angle of Friction ............................................................. .......................................................... 115 6.3.15 Effective Cohesion ............................................................................ ....................................... 116 6.3.16 Sensitivity ............................................................ .............................................................. ....... 117 6.3.17 Coefficient of Lateral Earth Pressure ................................................ ....................................... 117 6.3.18 Rigidity Index ....................................................... ............................................................ ......... 118 6.3.19 Hydraulic Conductivity ............................................................. ................................................. 120

6.4 Liquefaction Assessment .................................................................................................... 121 6.4.1 Soil Behaviour Type Index 1 .................................................................................................... 121 6.4.2 Stress Exponent ................................................................................................................... 121 6.4.3 Layer Thickness ................................................................................................... .................... 121 6.4.4

Thin Layer Correction Factor (KH) ............................................................................................ 121

6.4.5 Coefficient of Lateral Earth Pressure 1 ................................... ................................................. 122 6.4.6 State Parameter ................................................................................................... .................... 122 6.4.7 Fines Content (FC) ......................................................... .......................................................... 125 6.4.8 Bulk Unit Weight (Earthquake) .......................................................... ....................................... 125 6.4.9 In-Situ Pore Pressure (Earthquake) ......................................................................................... 125 6.4.10 Total Stress (Earthquake) ................................................................. ....................................... 125 6.4.11 Effective Stress (Earthquake) ............................................................ ....................................... 126 6.4.12 Cyclic Stress Ratio (CSR) ....................................................... ................................................. 126 6.4.13 Overburden Correction Factor ........................................................... ....................................... 127 6.4.14 Normalised Cone Resistance, () .......................................................... ............................ 128 6.4.15 Normalised Shear Wave Velocity () .......................................................................... ......... 129 6.4.16 Clean-Sand Equivalent Normalised Cone Resistance .................................... ......... 129 6.4.17 Modified Normalised CPT Cone Resistance (

) ....................................................... 130

6.4.18

Cyclic Resistance Ratio (CRR) ................................................................................................ 130 6.4.19 Factor of Safety (FoS) ............................................................. ................................................. 133

6.4.20 Liquefaction Potential Index (LPI) ....................... ............................................................ ......... 136 6.4.21 Normalised Residual Shear Strength (′) ................................................................ ........ 136 6.4.22 Relative Density, () ............................................................................................ .................. 138 6.4.23 Maximum Shear Strain, () ........................................................ ....................................... 138 6.4.24 Lateral Displacement Index (LDI) ...................................................... ....................................... 139 6.4.25 Lateral Displacement (LD)........................................................................................................ 139 6.4.26 Post Liquefaction Volumetric Strain, ....................................................... ............................ 141 6.4.27 Post Liquefaction Reconsolidation Settlement, S .............................................................. ....... 144 6.4.28 Liquefaction Severity Number, LSN .................................................. ....................................... 144

6.5 Foundation Correlations ..................................................................................................... 145 6.5.1 Pile Axial Capacity ................................................................................................................... 145 6.5.2 Bulk Unit Weight (Foundation) ............................ .............................................................. ....... 148

6.5.3

In-Situ Pore Pressure (Foundation) .............................................................. ............................ 148 6.5.4 Total Stress (Foundation) ........................................................ ................................................. 149

6.5.5 Effective Stress (Foundation) ............................................................ ....................................... 149 6.5.6 Young’s Modulus Alpha, ................................................................................................ ....... 149 6.5.7 Young’s Modulus, E ..................................................................................... ............................ 149 6.5.8 Shallow Foundation Settlement ......................................................... ....................................... 149

6.6 Lower-Best-Upper Correlations .......................................................................................... 151 6.7 Correlation Summary .......................................................................................................... 152

6.7.1 Default Configuration ............................................................................................................... 152 6.7.2 Custom Configuration .............................................................................................................. 153

6.8 qc and qt Averaging ............................................................................................................. 155 6.8.1 Moving Average ........................................................................................... ............................ 155 6.8.2 Stepped Average ..................................................................................................................... 155 6.8.3 Strata Average .................................................................................. ....................................... 155

6.9

Exclude Fines Layers ......................................................................................................... 155

6.10 Configuring the Design Line .......................................................................................... 155 6.11 Dissipation Test Analysis ............................................................................................... 157

6.11.1 Procedure to analyse a dissipation test in normally consolidated soil ...................................... 157


6/250

CPT Tool gINT Add-In 3.1 DatgelUser Guide iv DCT-UG-001 - 3.11 - September 2014

6.11.2 Procedure to analyse a dissipation test in overconsolidated soil .............................................. 160 6.11.3 Procedure to use forward extrapolation ........................................................ ............................ 162

7 Reports .................................................................................................................... 164 7.1 Report Symbology ............................................................................................................... 164

7.1.1 Symbology Table Structure ............................................................................................... ....... 164 7.1.2 Configurable Options ...................................................... .......................................................... 167

7.2 Log Reports ......................................................................................................................... 169 7.2.1 Dynamic Logs ....................................................... ............................................................. ....... 170

7.3

Fences Reports ................................................................................................................... 171

7.3.1 Adding the CPT Tool fence stick to a non-CPT Tool fence report ............................................ 173

7.4 Graph Reports ..................................................................................................................... 173

8 Tutorials ................................................................................................................... 184 8.1 Creating a Log and Fence Report Column for a new Derived Parameter .......................... 184

8.1.1 Aim ............................................................ .............................................................. ................. 184 8.1.2 Creating the Data Field....................................................................... ...................................... 184 8.1.3 Creating the User System Data .......................................................... ...................................... 184 8.1.4 Adding the Configuration to the Library Table ......................................................... ................. 185 8.1.5 Creating the Dynamic Log Block ............................................................................. ................. 190 8.1.6 Creating the Fence Block ............................................................................. ............................ 193 8.1.7 Replace Field Names in Log and Fence Blocks ....................................................................... 196

8.2 Creating a New Correlation in the Formula Tool ................................................................. 198

8.2.1

Aim ............................................................ .............................................................. ................. 198 8.2.2 Procedure ............................................................. ............................................................. ....... 198

8.3 Creating a Log and Fence Report Column for a new Correlation....................................... 208 8.3.1 Aim ............................................................ .............................................................. ................. 208 8.3.2 Creating the User System Data .......................................................... ...................................... 208 8.3.3 Adding the Configuration to the Library Table ......................................................... ................. 209 8.3.4 Creating the Dynamic Log Block ............................................................................. ................. 213 8.3.5 Creating the Fence Block ............................................................................. ............................ 216 8.3.6 Replace Field Names in Log and Fence Blocks ....................................................................... 219

8.4 Creating a New Unit System ............................................................................................... 221 8.4.1 Aim ............................................................ .............................................................. ................. 221 8.4.2 Adding a new Unit System to the Lookup List ......................................................... ................. 221 8.4.3 Creating the new Configuration Fields ........................... .......................................................... 221 8.4.4 Populating the Configuration Fields .................................................... ...................................... 222

8.4.5

Validating the Configuration and Executing the Unit Conversion ....... ...................................... 223 8.5 Entering a New Unit Quantity .............................................................................................. 226

8.5.1 Aim ............................................................ .............................................................. ................. 226 8.5.2 Procedure ............................................................. ............................................................. ....... 226

8.6 How to change a field unit and make it work with reports ................................................... 228 8.6.1 Aim ............................................................ .............................................................. ................. 228 8.6.2 Step 1 - Change the field unit ................................................................................................... 228 8.6.3 Step 2 - Use the Data Correction Tool to convert the data from kPa to MPa ........................... 228

8.7 How create and configure a new CPT Data table ............................................................... 230 8.7.1 Aim ............................................................ .............................................................. ................. 230 8.7.2 Creating a New Table ................................................................ ............................................... 230 8.7.3 Adding the gINT Rules Table Procedures .................................................... ............................ 232 8.7.4 Adding New Records to the CPT_FIELD_MAP Library Table .................................................. 233 8.7.5 Adding gINT Rules Code to Reference the New Table ..................................................... ....... 234

8.7.6

Colouring the Change Initiates Calculation Fields to Pastel Beige ........................................... 236 9 References .............................................................................................................. 237

Tables

Table 1 - Field Colours ............................................................................................................................. viii Table 2 - Derived Parameters .................................................................................................................. 92 Table 3 - Log Reports ............................................................................................................................ 169 Table 4 - Dynamic Log Report Variables ............................................................................................... 170 Table 5 - Fence Reports ........................................................................................................................ 171 Table 6 - Fence Report Variables .......................................................................................................... 171 Table 7 - Graph Reports ........................................................................................................................ 173


7/250


8/250

CPT Tool gINT Add-In 3.1 DatgelUser Guide vi DCT-UG-001 - 3.11 - September 2014

3. Soil behaviour type correlations by Eslami Fellenius (1997), Ramsey (2002), andSchmertmann (1978)

4. Option to store site specific SBT definition in the project database

5. Non-normalised Soil Behaviour Type Index, ISBT, Robertson (2010)

6. Soil behaviour type index by Been and Jefferies (1992)

7. Pile axial capacity8. Liquefaction factor of safety, residual shear strength, lateral displacement and settlement

9. Database schema restructure of project and point level parameters

10. Log and fence report speed improvement

11. Support for AGS4

12. Control minimum thickness of a SBT layer

13. Option to average qc over sleeve range for Rf and Fr calculation

14. Correlation summary command

15. Import of more data file formats: ConeTec(*.cor), Datem Neptune (*.cdf), Geo-Explorer (*.csv),Gregg Drilling (*.cor) and Vertek (*.ecp)

16. Enhanced support for gINT Professional Plus with SQL Server

17. Faster, multithread calculation

Versions Used When Writing This Document

This user guide has been written using:

CPT Tool gINT Files 3.10

CPT Tool DLL 3.1.3

gINT Professional Plus 8.30.04.206 or later

Windows 7 64 bit operating system

Support

12 months support and maintenance is included with the license purchase. For technical supportplease email [email protected] or call +61 2 8202 8600 or +65 6631 9780.

System Requirements

gINT

The product runs optimally using gINT 8.2.008 or 8.1.2.008 (23/Jun/2010 12:00:00 PM) or higher.

gINT Professional or gINT Professional Plus is recommended as the tool includes fence and graphreports. The product will run using gINT Logs.

Hardware and Operating System

Same system requirements as gINT.

Required Windows Components

1. Windows Installer 3.1

2. .NET 3.5 Framework SP1

mailto:[email protected]:[email protected]:[email protected]:[email protected]


9/250

CPT Tool gINT Add-In 3.1 DatgelUser Guide vii DCT-UG-001 - 3.11 - September 2014

About this guideThis document is intended for use by soil researchers and engineers. Good familiarity is assumed withthe following technologies and environments:

Microsoft Windows and Microsoft Office software. Soil research techniques and terminology

Conventions and typography used in this guide

Note: Tips and additional Information to help you.

> Used to indicate a series of menu commands.

e.g. Select File > Open.

| Used to indicate a gINT Application Group, Application, Table Group or Table , e.g.DATA DESIGN | Project Database

Bold Text Items you must select, command buttons, or items in a list.

e.g. Navigate to UTILITIES | Convert Projects (4th tab).

Italics Emphasis Use to emphasize the importance of a point such as parameters.

e.g. Data Entry – Check Omit Must Save prompt when save is required

CAPITALS Names of keys on the keyboard. for example, SHIFT, CTRL, or ALT.

KEY+KEY Key combinations, for example CTRL+P, or ALT+F4.

Code Snippet Indicates a code snippet within a paragraph

Code sample Indicates a sample program codes inserted in user guide e.g.

public override string ToString ()

File name or path Used for formatting file name and paths e.g. abc_lib.glb or

V:\10 gINT\Datgel Install Files\

Table_Name Database table name, e.g. POINT_TABLE.

Field_Name Database field name; e.g. PointID

ommand line

Command line, presented exactly as it must be entered e.g.

dir


10/250

CPT Tool gINT Add-In 3.1 DatgelUser Guide viii DCT-UG-001 - 3.11 - September 2014

Field Colours

Each of the fields in the project tables have been coloured to improve the data entry process asindicated below in Table 1.

Table 1 - Field Colours

Field Colour Field Name and Explanation

Yellow gINT Key Field – mandatory data entry

Pastel Purple AGS Data – data associated with the AGS DataInterchange format

Pastel GreenCalculated Field – data is written to this field by Datgel’scode

Brown - Green Data Entered and Calculated field

Pastel BeigeData Entry Field – data should be entered into this field,or data in this field influences the calculation

Pastel Red Legacy Data Field – historic data entered here, typicallyan old database

Pastel BlueOutput Option – used to control how the data displayedon a report

Pastel OrangeRemark or Metadata Field – additional data associatedwith the primary information

Grey Read-only

Note: The Datgel CPT Tool is supplied with three database options – DGD SI metric with long table (e.g.

CPT_POINT_PARAMETERS) and field names, DGD EN same names as DGD SI but with English/Imperial units,and AGS RTA with short AGS RTA-compliant names (e.g. GEOL) for non CPT tables.

Both DGD SI and AGS-RTA names are usually given, although only one is relevant to any given site.Screen images are not duplicated and usually show only the DGD SI version


11/250

CPT Tool gINT Add-In 3.1 – DatgelUser Guide 1 DCT-UG-001 - 3.11- September 2014

1 Installation and LicensingIf you’re trialling the CPT Tool, then please first work through the following sections: 1.1 DLL ProgramInstallation, 1.3 Which Database Structure? – DGD SI, DGD EN or AGS RTA, and 2 Quick Start Tutorial . Please also watch the CPT Tool video on datgel.com.

There are five parts to the installation process:

DLL program installation

Merge gINT library objects

Merging project tables and fields

Configure settings in library and project/data template

Activate the product license

The first three steps can be completed in any order and are described below. The activation proceduremust be done last and is described in the Datgel Product Licensing System User Guide.

1.1 DLL Program Installation

The CPT Tool requires that the Microsoft .net 3.5 framework is installed on the PC prior to theinstallation of the CPT Tool. If your PC does not have the .net 3.5 framework SP1 installed, then it willbe automatically installed during the CPT Tool installation process.

You need local administrator rights to the PC to install the CPT Tool.

To install the CPT Tool:

Ensure that gINT is closed

Run the setup.exe file

Follow the prompts

In the following screen, you can either accept the default location for the new file, or change it byclicking Browse. The Disk Cost button shows the space required versus space available on each ofyour disks.


12/250


1.2 Virtual Memory Configuration

This setting is recommended so that Windows can achieve optimal memory use and speed for batchcalculation.

1. Start Menu, right click on Computer > Properties > Advanced System Settings >Advanced tab > Performance section > Settings… button > Advanced Tab > Virtual

memory section > Change… button 2. Uncheck Automatically manage paging file size for all drives

3. Select Custom size radio button.

4. Set Initial size to the same as your installed RAM (e.g. if 8GB RAM, then enter 8192MB)

5. Set Max size to double your installed RAM (e.g. if 8GB RAM, then enter 16384MB)

1.3 Which Database Structure? – DGD SI, DGD EN or AGS RTA

At this point you must decide which CPT Tool database structure to use. The options are:

1. DGD SI stands for Datgel Database with SI/metric units and long table (e.g.CPT_POINT_PARAMETERS) and field names.

2. DGD EN stands for Datgel Database with English/Imperial units and long table (e.g.CPT_POINT_PARAMETERS) and field names.

3. AGS RTA, based on the structure prescribed by the Roads and Traffic Authority of NSW, Australia, and the Association of Geotechnical and Geoenvironmental Specialists. Thedatabase has short AGS RTA-compliant names (e.g. GEOL) for non CPT Tables. This optionuses metric/SI units. From version 3 the CPT specific tables use the DGD naming convention.

Unless you’re currently using an AGS RTA style database, we recommend you adopt the DGD database most relevant for your local practice.

1.4 Merge gINT Library Objects

Note: If you’re in one of the following situations then proceed to Section 1.7 Validate or Activate License.

In the trial version of the CPT Tool, the library will be locked and you cannot merge any gINT Library Objectsinto your Library file, or make changes to this Library file. In this case, you have to use the locked library as-is.

Steps 1.4 to 1.6 have been done by Datgel’s developers or done previously by you or a colleague.

If you don’t have existing gINT files then you may wish to just use the example CPT Tool gINT Files providedon the DVD.

If you have purchased the CPT Tool, then you have full access to the library objects, and you mayproceed with the following steps to merge the gINT Library components into your Library file.

1. Make a backup copy of your existing library file. By default this is located at:

C:\Users\Public\Documents\Bentley\gINT\libraries\

2. Start gINT and open the library and project file you wish to use the Datgel CPT Tool with.

3. If your library has existing library tables with the same name as those in the CPT Tool files,please now delete those tables. To do this, go to DATA DESIGN | Library Tables > File >List…, select the rows to delete, and press the Delete key.

4. If you have an older version of the CPT Tool in your gINT files, it is simpler to delete the libraryobjects prior to merging the new version. This is done by navigating to each library application,e.g. Log Blocks, displaying the List of objects, and deleting those starting with DG CPT .


13/250


5. Select UTILITIES | Lib Merge/Copy.

6. Browse the Source Library File for datgel cpt tool dgd lib #.## .glb

7. Check the Query On Overwrite box, then move all source tables, except Material CompositeSymbols and Tiles, to the yellow box on the right side by clicking the >> button.

8. Click Execute. The process may take several minutes.

This merges the CPT Tool Add-In menu item, gINT Rules modules, user system data and other librarytables relevant for the use of the CPT Tool.

Depending on which page sizes you tend to use, you may find it convenient to not merge the Letter(LET) and 11x17 or the A4 and A3 reports.

1.5 Merge gINT Project File Tables and Fields

1. Open your existing project/data template in DATA DESIGN | Project Database.

2. If you have existing tables for CPT data or old tables for the CPT Tool, you should delete them

now. A simple way to delete multiple tables is to call Tables > List… or click the toolbar button, select the tables to delete, click the delete key, and click OK.


14/250


3. Select Tables > Import Multiple Tables... then browse for either file datgel cpt tool dgd#.## .gpj or datgel cpt tool dgd #.## .gdt.

4. At the minimum, select the tables to import as shown in the following examples, and click OK.The selected blue rows are required. The tables indicated by red boxes are used by reportsand should be merged if your project doesn’t have existing equivalent tables. The rest of thetables are generally ItemKey tables and are used as lookup lists by fields.

a) DGD


15/250


b) AGS RTA

5. Merge fields from POINT. Change the object selector to POINT, and call Tables > Merge fieldsfrom other file…, select datgel cpt tool dgd #.## .gpj or datgel cpt

tool dgd #.## .gdt, then select POINT, and select the fields to merge. If you’reunsure, we suggest merging them all and reconciling them later.

6. Merge fields from PROJECT. Follow a similar process to that for POINT.


16/250


7. Consider report changes to suit your custom project database.

Many of the gINT reports provided with the CPT Tool reference the red boxed tables, and youmay need to update the field references in the reports to work with your custom projectdatabase. In particular you need to consider fields on the POINT and PROJECT tables.

The DATA DESIGN | Project Database | Tools > Compare Databases function will list thetable, field, and property differences between databases. Use this to compare your company’s

project file to the CPT Tool project file.The DATA DESIGN | Project Database | Tools > Replace Field Names function will assistyou to update the CPT library objects to use the fields and tables in your custom project file.

8. In DATA DESIGN | Project Database change the yellow object selector list to the POINT table,call the command Tables > Properties... move to the gINT Rules tab, and place DATGELDGD!OnSave in the gINT Rules Procedure on Save text box. (This can also be configured inINPUT)

9. In INPUT call the command gINT Rules > System Events... and place DatgelDgd!beforecommand in the Before Command text box. (This can also be configured in DATADESIGN | Library Data)

10. Move to INPUT, and run the Add-Ins > Datgel Administrator Tools > Lookup List CheckTool to search for broken lookup list references, and rectify as needed. This step requires theDatgel Administrator Tools to be installed and licensed.

1.6 Initial Configuration

After the library and project merge steps, the following items should be configured:

1. Move to INPUT and reorder the tables within the CPT table group. Select the Table Group,and call Tables > Input Sequence…


17/250


a) CPT

b) CPT-Liquefaction

c) CPT-Foundation

d) CPT-Configuration

2. Move to DATA DESIGN | Library Data, and configure the Graphic_1 and Graphic_2 fields onDG_CPT_SOIL_CLASS_ZONES library table; see 3.2.19 DG_CPT_SOIL_CLASS_ZONES on page32. Select the most appropriate graphics in your library for each soil type zone.

3. Configure DG_LOG_CONSISTENCY_DENSITY library table to be consistent with your soildescription standard. By default, the table is configured with data consistent with AustralianStandard, ASTM and New Zealand Geotechnical Society. We have configured example datafor BS 5930 in DG_LOG_CONSISTENCY_DENSITY_BS_00.xlsx, and if required you can

delete the data in the library table and copy/merge in the data from the Excel file.


18/250


4. Move to INPUT and configure the table and field names for Lithology/Stratigraphy andConsistency/Density as described in 5.1.3 Configuration of description and consistencysummary transfer on page 54 .

5. In SYMBOL DESIGN | Bitmap Symbols, import your company logo into the existing symbolcalled LOGO. This symbol is referenced by all the Tools reports.

Alternatively you can adjust the DRAWINGS | Drawing Library DG COM LOGO to reference

a different Bitmap Symbols.Review how your logo appears on the DRAWINGS | Drawing Library block DG COM FIGURETITLE BLOCK. If required change the block x and y offset.

6. Update the import correspondence files (*.gci) for the numerous CPT formats to work with yourcustom gINT project file. Particularly the POINT and PROJECT tables.

7. Assign correct page sizes and printer to reports. In order to export a report to pdf or otherimage format the correct page size must be assigned.

a) Ensure a printer driver installed on your pc has A3 and 11x17 size.b) Use the command REPORT DESIGN | File > Set printer for reports, pick the printer with

A3 from the printer list, and select the A3 size reports from the reports list.

c) Then go to each A3 and 11x17 size report in REPORT DESIGN by changing the yellowdrop down list. Display the report properties, File > Page > Properties, and set the pagesize to A3 or 11x17. You may also need to adjust the margins. Click Ok.

d) Review the page margins and outlines by clicking on Zoom Page, and move to the nextreport.

8. If you have upgraded from an older version, may now reapply custom configurations such as:

a) Create new fields in CPT project tablesb) Merge formulas into the Formula Toolc) Configure DG_CPT_SYMBOLOGY and DG_CPT_SYMBOLOGY_SCALES_UNITS d) Configure reports

1.7 Validate or Activate License After installation (and before using the CPT Tool Add-in), validate or activate the user license asdescribed in Chapter 2 of the Datgel Product Licensing System User Guide.

1.8 Upgrading From Version 2 to Version 3

1.8.1 DLL program

You may simply install the DLL program over the top of a previous installation.

1.8.2 gINT FilesWe suggest you delete all old CPT Tool specific project tables from your data template, and all CPTspecific library objects from your library including Add-In commands and gINT Rules modules. Thenmerge the new CPT Tool into your library and data template as describe above.

You will need to design a correspondence file to migrate old project to the new project/data templatestructure. We have provided two correspondence files that you can use as a basis:

datgel_cpt_tool_dgd_2.19_to_3.02_02.gci

ags rta 2.21 to ags rta 3.02 00.gci

We recommend you open the relevant file above in DATA DESIGN | Correspondence Files, and do

the following:


19/250


1. Adjust the Source File and Target File properties to point to your old and new data template /project file.

2. Click Refresh Fields All (F5).

3. Save correspondence with a new name.

4. Try converting one file using UTILITES | Convert Projects. Note that gINT will automaticallymake a backup of the project with an extension *.or#.

5. Review the converted file to ensure all data was correctly converted.

When converting projects it will be faster if you a have a library open that doesn’t have gINT Rules modulesfor the CPT Tool, so that all calculations are supressed.


20/250


2 Quick Start Tutorial

2.1 Introduction

This tutorial will introduce you to the basic operations of the CPT Tool; it assumes you have a basic

understanding of gINT INPUT and OUTPUT. If this is the first time you’ve used gINT then we suggestyou read C:\Program Files (x86)\Bentley\gINT\docs\welcome_to_gint_8.pdf.

To learn about more advanced operations of the CPT Tool, refer to 8 Tutorials.

2.2 Preparing

1. First work your way through sections 1.1 DLL Program Installation and 1.3 Which DatabaseStructure? – DGD SI, DGD EN or AGS RTA.

2. Start gINT, and check you’re running 8.2.008 (23/Jun/2010 12:00:00 PM) or 8.1.2.008 or laterby reviewing the version number on the Help > About gINT dialog. If you’re running an older

update, then you should download and install the latest gINT version from Bentley’s SELECTwebsite or the Datgel trial page on www.datgel.com.

3. This tutorial will use our standard DGD SI CPT Tool gINT Files, located on the DVD in foldergINT Files\DGD SI\. If you haven’t done so, copy the folders on the DVD to a location onyour local or network drives. You can also use a set of custom gINT files that already have theCPT Tool tables and objects merged in, as described in section 1 Installation and Licensing.

4. Now, open the datgel cpt tool dgd lib X.XX SI.glb, using File > Change Library.

5. Create a new project, select the command File > New Project > Clone Data Template..., andselect the datgel cpt tool dgd X.XX SI.gdt file, and click Open. Then provide thename Tutorial 1.gpj and click Save.

2.3 Importing CPT and Dissipation Data

1. Launch the Data Import Tool, by calling the command Add-Ins > Datgel CPT Tool > DataImport.

The CPT Tool splash screen should displays, confirming you are now using the CPT Toollicense.

If you’re using a trial license then a form displays how many uses you have remaining. If nothing happens, then confirm you have installed the CPT Tool program by running the

setup.exe file located in the Installation Files folder on the DVD.

http://www.datgel.com/TrialSoftware.aspxhttp://www.datgel.com/TrialSoftware.aspxhttp://www.datgel.com/TrialSoftware.aspxhttp://www.datgel.com/TrialSoftware.aspx


21/250


If you haven’t pr eviously validated your license, i.e. by entering the serial number, licensenumber, contact details, and server name in the case of a network license. Then you willbe prompted to do so now, and you should refer to Chapter 2 of the Datgel ProductLicensing System User Guide, which was included on the DVD in the Documentation folder.

You should now see the Data Import Tool form.

2. In this tutorial we will import GEF files.

a) Set File Type to GEF 1.1.0 (*.gef) b) Set Overwrite Option to Never c) Set Correspondence File to …\datgel_cpt_tool_dgd_si_X.XX_gef_XX.gci. The

gci can be found in the gINT Files\DGD SI\ folder on the DVD. The gci file translatesthe data during the import process between a temporary CSV file created by the CPT Toolcode and the DGD database tables and fields.

Select the Browse… button in the top right of the form, and browse to the \Example CPT

Data Files\ folder from the DVD. Select: "GEF_01.GEF" "GEF_01_D01.GEF""GEF_01_D02.GEF". The *D* files are dissipation test files related to the GEF_01.GEF file. The form should now look similar to the screenshot (apart from the folder paths).

d) Click Execute. There will be a short pause while the Datgel code translates the data, thenyou will see a gINT progress form.


22/250


Finally when the import is complete a gINT Import Log form will display.

It can be useful to review the Source and Target record counts to confirm the data hasimported. The Log also lists overwrite and lookup warnings. In this case the warnings areof little consequence.

You may now like to step through the tables in the project file, and observe the importeddata. Note that some values, such as those on the Project Parameters table are default valuesstored in the data template file we used to make the new project.

2.4 Configuring Parameters and CPT Data Analysis

The following information must be entered for the basic CPT Calculations to occur:

CPT | CPT Data - Upper : Test Number , Cone ID, and (optionally) Groundwater Depth. Set GroundwaterDepth to 0 .

CPT | CPT Data - Lower : Depth, qc, fs, u2 (for CPTu)

CPT | Cone Information: Cone ID, Cone Area Ratio (for CPTu), Cone Sleeve Offset (used to filter rodchange noise for fs), and Cone Diameter (used by dissipation test analysis)


23/250


CPT-Configuration | Point Parameters: (optionally) Groundwater Depth

CPT-Configuration | Project Parameters: Most fields should be set, and these will be used as defaultvalues. In particular to enable basic calculations you should define:

Bulk Unit Weight, default is 17 kN/m3 Bulk Unit Weight Saturated, default is 18 kN/m3 Soil Class Method 1, change to Robertson 1990 Extrapolated

Soil Class Method 2, leave default

Refer to section 4.4 Groundwater and Overwater Testing for a detailed explanation of where to setgroundwater data.

When you change the value of related fields the CPT Tool table calculation will automatically initiate.You can suppress the automatic calculation by checking Suppress Automatic Calculation on Project Parameters,and the calculation can be run later as part of a batch calculation (for more information see section 4.2Initiation of the CPT Data Calculation).

The resulting CPT | CPT Data screen should look like this:

2.5 Transfer Summary of Material Description

We will now transfer a summary of the soil layers to the Strata Main table. Call the command Add-Ins >Datgel CPT Tool > Transfer Description and Consistency for current PointID, then move to MainGroup | Strata Main to see the transferred descriptions. You can edit the description data, and it will not beover written unless you call the Add-In command again.


24/250


2.6 Output a Log

To produce a log output click on the OUTPUT tab.

From the Logs tab, click on the yellow drop down list and select the Report CPTU SU DR A3L. Thenclick on the PointID browse button and select PointID GEF_01.

Then click preview, and you should see this:

2.7 More Information

Refer to section 6.11 Dissipation Test Analysis for a tutorial on that subject.


25/250


3 How the CPT Tool is Organised Almost all of the data and configuration that is created through using CPT can be viewed directly. Youmight not ever need to do this as part of your workflow, but gaining familiarity with this data can provideconfidence about the accuracy of CPT calculations. Some power users also find that it provides a betterunderstanding of the analysis process.

3.1 Project Tables

The test and interpreted data tables are stored in the project database.

A number of constants and assumptions are required in derivations. Many may be set as follows:

At a project level on Project Parameters and Project Correlation Parameters

For each PointID on Point Parameters and Point Correlation Parameters

By depth for a PointID on Point Material Properties

Some may be set for each push (on CPT Data –

Upper ).

This provided you with full control over which level in the hierarchy to use.

3.1.1 Main Group

3.1.1.1 POINT

When an Elevation is changed the Tool will calculate. The PointID and HoleDepth fields must be defined.


26/250


3.1.2 CPT

3.1.2.1 CPT Data – Upper (CPT_GENERAL)

This table defines each CPT stroke within a PointID, since under some circumstances multiple CPTstrokes take place in the same hole. Each stroke has a unique Test Number.

3.1.2.2 CPT Data – Lower (CPT_DATA)

This table stores the actual raw depth related data for each push and derived results related to eachreading.


27/250


3.1.2.3 Cone Information - Upper (CPT_CONE_INFORMATION)

The cone and equipment constants are stored on this table. For example, two important constants arethe Cone Area Ratio and Cone Sleeve Offset.

3.1.2.4 Cone Information - Lower (CPT_CONE_CALIBRATION)

This table can be used to record the calibration dates for each cone.


28/250


29/250


3.1.2.7 Enviro Data (CPT_DATA_ENVIRONMENTAL)

This table is a one-to-one child of CPT_DATA, and stores environmental and some geophysics relatedresults. For the most part this is included for AGS Format compatibility, and the data on this table is notdisplayed on the standard CPT Tool reports.

3.1.2.8 BPT Data (CPT_BPT_GENERAL & CPT_BPT_DATA)

Spherical Ball Penetrometer Data is stored on these tables. In future versions correlations will beadded.


30/250


3.1.2.9 Point Correlation Summary (CPT_POINT_CORELATION_SUMMARY)

This table is populated by the Correlation Summary command / functionality.

3.1.2.10 Correlation Summary (CPT_STROKE_CORELATION_SUMMARY)

This table was added to support AGS 4 Format. Currently users must manually enter summary data inthis table.


31/250


3.1.3 CPT-Liquefaction

3.1.3.1 Liquefaction Data (CPT_LIQUEFACTION_DATA)

One-to-one child of CPT_DATA which stores liquefaction related correlation results.

3.1.3.2 Liquefaction Point Parameters(CPT_LIQUEFACTION_POINT_PARAMETERS)

Stores point level parameters for liquefaction correlation calculations.


32/250


3.1.3.3 Liquefaction Project Parameters(CPT_LIQUEFACTION_PROJECT_PARAMETERS)

Stores project level parameters for liquefaction correlation calculations.

3.1.4 CPT-Foundation

3.1.4.1 Pile Data (CPT_DATA_FOUNDATION)

One-to-one child of CPT_DATA which stores pile capacity correlation results.


33/250


3.1.4.2 Foundation Point Parameters – Upper(CPT_FOUNDATION_POINT_PARAMETERS)

Point level parameters used by foundation calculations.

3.1.4.3 Foundation Point Parameters – Lower(CPT_FOUNDATION_POINT_PARAMETERS_PROFILE)

Depth profile of material type used by pile capacity calculation.


34/250


3.1.4.4 Foundation Project Parameters(CPT_FOUNDATION_PROJECT_PARAMETERS)

Project level parameters used by foundation calculations.

3.1.5 CPT-Configuration

3.1.5.1 Point Parameters - Upper (CPT_POINT_PARAMETERS)

This table stores the Point level constants and assumption values related to derived parameters andsoil behaviour type calculations. Hence if you wish to set the groundwater depth for all strokes for aPointID then that value should be entered into the Groundwater_Depth field on the CPT_POINT_PARAMETERS Table.


35/250


3.1.5.2 Point Correlation Parameters - Upper(CPT_POINT_CORRELATION_PARAMETERS)

Point level constants for correlations are stored in this table.

3.1.5.3 Point Correlation Parameters - Lower(CPT_POINT_MATERIAL_PROPERTIES)

A bulk unit weight, u0, e, Nk, Nkt, Su LB, Su BE, Su UB, FC depth profile may be defined for each PointID

on the CPT_POINT_MATERIAL_PROPERTIES table. The depth ranges for a particular PointID must notoverlap in any way. You will not be able to save the table if overlapping depth ranges are entered.

3.1.5.4 Project Parameters (CPT_PROJECT_PARAMETERS)

Project level constants and parameters related to derived parameter and soil behaviour typecalculations are stored on this table.


36/250


3.1.5.5 Project Correlation Parameters(CPT_PROJECT_CORRELATION_PARAMETERS)

Project level correlation parameters and constants are stored on this table.

3.1.5.6 Project Output Options (CPT_PROJECT_OUTPUT_OPTIONS)

This table stores the project level report output options.


37/250


3.1.5.7 Point Symbology (CPT_POINT_SYMBOLOGY)

This table stores Point level overrides for the settings on CPT_PROJECT_SYMBOLOGY andDG_CPT_SYMBOLOGY.

3.1.5.8 Project Symbology (CPT_PROJECT_SYMBOLOGY)

This table stores Project level overrides for the settings on DG_CPT_SYMBOLOGY. You can set scales,line types etc. for each parameter here for the entire project.


38/250


3.1.5.9 Design Line (CPT_DESIGN_LINE and CPT_DESIGN_LINE_DATA)

These tables define the design line for Cone Resistance and all correlations. In the case of ConeResistance the data is written to the CPT Data table, and can display on log and fence reports. Forcorrelations the data is optionally displayed on Graph reports, and not written to CPT Data. You canassign the Design Line to use on the Project Parameter and Point Parameter tables.


39/250


3.1.5.10 Soil Class Method (CPT_SOIL_CLASS_METHOD)

Definition of project specific Soil Behaviour Type methods.

3.1.5.11 Soil Class Zones (CPT_SOIL_CLASS_ZONES andCPT_SOIL_CLASS_DATA)

Definition of project specific Soil Behaviour Type zones and polygon data.


40/250


3.1.5.12 Formula Configuration (CPT_FORMULA_CONFIGURATION)

This is a hidden table, and stores Project level formulas.

3.1.5.13 Data Correction Configuration(CPT_DATA_CORRECTION_FORMULA_CONFIG)

This is a hidden table and stores Project level Data Correction formulas.

3.2 Library Tables

This section lists library tables that are important to calculation of the CPT Tool and reports.

3.2.1 DG_COM_UNIT_CONVERSION

This table contains a list of the units, conversion factors and equations, and is referenced to convertvalues from one unit to another throughout the CPT Tool.

3.2.2 DG_CPT_AUTO_FILTER

This table is a simple lookup for the filter options.

3.2.3 DG_CPT_CORRELATION_SUMMARY_CONFIG

This table stores Library level data for the correlation summary function.

3.2.4 DG_CPT_DATA_CORRECTION_FORMULA_CONFIG

This table stores Library level data correction formulas.

3.2.5 DG_CPT_DEPTH_ELEVATION_SCALE

Attribute table used by log reports.

3.2.6 DG_CPT_FENCE_BLOCK

Lookup and attribute table used by fence reports.

3.2.7 DG_CPT_FIELD_MAP

Stores the table and field name configuration used by the CPT Tool calculation. This allows you to setnon-standard field and table names. If a parameter is missing the DGD name is used as default.

This table also stores units, field rules and default values used for Unit Conversion for each unit system.

3.2.8 DG_CPT_FORMULA_CONFIGURATION

These table stores Library level formulas for the Formula Tool.

3.2.9 DG_CPT_LOG_BLOCK

Lookup and attribute table used by dynamic log reports.

3.2.10 DG_CPT_MEASUREMENT_SYSTEM

This table is a simple lookup for the measurement system type options, based on the GEF standard.


41/250


3.2.11 DG_CPT_MODIFIED_TIME_FACTOR

Used for dissipation analysis.

3.2.12 DG_CPT_PILE_AXIAL_CAPACITY_LCPC_BEARING

Used for pile axial capacity calculations.

3.2.13 DG_CPT_PILE_AXIAL_CAPACITY_LCPC_FRICTION


3.2.14 DG_CPT_PILE_AXIAL_CAPACITY_LCPC_SOIL


3.2.15 DG_CPT_PORE_PRESSURE_FILTER_POSITION

Used for dissipation analysis.

3.2.16 DG_CPT_SCALE_TYPE

This table is a simple lookup for the soil classification graph type options.

3.2.17 DG_CPT_SOIL_CLASS_DATA

This table stores the soil classification polygon data. Users can add their own classification methods.


42/250


3.2.18 DG_CPT_SOIL_CLASS_METHOD

This table stores the names and graphing options for each soil classification method.

3.2.19 DG_CPT_SOIL_CLASS_ZONES

This table stores the descriptions and graphics for each soil classification zone.


43/250


44/250



45/250


4 ProcessingThis section provides information that is helpful for gaining an understanding of the end-to-end workflowusing the CPT Tool. After completing this section, you can use this information to develop greatercontrol over processing. This will enable you to achieve accurate, repeatable results. Importing dataenables you to work with data created by many hardware manufacturers, without the effort of manualdata entry or copy-paste. The import feature supports a wide range of standard data formats

You can use processing functions to apply repetitive corrections, e.g. apply calibrations.

4.1 Data Import

The Data Import Tool allows you to import data from various file formats into gINT. The command islocated in INPUT Add-Ins > Datgel CPT Tool > Data Import.

On load the default setting will populate the form. In addition, the previous correspondence file used foreach file type be loaded as default.

4.1.1 Tools Menu

Load Defaults: Loads all selections, field values and the initial directory that has beenpreviously saved as default.

Save Defaults: Saves defaults for File Browse Type, Friction Sleeve Offset, and OverwriteOption.

Set Initial Directory: Sets the initial browse directory so that every time you browse, it will start

at the set directory.

About: Displays the version information of the Data Import Tool.

4.1.2 File Browse Types

Individual Files: Select one or more files in a single folder manually.

Folder : Select a folder and all relevant files in that folder are selected automatically.

Folder and Sub-Folders: Select a folder and all relevant files in that folder and its sub-foldersare selected automatically.

Files paths may be manually entered or deleted from the large text box.


46/250


4.1.3 File Types

A.P. van den Berg Gorilla! (*.*) – CPT and Dissipation

Access database files (*.gpj; *.mdb)

AGS (*.ags)

ConeTec (*.cor) Datem Neptune (*.cdf)

Delimited Depth qc fs u (*.*) – simple file with no header, and data delimited by tab, ",", ";", or":". The u data is not required, and the columns must be in the order Depth qc fs u. The filename (without the extension) will be used as the PointID.

Douglas Partners (*.*)

GEF 1.1.0 (*.gef) – CPT and Dissipation. The friction shift is applied for 1.0.0 version filesonly

See: http://www.geffiles.org/

Geo-Explorer (*.csv)

Geomil PlotCPT (*.T*)

gINT CSV (*.csv; *.txt) – regular gINT compliant csv file.

gINT Excel (*.xls) – regular gINT compliant excel file.

Gregg Drilling (*.cor)

Hogentogler (*.cpd)

Pagani (*.cpt)

Pagani (*.dat)

ProbeDrill (*.txt; *.dis) – you must import *.txt and *.dis files together. The *.dis fileand *.txt file for the one location MUST has the same file name

Swedish Geotechnical Format (SGF), used by Geotech AB and Envi A.B. (*.cpt; *.dpt;*.ini)

See: http://www.sgf.net/home/page.asp?sid=862&mid=2&PageId=21095

Vertek (*.ecp)

4.1.4 Overwrite Option

These are the standard gINT overwrite options.

4.1.5 Correspondence File

gINT correspondence files need to be developed or altered to meet the needs of each companies gINTproject database for each data source file type. We have provided example files that meet the needs ofDatgel’s standard project files.

4.1.6 Advanced Options

Click on the Advanced button to show the Advanced Options panel. To hide the Advanced Optionspanel once it is open, click on the Simplified button.

http://www.geffiles.org/http://www.geffiles.org/http://www.geffiles.org/http://www.sgf.net/home/page.asp?sid=862&mid=2&PageId=21095http://www.sgf.net/home/page.asp?sid=862&mid=2&PageId=21095http://www.sgf.net/home/page.asp?sid=862&mid=2&PageId=21095http://www.sgf.net/home/page.asp?sid=862&mid=2&PageId=21095http://www.geffiles.org/


47/250


There are two features in the Advanced Options panel, reate Temp Import File and User ImportParameters.

4.1.6.1 Create Temp Import File

During the import process the initial data files are read and transferred to a temporary file in gINTcompatible CSV format. If this box is checked, the Data Import Tool will bring up a new windowshowing the contents of this temporary file, and will not continue with the import. This can be saved asa CSV, and used as the source when designing an import correspondence file.


48/250


In this interface, click Save As to save the text as a file, or Print to print the text on a printer. You mustsave the text as a file before you can modify the text. This file can be imported into gINT with the DataImport Tool with gINT CSV selected as the File Type.

4.1.6.2 User Import Parameters

The User Import Parameters feature allows you to insert custom fields into the tables in the temporaryimport file, thus allowing you to reference the custom field in the correspondence file, and import theparameter value into gINT.

This enables you to import values that are not in the data file without needing to modify the data fileitself.

The User Import parameters configuration is stored in a library table calledDG_IMPORT_TOOL_USER_IMPORT_PARAMETERS . This table must exist in the current library to use theUser Import Parameters, if it does not exist then the grid will be disabled.

To save the User Import Parameters to the configuration table, go to Tools > Save User ImportParameters to Library.

The User Import Parameters currently only works for Swedish Geotechnical Format (SGF) (*.cpt;

*.dpt; *.ini) files.

The Parameters will be created as fields in all tables in the temporary import file, and will be prefixedwith UIV , followed by a space. Each row of the table will have the specified value in the column. Thiswill apply for all files selected for import.


49/250


Description of the columns are as below:

Parameter – The name of the parameter. The parameters will be created as fields in all tablesin the temporary import file, and will be prefixed with UIV , followed by a space. E.g. UIV

Baselate Penetration. Unit – The unit of the parameter. This field is metadata and is optional. It does not affect the

User Import Parameter in any way.

Value – The Value of the parameter. Each row of the table will have the specified value in thecorresponding parameter column.

Description – Description of the Parameter. This field is metadata and is optional. It does notaffect the User Import Parameter in any way.

4.1.7 Importing Multiple Strokes/Tests into one PointID

The Depths in all strokes within the one PointID must have the same zero depth reference, hence if

multiple strokes are done down a borehole, then when importing the Depth field must be populated withpre-drill Depth plus the push depth. This can be achieved in the correspondence file if the predrill depthin recoded in the source data file.

Gorilla files are a common offshore data file format, and we have seen files with the start depth of eachtest recorded in fields titled Reference Level and Depth Borehole.

[TEST]

job number=BH-CPTU-S8-BLclient=PETRONAS CARIGALIjob description=SEPAT 8 LOCATION.

..operator=ZAHID/HILMI


50/250


reference level=3.0reference point=M.S.Lpre drilled=0.0GORILLA!-remark 1=...GORILLA! serie #=

NORM=KTN/PCSB/08/268/SISTART DEPTH=Seabed ref level=Seabed ref point=Depth borehole=3.0Vanedepth=

[SCALING FACTORS]...[DATA]*D:0.02#1:0.01#2:0.000#4:4#0:28!*D:0.04#1:0.01#2:0.000#4:4#0:29!

*D:0.06#1:0.03#2:0.000#4:3#0:30!*D:0.08#1:0.04#2:0.001#4:4#0:31!*D:0.10#1:0.05#2:0.001#4:4#0:32!

Gorilla File Example with relevant depth information highlighted

Two correspondence files read the start depth from the different fields and calculate the true depth ofeach reading below the borehole reference level (typically seabed).

datgel_cpt_tool_dgd_X.XX_gorilla_cpt_Depth_Borehole_##.gci

datgel_cpt_tool_dgd_X.XX_gorilla_cpt_Reference_Level_##.gci

After importing a set of test files for one PointID, you will need to manually set the POINT.HoleDepth fieldwith the correct maximum depth of the test.

4.1.8 Importing only the File Name from the Full File Path

If the full file path of the source file is being imported, but you only want to import the file name, you canmodify the gINT correspondence file (.gci) to extract the file name from the full file path to import intogINT.

Open the gINT correspondence file in a text editor, and then search for the field name where the filepath is being directed to (for example, File_Reference). Replace the existing expression with thefollowing:

)>>

Where is the original expression that retrieves the full file path for thatparticular field.

4.2 Initiation of the CPT Data Calculation

4.2.1 Primary Table Calculations

The primary CPT calculation is initiated by changing data then saving on the following tables (or thesplit screen parent of these tables):

POINT

CPT_GENERAL


51/250


CPT_DATA, and any one to one child tables of CPT_DATA

CPT_DATA_ENVIRONMENTAL

CPT_DATA_LIQUEFACTION

CPT_DATA_LOWER_BEST_UPPER

CPT_DATA_FOUNDATION

CPT_CONE_INFORMATION

CPT_DESIGN_LINE

CPT_DESIGN_LINE_DATA

CPT_FOUNDATION_POINT_PARAMETERS

CPT_FOUNDATION_POINT_PARAMETERS_PROFILE

CPT_FOUNDATION_PROJECT_PARAMETERS

CPT_LIQ_POINT_PARAMETERS

CPT_LIQ_PROJECT_PARAMETERS

CPT_POINT_CORRELATION_PARAMETERS

CPT_POINT_MATERIAL_PROPERTIES

CPT_POINT_PARAMETERS

CPT_PROJECT_CORRELATION_PARAMETERS

CPT_PROJECT_PARAMETERS

Additional tables can be configured to initiate the CPT calculation. This is set in the CPT_FIELD_MAP librarytable, by checking the Change_Initiates_Calc check box for the table record. See the appendix for instructionson setting up a new CPT Table, and configuring it to initiate the CPT calculation if values have changed.

The calculation will only take place if a Pastel Beige coloured field has been modified on the abovetables. This allows you to change metadata fields that do not have any effect on the calculation withouthaving to recalculate the CPT test.

The exception to this is the CPT_DATA table, and one to one child tables of CPT_DATA. The calculationwill occur if any cell has been modified, regardless of colour.

The CPT calculation on POINT will only run when an existing POINT record has records on the CPT_DATA table, and the Elevation has changed and the new Elevation has a value.

The automated CPT calculation when saving on these tables can be stopped by checkingSuppress_Automatic_Calculation on CPT_PROJECT_PARAMETERS. If it is checked, then the CPT will beflagged for pending calculation (see section 4.2.2).

The calculation will not run when converting projects.

Unless the Suppress_Calculation_on_Import on CPT_PROJECT_PARAMETERS is checked, the calculation willtake place upon import.

The table below lists the action taken on import under all combinations of theSuppress_Calculation_on_Import and Suppress_Automatic_Calculation values.

Suppress Calculation on Import Suppress Automatic Calculation Action Taken

FALSE FALSE CPT calculatedTRUE FALSE CPT not calculated, not flagged


52/250


pending calculation

FALSE TRUE CPT Calculated

TRUE TRUE CPT flagged pending calculation

When calling gINT Rules > Recalculate Current Table from a CPT Table, a form will display, givingyou the following options:

Yes: will recalculate all CPTs in the project, this is equivalent to changing a value on the

Project Parameter table. This is the fastest way to revaluate the entire database of CPTs. Aprogress bar will be shown to display the progress of the calculation. This is normally theoption to pick.

No: will use gINT’s native recalculate current table, which can be a very inefficient way tocalculate the database of CPTs. This option is not recommended.

Cancel: Cancels the call, and nothing is calculated.

4.2.2 Batch Calculation

The Batch Calculation feature allows you to make changes to the CPT data, and flag the affected CPTsas pending for calculation instead of running the calculation immediately. An example of where thisfeature may be useful is if you needed to enter the groundwater depth for each CPT on theCPT_GENERAL table. It is much more convenient to calculate the CPTs after you have entered thegroundwater depth for all tests at once rather than calculate each time you change of the groundwaterdepth.

A CPT is flagged for calculation by inserting the current date time into the Calculation_Pending field on theCPT_GENERAL table. When the CPT is calculated, the Calculation_Pending field is cleared for that CPT.

The CPT Tool will flag CPTs for batch calculation in place of running the CPT calculation, if theSuppress_Automatic_Calculation checkbox on CPT_PROJECT_PARAMETERS is checked. Like the CPTcalculation, the Batch Calculation feature will flag all CPTs that were affected by the change. Forexample, changing the values for a Cone ID record in the CPT_CONE_INFORMATION table will flag allCPTs that reference the modified Cone ID for batch calculation.

The Batch Calculation Form allows you to view a list of flagged CPTs that are pending calculation, andcalculate all, or a selection of CPTs.

To launch the Batch Calculation Form, call the command INPUT | Add-Ins > Datgel CPT Tool > BatchCalculation, or press Ctrl + Shift + B.

You should see a window similar to the following.


53/250


The form will display a list of the CPTs that have been flagged as pending calculation on the PendingTests to Calculate grid. When OK is clicked, the Batch Calculation Form will initiate the calculation forthe CPTs that are listed on the Selected Tests to Calculate grid.

You may use a combination of left click, left click-drag, ctrl + click and shift + click to select the desiredCPTs, and the arrow buttons in the middle to move CPTs to the right or left grid.

An explanation of the commands is as below:

Show All Tests – Check this to show all CPTs in the Pending Tests to Calculate grid,regardless of if they have been flagged pending calculation. Uncheck to hide the non-flaggedCPTs.

Clear All Pending – Clears the Calculation Pending flag on all CPTs without calculating them.

Select All Pending – Selects all CPT calculations pending

OK – Closes the form and initiates the CPT calculation for CPTs listed in the Selected Tests to

Calculate grid. Calculated CPTs will be cleared of the Calculation Pending flag. A progressform will appear to display the progress of the calculations.

Cancel – Closes the form without calculating any CPTs.

4.2.3 Order of Calculation

The order of calculation is:

1. Derived parameters

2. Soil Behaviour Type

3. Formula Tool – Library formulas

4. Formula Tool – Project formulas

4.2.4 Calculation Settings

The calculation settings form may be displayed be either calling the command Add-Ins > Datgel CPTTool > Settings, or clicking on the Settings hyperlink located in the bottom left corner of the batchCalculation form.


54/250


Batch Calculation

Batch Size Denominator : The denominator of the fraction applied to available memory in orderto calculate the size of each sub-batch. The default value is 32, meaning that 1/32nd ofavailable memory will be used to store each sub-batch's data.

Log Formula Exceptions: Include errors from the Formula Tool formulas in the BatchCalculation Report, in order to help optimise the performance of formula calculations

Maximum Strokes Per Sub-batch: This Setting applies to SQL Server databases only. If abatch contains a large number of short Strokes, then the length of the resulting queue ofStrokes waiting to be processed will grow large. This may have a detrimental effect on thespeed of the batch calculation. On SQL Server it may cause connection dropouts and failure toupdate a Stroke with the newly calculated values. Setting this value may help stop these kindsof issues. 30 is the default and recommended value. When set to 0, this setting is not applied.

Threading

Maximum Threads Per Processor : Each CPT calculation is performed in a separate multi-tasking process called a "Thread". This specifies the maximum number of CPT calculations(Threads) that can be concurrently handled by a processor. 1 or 2 are the only recommendedvalues.

Processor Count Meth