Skip to main content
Version: 3.4.20 (unreleased)

Stereonet User Guide

The stereonet is where VRGS plots orientation data: the planes and lineations you have interpreted, and the dip and azimuth attributes of a mesh, as a pole per vertex or per triangle. It contours pole density, draws a rose diagram and a dip plot beside it, colours the net by a stress attribute, draws the kinematic analysis of a slope face, fits a fold to the bedding, and exports everything as SVG or a spreadsheet.

Where to find it​

WhereWhat you get
Charts panelA stereonet that is always available beside the 3D view, tracking whatever is displayed.
Stereonet window (Home → Windows → Stereonet Window)A full document window — the document view, which has everything: the mesh-pole layer, the key, the stress-attribute field, the kinematic analysis and the fold analysis.

The two share their settings, so a change made in one is a change in the other. Some controls appear only in the stereonet window because the Charts panel does not draw what they control; those are called out below.

Almost all the controls are in the property sheet

The Stereonet ribbon tab now carries only zooming and pole selection. Everything about what is drawn lives in the property sheet (the Properties panel, shown whenever a stereonet has focus) and on the right-click menu. Both are documented below.

The right-click menu​

Right-clicking anywhere on the net — in the 2D view or on the 3D stereosphere — opens one menu, grouped into five blocks. Toggles show a tick when they are on.

When there is a pole to go to, the menu starts with Go To in 3D View: it flies the 3D view to the pole you right-clicked, and brings the 3D window to the front. It reads Go To Selected in 3D View when the pole is part of the selection, or when you right-clicked away from a pole, and then flies to the whole selection.

Display​

CommandEffect
Show StereonetDraw the net itself (the grid and its frame).
Show PolesPlot orientations as poles.
Show PlanesPlot orientations as great circles.
Show ContoursDensity-contour the poles.
Show RoseDraw the rose diagram.
Strike ValuesPlot the rose as strike rather than dip azimuth. Available only while the rose is shown.

Selection​

CommandEffect
Set Selected As → Bedding / Fractures / CleavageRe-type the selected orientations. The change goes back to the objects themselves, so it is reflected everywhere in the project.
Group SelectedMove the selected orientations into a new Stereonet Group in the interpretation tree.
Invert SelectionSelect what was not selected, and vice versa.
De-select allClear the selection.
From the net back to the outcrop

Go To in 3D View is the point of selecting on the stereonet: lasso a cluster of poles, and go and look at the part of the outcrop they came from. It was called View in 3D window in earlier versions.

Analysis​

CommandEffect
Analyse FoldFit a fold to the selected bedding poles, or to all the bedding when none is selected; the entry says which, and how many (Analyse Fold (12 Selected Bedding)). Needs three. See Fold analysis.
Create Fold Axis & Axial PlaneKeep the fold axis as a lineation and the axial plane as an orientation.
Look Down Plunge in 3DTurn the 3D view to look along the fold axis, in orthographic projection.
Create Down-Plunge OrthopanelAdd an orthopanel that looks down the plunge at the analysed picks and traced contacts.
Save Fold Profile as SVG...Save the down-plunge profile as an SVG file.
Export Fold for LoopStructural / GemPy...Write the bedding, contacts and fold frame into a folder for implicit modelling.
Clear Fold AnalysisRemove the fold analysis from the net.

The fold analysis runs on the 2D net, so these are greyed on the 3D stereosphere.

The Set Selected As entries set the classification of a measurement (bedding, fracture, cleavage), not its discontinuity set. Give a measurement a set with its Set property, or with Auto-cluster.

View​

CommandEffect
2D ViewThe flat stereonet on its own.
3D ViewThe stereosphere — the same data on a sphere you can rotate.
Split View (2D & 3D)Both, side by side.

The stereosphere shares this menu, so you can switch back from inside it.

Export​

CommandEffect
SpreadsheetThe plotted orientations as a table.
SVG Document → Stereonet DiagramThe net as a vector drawing, at publication quality.
SVG Document → Rose DiagramThe rose as a vector drawing.
The same picture goes into a report

Analysis reports insert stereonet and rose figures through these same writers, so a figure in a report and the SVG you export here are the same drawing.

Selecting poles​

Click a pole to select its measurement; Ctrl+click adds to the selection. Double-click a pole to fly the 3D view to it, or Ctrl+double-click to fly to the whole selection. Poles on the Charts-pane stereonet work the same way.

For many poles at once, use the tools on the Stereonet ribbon tab (hold Ctrl to add to the selection):

ToolWhat it does
RectangleDrag a rectangle; every pole inside is selected.
EllipseThe same with an ellipse.
PolygonDraw a closed polygon around a cluster.
SectorSelect an angular sector of the net.
Hide UnselectedHide everything that is not selected, in the 3D view as well.

Selection is shared with the rest of VRGS: what you pick on the net is picked in the model, in the trees, on every other stereonet and on the Mohr diagram, and what you pick there is ringed on the net. Selecting an orientation group in the tree selects every measurement in it.

