This tutorial requires Jupyter, Python 3, Uproot (of course), Awkward Array, Vector, Matplotlib, and SciPy (for the optional fitting section).
Getting Uproot and Jupyter
There are many ways of running the software necessary for this tutorial. I’ve put three common options in the sections below (you only need to use one). For ease of debugging, I recommend using Binder unless you already have another option up and running, but feel free to use whatever gets you to a Jupyter notebook with Uproot, Awkward Array, Vector, Matplotlib, and SciPy installed.
Simply follow this link to Binder. It should open up Jupyter with all necessary packages and files installed.
You must have a CERN account for this option.
Anaconda (local installation)
The easiest way to run everything locally is through Anaconda.
Download the Python 3 version and follow the instructions.
Once you’re in the Anaconda environment, create a new environment with Uproot installed by running
conda create -n uproot uproot awkward vector
and then activate that environment by running
conda activate uproot.
(After the first time doing this, you only have to run the last command within Anaconda when you want to use Uproot again.)
A browser window should pop up with Jupyter open.
Required data file
You will need to download a small (3.5 MiB) CMS open data file as well. (This is already done for you if you’re running on Binder).
Once you have Jupyter open…
Just open a new Python 3 notebook. Whenever you see Python code in the tutorial, you can type it in and run it (Shift-Enter). The exercises are done in the notebook. You are encouraged to experiment far beyond what’s in the tutorial whenever you have a question or are just curious about something!