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

Search Results

Automate Deterministic Analysis

This tutorial will familiarize you with the Automate Compute feature of RocSupport by automating a RocSupport Deterministic analysis.

Topics Covered in this Tutorial:

  • Deterministic Analysis RocSupport Model
  • Input Excel File Format
  • Adding Input Excel File(s) to Automate Compute File Queue
  • Output RocSupport Automate Compute Results File
  • RocSupport Automate Compute Error Log

Finished Product:

The finished products of this tutorial can be found in the Tutorial 7 Automate Compute - Deterministic Analysis folder, located in the Examples > Tutorials folder in your RocSupport installation folder. Inside, you will find:

  • Tutorial 07 Automate Compute - Deterministic_base file.rsp RocSupport model file setup for automation
  • Tutorial 07 Automate Compute - Deterministic_inputs.xlsx Excel input file
  • Tutorial 07 Automate Compute - Deterministic_inputs folder containing the computed results files

1.0 Introduction

The Automate Compute option helps users quickly generate results for several RocSupport analysis cases at a time by reading in various model inputs from Excel. In this tutorial, we will automate the computation of three unique Deterministic cases (i.e., three tunnel cases).

2.0 Creating a New File

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

When the program starts, there are no Models loaded. You need to create a new project as follows:

New File Icon Select: File > New

Whenever a new file is created, the Ground Reaction View is displayed. The view shows the Ground Reaction Curve based on the default Tunnel and Rock Parameters.

Ground Reaction View Display

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

Before we are ready to run the Automate Compute, we must first set up the model environment in the following dialogs:

  1. Project Settings
  2. Tunnel and Rock Parameters
  3. Support Parameters

NOTE: This RocSupport model file is meant to be used as a base file for automation, It contains the appropriate settings to be used for all automated cases and the engine for computation. It is not meant to be used for model creation and result viewing, as it does not save the model state for every case.

3.0 Project Settings

First, set the model Units, and Analysis Type.

  1. Select Project Settings Project Settings Icon from the Analysis menu to open the Project Settings dialog.
  2. Set the Units = Metric, stress as MPa
  3. Set the Analysis Type = Deterministic
  4. Set Solution Method = Lee and Pietruszczak (2008)
  5. Set Modulus Estimation Method for Generalized Hoek-Brown Materials = Simplified Hoek-Diederichs (2006)
  6. Project Settings Dialog

  7. Select Ok to close the dialog

NOTE: The above Project Settings will apply to all cases analyzed in Automate Compute. Each case being analyzed is Deterministic (i.e a single Ground Reaction Curve) in this case.

4.0 Tunnel and Rock Parameters

Next, set the optional Tunnel and Rock Parameters.

  1. Select Tunnel Parameters Tunnel Parameters Icon from the Analysis menu to open the Deterministic Tunnel and Rock Parameters dialog.
  2. Click on the "Residual" radio box and keep all the other check box controls in the default state.

Keep in mind that the following are required input parameters that have to be specified later on in the Input Excel File

  • Tunnel Radius
  • In-Situ Stress
  • Young's Modulus
  • Poisson ratio
  • Critical Deviatoric Plastic Strain
  • Dilation Angle
  • Residual Dilation Angle
  • Compressive Strength of Intact Rock
  • Residual Compressive Strength of Intact Rock
  • mb
  • s
  • a
  • Residual mb
  • Residual s
  • Residual a

 Tunnel Parameters Dialog

NOTE: You can learn about RocSupport Tunnel and Rock Parameters in detail in Overview of RocSupport Tunnel and Rock Parameters

5.0 Support Parameters

Next, set the optional Support Parameters.

  1. Select Support Parameters Support Parameters Iconfrom the Analysis menu to open the Deterministic Support Parameters dialog.
  2. Navigate to the Shotcrete tab.
  3. Click on the "Add Support" radio box and keep all the other check box controls in the default state.

Keep in mind that the following are required input parameters that have to be specified later on in the Input Excel File:

  • Thickness
  • Uniaxial compressive strength
  • Young's Modulus
  • Poisson ratio
  • Distance from tunnel face

Support Parameters Dialog

NOTE: You can learn about RocSupport Support Parameters in detail in Overview of RocSupport Support Parameters

6.0 Input Excel File

Now, let's take a look at the structure of the input Excel file.

  1. Obtain the RocSupport Deterministic Excel Template by creating a new project New File Icon and by selecting Analysis > Automate Compute > Deterministic Excel Template.

A Read-Only Excel workbook titled RocSupport Automation Template_Deterministic.xlsx will be automatically opened (if you have Excel installed on your local machine).

Deterministic Excel Template

The RocSupport Deterministic Input Data Automation Template Excel workbook and worksheets are protected to prevent any accidental modifications to the tab structure and headers. The input Excel template contains 7 worksheets for inputting numerical parameters for automation.

  1. Create a folder called Tutorial 7 Automate Compute - Deterministic.
  2. Navigate to the LEE AND PIETRUSZCZAK worksheet

Each worksheet contains fields for the necessary inputs related to each solution method available in RocSupport. For this tutorial, we will choose the Lee and Pietruszczak method.

  1. Under the Tunnel ID column, provide the names of the tunnel cases. We will name them arbitrarily Tunnel A, Tunnel B, and Tunnel C. Each row in the input Excel file represents one Deterministic Analysis case in RocSupport.
  2. Enter the following values for the general properties of the tunnel and elastic/plastic properties of the rock.

Tunnel ID

Rock Parameters

Rock Parameters

General

Elastic/Plastic Properties

Radius

In-Situ Stress

Young's Modulus

Poisson Ratio

Critical Deviatoric Plastic Strain

