Rocscience International Conference 2025 is going to take place in Sydney, Australia Read more

Search Results

11 - ShapeMetriX Integration

1.0 Introduction

This tutorial demonstrates RocSlope3’s ShapeMetriX Geometry and Joint Import options. It also demonstrates how the integration and interoperability of ShapeMetriX and RocSlope3 streamlines the 3D block stability analysis workflow, from data acquisition in the field. It helps to determine each block's stability and predict failure locations and magnitudes. The tutorial will help you become familiar with importing ShapeMetriX 3D Models to generate a RocSlope3 model and structures (i.e. joints) to perform a 3D block stability analysis in RocSlope3.

Topics Covered in this Tutorial:

  • Importing 3D Model from ShapeMetriX
  • Importing Measured Joints from ShapeMetriX
  • Results Interpretation

Finished Product:

The finished product of this tutorial can be found in the Tutorial 11 ShapeMetriX Integration folder, located in the Examples > Tutorials folder in your RocSlope3 installation folder.

2.0 ShapeMetriX 3D Model Generation and Structural Mapping

ShapeMetriX is a comprehensive software suite designed for geologic mapping and geometric analysis, equipped with an advanced 3D model generator. It is ideal for creating 3D models of rock surfaces, rock slopes, tunnel faces and walls, etc. using digital imagery or by importing 3D datasets (E57 laser scanner or OBJ data) and performing fast, detailed, non-contact geological mapping and geometric assessment.

MultiPhoto, the first main component of ShapeMetriX, uses multiple overlapping images from standard drones and handheld cameras, including smartphones as input and generates 3D models by estimating the 3D structure of a scene from a set of 2D images using the Structure from Motion (SfM) process. Additionally, MultiPhoto includes standard and constrained referencing features that reference the 3D model to a higher-level coordinate system using externally surveyed Ground Control Points (GCP).

3D Model Generation and Referencing are discussed in more detail in ShapeMetriX Tutorial 1 – 3D Model Generation and Tutorial 2 – Standard and Constrained Referencing Using Ground Control Points.

Analyst, the second main component of ShapeMetriX, is a convenient tool designed for visualizing and assessing 3D models. Analyst features a fast and detailed visualization of single, multiple and merged 3D models and allows users to perform geometric measurements like dip directions and dip angles, lineaments, rock bridges (non-persistent elements), areas, distances, point locations, occurrences (water, single events), partitioning of areas (lithology and homogeneous areas), and many more, directly on a 3D model. Analyst also includes attributes like:

  • Grouping measurements into Structure Sets
  • Semi-automatic trace detection
  • Automatic joint set clustering
  • Orientation of areas and traces including stereographic projection and statistics
  • Defining scanlines and mapping regions
  • Lithologic region and homogenous area mapping

These help to streamline the geological and geotechnical assessment of rock faces or terrains across various scales, such as open pit mines, tunnel faces, rock slopes, drift faces, caverns, quarries, laboratory samples, and constructions like dams.

Geometric Measurements and Structural Mapping in ShapeMetriX are discussed in more detail in Tutorial 3 – Geometric Measurement and Structural Mapping.

3.0 3D Model

The model used in this tutorial is a 15m high and approximately 90m long bench face from an open pit mine with a large number of measured joint surfaces and traces of known orientation, size, and location. The 3D model is generated in ShapeMetriX’s MultiPhoto tool using 49 aerial images, and the structural mapping is performed in ShapeMetriX’s Analyst tool using semi-automatic joint trace and surface mapping features.

ShapeMetriX model

The 3D model geometry and the mapped joints data are exported as RocSlope3 readable files (.3grs for model geometry and .3gdps for joint data). These exported files will be used as input files in RocSlope3 and can be found in the Examples > Tutorials > Tutorial 11 ShapeMetriX Integration folder in your RocSlope3 installation folder.

3.1 Project Settings

Open RocSlope3. You will see a blank workspace.

