Skip to main content
Version: 3.4.20 (unreleased)

Geological Logging

A geological log in VRGS is a measured section digitised on the outcrop itself: a sedimentary section, or an igneous, metamorphic or mineralised one, logged the same way. You walk a path up the section by clicking bed boundaries, and each click adds a unit with a grain size and a facies. The result is a graphic log that knows where it came from — so it plots in 3D on the outcrop, corrects its own thicknesses for dip, and correlates against its neighbours.

Two windows are involved:

The 3D viewWhere you digitise the log path and edit its geometry, and where the log stands on the outcrop as a graphic panel. Ribbon tab: Log.
The 2D log panelWhere you draw the profile, edit units, and correlate contacts and intervals between logs. Ribbon tab: 2D Log.

Logging a section​

1. Make the outcrop the active mesh​

The log path can follow the bedding rather than cutting straight lines between your clicks — but only if there is an active mesh to follow. Set the outcrop mesh active before you start.

2. Start the path​

Interpretations → Sedimentology → Measured Section creates an empty log, brings up the Log ribbon tab, and arms the digitiser.

3. Click the bed boundaries​

Each click adds a log unit running from the previous click to this one, with the active facies applied.

The first click just sets the base. From the second click onward, VRGS tracks the route between your markers across the mesh surface and stores the tracked path as the log's deviation — so the log tube drawn in 3D follows the outcrop rather than hanging in the air between markers. It also samples the mesh's per-vertex attributes along the path into a digital-log curve.

The tool stays armed, so you can work straight up the section.

Set the active facies as you climb

The facies dropdown on the Interpretations tab applies to each new unit as it is created. Changing it as you move between bed types is much quicker than correcting units afterwards — though Replace Facies on the log's tree menu will do a bulk correction if you forget.

No mesh, no tracking

Without an active mesh carrying a tracker, each click simply adds a straight segment. That is fine for a quick section, but you lose the surface-following deviation and the attribute sampling.

4. Open the log in 2D​

To draw grain-size profiles, edit beds and correlate, open the log in the 2D log view: double-click the log in the Data Tree (under Logs), or double-click the log's panel in the 3D view while in Move or Picks mode. VRGS opens the log's saved correlation panel, or a new panel if it has none, and adds the 2D Log ribbon tab. There is no command for this on the log's right-click menu.

A correlation panel holding several logs opens the same way, by double-clicking it in the Collections tree under Correlation Panels — see Correlating logs.

Geodesic Path​

Log → Geodesic Path changes how the route between two markers is found:

OnThe path is straightened onto the shortest on-surface route — a true geodesic.
OffThe path is restricted to the mesh's own triangle edges, so it follows the triangulation.

Edge-restricted is the safe default: it cannot cut across a face and lift the path off the surface. Turn geodesic on when the triangulation is coarse enough that following edges makes the path visibly zig-zag.

Getting the thicknesses right​

A section measured on a dipping outcrop is not the thickness of the rock. VRGS holds three depth measures, chosen with Depth on the 2D Log tab:

ModeWhat it is
MTMeasured thickness — the raw distance you walked.
TVTTrue vertical thickness.
TSTTrue stratigraphic thickness — measured perpendicular to bedding. This is the one that compares between sections.

To get TST, VRGS needs to know the bedding orientation, and there are two ways to give it one:

  • Log → Set Dip Domain applies a dip and dip azimuth to the units currently selected in the 2D log panel. Select a run of beds, set their domain, then do the next run — that is how a section crossing a fold or a fault is handled.
  • Set Dip and Azimuth on the log's tree menu applies one orientation to the whole log.

The thickness of every unit is then recomputed by rotating it out of the dipping frame, so TST updates immediately.

TST is only as good as the dip you gave it

An uncorrected log silently reports apparent thickness. If two sections disagree and both were logged on dipping ground, check the dip domain before looking for a geological explanation.

Editing the log​

In 3D — the Log tab​

CommandWhat it does
Edit DeviationDrag the nodes of the log's path to correct its route.
Extend DeviationContinue the path from either end by digitising further points.
Link Log UnitLink a unit to an interpretation object in the scene.
Set Dip DomainAs above — the selected units' bedding orientation.

The Defaults panel sets the grain size, carbonate classification and facies that a new unit starts with. It does not change units that already exist.

A log moves with its outcrop​

