Skip to content

Goodness of fit: ROOT's chi-square test of data against the prediction

goodness_of_fit=True runs ROOT's TH1::Chi2Test of the data against the stacked prediction, a test of their shapes, and writes the chi-square per degree of freedom and the p-value under the label. "chi2-absolute" also tests the normalisation, with the systematic uncertainties, and "ks" is ROOT's Kolmogorov test. p.goodness_of_fit holds the results: the test, how each side entered and ROOT's warnings about bins with few entries.

import rootfig as rf

style = rf.Style()

rf.plot(
    mc,
    pt,
    observed=data,
    stack=True,
    panel="ratio",
    data_errors="auto",
    goodness_of_fit=True,
    style=style,
)
import rootfig as rf

style = rf.Style(experiment="ATLAS", status="Internal", lumi=140, com=13.6)

rf.plot(
    mc,
    pt,
    observed=data,
    stack=True,
    panel="ratio",
    data_errors="auto",
    goodness_of_fit=True,
    style=style,
)
import rootfig as rf

style = rf.Style(experiment="CMS", status="Preliminary", lumi=138, com=13.6)

rf.plot(
    mc,
    pt,
    observed=data,
    stack=True,
    panel="ratio",
    data_errors="auto",
    goodness_of_fit=True,
    style=style,
)
import rootfig as rf

style = rf.Style(experiment="LHCb", status="Preliminary", lumi=9, com=13.6)

rf.plot(
    mc,
    pt,
    observed=data,
    stack=True,
    panel="ratio",
    data_errors="auto",
    goodness_of_fit=True,
    style=style,
)
import rootfig as rf

style = rf.Style(experiment="ALICE", status="Preliminary")

rf.plot(
    mc,
    pt,
    observed=data,
    stack=True,
    panel="ratio",
    data_errors="auto",
    goodness_of_fit=True,
    style=style,
)
import rootfig as rf

style = rf.Style(experiment="DUNE", status="Preliminary")

rf.plot(
    mc,
    pt,
    observed=data,
    stack=True,
    panel="ratio",
    data_errors="auto",
    goodness_of_fit=True,
    style=style,
)
Setup

The code reads the toy dataset. In a checkout of rootfig, python examples/gallery writes it to examples/out/ in a few seconds; run the code inside that directory.

It uses these samples and variables, shared by the gallery examples (see Samples, variables, cuts and styles):

signal = rf.Sample("signal.root", tree="events", label="Signal", weight="weight", scale=0.03)
zjets = rf.Sample("background.root", tree="events", label="Z + jets", weight="weight")
diboson = rf.Sample("diboson.root", tree="events", label="Diboson", weight="weight", scale=0.15)
data = rf.Sample("data.root", tree="events", label="Data", is_data=True)
mc = [zjets, diboson, signal]  # stacked bottom to top

pt = rf.Variable("Muon_pt", bins=(30, 0, 300), label=r"$p_T^{\mu}$", unit="GeV")
mll = rf.Variable("m_ll", bins=(70, 50, 260), label=r"$m_{\ell\ell}$", unit="GeV")
met = rf.Variable("MET", bins=(40, 0, 400), label=r"$E_T^{miss}$", unit="GeV")