The tab's Navigation panel has Zoom To Fit, Zoom In and Zoom Out.

Plotting a mesh's dip and azimuth​

Stereonet window only. A mesh is plotted from two of its attributes: one read as the dip of each vertex or triangle, the other as its azimuth (dip direction). Pick them under Contour Properties as Dip Attribute and Azimuth Attribute. They default to Dip and Azimuth, which is what VRGS calls the layers when it computes them, by either of two routes:

Run on the meshWritesPlots
Attributes & Analysis → Geometry → Tensor Analysis, with Dip and Azimuth ticked (on a point cloud, Attributes & Analysis → Tensor Analysis)Vertex attributesA pole per vertex — the orientation of the surface around it, over the neighbourhood you set.
Attributes & Analysis → Geometry → Dip Angle, then AzimuthTriangle attributesA pole per triangle — each face's own orientation, with nothing to set.

The two routes write layers of the same names, and each replaces the other's. Running Dip Angle alone on a mesh that has been through Tensor Analysis leaves a triangle Dip beside a vertex Azimuth — a pair that cannot plot.

Any other pair of scalar attributes can be picked instead — ones imported from other software, say — provided they pass the checks below. The pickers, and Mesh Attributes in both Data Source lists, appear once a mesh in the view has two or more scalar attributes to choose from.

One such pair is Patch Dip and Patch Azimuth, the triangle attributes that Grow Planar Patches and Auto Structural Mapping write: every triangle of a patch plots with the plane fitted to the whole patch, so the net shows the extracted surfaces weighted by their number of triangles. Triangles in no patch have no value in either, so only the patches are plotted. See Patches on the Stereonet.

Another is Fabric Dip and Fabric Azimuth, which the Dimensionality Report writes and opens a Stereonet window on: each triangle's own orientation, folded so the dip never exceeds 90. The plain Dip layer from Dip Angle can, on a triangle whose normal points downward, and then fails the checks; the Fabric pair always plots.

One pair of picks serves everything in the window that plots a mesh:

  • the density contours, when Data Source is Mesh Attributes;
  • the rose and the dip plot, when the rose's Data Source is Mesh Attributes — azimuths into the rose, dips into the dip plot;
  • the mesh Poles, under Mesh Properties;
  • pole selection, which selects the matching vertices in the model — or the matching triangles, for triangle attributes.

The picks belong to the window, and like the Data Source settings they are not saved with the project: a new Stereonet window starts from Dip and Azimuth again.

Checking the picks​

Before anything is plotted, the picks are checked on every mesh in the view that carries either of them. To plot, a mesh needs:

  • both attributes, and two different ones;
  • both scalar — one number per vertex or triangle, not a vector or tensor;
  • both vertex attributes, or both triangle attributes;
  • the same number of values in each. If they differ, one was computed on an earlier version of the mesh: compute it again;
  • every Dip value within 0–90° and every Azimuth within 0–360°, give or take 0.01°;
  • at least one vertex or triangle with both values set.

Null and NaN values count as no value: that vertex or triangle is skipped rather than held against the ranges. A mesh that fails any check is left off the stereonet — no contours, rose, poles or selection from it — while meshes that pass still plot. A mesh carrying neither attribute is simply not part of the plot.

The Attribute Status row under the pickers gives the verdict:

StatusMeaning
OK (n vertices / triangles)Every mesh that carries the picks passes. n counts the vertices or triangles with both values set.
Partly valid: (in red)Some meshes pass and plot; the rest are left off.
Invalid: (in red)Nothing can plot.

A red status names the first problem. Select the row for the full explanation — every problem, with the mesh and attributes it concerns — in the description area at the foot of the Properties panel.

Until a bad pick is put to use, that row is the only place it is reported. Setting either Data Source to Mesh Attributes, switching the mesh Poles on, or changing a pick while any of those is in use, brings up a warning box explaining the problem, and writes a [WARNING] line to the Messages panel.

The checks cannot tell a strike from a dip direction

Both lie within 0–360°, so an attribute holding strike passes every check and plots 90° out. The Azimuth Attribute must hold the dip direction.

The property sheet​

Select the stereonet and the Properties panel fills with three top-level groups. Groups remember whether you collapsed them.

Stereonet Display Properties​

The group opens with a read-only census: a Source / N header, the number of Interpretations plotted, and a row per mesh plotted from its dip and azimuth, with its pole count. Each interpretation orientation is drawn as both a pole and a plane, so one N covers both.

PropertyDescription
Show Key(Stereonet window only) A legend in the top-right margin: projection, N per interpretation type and mesh, the mesh-attribute colourbar, and the contour settings and their source.

Interpretation Properties​