With Keep Interpretations On Their Models on in Project Properties (the default for new projects), a log stays attached to the mesh it was logged on, as polylines and other interpretations do. Move the mesh, by hand or by an alignment, and the log's path, its beds and its tracked route move with it. Where two meshes overlap, a log follows the one most of its path lies on. The attachment is worked out again each time the project opens, so it adds nothing to the saved project.

In 2D — the 2D Log tab​

Open the 2D log view by double-clicking the log in the Data Tree, or its panel in the 3D view (step 4 above). The 2D Log tab appears while that view is active.

CommandWhat it does
Digitise ProfileShape a bed's grain-size profile: click the curve to add a point, drag a point to move it.
Split UnitClick a bed to cut it in two. Drag the line between two beds to move it. Click in a log's column above its top or below its base to add a bed reaching to the click.
Sample PointAdd a sample at a picked depth.
Assign IntervalGive the selected beds the interval chosen in the Interval dropdown (see Intervals).
Auto SpacingArrange the visible log panels tidily.

While a mode other than Move Mode is on, a bar along the foot of the view names it and says what a click does. Esc leaves it. Its button on the ribbon stays highlighted while it is on, and each mode has its own cursor.

The box beside the cursor gives the log, the depth, and the bed under the cursor: its number, its thickness in the panel's depth mode and its facies.

Selecting beds​

Click a bed to select it. Ctrl+click adds a bed to the selection or takes it out, and Shift+click selects every bed from the one clicked before. The property pane shows the bed you clicked. Selected beds are marked by a blue band across the whole log, over their fills and patterns, so you can see what you have just given them. The band is not printed or exported.

Press Esc, or click off the logs, to clear the selection. A click on a track's header keeps it.

If you scroll away from the selected beds, a command that would change them brings them back into view instead and changes nothing, so nothing changes unseen. Give the command again to apply it. This goes for Delete, T, the number keys, Ctrl+V and the Log Palette.

An edit on a bed's right-click menu (facies, grain size, base contact, a lithology, a structure, a fossil, a generic class, Set Orientation) changes every selected bed when the bed you right-click is one of them. The menu then starts with Changes the N selected beds. Right-click a bed outside the selection to change that bed alone. However many beds it changes, the edit is one step of undo.

When two neighbouring beds are selected, Merge units appears on the menu alongside the track's own commands.

Adding, deleting and moving beds​

  • Add a bed on top or underneath. With Split Unit, click in a log's column above its top, or below its base. A new bed reaches to the click and is selected, so the next facies chosen goes to it. Picks and images stay with the beds when a bed goes in underneath.
  • Delete a bed. Right-click it and choose Delete bed, or select beds and press Delete. The bed below takes its thickness (the bed above, for the lowest bed), keeping its own facies and profile. The deleted bed's samples and palaeocurrent readings move into it. The log keeps its height.
  • Move a boundary. In Split Unit mode, hover over the line between two beds until the cursor turns into an up-down arrow. Drag the line to where the contact really is. A red line shows where it will go. Release to move it, or press Esc to leave it where it was. Each bed keeps its description, and its profile stretches with it.
  • Add a bed of a set thickness on top. Press B, or choose Add Bed on Top on the 2D Log tab or on a bed's or a log header's right-click menu. Type the new bed's thickness, in the panel's depth mode. The bed goes on top of the log you clicked last and is selected, so a number key gives it its facies. Press B again for the next bed: logging a section bed by bed, from the base up.

Logging from the keyboard​

The keys act on the selected beds of the log you clicked last.

KeyWhat it does
1 to 9Give the selected beds the facies on that key. A strip along the top of the view shows which facies each number gives while a bed is selected.
Ctrl+Shift+1 to 9Pin the selected bed's facies to that key, or unpin it if it is pinned there already.
FOpen every facies at the cursor: those on keys first, numbered, then the rest, the most recently used first.
Ctrl+CCopy the selected bed's description.
Ctrl+VGive the selected beds the description copied.
Up / DownSelect the bed above or below, scrolling to keep it in view. With Shift, extend the selection.
TCut the selected bed at a height you type, measured from its base. The lower part stays selected, so a number key gives it its facies, and Up moves on to what is left.
BAdd a bed of a thickness you type on top of the log. It is selected, so a number key gives it its facies.
DeleteDelete the selected beds.
Ctrl+1, Ctrl+2, Ctrl+3Show the panel in TVT, TST or MT.
D, S, N, P, MDigitise Profile, Split Unit, Sample Point, Picks and Move modes.
[ and ]The previous and next correlation contact.
EscLeave the mode; in Move mode, clear the selection.

