High-Energy Data Analysis Using Uproot

Dominic Weir, Ocean Lakes Highschool

Mentor: Alexandre Camsonne, Hall A/C Physicist

Introduction Main Notebook GitHub

Scientists at Jefferson Lab leverage the usage of ROOT, a
CERN-developed object-oriented computer program and
library, to conduct analysis on high-energy particle events.
ROOT employs a hierarchical tree structure for the
organization of detector data, thereby enabling efficient
computational capabilities that meet the demanding
requirements of nuclear physicists at major laboratories
worldwide. In addition to its inherent graphical user
interface, ROOT incorporates histogramming, graphing of
distributions and functions, 3-dimensional visualization,
and statistical treatment. However, ROOT can be difficult
for beginners without C++ background, and has various
flaws in its design and implementation, in addition to
limited applications outside of particle physics. Uproot
provides an alternative data analysis framework
independent of C++ ROOT, intended to stream data into
machine learning libraries in Python. The input/output
framework relies on NumPy and Matplotlib, two popular
python libraries most users are well acquainted with, to
cast blocks of data from the ROOT file and perform the
same graphical analysis as possible in ROOT. This project
explores the implementation of Uproot for the purpose of
analyzing run 13747 from Hall A’s Super-BigBite detector
data and includes the production of a Jupyter Notebook to
disseminate the process and findings.
This project is published in a
The Main notebook offers an overview of the kinematics and describes the Hall A spectrometers: BigBite and Super public repository under
BigBite. The Uproot notebook analyzes data from the Super-Bigbite Spectrometer (SBS) with its main detectors, the Gas Jefferson Lab’s GitHub.
Electron Multiplier (GEM) and the Hadron Calorimeter (HCal), from run 13747, a 1H elastic scattering for proton radius
investigation. https://github.com/JeffersonL
ab/JupyterAnalysis
SBS GEM HCal
Conclusion
This project demonstrates the potential benefits of adopting
Uproot as an alternative data analysis framework for high-
energy particle events. By leveraging Python libraries like
Feynman Diagram Conservation of 4-Momentum NumPy and Matplotlib, it offers a user-friendly and
efficient way to analyze data without the need for a C++
background, saving valuable time for new users from the
steep learning curve for ROOT. Furthermore, the notebook
could aid physicists looking to make the transition from the
native ROOT framework to Uproot. Going forward, to
collect feedback from the new users and evaluate the
efficacy of the Jupyter Notebooks, a Google Form was
created.

Uproot Tutorial Acknowledgments

The Uproot tutorial guides users through importing Uproot and the necessary dependences, graphing variables from
Super-BigBite with Matplotlib, and performing cuts on the data to reduce background noise.
The Jupyter Notebooks
Jupyter Notebooks are open-sourced documents that
combine live code, equations, text, visualizations, and
other media. To expand access to high energy data
analysis, 5 Jupyter Notebook tutorials have been created.
The Uproot notebook featured in this poster, as well a C++
ROOT notebook, and a python PyROOT notebook are
designed to walk new users through reading a tree,
graphing event data, and performing cuts in their
respective frameworks. Consequently, a new user at JLab
will have their choice between the different notebooks to
learn the data analysis. In addition to the 3 root notebooks,
there is a Main notebook that summarizes the detectors in
Hall A and relevant physical phenomenon, as well as a
notebook tutorial for markdown, the markup language
used to write the notebooks. Lastly, rather than having to
access JLab’s virtual machine, Jupyter is accessible in a
web environment.
Accessing elements of a tree
Positional scatter plot with energy modeled by color
Histogram of HCal’s highest energy clusters
Segment of code for cuts
I would like to express my deepest gratitude to my mentor,
Alexandre Camsonne and assistant mentor Sanghwa Park.
Sincere thanks to Provakar Datta for the proton spot plot.
Special thanks to the Jlab Science Education team, Rhonda
Bell, Jalyn Dio, Steve Gagnon, Carol McKisson, and Lisa
Surles-Law, for their support throughout my internship.
Lastly, I would like to thank my fellow interns Connor
Carpenter, Angelina Nair and Esha Singh.
Scatter plot of energy vs position of clusters
References
Jefferson Labs. (n.d.). HCAL-J OSP. SuperBigBite Documents.
https://hallaweb.jlab.org/12GeV/SuperBigBite/documents/ERR2017/final/HCal_OSP
.pdf
Mack, D. (n.d.). Introduction to Detectors in Nuclear Physics (By Jefferson Labs) [Slide
show]. Summer Lecture Series, JLab.
https://www.jlab.org/user_resources/pizza_seminars/2023/DMack.pdf
Particle Detectors at Accelerators (By Particle Data Group). (2023, May 25).
Proton spot plot
https://pdg.lbl.gov/2023/web/viewer.html?file=../reviews/rpp2022-rev-particle-
detectors-accel.pdf