# Rf 4 0 5_Realtocatfuncs¶

Data and categories: demonstration of real-discrete mapping functions

Author: Clemens Lange, Wouter Verkerke (C++ version)
This notebook tutorial was automatically generated with ROOTBOOK-izer from the macro found in the ROOT repository on Monday, January 17, 2022 at 10:03 AM.

In [ ]:
import ROOT


## Define pdf in x, sample dataset in x¶

Define a dummy PDF in x

In [ ]:
x = ROOT.RooRealVar("x", "x", 0, 10)
a = ROOT.RooArgusBG("a", "argus(x)", x, ROOT.RooFit.RooConst(10), ROOT.RooFit.RooConst(-1))


Generate a dummy dataset

In [ ]:
data = a.generate({x}, 10000)


## Create a threshold real -> cat function¶

A RooThresholdCategory is a category function that maps regions in a real-valued input observable observables to state names. At construction time a 'default' state name must be specified to which all values of x are mapped that are not otherwise assigned

In [ ]:
xRegion = ROOT.RooThresholdCategory("xRegion", "region of x", x, "Background")


Specify thresholds and state assignments one-by-one. Each statement specifies that all values below the given value (and above any lower specified threshold) are mapped to the category state with the given name

Background | SideBand | Signal | SideBand | Background 4.23 5.23 8.23 9.23

In [ ]:
xRegion.addThreshold(4.23, "Background")


## Use threshold function to plot data regions¶

Add values of threshold function to dataset so that it can be used as observable

In [ ]:
data.addColumn(xRegion)


Make plot of data in x

In [ ]:
xframe = x.frame(Title="Demo of threshold and binning mapping functions")
data.plotOn(xframe)


Use calculated category to select sideband data

In [ ]:
data.plotOn(xframe, Cut="xRegion==xRegion::SideBand", MarkerColor="r", LineColor="r")


## Create a binning real -> cat function¶

A RooBinningCategory is a category function that maps bins of a (named) binning definition in a real-valued input observable observables to state names. The state names are automatically constructed from the variable name, binning name and the bin number. If no binning name is specified the default binning is mapped

In [ ]:
x.setBins(10, "coarse")
xBins = ROOT.RooBinningCategory("xBins", "coarse bins in x", x, "coarse")


## Use binning function for tabulation and plotting¶

Print table of xBins state multiplicity. Note that xBins does not need to be an observable in data it can be a function of observables in data as well

In [ ]:
xbtable = data.table(xBins)
xbtable.Print("v")


Add values of xBins function to dataset so that it can be used as observable

In [ ]:
xb = data.addColumn(xBins)


Define range "alt" as including bins 1,3,5,7,9

In [ ]:
xb.setRange("alt", "x_coarse_bin1,x_coarse_bin3,x_coarse_bin5,x_coarse_bin7,x_coarse_bin9")


Construct subset of data matching range "alt" but only for the first 5000 events and plot it on the frame

In [ ]:
dataSel = data.reduce(CutRange="alt", EventRange=(0, 5000))
dataSel.plotOn(xframe, MarkerColor="g", LineColor="g")

c = ROOT.TCanvas("rf405_realtocatfuncs", "rf405_realtocatfuncs", 600, 600)
xframe.SetMinimum(0.01)

from ROOT import gROOT