Code and data for segmentation of granular material images using synthetic data and deep learning

Published: 21 October 2025| Version 1 | DOI: 10.17632/3mysh75r8r.1
Contributors:
Harold SIMO TENEKAM,
,
,

Description

This SyntheticSoil project is a Unity-based pipeline designed to procedurally generate and annotate realistic granular soil images from granulometric data. It enables the simulation of soil samples based on real-world particle size distributions (PSDs), their segmentation via Unity Perception, and their conversion to standard annotation formats (COCO, Pascal VOC) for training deep learning models such as Mask R-CNN. --- ## πŸ“ Repository Structure ``` SyntheticSoilProject/ β”‚ β”œβ”€β”€ 0_AnnotationSyntheticSoil/ # Unity project to generate and annotate soil images (top + bottom views) β€” version A (original project used in the article) β”œβ”€β”€ 1_solo2coco/ # Converts Unity SOLO annotations to COCO format using pysolotools β”œβ”€β”€ 2_polygon_vers_rle/ # Converts polygon annotations (x,y) to COCO RLE format β”œβ”€β”€ 3_json2xml/ # Converts COCO JSON annotations to Pascal VOC (XML) β”œβ”€β”€ 4_GrainSegNet/ # GrainSegNet model (training & inference code, checkpoints, evaluation scripts) β”œβ”€β”€ 5_SyntheticSoil/ # Unity project to generate high-resolution images without annotation β€” *version B (alternate codebase used in article) β”œβ”€β”€ 6_Annexes/ # Additional examples, outputs and test files β”‚ β”œβ”€β”€ 0_AnnotationSyntheticSoil/ # Example scene's images β”‚ β”œβ”€β”€ 1_Example_of_solo_data/ # Example outputs from the annotation Unity project (images, masks, SOLO JSON) β”‚ β”œβ”€β”€ 2_Example_of_SyntheticSoil_Images/ Example RGB images and instance masks β”‚ β”œβ”€β”€ 3_Test_GrainSegNet/ Example test outputs and evaluation of GrainSegNet β”‚ β”œβ”€β”€ Real_granular_material.JPG Example real sample photograph β”‚ └── Some_granulo_desired.txt Example PSD text file with desired granulometry β”œβ”€β”€ 7_BuildSyntheticSoil/ Builder version containing the full set of particle models used by the author (pre-processed prefabs) └── README.md ```

Files

Institutions

  • Ecole de technologie superieure

Categories

Synthetic Image, Granular Material

Licence