Getting Started
Overview
This section guides you through setup of the CPT Tool and explains some basic operations. It assumes you have a basic understanding of gINT INPUT and OUTPUT. If this is the first time you've used gINT, it would be helpful to first read the Welcome to gINT V8i guide: C:\Program Files (x86)\Bentley\gINT V8i\docs\welcome_to_gint_V8i.pdf
When you are comfortable with basic operations with the CPT Tool, you can learn about more advanced operations in section Tutorials.
Preparing
- First work your way through sections DLL Program Installation and Which Database Structure? – DGD SI, DGD EN or AGS RTA.
- Start gINT, and check you're running 8.2.008 (23/Jun/2010 12:00:00 PM) or later by reviewing the version number on the Help > About gINT dialog. If you're running an older update, download and install the latest gINT version from Bentley's SELECT website or the Datgel trial page on https://www.datgel.com/trial-software.
- This tutorial uses Datgel's standard DGD SI CPT Tool gINT Files, located on the downloaded .zip folder in folder gINT Files\DGD SI\. Copy these folders from the downloaded .zip folder to a location on your local or network drives. If you are using the full license of the CPT Tool you can also use a set of custom gINT files that already have the CPT Tool tables and objects merged-in, as described in sections Merge gINT Library Objects and Merge gINT Project File Tables and Fields.
- Open the datgel cpt tool dgd lib X.XX.glb, using File > Change Library.
- Create a new project, select the command INPUT | File > New Project > Clone Data Template..., and select the datgel cpt tool dgd X.XX SI.gdt file, and click Open. Then provide the name Tutorial 1.gpj and click Save.
Importing CPT and Dissipation Data
- Launch the Data Import Tool, by selecting Add-Ins > Datgel CPT Tool > Data Import.
The CPT Tool splash screen should display, confirming you are now using the CPT Tool license.- 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 .zip folder.
- If you haven't previously validated your license, i.e. by entering the serial number, license number, contact details, and server name in the case of a network license. Then you will be prompted to do so now, and you should refer to Validate the License.
You should now see the Data Import Tool form.
- In this tutorial we will import GEF files.
- Set File Type to GEF 1.1.0 (.gef)*
- Set Overwrite Option to Never
- Set Correspondence File to …\datgel_cpt_tool_dgd_si_X.XX_gef_##.gci. The gci can be found in the gINT Files\DGD SI\ folder on the downloaded .zip folder. The gci file translates the data during the import process between a temporary CSV file created by the CPT Tool code 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 downloaded .zip folder. 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).
- Click Execute. There will be a short pause while the Datgel code translates the data, then you will see a gINT progress form.
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 has imported. The Log also lists overwrite and lookup warnings. In this case the warnings are of little consequence.
You may now like to step through the tables in the project file, and observe the imported data. Note that some values, such as those on the Project_Parameters table are default values stored in the data template file that was used to make the new project.
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 Groundwater Depth 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 rod change noise for f_s), and Cone Diameter (used by dissipation test analysis)
- CPT-Configuration | Point_Parameters: (optionally) Groundwater Depth
- CPT-Configuration | Project_Parameters: Most fields should be set, and these will be used as default values. 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 Groundwater and Overwater Testing for a detailed explanation of where to set groundwater 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 Data Entry for Begemann Mechanical CPT).
The resulting CPT | CPT_Data screen should look like this:
Transfer Summary of Material Description
A summary of the soil layers will be transferred to the Strata Main table. Select Add-Ins > Datgel CPT Tool > Transfer Description and Consistency for current PointID, then move to Main_Group | Strata_Main to see the transferred descriptions. You can edit the description data, and it will not be over written unless you run the Add-In again.
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. Then click on the PointID browse button and select PointID GEF_01.
Then click preview, and you should see this:
More Information
Refer to section Dissipation Test Analysis for a tutorial on that subject.