PropertyDescription
Colour byObject = the per-type colours; Stratigraphy = the colours of the project's Contacts and Units (traces name a contact, measurements a unit; a name in both lists takes the unit's colour); Set = the Sets list colours; Group = the data-tree group each object sits in (loose objects plot grey as Ungrouped). DFN poles keep their own per-set colours. Applies to poles and planes alike.
PolesPlot the interpretation orientations as poles.
Pole SizePole radius, 1 (smallest) to 20 (largest).
Pole BorderA white ring behind each pole, so dark poles stay visible over contours.
PlanesPlot the interpretation orientations as great circles.

Mesh Properties​

Stereonet window only, and greyed until at least one mesh has a Dip and Azimuth pick that passes its checks. Without one there is nothing to plot.

PropertyDescription
Colour by attributeColour the mesh poles by one of the mesh's attributes — mapped over that attribute's full data range — or by a single flat object colour. The options are the attributes on the same elements as the poles: vertex attributes when the poles come from vertex Dip/Azimuth, triangle attributes when they come from triangle Dip/Azimuth.
Colour MapThe colour map used for that attribute, and for the key's colourbar. Sequential maps only.
PolesPlot the picked Dip/Azimuth as poles — one per vertex for vertex attributes, one per triangle for triangle attributes. Lasso-select these to select the matching vertices or triangles in the model.
SizeMesh pole radius, 1–20.
BorderA white ring behind each mesh pole.
Use Attribute FiltersHonour the mesh's attribute filters on the stereonet (poles, contours and rose). Off by default, which plots every vertex or triangle with both a Dip and an Azimuth value, regardless of the filters set on the mesh.
The data-tree selection does not colour these

Mesh pole colours come entirely from this combo. The active layer in the data tree and the mesh's attribute filters have no bearing on them — that is what Use Attribute Filters exists to change.

Contour Properties​

Show Contours is the master switch: everything below it is greyed until it is on — except Data Source and the mesh attribute rows under it, because the Dip and Azimuth picks also drive the mesh poles and the rose.

PropertyDescription
Show ContoursDraw spherical density contours.
Data Source(Stereonet window only) Interpretations — orientation and scanline data; Mesh Attributes — the mesh attributes picked as Dip Attribute and Azimuth Attribute, below. Mesh Attributes and the three rows below appear once a mesh in the view has two or more scalar attributes. The rose has its own Data Source, and the pole layers are controlled separately.
Dip Attribute(Stereonet window only) The mesh attribute read as dip, 0–90°: any scalar attribute on the meshes in the view, Dip by default. A vertex attribute gives a pole per vertex, a triangle attribute a pole per triangle. The contours, rose, mesh poles and selection all share this pick — see Plotting a mesh's dip and azimuth.
Azimuth Attribute(Stereonet window only) The mesh attribute read as azimuth (dip direction), 0–360°, Azimuth by default. Must be the same kind as the Dip: both vertex or both triangle attributes.
Attribute Status(Stereonet window only) Read-only: OK and how many vertices or triangles have both values — or, in red, Invalid: or Partly valid: and the first problem. Select the row for the full explanation, and see Checking the picks.
MethodModified Kamb — an adaptive counting circle sized to the sample, contoured in σ (standard deviations above a uniform distribution), which highlights statistically significant maxima. Schmidt (1%) — a fixed 1%-area counting circle contoured in % of the data: the classic equal-area method, comparable between datasets.
WeightingIn-circle weighting. Exponential is the smooth Vollmer (1995) Kamb kernel; Inverse Area and Inverse Area Squared taper the count toward the edge of the counting circle. Exponential has no effect under Schmidt, which is a plain count.
Significance (σ)1–5. Sets the counting area for Modified Kamb: lower gives tighter, more detailed contours, higher gives broader, smoother ones. Not used by Schmidt.
Contour ModeInterval — draw a contour every N units. Levels — draw exactly N equally-spaced contours between zero and the data maximum.
IntervalThe contour interval (1, 2, 3, 5, 10), in σ or %, depending on the method. Interval mode only.
LevelsThe number of contours (5, 8, 10, 15, 20). Levels mode only.
Solid FillFill the bands with colour-map colours.
LinesTrace each contour with a black line — shown on their own when Solid Fill is off.
Line Width1 (thinnest) to 20 (thickest).
Colour MapThe map used for the bands.
Reverse ColoursFlip the colour map.
Transparency0 (opaque) to 100 (fully transparent), so poles stay readable over a filled net.
Which method to use

Use Modified Kamb to ask "is this cluster real?" — its σ contours answer that directly. Use Schmidt (1%) when the plot has to be compared against published nets, or against another dataset of a different size.

Grid Properties​

PropertyDescription
Equal AreaEqual-area (Schmidt) projection. Uncheck for equal-angle (Wulff). Equal area is the default and is what density contouring assumes.
Major LinesThe 10° grid.
Minor LinesThe 2° grid.
Net ColourColour of the net lines, with Other… for a custom colour and Default to reset.
Cardinal LabelsN, E, S, W around the perimeter.
Degree LabelsDegree labels around the perimeter.
Degree IntervalSpacing between those labels: 10, 15 or 30°.

Rose Display Properties​

