The Rocscience International Conference 2021 Proceedings are now available. Read Now

Search Results

Application of Joint Networks (with XFEM)

1.0 Introduction

This tutorial will demonstrate how to specify joint networks or discrete fracture networks (DFN) in RS2 using XFEM. It will also demonstrate techniques for analyzing the effects of joints on model results. The model involves the stability analysis of slop contained of a parallel joint network.

Image of model involving the stability analysis of slope contained of a parellel joint network

2.0 Constructing the Model

  1. Select File > Recent Folders > Tutorials Folder > Jointed Rock
  2. Select Jointed Slope with XFEM (Initial)


Geometry workflow tab

Select: Analysis > Project Settings icon Project Settings

In the Project Settings dialog:

  1. Select General tab and ensure that the Use XFEM checkbox is checked.
  2. Project Settings dialog

  3. Click OK to close the dialog.


Apply a joint network to the model.

  1. Select Boundaries > Joint Networks > Add Joint Network
  2. Click the mouse cursor at any location within the model. A hatched pattern should appear in the selected zone.
  3. Hit Enter or right click and select Done in the popup menu to complete the selection. The Add Joint Network dialog will appear.
  4. Input data fields are grouped under headings. Labels (descriptions) of the input fields are shown on the left cells while the corresponding actual input fields are on the right cells.

  5. At the bottom of the dialog, ensure both “Auto Min/Max 3x Std.Dev.” and “Update Preview” are check boxed.
  6. Input the parameters shown in the table below. Leave all other parameters as the default settings provided in the dialog.
  7. General Settings

    Joint Model

    Parallel Deterministic

    Joint Property

    Joint 1


    Use Trace Plane






    20 m

    Initial Location






    Infinite length


    Joint End Condition

    Joint Ends

    All Open

  8. Select OK to close the dialog.

The model should appear as below:

Image of model


Loading workflow tab

  1. Select Loading > Field Stress icon Field Stress
  2. For Field Stress Type, select Gravity and ensure only “Use actual ground surface” is checked.
    1. Set Total Stress Ratio (horiz/vert in plane) = 1.0
    2. Set Total Stress Ratio (horiz/vert out-of-plane) = 1.0
  3. Select Ok to save and close the dialog.

Field Stress Properties dialog

2.6 MESH

Mesh Workflow tab

  1. Select Mesh > Mesh Setup icon Mesh Setup
  2. In the Mesh Setup dialog:
    1. Change the Mesh Type to Uniform and Element Type to 6 Noded Triangles in the drop-down menu
    2. Enter the Approximate Number of Mesh Elements as 1500.
    3. Select Discretize. If a Joint Networks Warning dialog appears, click “Clean geometry.” In the Geometry Cleanup dialog, accept the default values and click OK. Select Yes to the discretization and mesh prompt which follows.
  3. Select Mesh > Mesh.

Mesh Setup dialog

Model with mesh applied


Restraints workflow tab

By default, all nodes on the external boundary are pinned (fixed, zero displacement).

The slope (ground) surface must be free to move in any direction.

  1. Select Displacements > Free icon Free
  2. In the Set Restraints/Displacements dialog:
    1. Ensure Selection mode = Boundary Segments.
    2. Use the mouse to select all the top line segments defining the ground surface. Select Apply or right click and select Apply in the drop-down menu.
    3. Keep the Set Restraints/Displacements dialog open.
  3. On the Set Restraints/Displacements dialog select the Restrain X,Y symbol Restrain X, Y icon (or if the dialog was closed select Displacements > Restrain X,Y).
  4. Ensure Selection mode = Boundary Segments.
  5. Select the line segments making up both the left and right vertical sides of the model. Select Apply and Close.

The resulting model should look like the following:

Model with boundary segments

3.0 Compute

  1. Select File > Save icon Save As
  2. Select Analysis > Compute icon Compute

4.0 Results and Discussion

Select Analysis > Interpret icon Interpret


The maximum compressive stress (sigma 1) would be displayed.

Image of Sigma 1 contours

The effects of the joints on the Sigma 1 contours are visible; the contours are jagged and not as smooth as those for models without joints.


Yielded Joint icon

By clicking on yield joint icon, the yield joints in domain would turn to red and would display on active contour.

Model with yielded joints

As it can be seen, more joints on the top part of the slop are yielded since they experience more deformation than joints at the bottom of the slop.


Select Total Displacement from the drop-down menu in the toolbar.

The contour would show the maximum deformation on the slop and zero deformation on the boundaries as they are set to be zero by assigning the boundary condition. As it can be seen, regarding to the presence of joints, the deformation is discontinuous in the domain. To compare the results of XFEM with regular explicit joints in FEM, we repeated the similar simulation, but this time the checkbox of “use XFEM” in project setting has turned off.

Image of two models compared

(Left) regular explicit joint and (right) XFEM

The mesh used for each analysis is displayed on the above figure. In the explicit joint, the mesh is aligned with the joint, however in XFEM, joints are crossing the elements and it is not required to be aligned with joints. As it can be seen, the results are similar for both methods.

Account Icon - click here to log in or out of your account 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" 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 Twitter page Click here to visit Rocscience's Facebook page Click here to visit Rocscience's Instagram page Bookmark Network Scroll down for more Checkmark Download Print Back to top Single User Multiple Users CPillar Dips EX3 RocFall RocPlane RocSupport RocTopple RS2 RS3 RSData RSPile Settle3 Slide2 Slide3 SWedge UnWedge Commercial License Education License Trial License Shop safe & secure Money-back guarantee