Tunnel A

8.0

1.10

600

0.0023

5

Tunnel B

7.5

1.25

610

0.0021

0

Tunnel C

8.2

1.30

595

0.0019

2

Strength Properties

Dilation Angle

Residual Dilation Angle

Compressive Strength of Intact Rock

Residual Compressive Strength of Intact Rock

mb

s

a

Residual mb

Residual s

Residual a

5

3

6

5

1.0

0.0001

0.60

0.50

0.0001

0.4

0

0

6

4

1.2

0.0002

0.52

0.52

0.00018

0.4

2

1

5

4

1.4

0.0003

0.45

0.45

0.00025

0.4

NOTE: As set up previously in RocSupport Deterministic Tunnel and Rock Parameters dialog, only the above input data are required since the Mohr-Coulomb model is not applicable (i.e., checkbox control is unchecked). Be aware of units set in RocSupport Project Settings when entering data into the input Excel file. The units should be the same for bot!h!

The LEE AND PIETRUSZCZAK worksheet should look like this:

Tunnel Parameters worksheet

  1. Navigate to the SUPPORT PARAMETERS worksheet
    1. Under the Tunnel ID column, provide the names of the tunnels (Tunnel A, Tunnel B, Tunnel C).
    2. Enter the following:

Tunnel ID

Support Parameters

Shotcrete Properties

Support Installation

Thickness

Uniaxial Compressive Strength

Young's Modulus

Poisson ratio

Distance from tunnel

Tunnel A

60

28

30000

0.22

2

Tunnel B

55

25

29850

0.25

2

Tunnel C

65

30

32100

0.24

2

NOTE: As set up previously in the RocSupport Support Parameters dialog, only the above input data are required since Rockbolt supports and Steelsets supports are not added.

The SUPPORT PARAMETERS worksheet should look like this:

Support Parameters worksheet

  1. Save the Excel file as Tutorial 7 Automate Compute - Deterministic_inputs.xlsx to the Tutorial 7 Automate Compute - Deterministic folder previously created

NOTE: Since the RocTopple Automation Template_Deterministic.xlsx file is Read-Only, you must rename and save in a new location

We are now ready to automate computations in RocSupport by reading from the input Excel file.

7.0 Automate from Excel

Return back to the RocSupport model.

The Automate Compute dialog allows you to add Excel input automation files to the queue, select an output format, and compute the results. To open the dialog, select Automate Compute > Automate from Excel from the Analysis menu.

Excel Icon Select: Analysis > Automate Compute > Automate from Excel

Automated Compute Dialog

7.1 ADD FILES TO FILE QUEUE

To add multiple files to the File Queue:

  1. Select Automate from Excel Excel icon from the Analysis menu to open the Automated Compute dialog.
  2. Select the Open Open Folder Icon button to open a standard dialog to choose an Excel input file. Navigate to the Tutorial 7 Automate Compute - Deterministic folder and select the Tutorial 07 Automate Compute - Deterministic_input.xlsx file..

You will see the Excel input file appear under the File Queue list box.

Automated Compute Dialog

8.0 Output Result Files

Results files are automatically generated and saved into the same directory as the input Excel file after Automated Compute is complete. Before we run Compute, first ensure that the Output File Format is set to the desired format. Users can select from either Test File or Excel format.

8.1 TEXT FILE FORMAT

While still in the Automated Compute dialog:

  1. Set the Output File Format dropdown to Text File.
  2. Select the Compute button to start the automated computing process
  3. The Total Progress can be seen at the bottom of the dialog. When files have finished computing, they will appear in the Completed Files list box.

    Automated Compute Dialog

  4. When all files have finished computing, select Close to exit the dialog.

For each input Excel file, a test file (.txt) containing all results data is generated.

For a Deterministic Analysis (Tutorial 7 Automate Compute - Deterministic_inputs.xlsx), the results data for all cases are outputted following the header row. Each row of data represents one analysis case (i.e., one tunnel case). Each data type is separated by a comma (,) for easy parsing.

  • Take a look at the Results.txt result file

Results.txt result file

8.2 EXCEL FILE FORMAT

Now, we will do the same as before, but this time we will generate the results as an Excel output file format.

  1. Select Automate from Excel Excel Icon from the Analysis menu to open the Automated Compute dialog.
  2. Select the Add Files button to open a standard dialog to choose an Excel input file. Navigate to the Tutorial 7 Automate Compute - Deterministic folder and select the Tutorial 7 Automate Compute - Deterministic.xlsx file.
  3. You will see the Excel input file appear under the File Queue list box.

  4. Set the Output File Format dropdown to Excel
  5. Automated Compute Dialog

  6. Select the Compute button to start the automated computing process.
  7. When all files have finished computing, select Close to exit the dialog.

For each input Excel file, an Excel file (.xlsx) containing all results data is generated.

For a Deterministic Analysis (Tutorial 7 Automate Compute - Deterministic.xlsx), the results data for all cases are outputted following the header row. Each row of data represents one analysis case (i.e., one tunnel case). Each data type is separated by a column.

  • Take a look at the Results.xlsx result file.

Results.txt result file

9.0 Error Log

As you may have noticed, an Error Log is also generated for each input Excel file. For each input Excel file, an Error Log text file (Automate Compute Error Log.txt) is generated, and saved into the same directory as the output file directories. Always check that the Error Log reports "No errors found" before post-processing the raw results data. If any errors do occur as a result of missing (i.e., blank cells) or invalid inputs, the Error Log will indicate which worksheet(s) and cell(s) are problematic.

This concludes the tutorial. You are now ready for the next tutorial, Tutorial 08 - Automate Probabilistic Analysis from Excel in RocSupport.

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