Geological Model Lithologies

A geological model’s Lithologies object () describes all the lithology codes to be modelled and the colours used to display them in the scene. To view the lithology codes used for a geological model, you can:

  • Double-click on the geological model in the project tree and then click on the Lithologies tab.
  • Double-click on the geological model’s Lithologies object in the project tree.

The Lithologies object under a geological model in the project tree, with an arrow to the Lithologies tab of the Geological Model window listing the codes Green, Orange, Yellow and Unknown with their colours

It is these lithology codes that are used in displaying a geological model in the scene and make up the model’s legend ():

The Lithologies tab beside the same model displayed in the scene, with arrows linking the table's colour swatches to the scene legend and to the legend button in the shape list

The lithology codes used for a geological model can be derived in different ways:

  • Derived from the base lithology column. If a model is created from lithology data, the codes used in the model are derived from that lithology data; changes to that data will be updated in the geological model, and vice versa. For example, if you edit the colour for the lithologies in the source data, those colours will be updated in the geological model, and editing the colours in the geological model will update the colours used in the source data.
  • Derived from linked lithology data. Other lithology data in the project can be linked to the geological model. This can be done in the Lithology Columns tab, and is discussed below. As with the codes derived from the base lithology column, changes to that data will be updated in the geological model, and vice versa.
  • Manually defined. You can add codes to the model in the Lithologies tab.

When you open the Geological Model window, how the lithology codes are displayed in the Lithologies tab tells you from what sources they were derived:

In the example above:

  • The codes from the base lithology column are Green, Orange and Yellow, which are shown in plain text.
  • The Unknown code is also shown in plain text. This is the code automatically defined for all geological models and is used to label lithologies that cannot be assigned to known lithologies. See Creating and Editing a Geological Model for more information.
  • The codes Mixed_A, Mixed_B and Mixed_C come from another lithology column in the project, linked to the geological model via the Lithology Columns tab. These are shown in italic text.
  • The codes Added_lith_A, Added_lith_B and Added_lith_C have been manually added to the model. These are shown in bold italic text.

The rest of this topic describes how to add, remove and organise the lithology codes for a geological model. It is divided into:

Adding Lithology Codes

There are two ways to add lithology codes to a geological model:

  • Manually add codes in the Lithologies tab.
  • Link in lithology columns from other data in the project in the Lithology Columns tab.

Manually defined codes are shown in Lithologies tab in bold italics.

  • To add a new code, click the add button () in the Lithologies tab. Enter a name for the code and click the colour chip to change its colour, if necessary.
  • To rename a code, double-click on it in the list or click on it, then on the Rename button. See Renaming Manually Defined Codes for more information, as renaming manually defined codes does have flow-on effects in a geological model.
  • To delete a code, click on it in the list, then click on the Delete button (). If the code is not used in surfaces built for the geological model, the code will be deleted when you click on the Delete button; you will not be asked to confirm your choice. When the code is being used by the model, you will be asked to confirm your choice. See Deleting Manually Defined Codes for more information.

To add codes from other lithology columns in the project, click on the Lithology Columns tab. Click the add button (), then select from the lithology columns available in the project:

The add button on the Lithology Columns tab opening the Select Additional Columns window, where columns are moved from the Available Columns tree to the Selected Columns tree

Click OK to close the Select Additional Columns window, then OK to close the Geological Model window. When you open up the Lithologies tab once again, codes from the linked columns will appear in the list, if they do not already exist in higher-priority sources, i.e. the base column and/or manually-defined codes.

See Code Priority below for more information on how codes from different sources are prioritised.

When you have multiple linked columns in the Lithology Columns tab, their order in the list determines their priority in whether or not their codes appear in the model’s Lithologies list. You can change a column’s priority using the arrow keys in the Lithology Columns tab:

The Lithology Columns tab with a column selected and an arrow pointing to the up and down buttons used to change its priority

Codes from linked columns are shown in the Lithologies tab in italic text. Holding the mouse cursor over a code will show the name of the table and column the code is derived from:

A tooltip on an italic lithology code in the Lithologies tab showing the table and column the code is derived from

To remove codes from linked columns, you will need to remove the column from the Lithology Columns tab. If any codes in the linked column are being used by surfaces in the geological model, the deleted codes will be replaced by the code set as the Background lithology (in the Surface Chronology tab).

Code Priority

Leapfrog Works prioritises a geological model’s lithologies as follows, from high to low:

  • Base column codes
  • Manually defined codes
  • Codes from linked columns

When you have multiple linked columns in the Lithology Columns tab, their order in the list determines their priority in whether or not their codes appear in the model’s Lithologies list. You can change a column’s priority using the arrow keys in the Lithology Columns tab:

The Lithology Columns tab with a column selected and an arrow pointing to the up and down buttons used to change its priority

When you add, remove or reorder the columns in the Lithology Columns window, you will need to click OK to update the geological model before you can see the code changes in the Lithologies tab.

In this example, the geological model uses codes from the base lithology column (base_col) and a linked column (LC_A):

The Lithology Columns tab listing the base column base_col and one linked column, LC_A

The lithology codes in both columns are unique, so when we look at the geological model’s lithology codes, we can see that the codes from both the base column (the red/pink codes) and the linked column (the green codes) appear in the model’s lithologies list:

The model's Lithologies tab beside the legends for base_col and LC_A, with arrows showing that all four codes from each column appear in the model because none of them overlap

When the base column is switched to an updated column that contains codes that are also in the linked column (codes A2 and B2), we can see how the base column’s lithology codes (red/pink) take priority over the linked column’s codes (green):