PropertyDescription
Show KeyA rose legend in the top-right: data source, N, bin size, strike or dip azimuth, and the peak-count scale.
Frequency LabelsLabel every other count ring with its value, up the north axis.
Data Source(Stereonet window only) Interpretations or Mesh Attributes — the rose's own, independent of the contours'. Mesh Attributes reads the Dip and Azimuth picked under Contour Properties: azimuths into the rose, dips into the dip plot.
BinsBin width in degrees: 10, 15 or 30.
Petal ColoursAzimuth — coloured through a cyclic colour map. Group — the data-tree group colours.
Colour MapThe cyclic map used for azimuth petal colours.
Cardinal LabelsN, E, S, W around the rose.
Degree LabelsDegree labels at the bin boundaries.
Equal AreaScale petal radius so petal area is proportional to frequency. Off gives linear scaling, which exaggerates the long petals.
Strike ValuesTreat azimuths as axial strike lines: each measurement plots both ±90° from its dip azimuth, doubling the petals, and the key reports strike.
ShapeFull, North Half or South Half. The half rose is available when Strike Values is on — strike petals repeat at 180°, so half the circle already shows all of the data.
Density RingA 1° azimuth density ring around the rose.
Azimuth DotsEvery individual azimuth as a dot outside the rose.
Mean ArrowThe circular-mean azimuth, drawn solid over the petals.
Median ArrowThe circular-median azimuth, drawn dashed.
Arrow WidthMean / median arrow line width, 1–10.
Equal area matters more than it looks

With linear scaling a petal twice as long looks four times as important, because the eye reads area. Equal Area is the honest default for a rose that is going into a figure.

Dip Plot Properties​

The dip plot is a quarter plot of dip angle, drawn in the lower-right of the stereonet.

PropertyDescription
Show Dip PlotDraw it.
Colour byDip — bins coloured by dip angle through the colour map. Group — bins stack per data-tree group in the group colours (loose objects stack grey as Ungrouped), and the dip key lists each group with its N.
Dip BinBin size in degrees: 10, 15 or 30.
Degree LabelsLabel every bin boundary, rather than just 0 and 90.
Equal AreaScale bin length so bin area is proportional to count.
Mean LineThe mean dip, as a solid radial line.
Median LineThe median dip, dashed. Both use the rose's Arrow Width.
Colour MapThe map used for the bins, in Dip colour mode only.

Analysis Display Properties​

Stereonet window only. Colours the whole net with a stress attribute computed from the project's active stress tensor, evaluated over every plane orientation — so you can read off which orientations are prone to slip or to open — and draws the kinematic analysis of a slope face.

PropertyDescription
Stress TensorThe stress tensor the Stress Attributes field and the Stress Axes draw: Active Tensor, which follows Set as Active in Collections > Stress Tensors, or a tensor by name, which stays with this view. Shown with the Geomechanics module.
Stress AttributesDraw the field, computed from the chosen stress tensor. Mutually exclusive with the density Solid Fill (the control greys out while that is on); poles draw on top of it.
AttributeWhich attribute to plot — see the table below.
Colour MapThe map for the field. Sequential maps only; cyclic maps do not suit a 0–1 scale.
Stress AxesMark the principal stress axes of the chosen tensor — Sigma 1 a red circle, Sigma 2 a green triangle, Sigma 3 a blue square — with a key of their plunge/trend and magnitude, the stress ratio and the failure parameters. A tensor made by a stress inversion also shows its bootstrap σ1 and σ3 axes as faint red and blue dots, with their 95% cones in the key. A tensor that varies with depth is drawn at its reference depth.
Sets FromWhere Set Statistics and Kinematic Analysis take their discontinuity sets from. Folders (default): each orientation folder holding planes is a set. Project Sets: each Set the planes are tagged with is a set, wherever they sit in the tree — Auto-cluster tags its clusters this way. Planes in no folder, or with no Set, count as one more set, Ungrouped or No Set, drawn grey.
Terzaghi CorrectionWeight each plane for the bias of sampling it from one direction; see Terzaghi correction.
Sampling Trend, Sampling PlungeThe sampling line in degrees, plunge positive down: the scan line, or the outward normal of the outcrop face the planes were mapped on. A vertical face has a horizontal normal: plunge 0.
Maximum WeightThe largest weight a plane can take. Default 7.
Set StatisticsMark each set's mean pole with its cones, and list its statistics; see Set statistics.
Variability Cone1 Sigma (68%) (default), 2 Sigma (95%) or None.
AttributeMeaning
Slip Tendency (Ts)τ / σn — propensity to reactivate in shear (0–1).
Dilation Tendency (Td)(σ1 − σn) / (σ1 − σ3) — propensity to open (0–1).
Reduced-Risk Dilation (Tdn)Td × (1 − Ts/Tsmax) — opening-favoured with low shear risk (0–1).
Fracture Susceptibility (Sf)(σn − Pf) − (τ − C0)/μ — the pore-pressure rise needed to reach failure, in MPa.
Opening Angle (OA)atan(τ / (Pf − σn)) — Jolly & Sanderson (1997), in degrees.
Sf and OA need real stress magnitudes

