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

Search Results

03 - Add Joint Surface

1.0 Introduction

The shape, size and spatial distribution of joint structures may be defined as any arbitrary planar/surface geometry, or a collection of discrete planar surfaces; these can include faults, folding fractures, foliations, or Discrete Fracture Networks (DFNs). This tutorial covers the use of an imported cross-jointed Discrete Fracture Network (DFN) and Fault which will be used to model the joints in RocTunnel3. The DFN consists of bedding planes at a Dip/Dip Direction of 20/85 degrees and orthogonal cross-joints. The Fault has a Dip/Dip Direction of 60/135 degrees.

Finished Product

The finished product of this tutorial can be found in the Add Joint Surface.roctunnel_model file. All tutorial files installed with RocTunnel3 can be accessed by selecting File > Recent Folders > Tutorials Folder from the RocTunnel3 main menu.

2.0 Opening the Starting File

  1. Select File > Recent > Tutorials Folder in the menu.
  2. In the Add Joint Surface folder, open the file Add Joint Surface - starting file.roctunnel_model.

This model already has the following defined and provides a good starting point to start defining joint surfaces:

  • Project Settings
  • Material Properties
  • External Geometry
  • Joint Properties
3D View of Powerhouse Excavation and External Geometry
3D View of Powerhouse Excavation and External Geometry

2.1 Project Settings

Review the Project Settings.

  1. Select Analysis > Project Settings project settings
  2. Select the Units tab.
    1. Ensure Units are Metric, stress as MPa.
      Units tab in Project Settings dialog
      Units tab in Project Settings dialog

  3. Select the Analysis tab.
    1. Ensure Design Factor of Safety = 1.
    2. Ensure Successive Failure = OFF. We will only be analyzing the blocks which daylight and are readily removable.
      Analysis tab in Project Settings dialog
      Analysis tab in Project Settings dialog

  4. Click Cancel to close the dialog.

2.2 Material Properties

Review the Material Properties.

  1. Select Materials > Define Materials Define material properties icon
  2. One (1) material property is defined. The Rock material property has:
    1. Unit Weight = 0.026 MN/m3.
    2. No Water Surface applied.​
      Rock material property in Define Materials dialog
      Rock material property in Define Materials dialog

  3. Click Cancel to exit the dialog.

2.3 External Geometry

The External consists of an excavated Powerhouse structure assigned with No Material, bounded by an External box assigned with Rock material property.

3.0 Joint Properties

Review the Joint Properties.

  1. Select Joints > Define Joint Properties define joint properties
  2. Two (2) joint properties are defined. The DFN joint property has:
    1. Strength Type = Barton Bandis
    2. JRC = 10
    3. JCS = 90 MPa
    4. Phir = 25 degrees
    5. Override by Material = OFF
    6. Waviness = 0 degrees
    7. Water Pressure Method = Dry.​
      DFN joint property in Define Joint Properties dialog
      DFN joint property in Define Joint Properties dialog

  3. The Fault joint property has:
    1. Strength Type = Mohr-Coulomb
    2. Cohesion = 0 MPa
    3. Friction Angle = 35 degrees
    4. Override by Material = OFF
    5. Waviness = 0 degrees
    6. Water Pressure Method = Dry.​
      Fault joint property in Define Joint Properties dialog
      Fault joint property in Define Joint Properties dialog

  4. Click Cancel to exit the dialog.

4.0 Add Joint Surface

In this example, we will be defining joint surfaces from a DFN geometry file. To import the DFN geometry:

  1. Select File > Import > Import Geometry Import geometry icon. Several geometry file formats are supported. See the Import Geometry topic for more information.
  2. In the Open dialog, select the Fault.rsgeomobj and DFN Cross-Jointed.rsgeomobj files from the Tutorials > Add Joint Surface folder and click Open.
  3. The Import Geometry dialog shows the file(s) and mesh entities available for import and a preview of the entity.
  4. Select All Geometry.
    Import Geometry dialog
    Import Geometry dialog

  5. Click Post-Processing.
  6. Click Done to import the geometries.

The geometries are imported into RocTunnel3 and are shown in the Visibility Tree.

3D View of imported Fault Surface, DFN Surface and External geometries
3D View of imported Fault Surface, DFN Surface and External geometries

4.1 Add Joint Surface

In order for RocTunnel3 to treat the imported surfaces as joints, they must be assigned as a joint surface using the Add Joint Surface option.

  1. Navigate to the Joints workflow tab Joints workflow tab
  2. Select the Fault.Default.Mesh node from the Visibility Tree
  3. Select Joints > Add Joint Surface Add joint surface icon
  4. In the Add Joint Surface dialog, enter:
    1. Joint Property = Fault.
      Add Joint Surface dialog
      Add Joint Surface dialog

    2. Click OK to set the entity as a Joint Surface.
  5. Select the DFN Cross-Jointed.Default.Mesh node from the Visibility Tree.
  6. Select Joints > Add Joint Surface Add joint surface icon
  7. In the Add Joint Surface dialog, enter:
    1. Joint Property = DFN. Each face of the entity is treated as a separate joint by RocTunnel3, all with the assigned Joint Property.
      Add Joint Surface dialog
      Add Joint Surface dialog

  8. Click OK to set the entity as a Joint Surface.

The joints are drawn in the 3D View.

3D View of Fault Surface and DFN Surface as Joint Surfaces
3D View of Fault Surface and DFN Surface as Joint Surfaces

5.0 Compute

RocTunnel3 has a two-part compute process.

5.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 Compute blocks icon

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 blocks are shown in the 3D View. The Results node consists of the collection of valid blocks and the socketed excavation. The original External and Joint Surface visibility is turned off.

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

The blocks are coloured according to the Block Color option (Random Colors) set in the Results node's Properties pane.

Block Colors may appear with different colors than the Random Colors in this tutorial.

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.

5.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 the active workflow.
  2. Select Analysis > Compute Kinematics compute kinematics icon
If the current Results Set is not already set to Removable Blocks, then select the Results node from the Visibility Tree and set the Results Set = Removable Blocks.

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
3D View of Removable Blocks

6.0 Interpreting Results

Once both blocks and kinematics are computed, all block results can be viewed in the Results workflow tab.

6.1 Failed Blocks

To view failed blocks:

  1. Select the Results node from the Visibility Tree
  2. Set Results Set = Failed (FS < Design FS)
3D View of Failed Blocks
3D View of Failed Blocks

Even though many valid blocks are formed and are removable, only few of them are flagged as failed blocks with Factor of Safety less than the Design Factor of Safety of 1. The failed blocks slide along the steeply inclined joint faces on which the shear strength does not provide sufficient resistance.

This concludes Tutorial 03.

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 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 Settle3 Slide2 Slide3 SWedge UnWedge RocTunnel3 RocSlope2 BlastMetrix ShapeMetriX Fragmenter Commercial License Education License Trial License Shop safe & secure Money-back guarantee