A new bed, added with B or the Quick Log, is scrolled into view, so you can log up a section without touching the mouse.

The right-click Facies menu lists the facies on the keys at its top too.

The facies keys​

A facies keeps its key, so the keys can be learnt. Using a facies that is on a key moves nothing. The first time, the keys fill from the facies you used most recently and then from the list.

With more than nine facies, one that has no key takes a key when you use it, by the F menu, the track's menu, the palette or the Quick Log. It takes the key used longest ago, and every other key stays as it is. To stop a key being taken, pin it: select a bed of that facies and press Ctrl+Shift and the number. The strip underlines the number of a pinned key. The keys are saved with the project.

Copying a bed's description​

Ctrl+C, or Copy Bed Description on a bed's right-click menu, takes what a bed is: its facies, grain-size profile and profile scale, lithologies, structures, fossils, generic classes, base contact and its certainty, bioturbation index, Munsell colour and whether it is covered. Ctrl+V, or Paste Bed Description, gives that to the selected beds, as one step of undo. Each bed keeps its own thickness, place, orientation, name, comment, interval, samples and palaeocurrents. It stretches the profile to fit the bed.

From the right-click menu, paste follows the same rule as the track menus: it changes the selected beds when you right-click one of them, and the bed you right-clicked otherwise.

The Log Palette​

Log Palette on the 2D Log tab opens a pane of tiles for everything a bed can be given from the project's lists, in sections: facies in their colours and patterns, lithologies, sedimentary structures and fossils as their symbols, base contacts as their lines, grain-size classes, and each generic class track's entries. It opens by itself with the first 2D log view of a session; close it, and the button brings it back.

  • Click a tile to give it to the selected beds of the 2D log view you used last, as the track's menu would: a facies, grain size or contact is set; a lithology is added; a structure or fossil is ticked on, or off if the active bed already has it. The keys then work on the log again, with no need to click back in the view.
  • Drag a tile onto a bed to give it to that bed. The bed under the cursor is highlighted as you drag; if it is one of the selected beds, they all take it. Press Esc to drop nothing.
  • Type in the box at the top to filter every section by any words of a name.
  • Click a heading to fold its section away.
  • Lithologies, sedimentary structures and fossils are laid out by their groups (Cross Bedding, Invertebrates, Siliciclastic Rocks...), each under a heading of its own, after the tiles you used most recently and any in no group. Click a group's heading to fold just that group. A tile you used recently shows both at the top and in its group. Folded sections and groups are remembered with the project.
  • The line at the bottom shows the full name of the tile under the mouse.

Each change is one step of undo.

The Quick Log​

The box under the palette's filter takes a bed as a line of shorthand, the way a notebook has it. Press Q in a 2D log view to jump to it.

0.4 Sm fs/ms tcb erosive plant debris bi2
  • A number, with m, cm or mm after it or not, is the bed's thickness. With a thickness, Enter adds a bed of it on top of the log you clicked last and gives it the names on the line; the new bed is selected, so the next line goes on it. Without a thickness, the line describes the selected beds.
  • Every other word is a name from your project's lists, matched without regard to case, spaces or hyphens: the whole name (Sm), the start of one name and no other (eros for Erosional), or the initials of its words (tcb for Trough cross-bedding, fs for Fine Sand). Two or three words together can make one name (plant debris), or put them in quotes.
  • fs/ms, two grain sizes, is the class at the base and at the top. One grain size is both.
  • cov marks a covered interval; bi3 is a bioturbation index of 3.
  • A word in none of the lists goes into the bed's comment, so nothing you type is lost, and the line at the bottom of the palette says which.

Each line is one step of undo. The names you use move to the front of their lists, in the menus and the palette.

Moving around​

MouseWhat it does
WheelScroll up and down the log.
Ctrl+wheelZoom in and out about the cursor.
Shift+wheelChange the vertical scale. The depth under the cursor stays where it is.
Middle-dragPan, in every mode.
Shift+middle-drag (Move mode)Drag a log up or down against its neighbours.

The depth axis chooses its ticks from what the window shows, out to 2000 m apart, so a long well zoomed out stays readable.

Right-click the panel's background and choose Depth Axis to set how the axis reads:

  • Metres or Feet. In feet the ticks fall on round feet.
  • Up from the Base (the default) or Down from the Top. Up from the base, the axis gives each log's height above its base, or the elevation in TVT. Down from the top, it gives the depth below each log's top, as a well or a core is read.