Our first step is to configure the analysis parameters for the model in the Project Settings.

  1. Select Analysis > Project Settings or click on the Project Settings Project Settings icon icon in the toolbar.
  2. Select the Units tab.
    1. Set Units = Metric, stress as MPa and keep everything else as default.
    Units Tab in Project Settings dialog
    Units tab in Project Settings dialog
  3. Select the Analysis tab. Ensure:
    1. Design Factor of Safety = 1.0
    2. Successive Failure = ON
    Analysis Tab in Project Settings dialog
    Analysis tab in Project Settings dialog
  4. Click OK to save the settings and close the dialog.

3.2 Import Geometry

To import the Bench Face geometry into RocSlope3:

  1. Select Geometry > Import/Export > ShapeMetriX Import Import ShapeMetriX icon
  2. In the Surface Reconstruction dialog, click Browse Open icon, select the Blocky Bench Geometry.3grs file in the Tutorial 11 ShapeMetriX Integration folder (located in your installation folder) and click Open.

  3. The geometry file will be imported, and surface reconstruction will be performed automatically. The preview of the extruded volume will be displayed in the dialog.

  4. Ensure that the Surface Reconstruction parameters are as follows:
    1. Density of Voxels = 100
    2. Number of Buffer Voxels = 1
    3. Depth of Extrusion = 5
  5. Bench Face geometry preview in Surface Reconstruction dialog
    Bench Face geometry preview in Surface Reconstruction dialog
  6. Click OK to complete the geometry import.

Density of voxels controls how dense the resulting mesh will be. Increasing the density will result in a denser mesh triangulation.

Number of Buffer Voxels controls how far beyond the extents of the input point cloud the surface is extrapolated. Increasing the number will cause the surface to be extended further. Increasing this value can be useful to fill gaps in sparse input data, though at large numbers the extrapolated regions may not accurately reflect the input data.

Tip: Auto running the extruded volume generation from reconstructed surface can be turned on and off by selecting or deselecting the Auto Run checkbox in the Surface Reconstruction dialog.

The geometry is imported into RocSlope3 and added to the Visibility Tree. Click the Imported ShapeMetriX Geometry entity in the Visibility Tree. Notice in the Properties pane (below the Visibility pane) that the entity is imported as a closed Volume.

imported model

3.3 Setting the Volume as External

We now have to set the Volume entity as External to create a valid external geometry for modelling.

To set the external geometry from the volume entity:

  1. Select the Imported ShapeMetriX Geometry volume entity in the Visibility Tree. The entity is highlighted in the 3D View.
  2. Select Geometry > Set as External Set as external

The selected volume is now defined as the External volume. In this model, there is only one (1) Material Volume assigned with the Material 1 material property.

3.4 Defining Joint Properties

To define joint properties:

  1. Navigate to the Joints workflow tab
  2. Select Joints > Define Joint Properties or click on the Define Joint Properties define joint properties icon icon in the toolbar.
  3. Select Joint Property 1 from the list on the left side of the dialog. Enter the following properties for Joint Property 1:
    1. Under the Strength tab:
      • Strength Type = Mohr-Coulomb
      • Cohesion = 0 MPa
      • Phi = 30 deg
      • Override by Material = OFF
      • Waviness = 0 deg
    2. Under the Water Parameters tab:
      • Water Pressure Method = Dry
  4. Joint Property 1 in the Define Joint Properties dialog
    Joint Property 1 in the Define Joint Properties dialog
  5. Click OK to save and close the Define Joint Properties dialog.

3.5 Importing Measured Joints

We will be defining the joints using measured orientation data from a ShapeMetriX structural mapping file (.3gdps).

