GEARS -- A Fully Run-Time Configurable Geant4 Application

TL;DR

GEARS is a fully run-time configurable Geant4 application that allows users to modify simulation parameters through external configurations, eliminating the need for recompilation and simplifying the simulation setup process.

Contribution

It introduces a novel approach to Geant4 configuration, enabling complete simulation customization via external text files and environment variables without recompilation.

Findings

Enables rapid prototyping and execution of Geant4 simulations.

Provides a Docker-based ready-to-use distribution for easy deployment.

Achieves efficient data analysis with a flat ntuple structure.

Abstract

The Geant4 toolkit is the standard for simulating the passage of particles through matter, but its conventional architecture often requires users to modify and recompile C++ code to alter fundamental simulation parameters such as geometry, physics list, and primary particle source. This architectural constraint introduces significant friction for new users and slows down the experimental iteration cycle. This paper introduces GEARS (Geant4 Example Application with Rich features yet Small footprint), a universally applicable Geant4 application that fundamentally addresses this issue. GEARS achieves complete simulation configurability without C++ recompilation by strictly utilizing external configuration methods: Geometry is defined via simple text-based configuration, the Physics List is selected via the standard PHYSLIST environment variable, and the Primary Source is defined through the General Particle Source (GPS) macro commands. Furthermore, regarding GEARS as an application instead of a framework, key features include a flat ntuple structure with short variable names for highly efficient analysis and a solution for capturing vital initial step data. Output creation is also fully managed via run-time macro commands and volume properties. The project is distributed as a ready-to-use Docker container to eliminate compilation barriers. Through these design considerations, GEARS transforms Geant4 into a practical, ready-to-use tool, enabling users to rapidly prototype and execute simulations for diverse experiments solely through simple text configuration files, without ever needing to modify or compile the underlying C++ source code.