Data Types

Leapfrog Works has tools for importing, creating and working with many different types of data, including:

Leapfrog Works is unit-less and adopts the units used in the data you import. For example, if your imported data is in metres, the units displayed will be metres, and figures such as resolution, measured distances and slicer thickness will be in metres. It is important, therefore, to be consistent in the units used in the data you import. If you are importing data that uses different coordinate systems, you will need to pre-process the data so that it is using the same coordinate system.

The rest of this topic describes how to open, edit and correct errors in data tables in Leapfrog Works. It is divided into:

Working with Data Tables

To view the contents of a data table, double-click on it in the project tree. To view the contents of the attribute table for a GIS object, right-click on the object and select Attribute Table. The Table window will appear:

If the Ignored column is ticked, then Leapfrog Works completely ignores that row, as though it has been deleted. This is useful for suppressing erroneous data from being processed.

If a row in a collar table is ignored, then all other data associated with that hole (e.g. surveys and interval measurements in other tables) are also ignored.

Collar tables have a trench column that indicates whether or not the borehole is from a trench. When the trench column is ticked for a borehole, the trench will be desurveyed in a different manner from other boreholes. See The Raw Tangent Algorithm for more information.

Cells in a table are editable, apart from the id column, which Leapfrog Works uses as unique identifier. Double-click in a cell to edit it. If the cell you wish to edit is already selected, press the space bar to start editing.

When you edit a cell, the change will be indicated in bold text:

When you save the table, the edited text will no longer be displayed in bold.

The controls in the table toolbar provide quick access to table operations:

Click on Fix Errors to begin correcting errors in the table. See Correcting Data Errors in Leapfrog Works and Handling Special Values below for more information.

Click on Query to open up the query editor:

See the Query Filters topic for more information on how to build and use queries.

With borehole data, survey tables have Compatibility options for changing the desurveying method for the survey table as a whole. See Borehole Desurveying Options for more information.

Identifying Errors in Data Tables

Leapfrog Works automatically identifies and flags common data errors when data tables are imported. In the project tree, there are three ways Leapfrog Works marks tables that contain conflicts or errors:

  • Tables marked with a red X () contain errors that mean data cannot be used for processing. These errors can be corrected by opening the Errors window, which is described in Correcting Data Errors in Leapfrog Works below.
  • Numeric data columns marked with a red X () contain non-numeric values, which means that the rules that are used to handle non-numeric and negative values need to be reviewed. If a table has data that contain non-numeric and negative values, the affected rows cannot be used for further processing until the rules are verified, which is described in Handling Special Values below.
  • Tables marked with a yellow exclamation mark () contain warnings. Affected rows can be used for further processing, but the information in the warning can indicate that the data requires further attention. For example, if a warning indicates there is data missing for a borehole defined in the collar table, it may be that a borehole has been duplicated or that not all required data files have been loaded. Warnings are listed along with table errors in the Errors window.

Until errors are corrected, the rows that contain those errors are excluded for all processing that uses the table, including viewing in the scene. For example, if the ID for a collar position contains an invalid coordinate, that collar will not be displayed in the scene as its location is not known. Likewise, any processing will ignore data associated with this borehole.

It is worth correcting errors as soon as possible, as correcting them later can result in significant recomputation time.

When a table contains errors and warnings, only the errors will be apparent in the project tree view. However, all errors and warnings relevant to a particular table will be displayed in the Database Errors window.

There are two approaches to correcting errors in data:

Exporting Data Errors

If you need a record of corrected errors, first export the errors. This must be done first, as once errors have been corrected in Leapfrog Works, they cannot be exported, as they no longer exist.

For individual borehole tables, points tables and structural data tables, export the errors by right-clicking on the table and selecting Export Errors. Choose a location where the file will be saved and click Save.

To export all errors in the borehole data set, right-click on the Boreholes object and select Export Errors. The Export Borehole Errors window will appear:

The list shows the files that will be created, one for each table that contains errors. Choose a folder where the files will be saved, then enter a Base file name, which will be added to the front of each file name.

Click Export to export the error files.

Correcting Data Errors in Leapfrog Works

If you require a record of the errors in borehole data, export the errors as described in Exporting Data Errors above before starting to correct the errors in Leapfrog Works.

To correct errors in a data table, right-click on the table and select Fix Errors. The Borehole Errors window will appear. Leapfrog Works identifies a range of common errors, and all errors identified in a table are grouped by type. Click on an error type to expand it and see the source of a specific error:

You can change the size of the Borehole Errors window and the columns in the table to view more information easily. When you have finished fixing errors, click the Save button (). Leapfrog Works will then update the database.

Errors are automatically grouped by Type, but if there are many errors, you may find it useful to view them grouped by Table or HoleID:

When a row that contains an error is selected, a red box indicates the source of the error. When two rows of data conflict, both rows will be displayed, which may be useful in determining how to fix the error:

Some typical errors and how to correct them are described in Common Errors and How to Fix Them below.

Replacing Values in a Column

The Replace All button in the toolbar may be useful in correcting any errors without closing the Borehole Errors window. With the Replace All button, you can replace an incorrect value that occurs multiple times in a column. To do this, click the Replace All button (). Select the Column to search and enter the new value:

Click Replace All Occurrences to make the changes.

You can also select a number of rows and replace values in a selected column with a single value. To do this, use the Shift and Ctrl keys to select the rows you wish to edit, then click the Edit button and select Write to Selected Rows:

In the fields that appear, enter the New value, then click the Write to Selected Rows button:

