Rocscience International Conference 2023 | April 24-26, 2023 Learn More about RIC2023

Search Results

3 - Probabilistic Analysis

This tutorial familiarizes you with the Probabilistic analysis features of RocPlane.

Topics covered in this tutorial:

  • Project Settings
  • Probabilistic Input Data
  • Probabilistic Analysis
  • Histogram, Cumulative and Scatter Plots
  • Random and Pseudo-Random Sampling
  • Correlation Coefficient

Finished Product:

The finished product of this tutorial can be found in the Tutorial 3 Probabilistic Analysis.pln4 file, located in the Examples > Tutorials folder in your RocPlane installation folder.

1.0 Creating a New File

If you have not already done so, run the RocPlane program by double-clicking the RocPlane icon in your installation folder or by selecting Programs > Rocscience > RocPlane > RocPlane in the Windows Start menu.

When the program starts, a default model is automatically created. If you do NOT see a model on your screen:

  1. Select File > New

Whenever a new file is created, the default input data forms a valid wedge, as shown in the image below.

new file default input data

If the RocPlane application window is not already maximized, maximize it now so that the full screen is available for viewing the model.

Notice the four-pane, split screen format of the display, which shows Top, Front, Side and Perspective views of the model. This view is referred to as the 3D Wedge View. The Top, Front and Side views are orthogonal with respect to each other i.e., viewing angles differ by 90 degrees.

Before we proceed, it is very important to note the following:

  • Although RocPlane displays the model in a three dimensional format, the RocPlane analysis is strictly a two-dimensional analysis. The 3D display is solely for the purpose of improved visualization of the problem geometry.
  • All input data assumes that the problem is uniform in the direction perpendicular to the wedge cross-section. The analysis is performed on a “slice” through the cross-section of unit width.
  • All analysis results (e.g., Wedge Weight, Wedge Volume, Normal Force, Resisting Force, Driving Force, etc.) and input data are therefore stated in terms of force per unit length, volume per unit length, etc.

2.0 Model


The Project Settings dialog allows you to configure the main analysis parameters for your model, such as Analysis Type and Units. To open the dialog:

  1. Select Analysis > Project Settings in the menu or click the icon in the toolbar.
    Project Settings
  2. Select the General tab,
  3. Set Units = Metric, stress as tonnes/m2.
  4. Set Analysis Type = Probabilistic.
  5. Select the Project Summary tab and enter RocPlane Probabilistic Analysis Tutorial as the Project Title.
  6. Click OK.


Now we'll define the random variables for the Probabilistic analysis. This is done through the Probabilistic Input Data dialog. To open the dialog:

  1. Select Analysis > Input Data
  2. Probabilistic Input Data dialog
    Probabilistic Input Data dialog, Slope tab
  3. In the Slope tab, make sure Unit Weight = 2.7 t/m³.

2.2.1 Defining Random Variables

To define a random variable in RocPlane:

  1. Select a Statistical Distribution for the variable from the drop-down. In most cases, a Normal distribution is adequate.
  2. Enter Standard Deviation, Relative Minimum, and Relative Maximum values.
Minimum and Maximum values are specified as RELATIVE distances from the Mean Value rather than absolute values.

Any variable with Statistical Distribution = None is assumed to be exactly known and will not be involved in the statistical sampling. For more help, see Random Variables in a RocPlane Probabilistic Analysis and Overview of Statistical Distributions in RocPlane

For this tutorial, we'll define Normal Statistical Distributions for the following variables:

  • Failure Plane Angle
  • Failure Plane Strength Cohesion
  • Failure Plane Strength Friction Angle

2.2.2 Failure Plane Angle

  1. Select the Failure Plane tab in the Input Data dialog.
  2. Enter the following data for the Failure Plane Angle:
  • Mean Value = 28
  • Statistical Distribution = Normal
  • Standard Deviation = 2
  • Relative Minimum = 5
  • Relative Maximum = 5

Defining Random Variables

2.2.3 Failure Plane Strength Cohesion and Friction

  1. Select the Strength tab.
  2. Set Cohesion Mean Value = 10 t/m2
  3. Set Friction Angle Mean Value = 35 deg.
  4. For both Cohesion and Friction Angle, set:
    • Statistical Distribution = Normal
    • Standard Deviation = 2
    • Relative Minimum = 5
    • Relative Maximum = 5

Probabilistic Input Data

2.2.4 Water Pressure

For this tutorial, we will also apply Water Pressure.

  1. Select the Plane Water tab.
  2. Select the Plane Water Pressure Exists check box. We will use all of the default settings:
  • Pressure Distribution Model = Peak PressureMid Height
  • Percent Filled Mean Value = 100%
  • Statistical Distribution = None.

Probabilistic Input Data water pressure


To carry out the RocPlane Probabilistic analysis:

  1. Click OK in the Probabilistic Input Data dialog.

