Stereonet User Guide

The stereonet is where VRGS plots orientation data: the planes and lineations you have interpreted, and the per-vertex dip and azimuth of an analysed mesh. It contours pole density, draws a rose diagram and a dip plot beside it, colours the net by a stress attribute, 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, and the stress-attribute field.

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 four blocks. Toggles show a tick when they are on.

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.
View in 3D window	Fly the 3D view to the selected poles' centroid — or, with nothing selected, to the single pole under the cursor. The 3D window is brought to the front. Greyed when neither applies.
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.

From the net back to the outcrop

View in 3D window 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.

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.

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

On the Stereonet ribbon tab:

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 and in the trees.

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

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 visible analysed mesh 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 / Set = the project pick-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 the mesh has been analysed for dip and azimuth (Attributes & Analysis → Geometry → Tensor Analysis on the mesh). Without those attributes 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 union of attribute names across the analysed meshes.
Colour Map	The colour map used for that attribute, and for the key's colourbar. Sequential maps only.
Poles	Plot each mesh vertex's Dip/Azimuth as a pole. Lasso-select these to select the matching vertices 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 non-null vertex 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. Data Source is the exception, because the rose reads it too.

Property	Description
Show Contours	Draw spherical density contours.
Data Source	(Stereonet window only) Interpretations — orientation and scanline data; Mesh Attributes — the mesh's per-vertex Dip/Azimuth. The rose has its own Data Source, and the pole layers are controlled separately.
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.

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

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	Interpretations or Mesh Attributes — the rose's own, independent of the contours'.
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.

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.

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 stress state, evaluated over every plane orientation — so you can read off which orientations are prone to slip or to open.

Property	Description
Stress Attributes	Draw the field. 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.

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.

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 project's stress magnitudes are real values, not placeholders.

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. The mesh has no Dip and Azimuth attributes — run Tensor Analysis on it first.
• 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°.
• 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.
• Auto Structural Mapping — generating the orientations the net plots.
• 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.