Ts, Td and Tdn are ratios and work from the stress shape. Fracture Susceptibility and Opening Angle are in MPa and degrees and are only meaningful if the active stress tensor's magnitudes are real values, not placeholders.

Stress Axes​

Stress Axes, under Analysis Display Properties in a Stereonet window, marks the principal axes of the project's active stress tensor: σ1 a red circle, σ2 a green triangle, σ3 a blue square. Its key gives each axis's plunge/trend and magnitude, the stress ratio R = (σ2 − σ3)/(σ1 − σ3), the pore pressure, friction coefficient and cohesion. The markers move when the tensor is edited or another is made active, and they go into the SVG export. With Remove Regional Dip on they are not drawn, since the poles around them are rotated and the axes are not. Needs the Geomechanics licence feature; without it the row is not shown.

To see the same planes against the tensor on a Mohr circle diagram, use the Charts panel.

Set statistics​

With Set Statistics on, each discontinuity set's mean pole is marked in the set's colour with two cones round it:

  • the α95 cone of confidence (solid): how well the mean is known;
  • the variability cone (dashed): how widely the planes spread — the share of a Fisher distribution of the set's concentration that one standard deviation (68%) or two (95%) holds, as Rocscience Dips draws it.

The key lists, for each set, N (planes), the mean Plane as dip/dip direction, Fisher K and α95. A set of one plane shows - for K and α95. The sets are folders or project Sets, as Sets From says; lineations are left out. With Remove Regional Dip on, the statistics are those of the rotated planes. The cones and the key go into the SVG export.

In an older project, a folder whose planes an earlier Auto-cluster copied into folders below it is left out, so its planes are not counted twice; the key says how many poles were left out.

Terzaghi correction​

Planes are under-sampled when they lie nearly parallel to the line they were sampled along: a scan line, or the line of sight to an outcrop face. Terzaghi Correction weights each plane by 1/|cos θ|, θ being the angle between its pole and the sampling line (Terzaghi 1965), so a set the sampling all but missed counts for what it is.

  • Give the sampling line as Sampling Trend and Sampling Plunge: for planes mapped on an outcrop face, the face's outward normal.
  • Maximum Weight caps the weight. The default of 7 leaves a blind zone of about 8° either side of the plane square to the sampling line, a common choice (Priest 1993); a higher cap lets a few near-parallel planes dominate.
  • It applies to the density contours (weights scaled to average 1, so σ keeps its meaning), the set statistics (the key says Terzaghi weighted) and the kinematic percentages (the key says Terzaghi weighted percentages). Both keys add the sampling line, as plunge/trend, and the cap, as Line 00/090, cap 7, so an exported figure records the correction it was made under. Their N columns still count planes and pairs of planes, not the weights.
  • It does not apply to the Charts-pane stereonet. Slope Stability has its own weighting on the maps, against the face at each plane's position.

Kinematic Analysis​

The kinematic analysis of one slope face: the construction for a failure mode, its critical zones shaded over the net, and a key listing the percentage of each set's planes — or of the lines where two sets' planes meet — that are critical. Each folder of plane interpretations is one discontinuity set — or each project Set, as Sets From says — even when two folders share a name; lineations are left out. A set with a joint strength of its own is tested at its own friction angle, shown in the key beside its name. The same tests map a whole mesh or point cloud; see Slope Stability.

PropertyDescription
Kinematic AnalysisDraw the analysis.
Failure ModePlanar Sliding, Wedge Sliding, Flexural Toppling or Direct Toppling.
Slope DipDip of the slope face, 0–180°; above 90 it overhangs.
Slope Dip DirectionThe direction the face looks.
Friction AngleFriction angle of the discontinuities; it starts from the active stress tensor's friction coefficient. A set with a joint strength of its own uses its own angle.
Lateral LimitHow far a plane or line may swing from the slope's direction and still count: 20° for planar sliding and direct toppling, 30° for flexural toppling. Wedge sliding has none.
Minimum Wedge AngleWedge Sliding and Direct Toppling only. Two planes closer to parallel than this, in degrees, form no line, so they are left out of the Lines table. Default 10; it applies between 0.1 and 90. It changes N and the percentages, but not the factors of safety. The key prints it when it is not the default. See Minimum wedge angle.
Intersection ScatterWedge Sliding and Direct Toppling only. Plot every line where one set's planes meet another's, as a dot in the pair's colour: solid where the line is critical at the pair's own friction angle, pale where it is not. Off by default. See The intersection scatter.
Factor of SafetyAlso list the limit-equilibrium factor of safety of the chosen failure mode on each set's mean plane (each pair of sets' for wedges), for this face. In Wedge Sliding it also marks where each pair's mean planes meet. See factors of safety on the stereonet and wedge markers.
FoS Slope HeightHeight of the slope from toe to crest, in metres. Default 20.
FoS Unit WeightUnit weight of the rock, kN/m³. Default 26.
FoS Water0 dry to 1 full: how full of water a planar block's tension crack is, and how saturated a wedge. Default 0.
FoS Block WidthSpacing of the toppling planes, in metres, for block toppling. 0 (default) leaves toppling out.
FoS ProbabilityBeside each factor of safety, the probability of failure from 1000 Monte Carlo samples — each set's plane drawn from its Fisher spread, its friction angle with a standard deviation of 2° and its cohesion with a coefficient of variation of 0.25 — and below them the inputs that move the lowest factor most, one standard deviation either side (a tornado). The same seed every time, so the numbers do not flicker.