To define measured joints:

  1. Ensure the Joints workflow tab Joint workflow tab is still active.
  2. Select Joints > Define Measured Joints or click on the Define Measured Joints Define Measured Joints icon icon in the toolbar.
  3. Select Shear Strength = Use Joint Properties. We will be assigning the Joint Property 1 we defined earlier.
  4. Click Import ShapeMetriX Import ShapeMetriX icon
  5. In the Open dialog, select the Blocky Bench Joints.3gdps file from the Tutorial 11 ShapeMetriX Integration folder and click Open.
  6. Notice that Joint Orientations (Dip and Dip Directions), Locations (X, Y and Z) and Radius (Persistence) are imported. Joint Property 1 is also assigned to all the joints as their Joint Property.
  7. 503 Joints imported in Define Measured Joints dialog
    503 Joints imported in Define Measured Joints dialog
  8. Click OK to save the inputs, exit the Define Measured Joints dialog and add the joints to the model.
3D View of Measured Joints and the Blocky Bench Face Geometry
3D View of Measured Joints and the Blocky Bench Face Geometry

4.0 Compute

RocSlope3 has a two-part Compute process.

    4.1 Compute Blocks

    The first step is to compute the blocks which may potentially be formed by the intersection of joints with other joints and the intersection of joints with the free surface.

    To compute the blocks:

    1. Navigate to the Compute workflow tab Compute workflow tab
    2. Select Analysis > Compute Blocks or click the Compute Blocks Compute Blocks icon icon in the toolbar.

    As compute is run, the progress bar reports the compute status. Once compute is finished, the Results node is added to the Visibility Tree and All Valid Blocks are shown in the 3D View. The Results node consists of the collection of valid blocks and the socketed slope. The original External and Measured Joints visibility is turned off.

    3D View of all Valid Blocks
    3D View of all Valid Blocks

    Once compute is finished, the blocks are coloured according to the Block Color option (Random Colors) set in the Results node's Property pane.

    Compute Blocks only determines the geometry of the blocks. In order to obtain other information such as the factor of safety, Compute Kinematics needs to be run.

    4.2 Compute Kinematics

    The second and final compute step is to compute the removability, forces, and factor of safety for each of the valid blocks.

    To compute the block kinematics:

    1. Ensure that the Compute workflow tab Compute workflow tab is still the active workflow.
    2. Select Analysis > Compute Kinematics or click the Compute Kinematics Compute Kinematics icon icon in the toolbar.

    As compute is run, the progress bar reports the compute status. By default, after Compute Kinematics is run, only Removable Blocks are shown.

    3D View of Removable Blocks only
    3D View of Removable Blocks only

    In a Successive Failure mode of analysis, several Failure Iterations may be performed. In the first Failure Iteration, only immediately removable daylighting blocks are analyzed. Any blocks which have a factor of safety less than the Design Factor of Safety (set in Project Settings) is considered "failed". These blocks are also known as "key blocks". The stability of key blocks controls the global stability of the slope. As key blocks fail and are detached from the slope, potential constraints in joint faces (in regard to removability and valid sliding direction) are removed and become free faces which no longer support the block or provide shear resistance to sliding. As such, the failure proceeds in a successive manner. See the Analysis topic for more information on Successive Failure.

    Successive Failure analysis in RocSlope3 does not model the interaction between blocks; the unraveling mechanism is much more complex. Instead, RocSlope3 looks at each block in isolation during each Failure Iteration.

    5.0 Interpreting Results

    Once both blocks and kinematics are computed, all block results can be viewed in a grid format.

      5.1 Block Information

      To view all block results:

      1. Navigate to the Results workflow tab Results workflow tab
      2. Select Interpret > Block Information or click on the Block Information Block information pane icon icon in the toolbar.

      Visualizing blocks can be difficult when the slope extents are large compared to the block extents.

      To zoom into all blocks:

      1. Select Interpret > Zoom to All Blocks Zoom to all blocks

      The Block Information pane shows the collection of blocks according to the Results Set settings. The Results Set shown can be selected in the Results tab of the Display Options, or the Properties pane for the Results Node. In this case, only Removable Blocks are colored and listed in Block Information.

      Block Information pane showing Removable Blocks only
      Block Information pane showing Removable Blocks only

      644 blocks are computed, as displayed in the Status Bar at the bottom right of the RocSlope3 window. 168 valid blocks are formed, and 112 blocks are Removable. 54 of these blocks have a Factor of Safety less than the Design Factor of Safety (<1.0).

      Tip: The number of Valid, Removable and Failed blocks can be viewed by clicking the Filter icon in Block ID column in Block Information pane while the corresponding Results Set is selected.

      When visualizing All Valid Blocks or Removable Blocks result sets, some blocks may have a Failure Depth of 0. Blocks with a Failure Depth of 0 are either non-daylighting blocks or daylighting blocks which are safe (i.e., Factor of Safety >= Design Factor of Safety)

      In the case of Successive Failure, it may be more beneficial to only colour the failed blocks. Failed blocks are blocks which have a factor of safety less than the Design Factor of Safety.

      To colour Failed Blocks Only:

      1. Select the Results node from the Visibility Tree.
      2. In the Results node Properties pane, set Results Set = Failed Blocks (FS < Design FS).

      Failed Blocks Only are now coloured according to Random Colors.

      Block Information pane showing Failed Blocks only
      Block Information pane showing Failed Blocks only
      A failed block is inherently geometrically removable, but a removable block may not fail. The removability is geometry-dependent, while factor of safety is force-dependent.

      Note that the Failure Iteration column is visible for a Successive Failure analysis. The Failure Iteration indicates the step in which the block fails. It is not a true representation of the complex unraveling mechanism, but rather for notation and filtering.

      Notice that 40 blocks are immediately unstable and fail in Failure Iteration = 1. In other words, they are the key blocks. On the other hand, 10 blocks are failing in Failure Iteration = 2, 3 blocks are failing in Failure Iteration = 3 and 1 block is failing in Failure Iteration = 4.

      See Tutorial 5 – Successive Failure for more information on the Successive Failure phenomenon and how it is utilized in RocSlope3.

      5.2 Detailed Block Information

      To see the detailed information for a given block:

      1. Select the row for the block of interest in the Block Information pane. For this example, we will select Block ID = 4 from the rows of the Block Information (or graphically, by clicking the Block in the 3D View).
      2. Click the See Block Details See Block Details button at the top right of the Block Information pane.

      The Detailed Block Information dialog shows the 3D model of the Block, general block information as well as detailed information for Joints, Joint Line of Intersection, and Block Vertices.

      Detailed Block Information dialog for Block ID = 4
      Detailed Block Information dialog for Block ID = 4

      Now let’s look at Block Details of another block.

      1. Select the Block ID = 11 from the rows of the Block Information (or graphically, by clicking the Block in the 3D View).
      2. Click See Block Details See Block Details
      3. Notice that the block with Block ID = 11 is failing in Failure Iteration = 2. Note that the Joint = 2 is highlighted grey since it is treated as a free face due to the detachment of the adjacent in the Successive Failure analysis.
      Detailed Block Information dialog for Block ID = 11
      Detailed Block Information dialog for Block ID = 11

      This concludes Tutorial 11.

      Rocscience logo, click here to return to the homepage Portal Account Portal Account Log In Log Out Home Shopping Cart icon Click here to search our site Click here to close Learning Tech Support Documentation Info Chevron Delete Back to Top View More" Previous Next PDF File Calendar Location Language External Link Apply to ACC External Link Fees Video Click here to visit Rocscience's LinkedIn page Click here to visit Rocscience's YouTube page Click here to visit Rocscience's X page Click here to visit Rocscience's Facebook page Click here to visit Rocscience's Instagram page Click here to visit Rocscience's Reddit page Bookmark Network Scroll down for more Checkmark Download Print Back to top Single User Multiple Users RSLog RocFall3 CPillar Dips EX3 RocFall RocPlane RocSlope3 RocSupport RocTopple RS2 RS3 RSData RSPile RSWall Settle3 Slide2 Slide3 SWedge UnWedge RocTunnel3 RocSlope2 BlastMetrix ShapeMetriX Fragmenter TestLicense Commercial License Education License Trial License Shop safe & secure Money-back guarantee