English

Chromo: A High-Performance Python Interface to Hadronic Event Generators for Collider and Cosmic-Ray Simulations

Computational Physics 2025-07-30 v1 High Energy Astrophysical Phenomena High Energy Physics - Phenomenology

Abstract

Simulations of hadronic and nuclear interactions are essential in both collider and astroparticle physics. The Chromo package provides a unified Python interface to multiple widely used hadronic event generators, including EPOS, DPMJet, Sibyll, QGSJet, and Pythia. Built on top of their original Fortran and C++ implementations, Chromo offers a zero-overhead abstraction layer suitable for use in Python scripts, Jupyter notebooks, or from the command line, while preserving the performance of direct calls to the generators. It is easy to install via precompiled binary wheels distributed through PyPI, and it integrates well with the Scientific Python ecosystem. Chromo supports event export in HepMC, ROOT, and SVG formats and provides a consistent interface for inspecting, filtering, and modifying particle collision events. This paper describes the architecture, typical use cases, and performance characteristics of Chromo and its role in contemporary astroparticle simulations, such as in the MCEq cascade solver.

Keywords

Cite

@article{arxiv.2507.21856,
  title  = {Chromo: A High-Performance Python Interface to Hadronic Event Generators for Collider and Cosmic-Ray Simulations},
  author = {Anatoli Fedynitch and Hans Dembinski and Anton Prosekin},
  journal= {arXiv preprint arXiv:2507.21856},
  year   = {2025}
}

Comments

10 pages, 5 figures, 1 table. Code archived on Zenodo: https://doi.org/10.5281/zenodo.16562752. Submitted to Computer Physics Communications

R2 v1 2026-07-01T04:24:09.118Z