arXiv Science⌕ Search
Home/Archive/arXiv

arXiv · 2202.03911

An array-oriented Python interface for FastJet

Aryan Roy·Jim Pivarski·Chad Wells Freer
View original source ↗Read source document ↗Export metadata ↓

Abstract

Analysis on HEP data is an iterative process in which the results of one step often inform the next. In an exploratory analysis, it is common to perform one computation on a collection of events, then view the results (often with histograms) to decide what to try next. Awkward Array is a Scikit-HEP Python package that enables data analysis with array-at-a-time operations to implement cuts as slices, combinatorics as composable functions, etc. However, most C++ HEP libraries, such as FastJet, have an imperative, one-particle-at-a-time interface, which would be inefficient in Python and goes against the grain of the array-at-a-time logic of scientific Python. Therefore, we developed fastjet, a pip-installable Python package that provides FastJet C++ binaries, the classic (particle-at-a-time) Python interface, and the new array-oriented interface for use with Awkward Array. The new interface streamlines interoperability with scientific Python software beyond HEP, such as machine learning. In one case, adopting this library along with other array-oriented tools accelerated HEP analysis code by a factor of 20. It was designed to be easily integrated with libraries in the Scikit-HEP ecosystem, including Uproot (file I/O), hist (histogramming), Vector (Lorentz vectors), and Coffea (high-level glue). We discuss the design of the fastjet Python library, integrating the classic interface with the array oriented interface and with the Vector library for Lorentz vector operations. The new interface was developed as open source.

Explore related subjects

hep-excs.PLphysics.comp-phphysics.data-an

Keep this discovery

BibTeXRIS

Aryan Roy, Jim Pivarski, Chad Wells Freer. 2022-02-08. An array-oriented Python interface for FastJet. https://doi.org/10.1088/1742-6596%2F2438%2F1%2F012011

Cite the original work for its findings. Save a collection to share your selection of sources.

KEEP EXPLORING

Related papers

arXiv2026

Production of Light Nuclei and Hypernuclei in Heavy-Ion Collisions

We review recent STAR and ALICE measurements of light-nucleus and hypernucleus yields, femtoscopic correlations, and collective flow presented at SQM 2026. Statistical-hadronization calculations provide a useful baseline for integrated yields but do not simultaneously describe all measured light-nucleus ratios across collision energies and system sizes. For bound states with mass number $A<4$, current coalescence calculations provide a broadly consistent description of yields, femtoscopic correlations, and collective flow, although the quantitative hypertriton comparison depends on the assumed few-body wave function. The suppressed production of resonant $^{4}$Li relative to compact $^{4}$He indicates an effect of nuclear structure and late-stage dynamics. However, the quantitative model comparison also depends on the treatment of feed-down from unstable states. In high-multiplicity $p$+$p$ collisions, pion-deuteron femtoscopy further indicates that most observed (anti)deuterons are formed through nucleon fusion after strong decays of short-lived resonances. Taken together, these measurements show that production chronology and internal nuclear structure leave measurable imprints on the physics observables.

hep-ex↗
arXiv2026

Search for the process $e^+e^-\to f_1(1285)$ at the SND detector

In the experiment with the SND detector at the VEPP-2000 $e^+e^-$ collider, a search is performed for the direct production of the $C$-even $f_1(1285)$ resonance in $e^+e^-$ collisions. The analysis is based on data with an integrated luminosity of about 200 pb$^{-1}$, accumulated in the center-of-mass energy range of 1.14--1.46 GeV, of which about 72 pb$^{-1}$ were recorded near the maximum of the $f_1(1285)$ resonance. The $f_1(1285)$ production cross section at the resonance maximum $\sigma(e^+e^-\to f_1)=(31\pm 13\pm 2)$ pb and the branching fraction $B(f_1(1285)\to e^+e^-)=(3.5\pm 1.4\pm 0.3)\times 10^{-9}$ have been measured. The significance of the observation of the $e^+e^-\to f_1(1285)$ process is $2.5\sigma$. Since the significance is low, we also present the upper limits at the 90% confidence level: $\sigma(e^+e^-\to f_1)<48\mbox{ pb}$ and $B(f_1(1285)\to e^+e^-)<5.4\times 10^{-9}$.

hep-ex↗
arXiv2026

Projected Sensitivity to Slow Muonphilic Dark Matter with Accelerator Muon Beams

The nature of dark matter (DM) remains one of the most enduring open questions in modern physics, and muonphilic DM has emerged as a promising scenario that complements traditional DM candidates. Following the recently established cosmic-ray muon scattering approach, we investigate the sensitivity for probing slow muonphilic DM with accelerator muon beams. A Geant4-based simulation framework is developed, incorporating the detector geometry from the PKMu muon tomography system and a dedicated elastic $\mu$-DM scattering process. The projected sensitivity is found to be largely insensitive to both the beam energy and the transverse beam size when the beam is fully contained within the detector acceptance. For a benchmark beam intensity of $10^5/\rm{s}$, the simulated pure-muon beam surpasses the existing cosmic-ray limit of $1.61\times10^{-17}$ cm$^2$ at $m_{\rm DM}=1$ GeV within approximately 11 seconds. A realistic muon beam phase-space distribution based on simulations for the High Intensity heavy-ion Accelerator Facility (HIAF) is also implemented, yielding projected limits that improve upon the cosmic-ray results by nearly two orders of magnitude in a one-day exposure. These results demonstrate that a beam-muon scattering experiment offers a robust and promising route toward significantly improved sensitivity to slow muonphilic DM.

hep-ex↗