3.0 Probabilistic Analysis


The primary result of interest from a Probabilistic analysis is the Probability of Failure. This is displayed at the top of the Perspective View in the 3D Wedge View and in the Wedge Information Panel in the Sidebar.

Probability of Failure

For this example, you should obtain a Probability of Failure of 13.3%. (i.e. PF = 0.133 means 13.3% Probability of Failure).

Later in this tutorial we'll discuss Random versus Pseudo-Random sampling. By default, Pseudo-Random sampling is in effect, which means you'll always obtain the same results each time you run a Probabilistic analysis with the same input data. With Random sampling, different results are generated each time you run the analysis. For more help, see Random Numbers Settings in RocPlane.


The wedge initially displayed after a Probabilistic analysis is based on the Mean input values and is referred to as the Mean Wedge. It appears exactly the same as the one based on Deterministic input data, with the same orientation.

Notice that the Wedge Information Panel in the Sidebar displays a Mean Wedge Data sections with the details of the wedge.

You can view other wedges generated by the Probabilistic analysis, as described in Section 3.3.2 Viewing Other Wedges below.


Now let's plot of a histogram of the Probabilistic analysis results, using the Histogram Plot Parameters dialog. To open the dialog:

  1. Select Statistic > Plot Histogram in the menu or click the icon in the toolbar.
    Histogram Plot Parameters dialogHistogram Plot Parameters dialog
  2. Click OK to plot a histogram of Safety Factor.

The histogram displayed in the Histogram Plot View represents the distribution of Safety Factor for all valid wedges generated by the statistical sampling of the input. The red bars at the left of the distribution represent wedges with a Safety Factor of less than 1.0.

Histogram Plot of Safety Factor
Histogram Plot of Safety Factor

3.3.1 Mean Safety Factor

Notice the mean, standard deviation, and minimum and maximum values displayed at the bottom of the Histogram Plot View.

Note that the Mean Safety Factor from a Probabilistic analysis as shown in the Histogram Plot View (i.e., the average of all of the Safety Factors generated by the analysis) is not always the same as the Safety Factor of the Mean Wedge (i.e., the Safety Factor of the wedge corresponding to the mean input data values). You can view the Safety Factor of the Mean Wedge in the title of the 3D Wedge View or in the Mean Wedge Data section of the Wedge Information Panel in the Sidebar (press CTRL+1 to switch to the 3D Wedge View).

In this case, the two values are nearly equal (1.148 versus 1.152) because we are using Latin Hypercube sampling and 10,000 samples (see Sampling Settings in RocPlane). In general, however, these values are not equal. There are various reasons for this:

  • Random sampling does not sample your input data distributions “exactly”.
  • The number of samples is small.
  • If invalid wedges are generated by the Probabilistic analysis, it can lead to differences between the Deterministic Safety Factor and the Probabilistic Mean Safety Factor.
If you use Monte Carlo sampling instead of Latin Hypercube and a smaller number of samples (e.g., 1000), you will see a greater difference between the Mean Safety Factor and the Safety Factor of the Mean Wedge This is demonstrated later in this tutorial.

3.3.2 Viewing Other Wedges ("Picked Wedge")

Now tile the Histogram Plot View and the 3D Wedge View so that both are visible.

  1. Select Window > Tile Vertically

Picked Wedge figure

A useful feature of Histogram plots (and also Scatter plots) is the ability to view other wedges. Double-clicking on the plot displays the nearest corresponding wedge in the 3D Wedge View.

Double-click at any point along the histogram and notice that a different wedge is now displayed. Note that the Safety Factor of this wedge is displayed in the title bar of the 3D Wedge View. Also note that the title bar indicates you are viewing a Picked Wedge rather than the Mean Wedge. Double-click at various points along the Histogram and notice the different wedges and Safety Factors displayed in the 3D Wedge View. For example, click the red area of the histogram to view wedges with a Safety Factor < 1.

This feature allows you to view any wedge generated by the Probabilistic analysis corresponding to any point along the histogram distribution. In addition to the 3D Wedge View, all other views (e.g., the Info Viewer) are updated with data corresponding to the Picked Wedge.

Note that the feature can be used on histograms of any statistical data generated by RocPlane, not just a Histogram of Safety Factor. The feature also works on other plot types, such as Cumulative plots and Scatter plots.

3.3.3 Resetting the Mean Wedge

To reset all views so that the Mean Wedge data is displayed:

  1. Click in the wedge view
  2. Select Show Mean FS Wedge from the View menu

3.3.4 Histograms of Other Data

In addition to Safety Factor, you can plot histograms of the following:

  • Wedge Weight, Wedge Volume
  • Normal, Driving, and Resisting Forces
  • Failure Plane Length, Upper Face Length
  • Any random input variable (i.e., any input data variable assigned a Statistical Distribution)