The zones sit over the density contours and under the poles and planes, and the curves over the planes. With Remove Regional Dip on, the zones, the intersection scatter and the wedge markers are not drawn. SVG export includes them all.

How the keys are laid out​

The keys of the kinematic analysis, the fold analysis, the stress axes and the set statistics run as one flow, in that order, down shared columns to the right of the net: below the stereonet key when that is shown, then on into further columns to the right when a column is full. A title block, or a table with its caption and notes, moves to the next column whole rather than splitting; only a table taller than a column splits. The SVG export lays them out the same way, and its canvas grows to hold them.

Fold analysis​

Stereonet window only. Fits a cylindrical fold to bedding: the fold axis and how sure it is, the limbs, the interlimb angle, the axial plane and the fold's class.

What counts as bedding​

Orientation measurements typed Bedding, or not typed at all — the net already colours and counts those as bedding. Faults, fractures, cleavage, foresets, lineations, polylines, scanlines and DFNs are left out. A polyline's plane carries no type, so traced bedding is not used: measure orientations on it instead, or re-type picks with Set Selected As → Bedding.

Select poles on the net to analyse part of the data — one fold, or one domain of it, at a time. With nothing selected, all the bedding on the net is used.

Traced polylines do play a part, as contacts: they are drawn on the down-plunge profile and written to the modelling export. The selected polylines on the net are used, or all of them when none is selected; a polyline's stratigraphic contact gives it its name in the export and its colour on the profile.

The bedding statistics now count bedding only

The stats block's Number of Samples (Beds), Fisher K and α95, the mean ring (Show Means) and the figures Athos describes from the net used to count every plane and line on it, faults and lineations included. They now count the bedding described above, and the stats block adds a line with the π-axis.

Running it​

Right-click the net → Analyse Fold. The result is drawn on the net, a report page — with the down-plunge profile as a figure — is written to the project's Reports folder and opened in the report editor, and the messages panel gets one line with the axis and the fold's class.

On the netWhat it is
Pi-circle (blue)The best-fit girdle: the great circle the poles of a cylindrical fold lie on.
Fold axis (red dot)The pole to the pi-circle — the π-axis, the eigenvector of the smallest eigenvalue of the poles' orientation tensor.
95% cone (dashed red) and 95% ellipse (shaded)Where the axis could be, from a bootstrap of the poles. The ellipse is usually longer one way: a fold sampled mostly on its limbs pins its axis better in one direction than the other.
Axial plane (green)The plane through the axis that bisects the limbs. Two dashed green planes when the analysis cannot tell which of the two bisectors it is — see below.
Beta-axis (orange cross)The average line in which pairs of the planes meet: a cross-check that sits on the π-axis when the fold is cylindrical.
Limb mean poles (purple squares)The mean pole of each limb.
Cone (dashed purple)The small circle the poles follow, when the fold is conical.

The fold key lists the axis, the cone, the share of poles on the girdle, ln(S2/S3), the interlimb angle, the axial plane, whether the fold is conical, how many cylindrical domains it divides into, and the class. SVG export and report figures include the overlay. With Remove Regional Dip on it is not drawn: the analysis uses the planes as measured.

Reading the result​

  • Is there an axis at all? Only when the poles spread along a girdle. ln(S2/S3) measures that: below 1 the poles cluster — near-planar bedding, or a fold too gentle for the data — and the mean bedding plane is reported instead of an axis. Woodcock K on its own does not decide it.
  • Is the fold cylindrical? The share of poles within Fold: Girdle Tolerance (15° by default) of the pi-circle. Below 80% the result warns that the fold may be conical, refolded or several domains. The conical fit and the domains test those directly.
  • How sure is the axis? The 95% cone. By default every pick counts as an independent measurement, which picks along one bedding surface are not, and the cone then comes out too small. Set Fold: Resample By to Folder or Proximity for a cone that counts stations rather than picks.
  • Which interlimb angle? From orientations alone there are always two answers, θ and 180° − θ, with perpendicular bisecting planes: it depends on which side of the limbs the hinge lies. VRGS decides it from where the picks are — projected down the axis, the two limbs meet at the hinge, and only the true axial trace separates one limb's picks from the other's — or, without positions, from which of the two arcs between the limbs the poles actually cover: the hinge lies on the covered arc, and the other holds a gap. When neither decides it, both answers are shown and the class says unresolved, rather than guessing. Two tight clusters of limb poles with nothing between them are unresolved; limbs whose scatter fills the short arc between them read as the gentler fold.
  • The bisector is the axial surface only of a symmetric fold. The analysis assumes one cylindrical fold with straight limbs. A fold train, an asymmetric fold or strongly curved limbs give an unresolved or approximate answer, and the report says which.
