MAGE-HEP: Monte Carlo Analysis and Graphical Environment for High-Energy Physics

TL;DR

MAGE-HEP is a GUI-driven environment that simplifies reproducible Monte Carlo analysis workflows in high-energy physics, organizing processes through a hierarchical project-study-run structure.

Contribution

It introduces a novel GUI-based workflow system with a Node API for defining and managing complex Monte Carlo analysis tasks in high-energy physics.

Findings

Validates core ideas with PYTHIA8 and ROOT workflows

Supports background execution and run tracking

Enables live ROOT inspection and particle summaries

Abstract

Monte Carlo event generators are central to high-energy physics analysis. However, workflows based on handwritten scripts can be difficult to reuse, modify, and reproduce when multiple Monte Carlo models, tune variations, run variations, and output formats are involved. We present MAGE-HEP, short for Monte Carlo Analysis and Graphical Environment for High-Energy Physics, a Graphical User Interface (GUI) driven workflow environment for reproducible Monte Carlo-based analyses in high-energy physics. MAGE-HEP organizes analysis workflows through a project-study-run hierarchy. The project stores the workspace, the study stores the reusable analysis context, and each run represents a controlled execution of that context. The MAGE-HEP Node API provides the analysis-building layer for defining generator configurations, observables, selections, output rules, and generated C++/ROOT analysis code. A study context can be inspected, reused, or exported as a \texttt{.mcx} context bundle, while the project state can be exported as a portable \texttt{.mgp} bundle. The current beta implementation validates the core idea using a PYTHIA8 and ROOT workflow. It includes background execution, manifest-based run tracking, live ROOT inspection, and particle-table summaries for supported output layouts. This paper describes the architecture, workflow, and current beta implementation of MAGE-HEP.