ROOT training for STAR/EIC workshop

This is a self-contained tutorial for STAR/EIC workshop aimed at learning some ROOT basics

---

How to start:

For running on Github Codespaces submit an application for Free Github Education benefits. Then click on Github Codespace button to start a container (predefined software environment).

What is Jupyter notebook?

Start at extra_jupyter.ipynb and optionally more detailed info extra_jupyter_more.ipynb

Physics tutorials:

• 00_Intro.ipynb what is ROOT
• 01_SimpleHistogramGraphFunction.ipynb - basics of data representation - Histograms
• 02_ExcerciseCentralLimitTheorem.ipynb - try using histogram in a simple experiment of Galton problem and then fit the distribution
• 03_TreesAndFiles.ipynb - how to save data in file and read it after + optionally RDataFrames
• 04_InvariantMass.ipynb - all tutorials combined and used for OpenData $J/\psi$ decaying to 2 muons - final boss tutorial

---

What are files for:

• .devcontainer - special folder for running in Container (like Github Codespaces)
• data - backup input data in case some problems
• img - images used in notebooks
• .gitignore - special file for git (not to track)
• .rootlogon.C - your own default style for CERN ROOT settings which loads after ROOT starts
• 00_* - 04_**.ipynb - actual tutorials
• README.md - current displayed text page
• environment.yml - container settings used for Binder
• extra_*.ipynb - supplementary material for what is Jupyter Notebook

---

I like to run it on my own system:

• Git clone this repo:

git clone https://github.com/aprozo/root_workshop

• One needs to install ROOT

• Then install some additional packages with

sudo apt-get update && apt-get install -y git python3-pip
python3 -m pip install --upgrade wheel jupyter metakernel dask distributed pyspark

• After it run

root --notebook

---

Part of the material has been reused from:

• https://github.com/root-project/training
• https://github.com/root-project/software-carpentry

If facing a problem with ROOT kernel ROOT C++ kernel, one has to run it in terminal

mkdir -p  ~/.local/share/jupyter/kernels
cp -r $ROOTSYS/etc/notebook/kernels/root ~/.local/share/jupyter/kernels
jupyter notebook --allow-root

Then, wait untill the page is reloaded and choose Jupyter Kernel -> ROOT