SPARKX: A Software Package for Analyzing Relativistic Kinematics in Collision Experiments Journal: Computer Physics Communications

Nils Sass, Hendrik Roch, Niklas Götz, Renata Krupczak, Carl B. Rosenkvist · 2025

Read SPARKX: A Software Package for Analyzing Relativistic Kinematics in Collision Experiments Journal: Computer Physics Communications by Nils Sass, Hendrik Roch, Niklas Götz, Renata Krupczak, Carl B. Rosenkvist (2025) in the Tower of Babel, a free online library of public-domain works preserved in clean, searchable text. No sign-up. The full text is served as a plain-text file at a predictable URL, where text is present: https://antarctic-labs.com/tower-of-babel/arxiv-2503-09415.txt.

Introduction

Nils Sass, Hendrik Roch, Niklas Götz, Renata Krupczak, and Carl Rosenkvist present a free software tool for collision studies in a 2025 paper. Heavy-ion collisions are probed with large simulation files that are slow to read by hand. Their Python package, SPARKX, speeds up work on relativistic kinematics. It reads the OSCAR2013 format and links with known simulation tools.

The paper sets out the design and main features of SPARKX. Worked examples show how the tool handles real analysis tasks. Speed tests show gains in both work rate and accuracy. The authors aim to cut routine effort for research groups. SPARKX is open-source, so any lab can use and extend it.

Catalog record

CREATORNils Sass, Hendrik Roch, Niklas Götz, Renata Krupczak, Carl B. Rosenkvist
YEAR2025
COLLECTIONPAPERS
FORMATTXT
FILE SIZE40 KB
VERSION1.0
LICENSEhttp://creativecommons.org/licenses/by/4.0/
RIGHTSCC BY
SOURCEarXiv

Source: https://arxiv.org/abs/2503-09415

Browse the full library · About the Tower of Babel

Full text

The opening of the work, from the library's hosted text:

