Logo
ScienceStack
Table of Contents
Fetching ...
Sign In

MinGLE: A Minimalist, Configurable, and Pedagogical Geant4 Application Template

Jing Liu

TL;DR

MinGLE tackles the steep learning curve of Geant4 by offering a minimalist, fully functional application template with under 70 lines of C++ and runtime-configurable detector definitions via Text Geometry. It replaces boilerplate and low-level assembly with modern Geant4 factory classes and a file-based learning roadmap that uses Git branches and tags to document eleven core components. The template is hosted on GitHub, supports batch and interactive modes, and includes a prebuilt Docker image to provide immediate usability. As a pedagogical tool, MinGLE demonstrates a continuous, compilable path from a simple UI to a feature-rich simulation while preserving standard Geant4 interfaces without extension code. Distributed under the MIT license, it aims to be a reusable educational and research-oriented foundation in Geant4.

Abstract

The Geant4 toolkit is the leading software for the simulation of particle transport through matter, widely used in nuclear physics, high-energy physics, and medical physics. However, the initial learning curve for new developers can be steep, often due to the complexity and experiment-specific nature of many introductory examples. This paper introduces MinGLE (Mini Geant4 Learning Example), a dedicated application template designed to be a universal, flexible, and educational starting point for Geant4 projects. MinGLE achieves a complete, functional simulation kernel using fewer than 70 lines of core C++ code. This minimalism is realized by leveraging contemporary Geant4 features, including factory classes for run management and physics, and the Text Geometry format for detector definition. Furthermore, MinGLE employs a unique pedagogical structure, using Git tags to document the incremental development of eleven core Geant4 components, with each tagged version being fully compilable, executable, and testable, providing a clear, step-by-step learning resource.

MinGLE: A Minimalist, Configurable, and Pedagogical Geant4 Application Template

TL;DR

MinGLE tackles the steep learning curve of Geant4 by offering a minimalist, fully functional application template with under 70 lines of C++ and runtime-configurable detector definitions via Text Geometry. It replaces boilerplate and low-level assembly with modern Geant4 factory classes and a file-based learning roadmap that uses Git branches and tags to document eleven core components. The template is hosted on GitHub, supports batch and interactive modes, and includes a prebuilt Docker image to provide immediate usability. As a pedagogical tool, MinGLE demonstrates a continuous, compilable path from a simple UI to a feature-rich simulation while preserving standard Geant4 interfaces without extension code. Distributed under the MIT license, it aims to be a reusable educational and research-oriented foundation in Geant4.

Abstract

The Geant4 toolkit is the leading software for the simulation of particle transport through matter, widely used in nuclear physics, high-energy physics, and medical physics. However, the initial learning curve for new developers can be steep, often due to the complexity and experiment-specific nature of many introductory examples. This paper introduces MinGLE (Mini Geant4 Learning Example), a dedicated application template designed to be a universal, flexible, and educational starting point for Geant4 projects. MinGLE achieves a complete, functional simulation kernel using fewer than 70 lines of core C++ code. This minimalism is realized by leveraging contemporary Geant4 features, including factory classes for run management and physics, and the Text Geometry format for detector definition. Furthermore, MinGLE employs a unique pedagogical structure, using Git tags to document the incremental development of eleven core Geant4 components, with each tagged version being fully compilable, executable, and testable, providing a clear, step-by-step learning resource.
Paper Structure (23 sections, 4 figures, 1 table)

This paper contains 23 sections, 4 figures, 1 table.

Table of Contents

  1. Introduction
  2. Code Management
  3. Git as a Pedagogical Tool
  4. Git Tag for Static Inspection
  5. Git Branch for Dynamic Exploration
  6. GitHub as a Pedagogical Tool
  7. Compilation and Deployment
  8. Development Roadmap
  9. Geant4 User Interface
  10. Batch Execution
  11. Run Management
  12. Physics List
  13. Detector Definition
  14. Visualization
  15. Particle Generation
  16. ...and 8 more sections

Figures (4)

  • Figure 1: Screenshot of the Geant4 GUI with a customized menu, visualized detector geometry, and accumulated particle trajectories.
  • Figure 2: Dose distribution behind Shape2 recorded by the scoring manager shown as 2D histograms in color.
  • Figure 3: Energy deposit in Shape1 from 60 keV gamma rays.
  • Figure 4: Charged particle trajectories bending in a uniform magnetic field.