The updated base column and the linked column LC_A compared with the model's lithology list, showing the base column's A2 and B2 struck out of LC_A because base column codes take priority

When you have more than one linked column, the order of the columns in the Lithology Columns tab is the priority each column has, with the first linked column having the highest priority.

In this example, there are two linked columns, LC_B (yellow codes) and LC_C (blue codes):

Two linked columns in the Lithology Columns tab, LC_B above LC_C, with arrows to their legends: LC_B holding yellow codes A3 to D3 and LC_C holding blue codes that include the same four

LC_C contains codes that are also in LC_B, codes A3, B3, C3 and D3. When LC_B has the higher priority, the model’s legend uses the codes from LC_B, ignoring the duplicate codes in LC_C:

With LC_B ordered above LC_C, the model takes the shared codes A3 to D3 from LC_B and only the unique codes A2 and B2 from LC_C, whose duplicates are struck out

When LC_C has the higher priority, its codes are used in preference to those in LC_B. Because LC_B contains only codes that also exist in LC_C, none of LC_B’s codes are in the geological model’s lithology codes list:

With LC_C ordered above LC_B, all of the model's linked codes come from LC_C and none from LC_B, whose codes are all struck out and its arrow crossed out

Manually defined codes are of lower priority than the codes from the base lithology column, but take precedence over codes from linked lithology columns. In this example, the geological model has the base lithology codes (A to D), plus two manually defined codes (A2 and B2):

A model's Lithologies tab holding the base lithology codes A to D in plain text and two manually defined codes, A2 and B2, in bold italics

When column LC_A is linked, two of its lithology codes (C2 and D2) are added to the geological model’s lithology codes, but A2 and B2 are not, because the manually-defined codes are of higher priority:

Linking column LC_A adds only its codes C2 and D2 to the model; A2 and B2 are struck out because manually defined codes of the same name take priority

Code Colours

Lithology codes from the base lithology column and any linked lithology columns use the colours defined for the source data. For example, here we can see that the lithology codes and their colours match the Grouped_ROCK column’s lithologies, which are displayed in the scene:

A geological model's Lithologies tab beside the drillholes displayed in the scene, with arrows showing the model's codes and colours matching those of the Grouped_ROCK lithology column

The link goes both ways, and when you make changes to the colours used for geological model codes derived from lithology data, those changes will be made in the source data:

  • If the colours used are changed in the geological model, the changes will also be made in the drilling data.
  • If the colours used are changed in the source data, the changes will be reflected in the geological model.

Be careful in making changes to the colours used for codes that have been derived from drilling data, as you can inadvertently change colours that are used elsewhere in the project.

Renaming Manually Defined Codes

You cannot rename codes derived from the base lithology column or from linked lithology columns, but you can rename manually defined codes. When you rename a code that is used in surfaces built for the geological model, the name will be updated where that code is used.

To rename a manually defined code, double-click on the code in the Lithologies tab or click on it, then on the Rename button. Enter the new name, then click the OK button to close the Geological Model window and process the change.

In this example, the manually defined code Andesite has been used in defining two contact surfaces and so is reflected in one of the output volumes:

Renaming the manually defined code Andesite to AndesiteRenamed in the Lithologies tab, with arrows to the two contact surfaces and the output volume in the project tree that use the old name

Clicking OK updates the model, and the name change for the code results in the contact surfaces and the output volume also being updated:

The project tree after clicking OK, with the contact surfaces and the output volume all updated to the new code name AndesiteRenamed

Deleting Manually Defined Codes

You cannot delete codes derived from the base lithology column or from linked lithology columns without removing those columns from the geological model, but you can delete manually defined codes.

To delete a manually defined code, click on it in the Lithologies tab, then click on the Delete button (). If the code is not used in surfaces built for the geological model, the code will be deleted when you click on the Delete button; you will not be asked to confirm your choice.

When you delete a code that is used in surfaces built for the geological model, a warning will be displayed:

The Confirm Delete warning shown when deleting a lithology code that is in use, with a link reporting how many objects will be deleted and reprocessed

Click on the link to see what objects are affected by the change and decide how to manage those changes before clicking Delete, then OK in the Geological Model window.

In this example, two contact surfaces use the Andesite code, which then flows through to the Andesite output volume:

The Objects to Delete and Reprocess window listing the contact surfaces and output volumes affected, with arrows to the same objects in the project tree

By double-clicking on each contact surface, we can see where the Andesite code is used:

The two contact surface windows before the code is deleted, each with Andesite still set as one of its first or second lithologies

Deleting the Andesite code from the Lithologies tab will result in the code being replaced by the code set as the Background lithology (in the Surface Chronology tab). In this case, the background lithology is Unknown, which is substituted for the deleted code in the contact surface windows:

After deletion, both contact surfaces use the background lithology Unknown in place of the deleted code, and an Unknown volume has appeared in the Output Volumes folder

Note also that there is now an Unknown volume in the Output Volumes folder.

See the Changing a Geological Model’s Base Lithology Column topic for an example of how deleting a manually defined lithology code could be part of the workflow for using a different lithology column for a geological model.

Organising the Geological Model’s Legend

The order of the codes in the Lithologies tab is the order used for the model’s legend when the model is displayed in the scene:

The Lithologies tab beside the model in the scene, with an arrow showing the scene legend using the same order as the codes in the tab

Note that the order of codes in the Lithologies tab does not reflect the priority associated with codes from different sources. The priority of codes is determined by their source and, in the case of linked columns, their order in the Lithology Columns tab. See Code Priority above for more information.

Click on a code in the list and use the arrow keys to reorder the list. Use the Shift or Ctrl keys to select multiple codes. This is useful for moving multiple codes up and down in the list.