Fleuty (1964) classBoundaries
Interlimb angleGentle 120° and over, open 70–120°, close 30–70°, tight 10–30°, isoclinal under 10°
Hinge plungeHorizontal under 10°, gently 10–30°, moderately 30–60°, steeply 60–80°, vertical 80° and over
Axial surface dipRecumbent under 10°, gently inclined 10–30°, moderately inclined 30–60°, steeply inclined 60–80°, upright 80° and over

A fold is reclined when its axis pitches 80° or more in an inclined axial plane, and vertical when the axis plunges 80° or more.

The report gives all of this in full: the eigenvalues, Woodcock and Vollmer figures, the bootstrap, both candidate axial planes and how well each separates the limbs, the profile frame, and every caveat.

Conical folds and cylindrical domains​

A cylindrical fold has one axis. Two common departures from it are tested in every run, and both are in the report.

  • Conical folds. The bedding of a conical fold wraps round a cone, so its poles lie on a small circle about the cone axis rather than on a great circle. VRGS fits one and asks whether it fits better than chance: the improvement is compared with simulated cylindrical folds that have the same spread of poles round the girdle and the same scatter off it. The fold is called conical when the improvement is significant (p < 0.05) and the cone is at least 5° wide; the fitted small circle is then drawn dashed purple, and the report gives the cone axis, the semi-apical angle and the test. It is only tested with ten or more poles spread over at least 30° of the girdle; poles from the two limbs alone, without the hinge, can hardly show a cone either way.
  • Cylindrical domains. A fold whose plunge changes along its hinge — a culmination, a depression, a curved hinge — is often cylindrical piece by piece. The positioned picks are sorted along the axis and analysed in windows of Fold: Domain Window picks; neighbouring windows whose axes agree form a domain, and each domain is analysed in full. The report lists the domains with their axes, where along the axis the plunge changes sense (a culmination where the hinge rises then falls, a depression where it falls then rises), and how fast the plunge and trend change per 100 units. It needs at least two windows of positioned picks, spread along the axis rather than all in one cross-section.

When a fold is conical or divides into domains, the single axis on the net is an average. Select the poles of one domain and run the analysis on them alone.

The down-plunge profile​

The report's figure looks down the fold axis: every positioned bedding pick and traced contact is projected along the axis onto the profile plane, so the fold is seen in true profile however the outcrop cuts it.

  • Picks are short ticks along the bedding, coloured by limb: blue limb A, orange limb B, green hinge zone. A hollow dot marks bedding that faces along the axis, whose trace in the profile is undefined.
  • Contacts are drawn in their stratigraphic colour.
  • The axial trace is the purple dash-dot line through the hinge (a diamond), or both candidates when the interlimb angle is unresolved.
  • A scale bar, the screen directions (right is a compass direction; up is vertical, or north for a vertical axis), and the axis with its cone.

Projection is only as good as the axis. A point far along the axis from the picks can be moved by the axis's uncertainty by more than the profile is wide; where that error exceeds a tenth of the plot, the contact is drawn dashed. Trust the solid parts.

Save Fold Profile as SVG... saves the same figure on its own. Create Down-Plunge Orthopanel adds an orthopanel to the 3D model that looks down the plunge, placed up-plunge of all the picks and contacts and deep enough to take them all in, so the baked image is the outcrop itself seen in profile. The panel cannot look straight down, so an axis steeper than 89° is taken as 89°.

Exporting for LoopStructural and GemPy​

Export Fold for LoopStructural / GemPy... writes six files into a folder you pick, named after the project (<project>_fold_…):

FileContents
_loopstructural.csvThe data: contacts as interface points (S0), bedding as normals (S0) and, when the axial plane is decided, the fold frame (S1): the axial surface and the fold axis.
_loopstructural_bbox.txtThe model's extent, the data padded by 10%.
_loopstructural.pyA script that builds the model: python <project>_fold_loopstructural.py.
_gempy_surface_points.csvGemPy surface points: the traced contacts.
_gempy_orientations.csvGemPy orientations: each pick's dip direction, dip and polarity, in the formation of the nearest contact.
_README.txtWhat was written, and the caveats below.
  • Polarity. Implicit models need each bedding normal to point toward younger beds, and a measured dip always points up, which is wrong on an overturned limb. When the axial plane is decided, every bed is oriented the same way round the hinge as the bedding at the hinge, which is taken as right way up — true of anticlines and synclines, not of inverted folds; reverse every normal for those. Otherwise polarity is worked out by walking between neighbouring picks, which can flip a whole limb of a fold sampled on its limbs alone. The messages panel warns when the polarity should be checked.
  • Contacts are exported by their stratigraphic contact name; a polyline without one is left out. With no contact traced, GemPy gets three points along the axis through the middle of the picks, which lie on one bedding surface of a cylindrical fold.
  • LoopStructural. The script builds the bedding as a plain foliation through the contacts and normals. Set FOLDED = True at its top to fold it about the fold frame instead, which carries the fold's shape away from the data; on test folds LoopStructural 1.8 fitted the data less closely that way, so compare the two.
  • GemPy has no fold-axis input, keeps no stratigraphic order from VRGS (put the formations in order before computing) and reserves the name basement, so a contact called that is written basement_1.

