5 - RocFall2 Section Creator
This tutorial will show you how to create 2D cross-sections for export to RocFall2, including batch section creation and export.
Topics Covered in this Tutorial:
- RocFall2 multi-section export
- The group plotting function in RocFall2
- Exporting reference lines in RocFall2
Finished Product:
The finished product of this tutorial can be found in the Tutorial 05 Terrain Generator 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 RocFall3 Model
Start RocFall3 by selecting Programs > Rocscience from the Windows Start menu. RocFall3 automatically opens a new blank document, which allows you to begin creating a model immediately. If the RocFall3 application window is not already maximized, maximize it now so the full-screen space is available for use.
- Select the File > Recent > Tutorial Folder > Tutorial 05 initial.
- 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 05 Initial file and click Open.
This model geometry was created from the satellite locater option in the Import Terrain dialog. The hard and soft material regions were defined using the Image Segmentation feature, and the water body regions were manually drawn. The line seeder properties and location were also set. These settings are already preset in the file, so you don’t need to change anything. For more information on the process described above, you can visit Tutorial 2 Terrain Generator.
2.0 Reference Line
- Select Geometry > Draw Polyline.
- Draw a line along the 2500 m elevation line, on the eastern slope, ensuring that it fully spans the model.
If you want to use the exact values of this model, navigate to and open the provided Tutorial 05 Reference polyline.txt file in the Tutorials folder. Alternatively, you can save the .txt file by right clicking here and selecting Save Link As. Select import in the Draw Polyline dialog and import the points.
- Right click and select Done.
- Name the polyline "reference line".
3.0 Compute
- Click on the Compute
icon in the toolbar (or select Analysis > Compute in the menu).
4.0 Results
Navigate to the Results tab. Contours of translational velocity are shown for the rock paths by default. The legend bar on the right can be used to toggle between the different outputs.
5.0 RocFall2 Multi-Section creation and Export
RocFall3 now supports batch section creation and export to RocFall2.
5.1 Creating Multiple Sections
- Select the Geometry tab.
- From the menu, select Geometry > RocFall2 Section Creator.
- In the Create/Edit Sections dialog, click Create Multiple Sections
.
- Select the Sections per Segment option as the creation method.
- For Number of Sections enter 1. This means 1 cross-section will be created perpendicular to each segment of the drawn polyline (discussed next).
- Click Draw, and then proceed to trace a line similar to the reference line as shown in the image below.
If you want to use the exact values of this model, navigate to and open the provided Tutorial 05 Creating Sections.txt file in the Tutorials folder. Alternatively, you can save the .txt file by right clicking here and selecting Save Link As. Select import in the Batch Section Creator dialog and import the points.
- You'll notice that 6 number of cross sections are created, right click, and select Done to exit drawing mode, and then select Ok to close the dialog.
5.1.1 Deleting Sections
We will delete the sections that don't intersect the reference line and line seeder.
- To delete a section, select the section and then select the Delete Icon
located on the bottom-left of the dialog. Section 1-1, shown below, is an example of a plane that does not intersect the reference line and line seeder.
- Delete sections 1-1and 1-6.
- Click OK to close the Create/Edit Sections dialog.
5.1.2 Adding a Single Section
- Select Geometry> RocFall2 Section Creator.
- To add a single section, click on the Add a Single Section Icon
located in the bottom-left corner of the dialog.
- Click Draw, then select the 2 arbitrary vertices of the cross section on the model preview. The following image showcases the drawn section in green.
- Click OK to save and close the dialog.
5.2 Exporting Multiple Sections to RocFall2
- Ensure that you're in the Geometry tab and select the Export All Section to RocFall2 button.
- In this dialog, we can control the information that is transferred to RocFall2. Ensure that all sections are selected.
- Ensure that the polyline defined as "reference line" is selected from the drop-down Reference Lines menu, then click Open to load RocFall2.
Once RocFall2 is open, you should be able to view all exported sections.
The reference line from the RocFall3 model is also visible in RocFall2.
If you do not see a point seeder, check that the 2D section intersects the line seeder in RocFall3. You can also manually insert a point seeder by selecting Seeder > Add Point Seeder.
6.0 Compute RocFall2 Model
- Click on the drop-down arrow next to the Compute Icon in the toolbar, and then select Batch Compute
.
7.0 Group Analysis
7.1 Group Plots
Group Plot show results from multiple sections in the same plot. This is a powerful tool that can be used to compare rockfall trajectories among multiple cross-sections.
- Select the Results tab.
- From the menu, select Graphs > Group Plots > Graph Endpoints.
- We can plot the data using the reference line, select the Endpoint Distance From option in data settings, and select the defined polyline "reference line".
- Click Plot Data to load up the histogram.
In the group plot, we can see the runout distribution in each slope section with respect to the same reference line. Each section has a colour associated, shown in the legend on the right side of the plot. Notice that some of the runout distances are negative, mainly from Section 1-5 and 1-4. This is because the rock paths stopped before reaching the reference line.