For example, let's generate a histogram for Wedge Weight:

  1. Select Statistic > Plot Histogram
  2. In the Histogram Plot Parameters dialog, select Wedge Weight in the Data Type drop-down.
  3. Select the Best Fit Distribution check box.
  4. Click OK.

A histogram of the Wedge Weight distribution is generated, as shown below.

Wedge Weight distribution

Note that all the features described above for the Histogram of Safety Factor apply to any other Data Type. For example, if you double-click on the Histogram of Wedge Weight, the nearest corresponding wedge is displayed in the 3D Wedge View.

Let's generate one more histogram. This time we'll plot one of the input data random variables: Failure Plane Angle.

  1. Select Statistics > Plot Histogram
  2. In the Histogram Plot Parameters dialog, select Failure Plane Angle in the Data Type drop-down.
  3. Select the Plot Input Distribution check box.
  4. Click OK.

The histogram shows how the Failure Plane Angle variable was sampled by the Latin Hypercube method. The curve superimposed over the histogram is the Normal distribution you defined when you entered the Failure Plane Angle Standard Deviation, Relative Minimum, and Relative Maximum values in the Input Data dialog above. Show Failed Wedges

Notice that, on all histograms, the distribution of failed wedges (i.e., wedges with Safety Factor < 1) is automatically highlighted in red. This allows you to see the relationship between wedge failure and the distribution of any input or output variable.

Show Failed Wedges

As we would expect, the failed wedges correspond to larger Failure Plane Angles, as can be seen above.


In addition to histograms, you can also plot cumulative distributions (S-curves) of the statistical results (i.e., Cumulative plots), using the Cumulative Plot Parameters dialog.

  1. Select Statistics > Plot Cumulative cumulative plot icon
  2. Cumulative Plot Parameters dialog

  3. Click OK.

A cumulative Safety Factor distribution is generated, as shown below.

cumulative Safety Factor distribution

A point on a cumulative probability curve gives the probability that the plotted variable is less than or equal to the value of the variable at that point.

For a cumulative Safety Factor distribution, the cumulative probability at Safety Factor = 1 is equal to the Probability of Failure. We can demonstrate this with the Sampler option, which allows you to obtain the coordinates of any point on the cumulative distribution curve.

To use the Sampler option:

  1. On the Chart menu or right-click menu, select Sampler > Show Sampler.
    You'll see a cross-hair vertical/horizontal line that follows the cursor.
  2. Move the cursor anywhere over the cumulative probability curve to see a popup data tip that shows the Cumulative Probability and Safety Factor at that point on the curve.
  3. Move the cursor until you see Safety Factor = 1.

Notice that the Cumulative Probability = 0.1332, which is equal to the Probability of Failure for this example, as shown in the figure below.

 Cumulative Probability

  • Turn off the display of the Sampler by re-selecting the Show Sampler option as above.


Scatter plots allow you to examine the relationships between analysis variables. You generate a Scatter plot using the Scatter Plot Parameters dialog.

  1. Select Statistics > Plot Scatter plot scatter button
    Scatter Plot Parameters dialog
  2. In the Scatter Plot Parameters dialog, select the variables you want to plot on the X and Y axes. For example, Safety Factor vs. Wedge Weight.
  3. Select the Show Regression Line check box.
  4. Click OK.

As can be seen below, there appears to be very little correlation between Safety Factor and Wedge Weight. However, Safety Factor does generally increase with increasing Wedge Weight.

Safety Factor vs. Wedge Weight

The Correlation Coefficient listed at the bottom of the plot indicates the degree of correlation between the two variables plotted. The Correlation Coefficient can vary between -1 and 1, where numbers close to zero indicate a poor correlation, and numbers close to 1 or –1 indicate a good correlation. Note that a negative Correlation Coefficient simply means that the slope of the best fit linear regression line is negative.

Alpha and beta, also listed at the bottom of the plot, represent the y-intercept and slope, respectively, of the best fit linear regression line to the scatter plot data.


  • As demonstrated earlier with Histograms, you can double-click on a Scatter plot to display the data for the nearest wedge on the plot.
  • The Show Failed Wedges option, described previously for Histograms, also works on Scatter plots. All wedges with Safety Factor < 1 are highlighted in red on the Scatter plot.
  • For the special case of Cohesion vs. Friction Angle, a user-defined Correlation Coefficient can be specified in the Input Data dialog. See the Additional Exercises at the end of this tutorial for details.

4.0 Sampling Settings


By default in RocPlane, Pseudo-Random sampling is in effect for a Probabilistic analysis. Pseudo-Random sampling allows you to obtain reproducible results from a Probabilistic analysis. We can demonstrate this by tiling the views.

  1. Select Window > Tile Vertically

Your screen should look similar to the figure below.

Pseudo-Random sampling

