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
| Where | What you get |
|---|---|
| Charts panel | A 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.
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
| Command | Effect |
|---|---|
| Show Stereonet | Draw the net itself (the grid and its frame). |
| Show Poles | Plot orientations as poles. |
| Show Planes | Plot orientations as great circles. |
| Show Contours | Density-contour the poles. |
| Show Rose | Draw the rose diagram. |
| Strike Values | Plot the rose as strike rather than dip azimuth. Available only while the rose is shown. |
Selection
| Command | Effect |
|---|---|
| Set Selected As → Bedding / Fractures / Cleavage | Re-type the selected orientations. The change goes back to the objects themselves, so it is reflected everywhere in the project. |
| Group Selected | Move the selected orientations into a new Stereonet Group in the interpretation tree. |
| Invert Selection | Select what was not selected, and vice versa. |
| De-select all | Clear the selection. |
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
| Command | Effect |
|---|---|
| Analyse Fold | Fit 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 Plane | Keep the fold axis as a lineation and the axial plane as an orientation. |
| Look Down Plunge in 3D | Turn the 3D view to look along the fold axis, in orthographic projection. |
| Create Down-Plunge Orthopanel | Add 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 Analysis | Remove 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
| Command | Effect |
|---|---|
| 2D View | The flat stereonet on its own. |
| 3D View | The 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
| Command | Effect |
|---|---|
| Spreadsheet | The plotted orientations as a table. |
| SVG Document → Stereonet Diagram | The net as a vector drawing, at publication quality. |
| SVG Document → Rose Diagram | The rose as a vector drawing. |
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):
| Tool | What it does |
|---|---|
| Rectangle | Drag a rectangle; every pole inside is selected. |
| Ellipse | The same with an ellipse. |
| Polygon | Draw a closed polygon around a cluster. |
| Sector | Select an angular sector of the net. |
| Hide Unselected | Hide 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 mesh | Writes | Plots |
|---|---|---|
| Attributes & Analysis → Geometry → Tensor Analysis, with Dip and Azimuth ticked (on a point cloud, Attributes & Analysis → Tensor Analysis) | Vertex attributes | A pole per vertex — the orientation of the surface around it, over the neighbourhood you set. |
| Attributes & Analysis → Geometry → Dip Angle, then Azimuth | Triangle attributes | A 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:
| Status | Meaning |
|---|---|
| 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.
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.
| Property | Description |
|---|---|
| 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
| Property | Description |
|---|---|
| Colour by | Object = 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. |
| Poles | Plot the interpretation orientations as poles. |
| Pole Size | Pole radius, 1 (smallest) to 20 (largest). |
| Pole Border | A white ring behind each pole, so dark poles stay visible over contours. |
| Planes | Plot 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.
| Property | Description |
|---|---|
| Colour by attribute | Colour 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 Map | The colour map used for that attribute, and for the key's colourbar. Sequential maps only. |
| Poles | Plot 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. |
| Size | Mesh pole radius, 1–20. |
| Border | A white ring behind each mesh pole. |
| Use Attribute Filters | Honour 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. |
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.
| Property | Description |
|---|---|
| Show Contours | Draw 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. |
| Method | Modified 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. |
| Weighting | In-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 Mode | Interval — draw a contour every N units. Levels — draw exactly N equally-spaced contours between zero and the data maximum. |
| Interval | The contour interval (1, 2, 3, 5, 10), in σ or %, depending on the method. Interval mode only. |
| Levels | The number of contours (5, 8, 10, 15, 20). Levels mode only. |
| Solid Fill | Fill the bands with colour-map colours. |
| Lines | Trace each contour with a black line — shown on their own when Solid Fill is off. |
| Line Width | 1 (thinnest) to 20 (thickest). |
| Colour Map | The map used for the bands. |
| Reverse Colours | Flip the colour map. |
| Transparency | 0 (opaque) to 100 (fully transparent), so poles stay readable over a filled net. |
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
| Property | Description |
|---|---|
| Equal Area | Equal-area (Schmidt) projection. Uncheck for equal-angle (Wulff). Equal area is the default and is what density contouring assumes. |
| Major Lines | The 10° grid. |
| Minor Lines | The 2° grid. |
| Net Colour | Colour of the net lines, with Other… for a custom colour and Default to reset. |
| Cardinal Labels | N, E, S, W around the perimeter. |
| Degree Labels | Degree labels around the perimeter. |
| Degree Interval | Spacing between those labels: 10, 15 or 30°. |
Rose Display Properties
| Property | Description |
|---|---|
| Show Key | A rose legend in the top-right: data source, N, bin size, strike or dip azimuth, and the peak-count scale. |
| Frequency Labels | Label 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. |
| Bins | Bin width in degrees: 10, 15 or 30. |
| Petal Colours | Azimuth — coloured through a cyclic colour map. Group — the data-tree group colours. |
| Colour Map | The cyclic map used for azimuth petal colours. |
| Cardinal Labels | N, E, S, W around the rose. |
| Degree Labels | Degree labels at the bin boundaries. |
| Equal Area | Scale petal radius so petal area is proportional to frequency. Off gives linear scaling, which exaggerates the long petals. |
| Strike Values | Treat azimuths as axial strike lines: each measurement plots both ±90° from its dip azimuth, doubling the petals, and the key reports strike. |
| Shape | Full, 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 Ring | A 1° azimuth density ring around the rose. |
| Azimuth Dots | Every individual azimuth as a dot outside the rose. |
| Mean Arrow | The circular-mean azimuth, drawn solid over the petals. |
| Median Arrow | The circular-median azimuth, drawn dashed. |
| Arrow Width | Mean / median arrow line width, 1–10. |
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.
| Property | Description |
|---|---|
| Show Dip Plot | Draw it. |
| Colour by | Dip — 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 Bin | Bin size in degrees: 10, 15 or 30. |
| Degree Labels | Label every bin boundary, rather than just 0 and 90. |
| Equal Area | Scale bin length so bin area is proportional to count. |
| Mean Line | The mean dip, as a solid radial line. |
| Median Line | The median dip, dashed. Both use the rose's Arrow Width. |
| Colour Map | The 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.
| Property | Description |
|---|---|
| Stress Tensor | The 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 Attributes | Draw 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. |
| Attribute | Which attribute to plot — see the table below. |
| Colour Map | The map for the field. Sequential maps only; cyclic maps do not suit a 0–1 scale. |
| Stress Axes | Mark 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 From | Where 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 Correction | Weight each plane for the bias of sampling it from one direction; see Terzaghi correction. |
| Sampling Trend, Sampling Plunge | The 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 Weight | The largest weight a plane can take. Default 7. |
| Set Statistics | Mark each set's mean pole with its cones, and list its statistics; see Set statistics. |
| Variability Cone | 1 Sigma (68%) (default), 2 Sigma (95%) or None. |
| Attribute | Meaning |
|---|---|
| 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. |
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.
| Property | Description |
|---|---|
| Kinematic Analysis | Draw the analysis. |
| Failure Mode | Planar Sliding, Wedge Sliding, Flexural Toppling or Direct Toppling. |
| Slope Dip | Dip of the slope face, 0–180°; above 90 it overhangs. |
| Slope Dip Direction | The direction the face looks. |
| Friction Angle | Friction 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 Limit | How 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 Angle | Wedge 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 Scatter | Wedge 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 Safety | Also 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 Height | Height of the slope from toe to crest, in metres. Default 20. |
| FoS Unit Weight | Unit weight of the rock, kN/m³. Default 26. |
| FoS Water | 0 dry to 1 full: how full of water a planar block's tension crack is, and how saturated a wedge. Default 0. |
| FoS Block Width | Spacing of the toppling planes, in metres, for block toppling. 0 (default) leaves toppling out. |
| FoS Probability | Beside 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 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 net | What 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) class | Boundaries |
|---|---|
| Interlimb angle | Gentle 120° and over, open 70–120°, close 30–70°, tight 10–30°, isoclinal under 10° |
| Hinge plunge | Horizontal under 10°, gently 10–30°, moderately 30–60°, steeply 60–80°, vertical 80° and over |
| Axial surface dip | Recumbent 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_…):
| File | Contents |
|---|---|
_loopstructural.csv | The 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.txt | The model's extent, the data padded by 10%. |
_loopstructural.py | A script that builds the model: python <project>_fold_loopstructural.py. |
_gempy_surface_points.csv | GemPy surface points: the traced contacts. |
_gempy_orientations.csv | GemPy orientations: each pick's dip direction, dip and polarity, in the formation of the nearest contact. |
_README.txt | What 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 = Trueat 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 writtenbasement_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-045and, when the analysis decided it, an orientationAxial 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:
| Property | Description |
|---|---|
| Fold: Resample By | What 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 Radius | For Proximity: picks closer than this, in model units, are one station. 0 uses 5% of the picks' extent. |
| Fold: Girdle Tolerance | Degrees a pole may lie off the pi-circle and still count as on it. |
| Fold: Bootstrap Replicates | How many resamples the cone and ellipse come from: 500, 1000, 2000 or 5000. |
| Fold: Domain Window | How 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
- Analysis Reports — putting a stereonet or rose figure into a document.
- Grow Planar Patches and Auto Structural Mapping — generating the orientations the net plots from the planar faces of a mesh, as one object per patch or as the Patch Dip and Patch Azimuth triangle attributes.
- Charts, Histograms and Filtering — the same stereonet in the docked Charts panel, alongside the attribute charts.
- Fracture Intensity Mapping — the intensity attributes derived from the same data.
- Slope Stability and its method — the kinematic analysis on the net, and mapped over a mesh or point cloud.
- Implicit Surfaces — folded and overturned surfaces built from the same bedding measurements.
- Mohr Diagram — the selected planes against a stress tensor.
- Sets — the project Sets and their joint strength.