The panel saves the choice. It is used on screen, in print and in the exports.

The key beside the panel lists what the displayed logs use, under Facies, Lithology, Sedimentary Structures, Palaeontology and Base Contacts. A heading appears only when the panel's template has a track of that kind and a log uses something of it. Each swatch is drawn as its track draws the entry, with its colour and its pattern or symbol, and named as in the Collections tree. Base Contacts lists the contacts drawn as other than a straight line. The SVG export writes the same key.

More in the 2D editor​

On the tree​

Right-click the log in the Data tree:

CommandWhat it does
Spreadsheet ViewThe log's beds as a read-only table: thicknesses, grain size at the top and base of each bed, and its samples.
Analysis → StatisticsWrites a summary to the messages panel: the number of beds; the log's thickness in TVT, TST and MT; the smallest, median, mean and largest bed thickness (TST); each facies' share of the thickness; the most frequent upward facies transitions, and whether their order is more than chance (a chi-square test of the embedded Markov chain); each interval's beds, thickness and facies, nested intervals indented under their parents; each facies association's share; the mean palaeocurrent direction, how closely the readings agree and whether they have a preferred direction (the Rayleigh test); and the number of samples per metre.
Analysis → Statistics Report...The log's statistics as a web page of tables and charts, with a CSV of its beds beside it. See Statistics report.
Replace FaciesBulk-swap one facies for another.
RepairFix a log with missing or inconsistent units.
Import → From FileBring in a log from file.
Import → Geophysical Log TracksAttach wireline-style curves.
ExportWrite the log out: its beds as a bed table (CSV), its curves as JSON, or the log as LAS 2.0.

Correlating logs​

The Correlate panel on the 2D Log tab lets you tie contacts between logs:

  1. Create a new contact (New contact on the 2D Log ribbon) or select an existing one as the Active correlation contact.
  2. Use Correlate Logs and click the contact's position on each log.

The contacts are the project's Contacts list, shared project-wide, so the same contact can be traced across every section in the study. A panel of two or more logs is saved with the project and listed in the Collections tree under Correlation Panels, where a double-click opens it as it was left.

Arranging the panel​

Right-click the panel's background to build it:

CommandWhat it does
Add TrackAdd a track of a chosen kind to the panel's template.
Add Class TrackAdd a class track.
Add LogPut another of the project's logs in the panel.
Flatten on Top, Flatten on Base, Flatten at CentreLine every log's top, base or middle up with the first log's. Offered with two or more logs in the panel.
Flatten on ElevationPlace each log's base at its elevation above the first log's. Offered in TVT only.

Right-click a log's track header:

CommandWhat it does
Swap Track, Remove TrackChange the panel's template, as one step of undo.
Remove Log From PanelTake this log out of the panel. The log itself is kept.
Swap with log on leftChange the order of two neighbouring logs. Not offered on the first log.

Right-click a pick:

CommandWhat it does
Activate PickMake its contact the Active correlation contact, to carry it on to the next log.
Flatten PickLine every log holding this pick up with it. A log without it stays where it is.
Delete PickRemove the pick from this log.

A flattened panel stays flattened when the vertical scale changes.

Any depth mode

Contact picks can be placed, dragged, drawn and flattened on in TVT, TST or MT. Correlate in TST to compare sections logged on dipping ground. A pick keeps its place in its bed: switch the depth mode, or change the bed's dip domain, and the pick moves with the bed. A bed with no vertical thickness (a level stretch of the log path) cannot hold a pick, so place it in the bed above or below.

A contact whose Contact Type is a sequence-stratigraphic surface is drawn by its type between the logs, and its short name follows its name on the label:

Contact typeLine
Sequence boundary (SB)The heaviest.
Maximum flooding surface (MFS)Heavy.
Transgressive surface (TS), Flooding surface (FS)Dashed.

Other contacts are drawn as before. The SVG export draws them the same way.

Correlation lines in 3D​

Each pick that a panel joins from one log to the next is also joined in the 3D view, by a line between the two logs in the contact's colour, so a correlation can be checked against the outcrop it was made on. Correlation Lines and Correlation Line Width (in pixels) in the display properties of the Logs group turn the lines on or off and set their width.

Intervals​

