JupyROOT

A software layer to integrate Jupyter notebooks and ROOT.

Installation

1. Install ROOT6 (> 6.05)
2. Install dependencies: pip install jupyter metakernel

Start using ROOTbooks

Set up the ROOT environment (. $ROOTSYS/bin/thisroot.[c]sh) and type in your shell:

root --notebook

This will start a ROOT-flavoured notebook server in your computer.

Alternatively, if you would like to use the Jupyter command directly, you can do on Linux:

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

and on OSx:

cp -r $ROOTSYS/etc/notebook/kernels/root /Users/$USER/Library/Jupyter/kernels/
jupyter notebook

Once the server is up, you can use ROOT with two kernels:

1. ROOT C++: new kernel provided by ROOT
2. Python 2: already provided by Jupyter

C++ ROOTbook

ROOT offers a C++ kernel that transforms the notebook in a ROOT prompt. Embedded graphics, syntax highlighting and tab completion are among the features provided by this kernel.

An example of how you would plot a histogram in a C++ ROOTbook is:

TCanvas c;
TH1F h("h","ROOT Histo;X;Y",64,-4,4);
h.FillRandom("gaus");
h.Draw();
c.Draw();

Python ROOTbook

If you prefer to use Python, you can create a new Python 2 kernel and import the ROOT libraries:

import ROOT

And then you could write something like:

c = ROOT.TCanvas("c")
h = ROOT.TH1F("h","ROOT Histo;X;Y",64,-4,4)

Additionally, you can mix Python and C++ in the same notebook by using the **%cpp** magic:

%%cpp
h->FillRandom("gaus");
h->Draw();
c->Draw();