Importing Drilling Data
Leapfrog Geo can import drilling data from the following sources:
- Files stored on your computer or a network location
- From a Central project’s Data Room
- From any database that runs an ODBC interface
- From an acQuire database
For each of these options, once the data source is selected, the process of importing drilling data is the same. See Importing Data Tables and Mapping Data Columns in the Working With Data Tables topic for an overview of how to map data columns in files to the format Leapfrog Geo expects.
The rest of this topic discusses the data format required for importing drilling data, how to connect to different data sources, how to add more tables to a drilling data set and the drillhole desurveying options available in Leapfrog Geo. It is divided into:
- Expected Drilling Data Tables and Columns
- Importing Drilling Data From the Central Data Room
- Connecting to an ODBC Data Source
- Connecting to an acQuire Database
- Setting Elevation for Collar Points
- Adding More Tables to a Drilling Data Set
- Desurveying Options
Expected Drilling Data Tables and Columns
Required table types for importing drilling data are:
- A collar table
- A survey table
- At least one interval table
Downhole points tables can also be imported, but are optional.
A screens table can be imported, if you have the Hydrogeology extension.
The following formats are supported:
- CSV Text File (*.csv)
- ASCII Text File (*.asc)
- Plain Text Files (*.txt)
- Data Files (*.dat)
- TSV Text Files (*.tsv)
The Collar Table
The collar table should contain five columns:
- A drillhole identifier
- The location of the drillhole in X, Y and Z coordinates
- The maximum depth of the drillhole
A collar table can also contain a trench column, and collars marked as trenches will be desurveyed in a manner different from other drillholes. See Desurveying Options for more information.
Leapfrog Geo expects a 0 for a normal hole and a 1 for a trench. If there is no trench column in the collar table, Leapfrog Geo will create one.
The drillhole ID is used to associate data in different tables with a single drillhole. The ID for a drillhole must be identical in all tables in order for data to be associated with that drillhole. Inconsistencies in the way drillholes are identified are common sources of errors.
The maximum depth column is optional. If it is present, is used to validate the data imported for the interval tables. The maximum depth specified is often a planned quantity, whereas the interval table records actual measurements. For this reason, Leapfrog Geo has an option for fixing the maximum depth value in the collar table to match the data in an interval table.
If maximum depth information is not included in a collar file, Leapfrog Geo will determine it from the maximum depth sampled as indicated by data in the interval tables.
The Survey Table
For the survey table, Leapfrog Geo expects a minimum of four columns:
- A drillhole identifier
- Depth, dip and azimuth values
By default, Leapfrog Geo assumes that negative dip values point up. If this is not the case, tick the Negative survey dip points down option.
See Desurveying Options for more information on the drillhole desurveying algorithms used in Leapfrog Geo.
The Screens Table
A screens table can only be imported if you have the Hydrogeology extension.
For the screens table, Leapfrog Geo expects a minimum of four columns:
- A drillhole identifier
- Start/from and end/to depths
- A value column
Interval Tables
For interval tables, Leapfrog Geo expects, at minimum, four columns:
- A drillhole identifier
- Start/from and end/to depths
- A column of measurements
If a drillhole ID in an interval table does not correspond to one in the collar table, the table can still be imported but the interval table will contain errors.
Supported column types are:
- Lithology columns containing lithologic data, which can be used for geological modelling.
- Numeric columns containing numeric values, which can be used for interpolating data.
- Category columns, which is text representing categories such as company, geologist, or mineralisation.
- Text columns containing text data that is not categorical, such as comments. Text columns are not validated when imported.
- Date columns containing date data. Custom date and timestamps formats are supported.
- URL columns. Use the prefix file:/// to link to local files.
- Hex colour columns containing RGB triplets.
When an interval table is displayed in the scene and an interval is selected, clicking on a link in the URL column will open the link. This is a useful way of linking to, for example, data files or core photo images from within Leapfrog Geo:
Points Tables
For downhole points tables, Leapfrog Geo expects the following columns:
- A drillhole identifier
- Depth
Importing Drilling Data From the Central Data Room
Drilling data can only be imported from a project’s data room. Although drilling data can be published to Central, that is for the purpose of visualising the data in the Central Browser and the Central Portal. Published drilling data cannot be imported into other Leapfrog Geo projects.
See the Storing and Accessing Data in the Project Data Room topic in the Central 4.0 help for information on how to work with a Central project’s data room.
To import drilling data from Central, first make sure you are connected to a Central server. Next, click on the Drillhole Data folder and select Import Drillholes via Central. In the window that appears, select the project you wish to import data from. The Import Drillholes from Central window will be displayed. Click the button for Collar to navigate the project’s data room to locate the collar file you wish to use.
Select the file and click Import. Work through the files as described in Importing Data Tables and Mapping Data Columns.
Connecting to an ODBC Data Source
Leapfrog Geo supports database files in Access Database (*.mdb, *.accdb) formats.
To import drilling data directly from any database that uses an ODBC interface, right-click on the Drillhole Data folder and select Import Drillhole Data via ODBC. The Select ODBC Data Source window will appear:
Enter the information supplied by your database administrator and click OK.
If you are importing from a local database file, click the Database file option and then browse to locate the file.
Selecting Tables
In the Select Tables To Import window, select the tables you wish to import.
To add an interval or points table, click the Add button (); the list of tables in the database will be displayed. To remove a table from either list, click on it and click the Remove button ().
Click OK to begin the process of importing the data. Work through the files as described in Importing Data Tables and Mapping Data Columns.
Connecting to an acQuire Database
There are two options for connecting to an acQuire database:
- Create a new connection. To do this, right-click on the Drillhole Data folder and select Import Drillhole Data via acQuire > New Selection. Select the server and click Connect. Next, enter the login details supplied by your database administrator.
- Create a connection from an existing selection file. Right-click on the Drillhole Data folder and select Import Drillhole Data via acQuire > Existing Selection. Navigate to the location where the selection file is stored and open the file.
Once connected to the database, you will be able to select the required data using the Select data from acQuire window.
Optionally, click the Profiles button and choose a profile from those on the acQuire database. Profiles are created in acQuire; see your acQuire administrator for more information.
You can also use the other tabs on the acQuire component interface to make other data selections.
For more information on using the third-party selection tools provided in the Select data from acQuire window, see your acQuire user documentation. When you have finished specifying the selection, click OK to import the data.
Once the drilling data has been loaded, you can:
- Import additional interval tables. See Importing Additional Interval Tables below.
- Update the drilling data with new data from the acQuire database. See Smart Refresh below.
- Reload drilling data. See Reloading Data Tables in the Working With Data Tables topic.
Smart Refresh
Smart Refresh obtains the latest drilling data from the acQuire database without reloading the entire contents of the database. This reduces the amount of data transfer required and speeds data updated. If any data relating to a drillhole has changed, the whole drillhole is updated. Any new drillholes in the database can be added.
Right-click on the drilling data set in the project tree and select Smart Refresh. The Select data from acQuire window will appear.
If the current data selection settings include data changes, you can click OK and the updated data will be imported. You may also chose to modify the data selection settings, which may append further data when you click OK.
Saving a Selection
Saving a selection saves the current acQuire database selection to file for future reuse. You can use a selection to import the same set of drilling data in new Leapfrog Geo projects.
To save an acQuire selection, right-click on the drilling data set in the project tree and select Save Selection. You will be prompted for a filename and location.
Setting Elevation for Collar Points
You can set the elevation for all collar points or for a subset of collar points by projecting them onto a surface. This overwrites elevation values in the z column of the collar table, using the data from the selected surface. If the surface does not intersect vertically with the selected points, you can choose how the z values for those unprojected points will be handled.
To set the elevation for collar points from a surface, right-click on the collar table in the project tree and select Set Elevation. The Set Elevation from Surface window will appear:
Select from the surfaces available in the project and set a query filter, if required.
Next, select how unprojected points should be handled. There are three options:
- Assign elevation values to sets the z values to a fixed elevation for all unprojected points.
- Leave elevation values empty clears the z values for all unprojected points.
- Leave unchanged makes no changes to the z values for unprojected points.
Click OK to set elevation values.
The collar table will be updated with an additional column, z_on_terrain:
The original z values are preserved in the z column. To switch back to the original z values, click on Collar Elevation, then select the original column:
If you switch back to using the original z column, the z_on_terrain column will remain in the collar table.
Adding More Tables to a Drilling Data Set
Once you have created a drilling data set in a project, you can add more tables to the data set. Types of tables you can add are:
- Additional interval tables. See Importing Additional Interval Tables.
- Downhole points. See Importing Downhole Points.
- LAS points. See Importing LAS Points.
- Downhole planar data. See Importing Downhole Planar Structural Data.
- A screens table, if you have the Hydrogeology extension and you did not import a screens table when you first imported the drilling data set. See Importing a Screens Table.
Importing Additional Interval Tables
Interval tables that have not been imported during the drilling data import process can be added to the project at any time. To add an interval table, right-click on the drilling data set in the project tree and select from the options available:
- If the interval table is stored in a file on your computer or a network location, select Import From File > Interval Values. Leapfrog Geo will ask you to specify the file location, and then will display the data in the file in the Import Interval window.
- If the interval table is stored in an ODBC database, select Import From ODBC > Interval Values. You will be prompted to select the data source. See Connecting to an ODBC Data Source.
- If your drilling data is stored in an acQuire database, select Import From acQuire > Interval Values. See Connecting to an acQuire Database.
Columns required are:
- A drillhole identifier
- Start/from and end/to depths
- A column of measurements
Select the required columns and assign the data type for each column. Click Finish to import the file, which will appear as a table in the drilling data set.
Importing Downhole Points
To import a set of points on drillholes, right-click on the drilling data set and select Import From File > Point Values or Import From ODBC > Point Values.
When importing from a file, Leapfrog Geo will ask you to specify the file location and then will display the data in the file in the Import Depth Points window.
When importing from ODBC, you will first be prompted to select the data source. See Connecting to an ODBC Data Source.
Columns required are:
- A drillhole identifier
- Depth
Select the required columns and assign the data type for each column. Click Finish to import the file, which will appear as a table in the drilling data set.
Importing LAS Points
LAS points need to be imported separately from other drilling data.
Leapfrog Geo imports LAS points down drillholes in LAS 1.2 and LAS 2.0 formats. An imported set of LAS files appears as one object with its associated data columns plus a LAS Drillholes folder that contains a filter for each drillhole. Importing the data preserves the metadata from the LAS files, which can be viewed in the Properties window for the LAS points object and in the Properties window for each drillhole.
To import LAS points down drillholes, right-click on the drilling data set and select Import From File > LAS Data. Select the files you wish to import and click Open.
Next, the Import LAS Data window will appear. The data displayed in this window is combined from the selected files, with blank and invalid values indicated by “nan”. For example, if a drillhole file does not contain columns that are included in other drillhole files, those missing columns will be marked as “nan”.
Leapfrog Geo expects drillhole ID and Depth columns and will attempt to match the data in the files with the expected format. Select the columns to import, then click Finish. The files will be added to the project tree as part of the drilling data set, as described above.
To view LAS points, add the LAS points object to the scene. You can also display individual drillholes by adding their filters to the scene.
LAS File Mapping
The Properties window for LAS Drillholes includes a LAS Mapping tab that shows what data files have been used for the selected drillhole:
This is useful when data for a drillhole originates in different files.
LAS File Inconsistencies
When importing LAS files, inconsistencies in the files are handled as follows:
- If there are two files with the same curve values at the same depth, the duplicate values will be added to the existing column and flagged as overlapping segments. See Correcting Data Errors in Leapfrog Geo for more information about correcting drilling data errors.
- If there are more than two files with the same curve values at the same depth, Leapfrog Geo will not be able to import the files. Note the conflicting files shown in the error message and reimport the files, leaving the conflicting files out.
- If there are multiple logs of the same name in the files, Leapfrog Geo will not be able to import the data. Edit the LAS file header outside of Leapfrog Geo to change the names.
Importing Downhole Planar Structural Data
Leapfrog Geo supports structural measurements in .csv or text formats. Structural data tables that include location information can also be imported to the Structural Modelling folder. See Importing Planar Structural Data.
Downhole structural data needs to be imported separately from other drilling data. To import downhole structural data, right-click on the drilling data set in the project tree and select Import From File > Planar Structural Data or Import From ODBC > Planar Structural Data.
When importing from a file, Leapfrog Geo will ask you to specify the file location and then will display the data in the file in the Import Planar Structural Data window.
When importing from ODBC, you will first be prompted to select the data source. See Connecting to an ODBC Data Source earlier in this topic.
Leapfrog Geo expects columns describing the drillhole identifier, the depth and the structural orientation. Structural orientation can be specified using either dip and dip azimuth or alpha and beta.
Match the values in the file to the required column headers, then click Finish to import the file. The table will appear in the drilling data set.
If the structural orientation is specified using alpha and beta, the reference line from which the beta is measured can be the bottom or top of the drillhole. When the table is imported, the default setting is Bottom of core. To change this, double-click on the structural data table in the project tree. Next, click on Compatibility to change the Beta reference mark setting to Top of core:
Importing a Screens Table
This feature is only available with the Hydrogeology extension. See Flow Models for more information.
Screens that have not been imported during the drilling data import process can be added to the project at any time. To do this, right-click on the drilling data set in the project tree and select Import From File > Screens or Import From ODBC > Screens.
When importing from a file, Leapfrog Geo will ask you to specify the file location, and then will display the data in the file in the Import Screen window.
When importing from ODBC, you will first be prompted to select the data source. See Connecting to an ODBC Data Source.
Columns required are:
- A drillhole identifier
- Start/from and end/to depths
- A value column
Select the required columns and assign the data type for each column. Click Finish to import the file, which will appear as a table in the drilling data set.
A drilling data set can have only one screens table.
Desurveying Options
Drillhole desurveying computes the geometry of a drillhole in three-dimensional space based on the data contained in the survey table. Under ideal conditions, the drillhole path follows the original dip and azimuth established at the top of the drillhole. Usually, though, the path deflects away from the original direction as a result of layering in the rock, variation in the hardness of the layers and the angle of the drill bit relative to those layers. The drill bit will be able to penetrate softer layers more easily than harder layers, resulting in a preferential direction of drill bit deviation.
There are a number of paths a drillhole could take through available survey measurements, but the physical constraints imposed by drilling are more likely to produce smoother paths. Selecting the desurveying method that gives the best likely approximation of the actual path of the drillhole will ensure that subsequent modelling is as accurate as possible.
Leapfrog Geo implements three algorithms for desurveying drillholes:
These options are described in more detail below.
Another factor that affects how drillholes are desurveyed is how dip values are handled. When the survey table is imported, Leapfrog Geo sets the Negative survey dip points down value according to the data in the imported table. When the majority of the dip data in the table is positive, Leapfrog Geo assumes all these drillholes will point down and leaves the field Negative survey dip points down disabled. When most of the values are negative, the field is enabled. This field can be changed by double-clicking on the survey table to open it and then clicking on Compatibility to show the table’s desurveying settings:
If you are going to change the automatically set value of Negative survey dip points down, consider carefully the implications if there is a mix of drillholes pointing down and up.
The other Compatibility setting relates to the algorithm used in desurveying the drillholes.
The Spherical Arc Approximation Algorithm
The default algorithm used in Leapfrog Geo is spherical arc approximation, which is sometimes referred to as the minimum curvature algorithm. Downhole distances are desurveyed exactly as distances along a circular arc:
The algorithm matches the survey at the starting and end positions exactly and the curvature is constant between these two measurements. At the survey points, the direction remains continuous and, therefore, there are no unrealistic sharp changes in direction.
If you wish to use spherical arc approximation, there is no need to change any settings.
The Balanced Tangent Algorithm
The balanced tangent algorithm uses straight lines but attempts to improve the accuracy of the raw tangent algorithm by assigning equal weights to the starting and end survey measurements:
It is an improvement on the raw tangent algorithm but still suffers from an unrealistic discontinuity in the drillhole path. It is, however, a better approximation of the overall drillhole path and is reasonably accurate when the spacing between measurements is small.
To use the balanced tangent algorithm, double-click on the survey table in the project tree. Click on Compatibility and change the Desurveying method.
The Raw Tangent Algorithm
The raw tangent algorithm assumes the drillhole maintains the direction given by the last survey measurement until the next new measurement is reached:
This implies that the drillhole makes sharp jumps in direction whenever a measurement is taken, which is unlikely, except when the drillhole is being used to define a trench.
Collar tables have a trench column that indicates whether or not the drillhole is from a trench. When the trench column is ticked for a drillhole, the trench will be desurveyed using the raw tangent algorithm. Double-click on the collar table in the project tree, then tick the trench box for the drillholes you wish to desurvey using the raw tangent algorithm.
Got a question? Visit the Seequent forums or Seequent support