3 - Import RocFall2 Model Tutorial
This tutorial provides an introduction on how to import a RocFall2 file add Barriers to a RocFall3 model and interpret the results.
Topics Covered in this Tutorial:
- Import RocFall2 files
- Extrude 2D models
- Add Barriers
- Graph Barrier Results
Finished Product:
The finished product of this tutorial can be found in the Tutorial 03 RF2 import and barrier data file. All tutorial files installed with RocFall3 can be accessed by selecting File > Recent Folders > Tutorials Folder from the RocFall3 main menu.
1.0 Import RocFall2 File
Let's import the RocFall2 Quick Start tutorial file:
- Select File > Import > Import RocFall2 File.
- Go to the Tutorials folder included with your RocFall3 install. The default location of this folder is C:\Users\Public\Documents\Rocscience\RocFall3 Examples\Tutorials. Select the Tutorial 03 RF2 file and click Open.
The Import Rocfall2 Options dialog pops up.
- Enter 50 m as the Extrusion Depth, check the Import Point Seeders as Line Seeders option and enter 40 m as the Seeder Extrusion Depth.
- Click OK.
This imported model should have all geometry and properties brought in correctly.
- Select the Line Seeder from the visibility tree and click Edit from the Properties pane.
- In the Edit Line Seeder dialog, change the geometry coordinates to (1,5,0) and (1,45,0) and click OK.
Open up the corresponding dialogs and observe the following:
- Analysis > Project Settings > Methods: Rigid Body Analysis Method
- Materials > Define Materials: Three slope materials (Type One, Type Two and Type Three) with statistical variability:
Name Normal Restitution
St. dev. / Rel.Min / Rel.Max Dynamic Friction St. dev. / Rel.Min / Rel.Max Type One 0.3 (Normal) 0.03 / 0.09 / 0.09 0.55 (None) - Type Two 0.2 (Normal) 0.03 / 0.09 / 0.09 0.55 (None) - Type Three 0.1 (Normal) 0.03 / 0.09 / 0.09 0.55 (None) -
- Materials > Define Materials: Three slope materials (Type One, Type Two and Type Three) with statistical variability:
- Seeder > Define Seeder Properties: Line seeder with statistical variability of initial velocity
- Uncheck Randomize Initial Rotation
- Number of Rocks = 50
- Group 1 shapes with small mass of 1000kg: Extruded Polygon Square, Extruded Polygon Hexagon
- Group 2 shapes with large mass of 10000kg: Extruded Polygon Triangle, Extruded Polygon Octagon
- Uncheck Randomize Initial Rotation
Note that the finished version of this tutorial is Tutorial 03 RF2 Import and Barriers
1.1 Initial Compute
Save the model and run compute.
- Select Analysis > Compute
- Click on the Results workflow tab
To view the rock paths, we will use the 3 stacked view option to help visualize the rock paths from different perspectives
- Select the Split View
drop down menu located on the top right of the model preview, select 3 Stacked View
.
- Select Interpret > Graph Endpoints , use the default options in the Chart Options dialog, and press OK.
- The next part of the tutorial will have you add a barrier. Let's first close the Endpoints graph using the close option X in the right corner of the window tab, then use the Interpret > Clear Results to remove the results.
2.0 Add Barrier
A barrier in RocFall3 is a polyline on the slope with defined height, which can be placed anywhere along the slope to alter the paths of the rocks as they travel down the slope. You can choose to define Custom Type barriers or choose from our built-in manufacturer library.
If a Custom Type is selected, the following inputs are required:
- Model Type: Custom or Infinite
- Capacity (non-infinite)
If a Predefined barrier is selected, the following inputs are required:
- Barrier Design
- Energy Level: MEL or SEL (when available)
Any number of barriers can be added to the slope. Barriers, however, cannot cross other barriers and cannot cross slope segments.
Change to the Barriers workflow tab then:
- Select Barriers > Add Barrier
- In the Add Barrier dialog, enter a height of 4 m. Keep the Default Barrier Property in the dropdown.
- Click on Add Points on Viewport.
- In the top right view, try to click on points very close to (15,0) and (15,50). Don't worry about getting the exact points. Right click and select Done. The points you added can now be edited to the exact locations mentioned above. Click OK in the Add Barrier dialog.
You can see a barrier was added.
Barriers can also be added by converting from polylines. As an exercise, create a polyline with 2 vertices: (15,0,-24.68253968) and (15,50,-24.68253968). Select the polyline from the Visibility Tree. From the Barriers menu, select Add Barrier from Polyline. Follow the same steps from above to put in Height and click OK.
2.1 Compute
- Select: Analysis > Compute
- Click on the Results workflow tab and observe the path results.
You can see that most of the paths that went down the bench were caught by the barrier.
- Select Interpret > Graph Endpoints and use the default options in the Chart Options dialog and press OK. You'll see the following plot.
3.0 Graph Barrier Results
For each barrier in your model, you can plot the following graphs for rocks that strike the barrier:
- Total Kinetic Energy
- Translational Kinetic Energy
- Rotational Kinetic Energy
- Translational Velocity
- Rotational Velocity
- Impact Height
Let's first graph Bounce Height, using the Chart Options dialog. To open the dialog, select Interpret > Graph Barriers on the menu:
- In the dialog, select Bounce Height under Data to Plot.
- Leave Cumulative Plot unchecked for plotting a histogram.
- Click OK.
Now let's graph total kinetic energy.
- In the dialog, select Total Kinetic Energy under Data to Plot.
- Check Cumulative Plot.
- Click OK.
Right-click on the plot and you can choose to copy the chart image or data to the clipboard or to export the chart and data to Excel for further post processing.