Unpositioned picks are not exported.

Keeping the axis and looking down it​

  • Create Fold Axis & Axial Plane makes a lineation named like Fold axis 12-045 and, when the analysis decided it, an orientation Axial plane 78-150 (fold analysis), typed Cleavage so it never feeds back into a bedding analysis. Both are placed at the hinge point when the limbs meet near the data, otherwise at the middle of the picks, and appear in the 3D view and on the net.
  • Look Down Plunge in 3D turns the 3D view to look along the axis at the picks and switches it to orthographic projection, so the outcrop reads as a fold profile. Zoom to frame the fold. The view is only as good as the axis: the further along the axis you look past the picks, the more its uncertainty moves things, and the report gives that error per 100 units along the axis.

These, the orthopanel, the profile and the export need the picks to have positions and a current result. When the bedding changes, the key says out of date and the entries are greyed until the analysis is run again. The profile, the export and the orthopanel use the picks and contacts the analysis was run on, whatever has been selected or traced since.

Settings​

In Analysis Display Properties, read when the analysis next runs:

PropertyDescription
Fold: Resample ByWhat the bootstrap treats as one independent measurement. Pick: every pole. Folder: every orientation folder; loose orientations count as one. Proximity: picks within Fold: Station Radius of each other.
Fold: Station RadiusFor Proximity: picks closer than this, in model units, are one station. 0 uses 5% of the picks' extent.
Fold: Girdle ToleranceDegrees a pole may lie off the pi-circle and still count as on it.
Fold: Bootstrap ReplicatesHow many resamples the cone and ellipse come from: 500, 1000, 2000 or 5000.
Fold: Domain WindowHow many positioned picks, in order along the axis, each window holds when the fold is divided into cylindrical domains: 10, 15, 20, 30 or 50. Smaller windows follow a changing plunge more closely and are noisier.

The analysis belongs to the window and is not saved with the project.

Tips and troubleshooting​

  • The net is empty. Nothing displayable is plotted: check the interpretations are visible, and that Show Poles or Show Planes is on.
  • Mesh Properties is greyed out. No mesh has a Dip and Azimuth pick that passes its checks. Read the Attribute Status row under Contour Properties — select it for the full explanation — then correct the picks, or give the mesh the attributes it lacks: Tensor Analysis for a pole per vertex, or Geometry → Dip Angle and Azimuth for a pole per triangle.
  • Mesh Attributes is not in the Data Source list. It appears once a mesh in the view has two or more scalar attributes to pick a Dip and an Azimuth from.
  • A warning says the Dip and Azimuth cannot be plotted. A pick has failed a check on at least one mesh. The warning names the mesh and the problem, and that mesh stays off the stereonet until the picks are put right. Values in another convention — a signed azimuth of −180 to 180°, say — fail the range check.
  • Mesh poles are missing where I filtered the mesh. That is the default: the stereonet ignores attribute filters. Tick Use Attribute Filters to honour them.
  • The Stress Attributes checkbox is greyed. Density Solid Fill is on; the two fields cannot both colour the net.
  • Contours look different from a published plot. Check the Method — Kamb σ contours and Schmidt % contours are not the same quantity — and that Equal Area is on.
  • The rose has twice as many petals as I expect. Strike Values is on, which plots each measurement axially at ±90°.
  • Number of Samples (Beds) went down. The bedding statistics now count only bedding, not every plane and line on the net.
  • Analyse Fold is greyed. It needs three bedding poles — selected, or on the net when none is selected. Faults, fractures and polylines do not count.
  • The fold analysis finds no axis. The poles cluster: the bedding is near planar, or the fold is too gentle for the scatter in the data. Add measurements from the hinge and the far limb.
  • The report has no down-plunge profile. The picks have no positions, or the analysis found no axis; the report says which.
  • The contacts on the profile are dashed. They lie far along the axis from the bedding picks, where the axis's uncertainty could move them by more than a tenth of the plot. Measure bedding nearer them, or trust only the solid parts.
  • The profile, export and orthopanel entries are greyed. They need a current fold result with an axis and positioned picks: run Analyse Fold again after changing the bedding.
  • A contact is missing from the export. Polylines are exported by their stratigraphic contact; give the polyline one.
  • A control I remember from the ribbon has gone. The Display, Contours and Rose panels moved off the ribbon into the property sheet and the right-click menu.

See also​