[論文レビュー] MinGLE: A Minimalist, Configurable, and Pedagogical Geant4 Application Template

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

Scientific Computing and Data Management被引用数 0

ひとこと要約

MinGLE は、UI から物理とジオメトリまで Geant4 の概念を段階的に学べる、70 行未満の C++ で動作するミニマリストな Geant4 テンプレートと、GitDriven の教育的な学習ロードマップを提供します。

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 geometry をテキストファイル detector.tg から読み込む方法を示す。
• Geant4 ファクトリクラスと外部設定を使い、C++ コードを最小限に保ちつつ高い設定自由度を実現する。
• UI、バッチモード、ランマネージャ、物理リスト、検出器定義、可視化、GPS、スコアリング、NTuple、磁場を段階的に導入する ten-stage Git ベースのロードマップ（ブランチとタグ）を採用する。
• ジオメトリをコードと分離するためにランタイムマクロコマンドとテキストジオメトリ検出器記述を組み込む。
• 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.