The Probabilistic analysis can be re-run at any time by selecting the Compute button in the toolbar.

  1. Select Analysis > Compute

Notice that, even though the analysis is re-run, all graphs and the Probability of Failure remain unchanged. Select Compute again to verify this.

Pseudo-Random sampling means that the SAME "seed" number is always used to generate random numbers for the sampling of the input data distributions. This results in identical sampling of the input data distributions each time the analysis is run (with the same input parameters). The Probability of Failure, Mean Safety Factor, and all other analysis output are reproducible. This can be useful for demonstration purposes or to discuss example problems.

You can change the sampling option to Random using the Project Settings dialog. The Random option uses a different seed number each time you re-compute, resulting in a different sampling of your input data distributions and therefore different analysis results.

  1. Select Analysis > Project Settings
  2. In the Project Settings dialog, select the Random Numbers tab.
  3. Set Random Number Generation = Random.
  4. Click OK.

Now re-select the Compute button several times. Notice that after each Compute:

  • All graphs are updated and display new results
  • The Probability of Failure is, in general, different each time the analysis is run (for this example, you should find that the Probability of Failure varies between about 13 and 14 %)

This demonstrates the difference between Random and Pseudo-Random sampling, and also graphically demonstrates the RocPlane Probabilistic analysis.

The 3D Wedge View does not change when you re-compute since by default the Mean Wedge is displayed (i.e., the wedge based on the mean input data), which is not affected by re-running the analysis.


So far we have used Latin Hypercube sampling throughout this tutorial. As an additional exercise, let’s try Monte Carlo sampling, with a smaller number of samples. You change this in the Project Settings dialog.

  1. Select Analysis > Project Settings
  2. In the Project Settings dialog, select the Sampling tab.
  3. Set Sampling Method = Monte Carlo.
  4. Set Number of Samples = 1000.
    Project Settings dialog
    Project Settings dialog, Sampling tab

  5. Click OK.

Examine the Probability of Failure and the Safety Factor Histogram. The results should be similar to the Latin Hypercube analysis.

The difference, as shown in the figure below, is in the sampling of the input data random variables. Notice that the Monte Carlo sampling method results in a much more variable sampling of the input data distribution compared to the Latin Hypercube method, which gives smoother results.

Safety Factor Histogram

Re-compute several times and observe the variability of results each time you re-compute.


Let’s finally examine the Info Viewer listing for a Probabilistic analysis.

  1. Select Analysis > Info Viewer

 Info Viewer

The Info Viewer displays a convenient summary of model and analysis parameters. Scroll down to view all of the information. Notice the listing of the probabilistic input and output data. As with the plot views, re-computing the analysis automatically updates the Info Viewer to reflect the latest results.

5.0 Additional Exercises


In this tutorial, Cohesion and Friction Angle were treated as completely independent variables. In fact, it is known that Cohesion and Friction Angle are related in a general way, such that materials with low friction angles tend to have high cohesion, and materials with low cohesion tend to have high friction angles.

You can use the Input Data dialog to define the degree of correlation between Cohesion and Friction Angle for the Failure Plane. This only applies if:

  1. BOTH Cohesion and Friction Angle are defined as random variables (i.e., assigned a Statistical Distribution), and
  2. Statistical Distribution = Normal/Uniform/Lognormal/Exponential/Gamma (will not work for Beta or Triangular).

As a suggested exercise, try the following:

  1. Define Normal distributions for the Cohesion and Friction Angle.
  2. Select the Correlation coefficient between cohesion and friction angle check box.Correlation Coefficient
  3. Enter a Correlation Coefficient (initially, use the default value of –0.5).
  4. Re-run the analysis.
  5. Create a Scatter plot of Cohesion vs. Friction Angle.
  6. Note the Correlation Coefficient listed at the bottom of the Scatter plot.
    It should be approximately equal to the value entered in the Input Data dialog (i.e., –0.5 in this case).
  7. Note the appearance of the plot.
  8. Now repeat steps 3 to 6, using Correlation Coefficients of -0.6 to -1.0, in 0.1 increments and observe the effect on the Scatter plot.
    Notice that, when the Correlation Coefficient is equal to –1, the Scatter plot results in a straight line.


After generating any graph in RocPlane, you can easily export the data to Microsoft Excel with a single mouse click, as follows:

  1. Select the Chart in Excel button on the toolbar OR right-click on a graph and select Chart in Excel from the popup menu.
  2. Export the graph data and generate a graph in Excel.

Finally, note the Export Dataset option on the Statistics menu. This option allows you to export raw data from a Probabilistic analysis to the Clipboard, a file, or Excel for post-processing. Any or all data generated by the Probabilistic analysis can be simultaneously exported.

This concludes the tutorial. You are now ready for the next tutorial, Tutorial 04 - Support in RocPlane.

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 RSLog RocFall3 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