Skip to content

Core Logging

Conclusions drawn from drill core data are typically summarized as annotations associated with particular depth ranges, i.e. as a Core Log.

The Core Log tool in Insight allows the user to define custom log categories (Lithology, Alteration, Texture, Grade, ...) that each contain custom log values (e.g. "Lith code 1", "Lith code 2" or "Coarse grained", "medium", "fine"). Log entries are then created by associating user-defined depth ranges with particular values.


When starting the program, the core log view is initially hidden. To show it, select Show → Core Log from the menu bar


Core logs are saved as part of the Project; remember to always save your project, to not lose any core log data.

Add Categories and Values

To start logging, the user must first define the categories and values that are to be logged. A new category is added by clicking the addition button below the list of current categories and selecting a unique name for it:

Add Category

Name Category

Once the category has been added, a corresponding column will appear, ready to house its entries:


To add a value to an existing category, select the category from the list and click the addition button below the list of current values:

Add Value

Each value is defined both by a name (which must be unique within the category, but not to the entire log) and a color with which it is graphically represented in its log column:

Name Value

Pick Color

Create Log Entries

When at least one value has been created, it is possible to start logging corresponding entries. First select the category to log for, and the value within it that an entry should be made for:

Pick Color

Then press Ctrl (Cmd on Apple macOS) to start the insertion of a new entry:

Create Entry

With Ctrl still pressed, then click on an appropriate position within the corresponding column and drag the mouse over the depth range to be logged:

Making Entry

The entry is permanently created when the mouse button is released. Alternatively, the insertion can be cancelled, by first letting go of the Ctrl key.

Adjust and Remove Log Entries

Previously logged entries can be adjusted both in terms of their depth range and associated value.

To resize an existing entry, bring the mouse cursor close to its top or bottom. Once the mouse cursor changes to indicate that resizing is possible, click and drag the boundary to adjust the depth range that the entry spans:



When resizing an entry, the mouse will automatically "snap" to nearby end points of other entries, which prevents the accidental creation of small gaps between them.

When working with several different categories, "snapping" additionally occurs to entries in the other categories, which simplifies consistent boundary alignment across the columns.


To change the value of an existing entry, first click the entry to select it (the currently selected entry is indicated by a thicker, differently colored outline):


Then click the new value in the list of available ones:

Change Value

To remove a previously logged entry, simply press Delete or Backspace while the entry is selected.


The current entry selection can be conveniently cleared by pressing the Ctrl (Cmd on Apple macOS) key. It is recommended to do this directly after the adjustment of an entry is finished, to avoid accidental adjustments with later input.


Both the creation and adjustment of entries may result in several entries merging into one, as artifical boundaries between adjacent entries with the same value will be automatically removed.

In the example below, two entries are automatically merged, as the value change of the upper entry would otherwise result in an artifical boundary:

Change Value Change Value

Edit Categories and Values

Both categories and values can at any point be edited to update their names (and associated color). To do this, simply select the category or value from the list and click the corresponding edit button:

Edit Category Edit Value

To remove a category or value, click instead on the corresponding remove button:

Remove Category Remove Value


Removing a value also permanently erases all entries associated with it, potentially erasing large amounts of logged data. Removing a category in turn erases all values associated with it. Always proceed with caution when confirming the removal of a value or category.

Confirm Remove

CSV Import

Already existing core log data can be imported for comparison, adjustment and extension in Insight, from CSV (Comma Separated Values) format. To start the import, first click the Import CSV button:

Import CSV

Then specify the data to import and its format in the Import CSV dialog. The data can be provided either as a local file to be read, or by pasting in the raw text input:

CSV Dialog

Next, select which columns of the CSV data to interpret as Hole ID, and as the start and end depths of the intervals, and which columns to import as categories:

Choose Columns

Finally, select the Hole ID for which data should be imported (other rows will be skipped):

Choose Columns


It may be the case that the imported core log data is not entirely inside the scanned depth range. Intervals that are outside the range will be skipped; and the following message is displayed:

Discarded Intervals

Each selected column is then imported as a separate core log category, with unique entries interpreted as new values and assigned default colors:

Choose Columns


For information on how to export core log data to CSV, see Exporting Core Log.