Common Errors and How to Fix Them

There are many possible sources of error in the data itself and you may be able to correct the errors directly in the Errors window. With borehole data, however, the message given in the Errors may actually point to an error elsewhere in the dataset, in which case you will need to open the other table from the project tree and edit it directly.

The errors and warnings described are:

Duplicate Points Error (Points Tables)

Points tables will have Duplicate Points errors when rows have identical x, y and z values:

Tick Ignored for the rows you wish to ignore. If there are many duplicate points in the table, click the Ignore Duplicates button (). When you save the table, all duplicate rows will be marked as Ignored.

Duplicate Hole ID Error

Collar tables will have Duplicate Hole ID errors when collars have been assigned the same ID. Here, rows 4 and 5 have the same ID but are clearly different holes:

Changing the hole ID for one of the boreholes will correct the error. If the collar has been recorded twice by accident, tick the Ignored box for the duplicate collar.

Hole ID Not in Collar Table Error

Interval tables will have Hole ID not in collar table errors when the hole ID specified in the interval table is not found in the collar table.

Affected intervals cannot be displayed. There are two possibilities for fixing this error:

  • The collar table uses the wrong hole ID. Edit the collar table to correct the hole ID.
  • The interval table uses the wrong hole ID. Use the Replace All tool to the incorrect values with the correct one. See Replacing Values in a Column above.

Collar Max Depth Error

Interval tables will have Collar max-depth exceeded errors when the depth values in the interval table exceeds the maxdepth value defined in the collar table. The maxdepth defined in the collar table is often a theoretical value established before drilling. If the depth value flagged as an error is not unrealistic, click on the Fix Max Depths button ():

This results in the collar table being updated with a maximum depth value that reflects the data in the interval tables.

Invalid Max Depth Error

Collar tables will have Invalid Max Depth errors when the maxdepth value is negative or non-numeric:

These errors are often the result of data entry mistakes and can be corrected by editing the table in the Errors window.

From Depth Exceeds To Depth Error

Interval tables will have From depth > = to depth errors when the from and to values in a row do not make sense:

These errors are often the result of data entry mistakes and can be corrected by editing the table in the Errors window.

Until the error is corrected, the affected interval cannot be displayed, although all non-conflicting intervals will still be displayed for that borehole.

Overlapping Segments Error

Interval tables will have Overlapping Segments errors when intervals are in the same place for the same hole or when two holes are in the same place. Here, row 12 overlaps row 13 and the error can be corrected in the Borehole Errors window by entering the correct to value for row 12:

If an interval has been defined twice, click Ignored for one of the rows. Until the error is corrected, the affected intervals cannot be displayed, although all non-conflicting intervals will still be displayed for that borehole.

No Samples for Collars Warning

Interval tables will have No values for Hole ID warnings when there are no values in the interval table that correspond to a collar defined in the collar table. In this example, a hole called M090 has been defined in the collar table, but there is no data for it in the M_Assays table.

There are three possibilities:

  • There are no values in this interval table for that collar. There is no need to do anything to remedy the warning as it will not affect further processing of the data.
  • The collar table uses the wrong hole ID. This may be the case if there is also a Hole ID not in collar table warning listed. Edit the collar table to correct the hole ID.
  • There are values for that collar in the interval table but they use the wrong collar ID. Again, there may also be a Hole ID not in collar table warning listed. Edit the interval table and correct the hole ID for the affected intervals.

No Surveys for Collar Warning

This survey table error is similar to No Samples for Collars Warning above: there are no values in the survey table that correspond to a collar defined in the collar table. Check that the collar table and the survey table are using the right hole ID. You will need to edit the survey table or collar table directly before this warning can be cleared.

Wedges Found Warning

Wedges found warnings occur in the collar table or in the survey table when boreholes appear to be duplicates because they are very close together in space.

Leapfrog Works flags boreholes that are less than 1° apart as possible duplicates; if you have two boreholes that are that close together, you may need to adjust the collar location of one of the boreholes to clear the warning. You can do this by editing the collar table.

Handling Special Values

Assay data often contains special values to represent different situations, such as grade values that are below a detection limit, cores that have been lost or segments that were not sampled. In addition, it is not uncommon for a borehole to contain some intervals that have no values.

When borehole data tables and points data are imported, Leapfrog Works will mark columns containing non-numeric special values and missing intervals so that you can review these missing and non-numeric values and determine how Leapfrog Works will handle them. For example, here numeric data columns that contain errors are marked with a red X:

To review these errors, double-click on the column. The Errors window will appear with the error displayed for the selected column:

Leapfrog Works will automatically set missing and non-numeric intervals to be omitted from further processing. Negative values are automatically set to keep. To change the Action, select another action from the list:

  • Select replace to enter a numeric value to be used for further processing.
  • Select keep to use a negative value in further processing.

For non-numeric and negative values, all values are initially treated as a single rule. However, if values have different meanings, you can define specific rules to determine how each value is handled. To do this, click on the Add Rule button. The window that appears will show the values present in the data. To define a new rule for a specific value:

  • Select that value in the list.
  • Tick the box for The value I want is not in the list.
  • Enter the Value.
  • Click OK.

In the Invalid Value Handling window, the value will be listed separately and you can choose the Action to apply.

Once you have reviewed the rules that will be applied to the column, tick the These rules have been reviewed box and click OK. The rules will be applied and used in further processing.

When you open a data table, the original values will be displayed. In all further processing of that data, the assigned special values will be used.

 

Got a question? Visit the Seequent forums or Seequent support