[论文解读] MinGLE: A Minimalist, Configurable, and Pedagogical Geant4 Application Template

Jing Liu|arXiv (Cornell University)|Jan 13, 2026

Scientific Computing and Data Management被引用 0

一句话总结

MinGLE 提供一个极简、功能完备的 Geant4 仿真模版，在 70 行 C++ 代码内实现，并附带教学性、基于 Git 的逐步开发路线，逐步教授 Geant4 的 UI、物理和几何概念。

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.

研究动机与目标

• 通过提供一个极简、可扩展的应用核心，降低 Geant4 的入门门槛。
• 提供一个逐步学习路径，通过 Git 分支和标签分阶段构建 Geant4 组件。
• 通过文本几何和宏命令实现运行时可配置，减少 C++ 模板代码。
• 演示现代 Geant4 工厂类与标准接口如何组合成完整的仿真核。
• 提供部署辅助（CMake、Docker）和工具链（编译命令），以简化学习与开发。

提出的方法

• 给出一个仅包含核心 Geant4 组件的 mingle.cc 单文件，并展示如何从文本文件 detector.tg 加载探测器几何。
• 使用 Geant4 工厂类和外部配置在最大化可配置性的同时尽量保持 C++ 代码的简洁。
• 采用十阶段的基于 Git 的路线图（分支与标签），逐步引入 UI、批处理模式、运行管理、物理列表、探测器定义、可视化、GPS、评分、NTuple 和磁场。
• 引入运行时宏命令与文本几何探测器描述，以实现几何与代码的解耦。
• 提供跨平台的 CMake 构建、可选 Docker 镜像，以及用于 IDE 集成的 JSON 编译数据库。

Figure 1: Screenshot of the Geant4 GUI with a customized menu, visualized detector geometry, and accumulated particle trajectories.

实验结果

研究问题

• RQ1 是否可以通过一个极简的核心加文本配置，分阶段教授和学习 Geant4 应用？
• RQ2 基于 Git 的阶段性路线对 Geant4 开发中的学习、代码质量与调试有何影响？
• RQ3 实现一个用于教学的功能性 Geant4 仿真核所需的最小组件集合是什么？
• RQ4 文本几何加载（detector.tg）是否能有效将几何从 C++ 解耦并加速试验？
• RQ5 是否能在 Windows、macOS、Linux 上通过简单的 CMake 工作流和可选 Docker 镜像编译运行该模板？

主要发现

• MinGLE 在 mingle.cc 中以不到 70 行 C++ 提供了完整的 Geant4 仿真核。
• 十阶段的基于 Git 的路线图将概念分离，使学习可逐步进行并可轻松回滚到稳定里程碑（标签）。
• 探测器几何可以在文本文件（detector.tg）中定义，并通过 G4tgbVolumeMgr 加载，从而实现几何与代码的解耦。
• 该模板通过每阶段仅有的最少新增，展示了现代 Geant4 组件（运行管理器、通过 G4PhysListFactory 的物理列表、UI、可视化、GPS）如何实现。
• 构建与部署通过 CMake 实现跨平台，提供可选的 Docker 镜像，并支持用于 IDE 集成的 JSON 编译命令。
• 该方法强调通过最小的样板代码在每阶段进行增量演进，从而实现动手、即时学习的体验。

Figure 2: Dose distribution behind Shape2 recorded by the scoring manager shown as 2D histograms in color.