synthetic_rockmass_image_generation_for_ml

Rhino/Grasshopper scripts for generating jointed rock mass images and annotated rock joint label images for machine learning

Citation/publication

This repository is associated with a manuscript of a journal article (to be submitted to the journal Rock Mechanics and Rock Engineering)

• Title: Automated rock joint trace mapping using a supervised learning model trained on synthetic data generated by parametric modelling
• Authors: Jessica Ka Yi Chiu, Tom Frode Hansen, Eivind M. Paulsen, Ole J. Mengshoel

How to cite

Chiu, J. K. Y., Hansen, T. F., Paulsen, E. M., Mengshoel, O. J. (2026). Automated rock joint trace mapping using a supervised learning model trained on synthetic data generated by parametric modelling. Preprint on arXiv: arXiv:2602.07590

Software

Rhino

• Rhino Version 8

Grasshopper Plug-in List

WIP

Instructions

[A-Modelling_synthetic_slope_dataset.gh]

First, open a blank Rhino document with meters as the model units, e.g. the "Large Objects - Meters" Rhino Templates. Then open the GH file. Go through each step in Part 1 of the GH file. Remember to set the Rhino document's distance tolerance to 0.001 or less (Step 1).

Figure 1 shows how to set the size of the Rhino Viewport in Step 5.

A resolution point cloud (e.g. 2 cm) is needed to export the rock mass images that depict a realistic rock slope surface. To reduce computational effort, the slope mesh OBJ can be generated via triangulation of a point cloud with a lower resolution (e.g. 10 cm).

[B1-Modelling_BlockShape_creator.gh]

Rhino set-up

Open the Rhino file [BlockShape_Playground_Template.3dm]. The template has embedded the block shape classification charts from Palmström (1995) and Singh et al. (2022).

Tunny settings in our study

• Sampler: Quasi-MonteCarlo
• Number of trials: 8192 (must be a power of 2)
• Timeout (sect): 0
• QMC Type: sobol
• Scramble: off
• Seed: 42 (configurable in settings.json, to be opened by from right-click menu of the Tunny component)

Results of our study are plotted in [BlockShape_Playground_Results.3dm]

[B2-Modelling_slope_rough_surface.gh]

First, open a blank Rhino document with meters as the model units, e.g. the "Large Objects - Meters" Rhino Templates. Then open the GH file. Go through the panel inputs and buttons from top to the bottom in Part 1 of the GH file.

[B3-Modelling_synthetic_DFN_dataset_many_textures.gh]

First, open a blank Rhino document with meters as the model units, e.g. the "Large Objects - Meters" Rhino Templates. Then open the GH file. Go through each step in Part 1 of the GH file. Remember to set the Rhino document's distance tolerance to 0.001 or less (Step 1).

Figure 1 shows how to set the size of the Rhino Viewport in Step 7.

[C-Modelling_synthetic_box_dataset_single_texture.gh]

First, open a blank Rhino document with meters as the model units, e.g. the "Large Objects - Meters" Rhino Templates. Then open the GH file. Go through each step in Part 1 of the GH file. Remember to set the Rhino document's distance tolerance to 0.001 or less (Step 1).

Figure 1 shows how to set the size of the Rhino Viewport in Step 5.

For modelling with different textures, the user needs to update the texture JPG file path in Step 2 for each texture.

Figure 1 setting Rhino Viewport size

[D-Calculation_BlockShape.gh]

If plotting is needed, open the BlockShape_Playground_Results.3dm. Then open the GH file. Go through each step in Part of the GH file. If plotting is not needed, open a blank Rhino document with meters as the model units, e.g. the "Large Objects - Meters" Rhino Templates. Then open the GH file. Go through step 1 and 2 of the GH file.

[E-Calculation_Network_topology.gh]

First, open a blank Rhino document with meters as the model units, e.g. the "Large Objects - Meters" Rhino Templates. Then open the GH file. Go through each step in Part 1 of the GH file.