An interval is a named span of one or more beds between a younger and an older contact: a formation, a member, a channel belt, or any package you want to follow from log to log. Intervals are kept in Collections → Intervals, where each one's Younger Contact and Older Contact are set (see Contacts, Units and Intervals).

To give beds an interval:

  1. Choose the interval in the Interval dropdown of the Correlate panel, or make a new one with the button beside it.
  2. Click a bed at one end of the run, and Shift+click the bed at the other.
  3. Click Assign Interval, or right-click the beds and choose Assign interval '…' to selected beds.

Remove interval from selected beds, on the same right-click menu, takes it off again.

An interval on a log is one unbroken run of beds; it cannot have a gap. So assigning an interval to a run moves it there: beds elsewhere on the log that had it lose it. A run assigned inside another interval cuts that interval, which keeps its longer part. The Messages panel says when beds outside the run changed.

Each log draws its intervals as a bar beside its beds, in the interval's colour and named at the top. Where two neighbouring logs in the panel hold the same interval, a band joins them from base to base and top to top: the panel's correlation of the interval. The bands follow the depth mode on screen, and the SVG export draws them too.

An interval can also be given to the beds a geopolygon spans on a log; see 3D interpretations on the log.

Nested intervals​

Intervals can sit inside one another: a member in its formation, a parasequence in its sequence, a storey in its channel belt. Set an interval's Parent Interval and Rank in its properties (Collections → Intervals). The Collections tree then lists each interval under its parent.

Give the beds the finest interval they belong to. A bed in a member is in that member's formation as well, so you never assign the formation separately. A bed can also be given a formation directly, for the part of it not divided into members.

Add an Intervals track to the template to see the hierarchy on each log. It has a column for each level, the coarsest on the left. Each interval is drawn over its beds in its colour and named at its top. Where a formation's members are separated by another formation, it is drawn as two boxes. The bar beside each log and the bands between logs show the beds' own intervals, as before.

Analysis → Statistics gives each interval a line, base up, with each one followed by those inside it and indented a level. The line opens with the interval's rank, such as Member 'Upper Sand', and counts only exposed beds. The statistics report tabulates them the same way, with each interval's net to gross and mean palaeocurrent.

Deleting an interval takes it off every bed that had it. The intervals inside it move up to its parent. Before, a new interval could pick up the beds of a deleted one.

Facies associations​

A facies association (Collections → Associations) groups facies that occur together, such as a channel fill or a delta front. Set each facies' Association in its properties. Then:

  • A Facies Association track draws each run of beds whose facies share an association as a box in the association's colour, named. A covered bed belongs to none.
  • Analysis → Statistics adds each association's share of the exposed beds, and the statistics report tabulates them.
  • The 3D log's Primary Display set to Facies Association colours and sizes the beds by their association. Its colour had the wrong blue and its width used the wrong facies; both are fixed.

A facies' association is now saved with the project. Before, it was lost on reopening. Deleting an association takes it off its facies.

Tips and troubleshooting​

  • A log shows as a thin coloured line, not a panel. It is too narrow on screen, or edge-on. Move closer, or raise Track Unit Width in the Logs display properties.
  • The log tube cuts through the outcrop instead of following it. There was no active mesh with a tracker when you digitised, so the units are straight segments. Set the mesh active and re-digitise, or correct the route with Edit Deviation.
  • Thicknesses look wrong compared with the field. You are probably reading MT or TVT. Switch the Depth mode to TST and give the log a dip domain.
  • Set Dip Domain is greyed out. It works on the units selected in the 2D log panel; nothing is selected.
  • Every unit came out the same facies. The active facies applies at the moment of the click. Use Replace Facies to fix it in bulk.
  • The image track came out blank or the command refused. A textured mesh must be shown along the log and the log must have a path — the message says which is missing.
  • An image track does not match the outcrop. Strips extracted with earlier versions could be upside down, and drifted against the beds where the path changes slope. Extract it again.
  • Assign Interval is greyed out. No interval is chosen in the Interval dropdown of the Correlate panel.
  • Beds lost their interval when I assigned another run. An interval is one unbroken run of beds on a log, so assigning it again moves it, and a run assigned inside another interval cuts that interval to its longer part.
  • No 3D interpretations show on the log. The overlay starts off: right-click the panel background and tick Show 3D Interpretations. Only interpretations shown in the 3D view, and within the Interpretation Range, are drawn.
  • A pick will not go where I click. The bed there is level, with no vertical thickness to hold it, and the Messages panel says so. Place the pick in the bed above or below.

See also​