Geometry Inputs
Define slopes, opening sections, tunnel intersections, benches, and rock bolts.
Related fields share two columns in the Geometry sidebar: Mode and Failure Mode, Slope Height and Unit Weight, and underground axis inputs. Project Settings remains in Configure; Documentation remains in Help (F1).
Slope Properties
| Input | Range/units | Description |
|---|---|---|
| Geometry | Planar or Profile | Selects whether the exposed slope is a single plane or a multi-bench profile. |
| Slope Height | >= 1 m | Planar mode height used to size the tetrahedral wedge. Hidden in profile mode. |
| Unit Weight | kN/m3 | Material unit weight used to calculate wedge weight and seismic force. |
Underground Opening Properties
| Input | Range/units | Description |
|---|---|---|
| Axis Trend | 0 to 360 degrees | Azimuth of the tunnel or opening extrusion axis. |
| Axis Plunge | -90 to 90 degrees | Signed inclination of the extrusion axis. Positive values descend along the trend; negative values rise. |
| Length | >= 1 m | Excavation length used to extrude the opening section. |
| Unit Weight | kN/m3 | Rock unit weight used to calculate underground wedge weight and required support pressure. |
| CAD | Button | Opens the 2D Opening Section CAD editor in a resizable popup above the 3D workspace. The editor writes to the same section vertex list as the table and DXF import. |
| Import DXF | DXF polyline | Imports a closed POLYLINE or LWPOLYLINE opening section into the section vertex list. |
| Add row | CAD coordinate-table action | Inserts a vertex on the selected edge, or appends to the closing edge. |
| Offset / Elevation | Metres | Coordinates of each closed opening-section vertex in the transverse section plane, edited in Opening Section CAD. |
For a non-zero axis plunge, the opening section remains perpendicular to the extrusion axis with zero roll. The section up direction is derived from global vertical, and the configured length remains centred equally on either side of the project origin.
Underground Rock Bolts
The opening-section CAD Rock Bolt tool places each bolt with a collar snapped exactly to the excavation boundary and a tip directed into the ground. Project-wide named bolt types define colour, tensile strength, optional bond strength, axis spacing, and cosine orientation efficiency; each drawn bolt references one type. Bolt rows repeat at axis positions 0, ±spacing, ±2 × spacing, using the assigned type's spacing and limited by the excavation or tunnel-leg length.
In Select mode, click or modifier-click bolts individually, or drag left-to-right for a containing window and right-to-left for a crossing window. The selection panel supports bulk type assignment, exact length changes, deletion, type visibility filters, and selecting every visible bolt of a type. A single bolt exposes its collar, tip, direction, length, and a draggable tip grip. Bolt creation and editing support a 100-action CAD undo/redo history.
For Tunnel Intersection geometry, every named CAD section stores its own bolt pattern. Each tunnel leg has a Rock Bolts checkbox that determines whether the referenced section pattern is applied to that leg, including inclined, rolled, and shaft legs. Rows whose collars lie on surfaces removed by the tunnel union are discarded, and coincident physical rows are deduplicated.
When a project contains underground bolts, the rock-bolt button in the viewport status bar can display every physical row. Rows that intersect the active wedge use their assigned bolt-type colour; the remaining configured rows are grey. With the button off, only rows engaged by the active wedge are shown.
Intersection Wedge Ranking
The Valid Wedges table supports sorting by family-qualified block code, factor of safety, volume, required support pressure, and backbreak. Its filter panel provides maximum FS, minimum volume, minimum support pressure, and an FS < 1 shortcut. Highlighted cells identify the active group’s lowest FS, largest volume, and highest support demand.
Hide redundant is enabled by default. Within each family-qualified block code, it hides a row when another row has no higher FS and no lower volume, support demand, or backbreak, with at least one meaningfully more critical metric. Stable results are treated as having infinite FS, exact ties retain the earliest canonical result, and incomplete rows remain visible. This reversible table filter runs before the numeric filters and sorting; navigation, Detailed Results, exports, diagnostics, and show-all rendering continue to use every recovered result.
The Multiple Rock Bolts tool generates ordinary bolts over either of the two perimeter paths between boundary-snapped start and end points. Enter a bolt length and in-plane spacing of at least 0.1 m, select the two limits, hover a path to preview it, and click that path to generate the bolts. The first bolt is placed at the start and subsequent bolts are placed at exact arc-length spacing intervals; the end receives a bolt only when an interval lands there. Bolts project along the outward edge normal, using the bisector of adjacent outward normals at a section vertex. Exact duplicate collar-and-tip geometry is skipped and reported.
Pattern inputs and route selection are temporary CAD state. Generated bolts are stored as the same individual bolt geometry used by the single-bolt tool, so the shared strength, axis spacing, and orientation-efficiency settings apply unchanged.
Moving existing section vertices keeps segment-relative bolt collars attached. Replacing the section topology, importing DXF, or inserting/removing vertices requires confirmation and clears the bolt geometry.
Tunnel Intersection Geometry
Choose Edit Geometry… in the Geometry sidebar to open Tunnel Intersection Geometry. This resizable window contains named section management, DXF import, the Tunnel Legs table, junction margin, and the Boolean evaluation limit. Unit weight and mode selection remain in the sidebar.
Tunnel Intersection supports only a native network of at least two overlapping straight tunnel legs. Switching geometry modes requires confirmation because it permanently replaces the source mode's geometry, placed or section rock bolts, and mode-specific probabilistic or intersection-search settings. Switching into intersection analysis keeps the first three active sets as single joints: combination inputs use their first orientation with effective row/set strength and length; probabilistic inputs use their means. Names and colours are retained; extra sets, rows, and distributions are discarded. Switching back creates three combination sets with one orientation each. Unit weight, the rock-bolt type library, joint scaling, and solver tolerances are retained. Tunnel-intersection mode starts with the valid two-leg default network; extruded-section mode starts with the default opening. Editing a section vertex keeps segment-relative bolt collars attached; replacing its topology clears that section's bolt pattern after confirmation.
Each leg references a named closed section and has an independent centre, trend, plunge, roll, positive length, negative length, and end-face roles. Side walls are physical excavation faces. End faces may be physical or artificial; blocks touching artificial end faces are rejected. Overlapping legs generate the internal junction search regions automatically using the configured diameter margin.
| Input | Range | Description |
|---|---|---|
| Junction Search Margin | >= 0 diameters | Expands each physical leg-overlap bounding box before searching for local blocks. |
| Boolean Evaluation Limit | 100 to 1,000,000 | Maximum solid-clipping evaluations for each combination, junction region, and block family search. Values above 100,000 may take a long time. |
Increasing the Boolean limit gives the deterministic feature, global, and local search more work time. Reaching it produces boolean-budget-limited; numerical limits or failures produce optimizer-limited or optimizer-failed. All three statuses are provisional.
The Tunnel Legs table in the geometry window contains one row per leg. Edit the section reference, centre coordinates, orientation, lengths, and boundary roles directly in that row. The table’s Add row action inserts a uniquely identified leg; the remove action is disabled when only the required two legs remain.
Select a named template in CAD Section and choose Edit Section in CAD to edit that exact template by ID. CAD editing does not reorder section templates or retarget any tunnel leg references.
Add CAD Section creates and selects a new valid template seeded from the currently selected section, ready to redraw in CAD. Import DXF Section validates a closed DXF POLYLINE or LWPOLYLINE and adds it as a separate template named from the file. Existing sections and leg references are left unchanged.
Section Name renames the selected template after a non-empty name is committed. Delete CAD Section requires confirmation and is disabled when only one template remains. If tunnel legs reference the deleted section, they are reassigned atomically to the adjacent remaining template identified in the confirmation message.
Planar Face Controls
| Input | Range/units | Description |
|---|---|---|
| Upper Face Dip | 0 to 90 degrees | Inclination of the upper release surface. |
| Upper Face Dip Direction | 0 to 360 degrees | Azimuth toward which the upper face dips. |
| Slope Face Dip | 0 to 90 degrees | Inclination of the exposed slope face. |
| Slope Face Dip Direction | 0 to 360 degrees | Azimuth toward which the slope face dips. |
Bench Width Controls
| Input | Range/units | Description |
|---|---|---|
| Enable bench width | On/off | Allows the planar tetrahedral wedge to be trimmed by a bench-width setback when the requested width is less than the natural crest setback. |
| Bench Width | >= 0 m | Requested planar bench width. Disabled when bench width is not enabled. |
Profile Cross Section Controls
| Input | Range/units | Description |
|---|---|---|
| Dip Direction | 0 to 360 degrees | Azimuth of the profile section direction. |
| Half Length | >= 1 m | Half-width used to extrude the profile geometry along strike. |
| Batter Height | >= 0.1 m | Vertical height of each batter segment. |
| Batter Angle | 1 to 89.9 degrees | Inclination of each batter segment. |
| Bench Above Batter | >= 0 m | Horizontal bench width immediately above each batter. The 3D toe landing is generated automatically and does not affect calculations. |
| Add Bench | Button | Adds another profile bench row using the previous row as the seed. |
| Remove bench row | Button | Removes a profile row. Disabled when only one bench remains. |