SPARKX: A Software Package for Analyzing Relativistic Kinematics in Collision Experiments Journal: Computer Physics Communications Nils Sass, Hendrik Roch, Niklas Götz, Renata Krupczak, Carl B. Rosenkvist Abstract SPARKX is an open-source Python package developed to analyze simulation data from heavy-ion collision experiments. By offering a comprehensive suite of tools, SPARKX simplifies data analysis workflows, supports multiple formats such as OSCAR2013, and integrates seamlessly with SMASH and JETSCAPE/X-SCAPE. This paper describes SPARKX’s architecture, features, and applications and demonstrates its effectiveness through detailed examples and performance benchmarks. SPARKX enhances productivity and precision in relativistic kinematics studies. PROGRAM SUMMARY/NEW VERSION PROGRAM SUMMARY Program Title: SPARKX CPC Library link to program files: (to be added by Technical Editor) Developer’s repository link: https://github.com/smash-transport/sparkx Code Ocean capsule: (to be added by Technical Editor) Licensing provisions(please choose one): GPL-3.0 Programming language: Python Supplementary material: The data generated for the benchmark section is available as ancillary file in the arXiv upload of this paper. Nature of problem: Efficient analysis of simulation data from heavy-ion collision experiments. Existing software is often optimized for experimental use, with steep learning curves and specialized syntax, making it less accessible for theorists. Moreover, custom-written analysis scripts for event generators are prone to errors, may lack systematic testing, and are challenging to maintain. Solution method: SPARKX [ 1 ] provides a robust, easy-to-use framework for analyzing simulation data. It includes pre-implemented observables and supports multiple data formats, ensuring a seamless integration with event generator outputs such as SMASH [ 2 ] and JETSCAPE/X-SCAPE [ 3 ] . The software adheres to best practices in code testing and design, minimizing bugs and enabling researchers to focus on data interpretation. Its modular design allows for straightforward extension to incorporate project-specific observables. 1 Introduction Heavy-ion collisions provide a unique opportunity to study nuclear matter under extreme conditions, such as high temperature and density, exploring phenomena like the quark-gluon plasma [ 4 , 5 ] . To analyze these phenomena, simulations using event generators like SMASH and JETSCAPE/X-SCAPE have become standard in the field. However, interpreting the complex datasets generated by these simulations requires sophisticated analysis tools. Existing software is often designed with experimentalists in mind, prioritizing performance but frequently resulting in steep learning curves and specialized, inflexible syntax and file formats. For theorists and phenomenologists, the lack of user-friendly tools tailored to their specific needs has often necessitated custom-written analysis scripts. Unfortunately, these scripts are typically untested, prone to errors, and difficult to maintain, posing significant risks to the reliability of results, as well as to their reliability. SPARKX was developed to bridge this gap, providing a robust, modular, integrated, and rigorously tested framework specifically for analyzing event generator outputs from various sources. By including pre-implemented observables and adhering to best practices in software design, SPARKX reduces the overhead associated with developing analysis workflows. At the same time, its modular and object-oriented design ensures that users can easily extend the codebase to incorporate custom observables and analysis methods. This paper introduces SPARKX, describing its motivation, architecture, key features, and practical applications in heavy-ion collision studies. The remainder of this paper is organized as follows. In section 2 , we provide an overview of the implemented analysis classes within SPARKX. A quickstart guide to basic functionalities is provided in section 3 . Section 4 describes the key features of the package, highlighting the range of physics analyses that can be performed. Implementation details are discussed in section 5 , which also introduces the SOLID design principles outlined in section 6 . To benchmark SPARKX against other state-of-the-art analysis tools, we present performance comparisons in section 7 . The testing routines for verifying the package’s functionality are detailed in section 8 , while section 9 illustrates SPARKX analysis workflows with two example applications. Section 10 demonstrates how the framework can be extended to support additional data formats. Finally, section 11 outlines planned future developments, and section 12 summarizes our findings and conclusions. 2 Program Overview SPARKX is designed to provide a comprehensive and modular framework for analyzing heavy-ion collision data in a simple and logical manner. The package supports the analysis of outputs from the SMASH and JETSCAPE/X-SCAPE codes. Its architecture is class-based, comprising several key components that are introduced in this section with an overview. The basic usage of SPARKX is structured around three main steps: first, loading the input file containing particle and event information; second, applying filters to select the relevant data and apply kinematic cuts to a specific problem; and finally, performing the necessary analysis on the selected particles or events. Therefore, the input file should contain a particle list from an event generator code, and the produced SPARKX output will contain the final observables from the analysis. The architecture decisions underlying the code are summarized in the Unified Model Language (UML) diagram in Figure 1 . Figure 1: Simplified UML diagram to represent the architecture of SPARKX. Blue boxes represent data storage and processing classes, and green boxes represent more physics quantity-related classes linked to the output of SPARKX. Arrows indicate dependencies between different package parts. The blue boxes represent classes responsible for storing and processing the input for the analysis, while the green classes handle the physics calculations. The purpose and functionality of each class is elaborated on in the following. More information about each class can be found in the SPARKX documentation [ 6 ] . • Data Loading and Filtering: The two first steps, loading and filtering, can be done concurrently. The classes BaseLoader and BaseStorer are an abstract representation of the functionalities, which is implemented specifically for each data format. \circ Storer These classes store the event data and allow processing and filtering. \square BaseStorer : Abstract class which defines a generic object to save event and particle information. All classes below implement it. \square Oscar : It handles various OSCAR data formats from different execution modes of SMASH. \square Jetscape : Manages hadron or parton outputs from JETSCAPE/X-SCAPE, facilitating seamless data integration. \square ParticleObjectStorer : Saves list of Particle objects and allows the creation of Storer objects without an external input file. \circ Loader These classes define how input data is parsed and processed. \square BaseLoader : Abstract class which defines a generic object to load event and particle information. All classes below implement it. \square OscarLoader : Loads and processes different formats of Oscar files. \square JetscapeLoader : Loads and processes JETSCAPE /X-SCAPE files. \square ParticleObjectLoader : Overloads the loading method in order to process lists of lists of Particle objects. \circ Particle Object \square Particle : Defines a particle object, which serves as the foundation for the SPARKX analysis. Additionally, nearly all analysis classes depend on Particle object instances since these objects are fundamental to all analysis processes. \circ Filtering \square Filter : Utility functions which allow filtering of events and particles, e.g. to filter only for charged particles. • Analysis: The final step, after reading and filtering the input file and producing the particle object, is to perform the necessary analysis. All methods assume that prior kinematic cuts and data selection have been applied using filter functionalities. These physics analysis classes are represented by the green boxes in Figure 1 , with further details on the

Read the complete text