This class serves as a container of analysis bins analysis bins are specified by defining the axes of a distribution.

TUnfold is used to decompose a measurement y into several sources x given the measurement uncertainties and a matrix of migrations A.

It is also possible to have unconnected analysis bins without axis. Multiple TUnfoldBinning objects may be arranged in a tree, such that a full tree structure of histograms and bins is supported

If you use this software, please consider the following citation S.Schmitt, JINST 7 (2012) T10003 [arXiv:1205.6201]

More documentation and updates are available on http://www.desy.de/~sschmitt

Functionality

The class gives access to all analysis bins numbered in sequence. Such a sequence of bins may be stored in a 1-dimension histogram. Correlations between two TUnfoldBinning objects may be stored in a 2-dimensional histogram. This type of ordering is required for the TUnfold class.

In addition, it is possible to have root histograms, using the axes as defined with the distributions. Underflow/overflow bins can be included or excluded when mapping bins on root histograms. In addition, it is possible to collapse one of more axes when going from a N-dimensional distribution to a root histogram.

More details are described with the documentation of TUnfold.

For most applications, it is best to use TUnfoldDensity instead of using TUnfoldSys or TUnfold

If you use this software, please consider the following citation S.Schmitt, JINST 7 (2012) T10003 [arXiv:1205.6201]

More documentation and updates are available on http://www.desy.de/~sschmitt

As compared to TUnfold, TUndolfDensity adds the following functionality background subtraction (see documentation of TUnfoldSys) error propagation (see documentation of TUnfoldSys) regularisation schemes respecting the bin widths support for complex, multidimensional input distributions

Complex binning schemes are imposed on the measurements y and on the result vector x with the help of the class TUnfoldBinning The components of x or y are part of multi-dimensional distributions. The bin widths along the relevant directions in these distributions are used to calculate bin densities (number of events divided by bin width) or to calculate derivatives taking into account the proper distance of adjacent bin centers

Complex binning schemes

in literature on unfolding, the "standard" test case is a one-dimensional distribution without underflow or overflow bins. The migration matrix is almost diagonal.

This "standard" case is rarely realized for real problems.

Often one has to deal with multi-dimensional input distributions. In addition, there are underflow and overflow bins or other background bins, possibly determined with the help of auxillary measurements

In TUnfoldDensity, such complex binning schemes are handled with the help of the class TUnfoldBinning. For each vector there is a tree structure. The tree nodes hold multi-dimensiopnal distributions

For example, the "measurement" tree could have two leaves, one for the primary distribution and one for auxillary measurements

Similarly, the "truth" tree could have two leaves, one for the signal and one for the background.

each of the leaves may then have a multi-dimensional distribution.

The class TUnfoldBinning takes care to map all bins of the "measurement" to the one-dimensional vector y. Similarly, the "truth" bins are mapped to the vector x.

Choice of the regularisation

In TUnfoldDensity, two methods are implemented to determine tau**2

ScanLcurve() locate the tau where the L-curve plot has a "kink" this function is implemented in the TUnfold class
ScanTau() finds the solution such that some variable (e.g. global correlation coefficient) is minimized this function is implemented in the TUnfoldDensity class, such that the variable could be made depend on the binning scheme

Each of the algorithms has its own advantages and disadvantages

The algorithm (1) does not work if the input data are too similar to the MC prediction, that is unfolding with tau=0 gives a least-square sum of zero. Typical no-go cases of the L-curve scan are:

(a) the number of measurements is too small (e.g. ny=nx)
(b) the input data have no statistical fluctuations [identical MC events are used to fill the matrix of migrations and the vector y]

The algorithm (2) only works if the variable does have a real minimum as a function of tau. If global correlations are minimized, the situation is as follows: The matrix of migration typically introduces negative correlations. The area constraint introduces some positive correlation. Regularisation on the "size" introduces no correlation. Regularisation on 1st or 2nd derivatives adds positive correlations. For this reason, "size" regularisation does not work well with the tau-scan: the higher tau, the smaller rho, but there is no minimum. In contrast, the tau-scan is expected to work well with 1st or 2nd derivative regularisation, because at some point the negative correlations from migrations are approximately cancelled by the positive correlations from the regularisation conditions.

whichever algorithm is used, the output has to be checked:

The L-curve should have approximate L-shape and the final choice of tau should not be at the very edge of the scanned region
The scan result should have a well-defined minimum and the final choice of tau should sit right in the minimum

Definition at line 50 of file TUnfoldBinning.h.

Public Types
enum	{ MAXDIM =32 }

Public Types inherited from TObject
enum	{ kIsOnHeap = 0x01000000, kNotDeleted = 0x02000000, kZombie = 0x04000000, kBitMask = 0x00ffffff }

enum	{ kSingleKey = BIT(0), kOverwrite = BIT(1), kWriteDelete = BIT(2) }

enum	EStatusBits { kCanDelete = BIT(0), kMustCleanup = BIT(3), kObjInCanvas = BIT(3), kIsReferenced = BIT(4), kHasUUID = BIT(5), kCannotPick = BIT(6), kNoContextMenu = BIT(8), kInvalidObject = BIT(13) }

Public Member Functions
	TUnfoldBinning (const char name=0, Int_t nBins=0, const char binNames=0)

	TUnfoldBinning (const TAxis &axis, Int_t includeUnderflow, Int_t includeOverflow)

virtual	~TUnfoldBinning (void)

Bool_t	AddAxis (const char name, Int_t nBins, const Double_t binBorders, Bool_t hasUnderflow, Bool_t hasOverflow)

Bool_t	AddAxis (const char *name, Int_t nBins, Double_t xMin, Double_t xMax, Bool_t hasUnderflow, Bool_t hasOverflow)

Bool_t	AddAxis (const TAxis &axis, Bool_t includeUnderflow, Bool_t includeOverflow)

TUnfoldBinning *	AddBinning (TUnfoldBinning *binning)

TUnfoldBinning *	AddBinning (const char name, Int_t nBins=0, const char binNames=0)

TH2D *	CreateErrorMatrixHistogram (const char histogramName, Bool_t originalAxisBinning, Int_t binMap=0, const char histogramTitle=0, const char *axisSteering=0) const

TH1 *	CreateHistogram (const char histogramName, Bool_t originalAxisBinning=kFALSE, Int_t binMap=0, const char histogramTitle=0, const char *axisSteering=0) const

void	DecodeAxisSteering (const char axisSteering, const char options, Int_t *isOptionGiven) const

TH1 *	ExtractHistogram (const char histogramName, const TH1 globalBins, const TH2 globalBinsEmatrix=0, Bool_t originalAxisBinning=kTRUE, const char axisSteering=0) const

TUnfoldBinning const *	FindNode (char const *name) const

virtual Double_t	GetBinFactor (Int_t iBin) const

const TUnfoldBinning *	GetBinLocation (Int_t binTHxx, const char *axisSteering, Int_t axisBins[MAXDIM]) const

TString	GetBinName (Int_t iBin) const

void	GetBinNeighbours (Int_t globalBin, Int_t axis, Int_t prev, Double_t distPrev, Int_t next, Double_t distNext) const

Double_t	GetBinSize (Int_t iBin) const

void	GetBinUnderflowOverflowStatus (Int_t iBin, Int_t uStatus, Int_t oStatus) const

TUnfoldBinning const *	GetChildNode (void) const

virtual Double_t	GetDistributionAverageBinSize (Int_t axis, Bool_t includeUnderflow, Bool_t includeOverflow) const

TString	GetDistributionAxisLabel (Int_t axis) const

virtual Double_t	GetDistributionBinCenter (Int_t axis, Int_t bin) const

TVectorD const *	GetDistributionBinning (Int_t axis) const

Int_t	GetDistributionDimension (void) const

Int_t	GetDistributionNumberOfBins (void) const

virtual Double_t	GetDistributionOverflowBinWidth (Int_t axis) const

virtual Double_t	GetDistributionUnderflowBinWidth (Int_t axis) const

Int_t	GetEndBin (void) const

Int_t	GetGlobalBinNumber (Double_t x) const

Int_t	GetGlobalBinNumber (Double_t x, Double_t y) const

Int_t	GetGlobalBinNumber (Double_t x, Double_t y, Double_t z) const

Int_t	GetGlobalBinNumber (Double_t x0, Double_t x1, Double_t x2, Double_t x3) const

Int_t	GetGlobalBinNumber (const Double_t *x) const

TUnfoldBinning const *	GetNextNode (void) const

TUnfoldBinning const *	GetParentNode (void) const

TUnfoldBinning const *	GetPrevNode (void) const

Int_t	GetStartBin (void) const

Int_t	GetTH1xNumberOfBins (Bool_t originalAxisBinning=kTRUE, const char *axisSteering=0) const

void	PrintStream (std::ostream &out, Int_t indent=0) const

void	SetBinFactorFunction (Double_t normalisation, TF1 *userFunc=0)

Public Member Functions inherited from TNamed
	TNamed ()

	TNamed (const char name, const char title)

	TNamed (const TString &name, const TString &title)

	TNamed (const TNamed &named)
	TNamed copy ctor. More...

virtual	~TNamed ()

virtual void	Clear (Option_t *option="")
	Set name and title to empty strings (""). More...

virtual TObject *	Clone (const char *newname="") const
	Make a clone of an object using the Streamer facility. More...

virtual Int_t	Compare (const TObject *obj) const
	Compare two TNamed objects. More...

virtual void	Copy (TObject &named) const
	Copy this to obj. More...

virtual void	FillBuffer (char *&buffer)
	Encode TNamed into output buffer. More...

virtual const char *	GetName () const
	Returns name of object. More...

virtual const char *	GetTitle () const
	Returns title of object. More...

virtual ULong_t	Hash () const
	Return hash value for this object. More...

virtual Bool_t	IsSortable () const

virtual void	ls (Option_t *option="") const
	List TNamed name and title. More...

TNamed &	operator= (const TNamed &rhs)
	TNamed assignment operator. More...

virtual void	Print (Option_t *option="") const
	Print TNamed name and title. More...

virtual void	SetName (const char *name)
	Set the name of the TNamed. More...

virtual void	SetNameTitle (const char name, const char title)
	Set all the TNamed parameters (name and title). More...

virtual void	SetTitle (const char *title="")
	Set the title of the TNamed. More...

virtual Int_t	Sizeof () const
	Return size of the TNamed part of the TObject. More...

Public Member Functions inherited from TObject
	TObject ()
	TObject constructor. More...

	TObject (const TObject &object)
	TObject copy ctor. More...

virtual	~TObject ()
	TObject destructor. More...

void	AbstractMethod (const char *method) const
	Use this method to implement an "abstract" method that you don't want to leave purely abstract. More...

virtual void	AppendPad (Option_t *option="")
	Append graphics object to current pad. More...

virtual void	Browse (TBrowser *b)
	Browse object. May be overridden for another default action. More...

virtual const char *	ClassName () const
	Returns name of class to which the object belongs. More...

virtual void	Delete (Option_t *option="")
	Delete this object. More...

virtual Int_t	DistancetoPrimitive (Int_t px, Int_t py)
	Computes distance from point (px,py) to the object. More...

virtual void	Draw (Option_t *option="")
	Default Draw method for all objects. More...

virtual void	DrawClass () const
	Draw class inheritance tree of the class to which this object belongs. More...

virtual TObject *	DrawClone (Option_t *option="") const
	Draw a clone of this object in the current pad. More...

virtual void	Dump () const
	Dump contents of object on stdout. More...

virtual void	Error (const char method, const char msgfmt,...) const
	Issue error message. More...

virtual void	Execute (const char method, const char params, Int_t *error=0)
	Execute method on this object with the given parameter string, e.g. More...

virtual void	Execute (TMethod method, TObjArray params, Int_t *error=0)
	Execute method on this object with parameters stored in the TObjArray. More...

virtual void	ExecuteEvent (Int_t event, Int_t px, Int_t py)
	Execute action corresponding to an event at (px,py). More...

virtual void	Fatal (const char method, const char msgfmt,...) const
	Issue fatal error message. More...

virtual TObject *	FindObject (const char *name) const
	Must be redefined in derived classes. More...

virtual TObject *	FindObject (const TObject *obj) const
	Must be redefined in derived classes. More...

virtual Option_t *	GetDrawOption () const
	Get option used by the graphics system to draw this object. More...

virtual const char *	GetIconName () const
	Returns mime type name of object. More...

virtual char *	GetObjectInfo (Int_t px, Int_t py) const
	Returns string containing info about the object at position (px,py). More...

virtual Option_t *	GetOption () const

virtual UInt_t	GetUniqueID () const
	Return the unique object id. More...

virtual Bool_t	HandleTimer (TTimer *timer)
	Execute action in response of a timer timing out. More...

virtual void	Info (const char method, const char msgfmt,...) const
	Issue info message. More...

virtual Bool_t	InheritsFrom (const char *classname) const
	Returns kTRUE if object inherits from class "classname". More...

virtual Bool_t	InheritsFrom (const TClass *cl) const
	Returns kTRUE if object inherits from TClass cl. More...

virtual void	Inspect () const
	Dump contents of this object in a graphics canvas. More...

void	InvertBit (UInt_t f)

virtual Bool_t	IsEqual (const TObject *obj) const
	Default equal comparison (objects are equal if they have the same address in memory). More...

virtual Bool_t	IsFolder () const
	Returns kTRUE in case object contains browsable objects (like containers or lists of other objects). More...

Bool_t	IsOnHeap () const

Bool_t	IsZombie () const

void	MayNotUse (const char *method) const
	Use this method to signal that a method (defined in a base class) may not be called in a derived class (in principle against good design since a child class should not provide less functionality than its parent, however, sometimes it is necessary). More...

virtual Bool_t	Notify ()
	This method must be overridden to handle object notification. More...

void	Obsolete (const char method, const char asOfVers, const char *removedFromVers) const
	Use this method to declare a method obsolete. More...

void	operator delete (void *ptr)
	Operator delete. More...

void	operator delete[] (void *ptr)
	Operator delete []. More...

void *	operator new (size_t sz)

void *	operator new (size_t sz, void *vp)

void *	operator new[] (size_t sz)

void *	operator new[] (size_t sz, void *vp)

TObject &	operator= (const TObject &rhs)
	TObject assignment operator. More...

virtual void	Paint (Option_t *option="")
	This method must be overridden if a class wants to paint itself. More...

virtual void	Pop ()
	Pop on object drawn in a pad to the top of the display list. More...

virtual Int_t	Read (const char *name)
	Read contents of object with specified name from the current directory. More...

virtual void	RecursiveRemove (TObject *obj)
	Recursively remove this object from a list. More...

void	ResetBit (UInt_t f)

virtual void	SaveAs (const char filename="", Option_t option="") const
	Save this object in the file specified by filename. More...

virtual void	SavePrimitive (std::ostream &out, Option_t *option="")
	Save a primitive as a C++ statement(s) on output stream "out". More...

void	SetBit (UInt_t f, Bool_t set)
	Set or unset the user status bits as specified in f. More...

void	SetBit (UInt_t f)

virtual void	SetDrawOption (Option_t *option="")
	Set drawing option for object. More...

virtual void	SetUniqueID (UInt_t uid)
	Set the unique object id. More...

virtual void	SysError (const char method, const char msgfmt,...) const
	Issue system error message. More...

Bool_t	TestBit (UInt_t f) const

Int_t	TestBits (UInt_t f) const

virtual void	UseCurrentStyle ()
	Set current style settings in this object This function is called when either TCanvas::UseCurrentStyle or TROOT::ForceStyle have been invoked. More...

virtual void	Warning (const char method, const char msgfmt,...) const
	Issue warning message. More...

virtual Int_t	Write (const char *name=0, Int_t option=0, Int_t bufsize=0)
	Write this object to the current directory. More...

virtual Int_t	Write (const char *name=0, Int_t option=0, Int_t bufsize=0) const
	Write this object to the current directory. More...

Static Public Member Functions
static TH2D *	CreateHistogramOfMigrations (TUnfoldBinning const xAxis, TUnfoldBinning const yAxis, char const histogramName, Bool_t originalXAxisBinning=kFALSE, Bool_t originalYAxisBinning=kFALSE, char const histogramTitle=0)

Static Public Member Functions inherited from TObject
static Long_t	GetDtorOnly ()
	Return destructor only flag. More...

static Bool_t	GetObjectStat ()
	Get status of object stat flag. More...

static void	SetDtorOnly (void *obj)
	Set destructor only flag. More...

static void	SetObjectStat (Bool_t stat)
	Turn on/off tracking of objects in the TObjectTable. More...

Protected Member Functions
TString	BuildHistogramTitle (const char histogramName, const char histogramTitle, Int_t const *axisList) const

TString	BuildHistogramTitle2D (const char histogramName, const char histogramTitle, Int_t xAxis, const TUnfoldBinning *yAxisBinning, Int_t yAxis) const

Int_t *	CreateBinMap (const TH1 hist, Int_t nDim, const Int_t axisList, const char *axisSteering) const

Int_t	FillBinMapRecursive (Int_t startBin, const char axisSteering, Int_t binMap) const

Int_t	FillBinMapSingleNode (const TH1 hist, Int_t startBin, Int_t nDim, const Int_t axisList, const char axisSteering, Int_t binMap) const

const TUnfoldBinning *	GetBinLocationRecursive (Int_t &offset, const char *axisSteering, Int_t axisBins[MAXDIM]) const

const TUnfoldBinning *	GetNonemptyNode (void) const

TUnfoldBinning *	GetRootNode (void)

TUnfoldBinning const *	GetRootNode (void) const

Int_t	GetTHxxBinning (Int_t maxDim, Int_t axisBins, Int_t axisList, const char *axisSteering) const

Int_t	GetTHxxBinningSingleNode (Int_t maxDim, Int_t axisBins, Int_t axisList, const char *axisSteering) const

Int_t	GetTHxxBinsRecursive (const char *axisSteering) const

Bool_t	HasUnconnectedBins (void) const

void	Initialize (Int_t nBins)

TUnfoldBinning const *	ToAxisBins (Int_t globalBin, Int_t *axisBins) const

Int_t	ToGlobalBin (Int_t const *axisBins) const

Int_t	UpdateFirstLastBin (Bool_t startWithRootNode=kTRUE)

Protected Member Functions inherited from TObject
virtual void	DoError (int level, const char location, const char fmt, va_list va) const
	Interface to ErrorHandler (protected). More...

void	MakeZombie ()

Protected Attributes
TUnfoldBinning *	childNode

TObjArray *	fAxisLabelList

TObjArray *	fAxisList

Double_t	fBinFactorConstant

TF1 *	fBinFactorFunction

Int_t	fDistributionSize

Int_t	fFirstBin

Int_t	fHasOverflow

Int_t	fHasUnderflow

Int_t	fLastBin

TUnfoldBinning *	nextNode

TUnfoldBinning *	parentNode

TUnfoldBinning *	prevNode

Protected Attributes inherited from TNamed
TString	fName

TString	fTitle

#include <TUnfoldBinning.h>

Inheritance diagram for TUnfoldBinning:

[legend]

Member Enumeration Documentation

◆ anonymous enum

anonymous enum

Enumerator
MAXDIM

Definition at line 117 of file TUnfoldBinning.h.

Constructor & Destructor Documentation

◆ TUnfoldBinning() [1/2]

TUnfoldBinning::TUnfoldBinning	(	const char *	name = `0`,
		Int_t	nBins = `0`,
		const char *	binNames = `0`
	)

Definition at line 133 of file TUnfoldBinning.cxx.

◆ TUnfoldBinning() [2/2]

TUnfoldBinning::TUnfoldBinning	(	const TAxis &	axis,
		Int_t	includeUnderflow,
		Int_t	includeOverflow
	)

Definition at line 150 of file TUnfoldBinning.cxx.

◆ ~TUnfoldBinning()

TUnfoldBinning::~TUnfoldBinning ( void )

virtual

Definition at line 162 of file TUnfoldBinning.cxx.

Member Function Documentation

◆ AddAxis() [1/3]

Bool_t TUnfoldBinning::AddAxis	(	const char *	name,
		Int_t	nBins,
		const Double_t *	binBorders,
		Bool_t	hasUnderflow,
		Bool_t	hasOverflow
	)

Definition at line 284 of file TUnfoldBinning.cxx.

◆ AddAxis() [2/3]

Bool_t TUnfoldBinning::AddAxis	(	const char *	name,
		Int_t	nBins,
		Double_t	xMin,
		Double_t	xMax,
		Bool_t	hasUnderflow,
		Bool_t	hasOverflow
	)

Definition at line 230 of file TUnfoldBinning.cxx.

◆ AddAxis() [3/3]

Bool_t TUnfoldBinning::AddAxis	(	const TAxis &	axis,
		Bool_t	includeUnderflow,
		Bool_t	includeOverflow
	)

Definition at line 263 of file TUnfoldBinning.cxx.

◆ AddBinning() [1/2]

TUnfoldBinning * TUnfoldBinning::AddBinning ( TUnfoldBinning * binning )

Definition at line 186 of file TUnfoldBinning.cxx.

◆ AddBinning() [2/2]

TUnfoldBinning * TUnfoldBinning::AddBinning	(	const char *	name,
		Int_t	nBins = `0`,
		const char *	binNames = `0`
	)

Definition at line 177 of file TUnfoldBinning.cxx.

◆ BuildHistogramTitle()

TString TUnfoldBinning::BuildHistogramTitle	(	const char *	histogramName,
		const char *	histogramTitle,
		Int_t const *	axisList
	)		const

protected

Definition at line 432 of file TUnfoldBinning.cxx.

◆ BuildHistogramTitle2D()

TString TUnfoldBinning::BuildHistogramTitle2D	(	const char *	histogramName,
		const char *	histogramTitle,
		Int_t	xAxis,
		const TUnfoldBinning *	yAxisBinning,
		Int_t	yAxis
	)		const

protected

Definition at line 465 of file TUnfoldBinning.cxx.

◆ CreateBinMap()

Int_t * TUnfoldBinning::CreateBinMap	(	const TH1 *	hist,
		Int_t	nDim,
		const Int_t *	axisList,
		const char *	axisSteering
	)		const

protected

Definition at line 858 of file TUnfoldBinning.cxx.

◆ CreateErrorMatrixHistogram()

TH2D * TUnfoldBinning::CreateErrorMatrixHistogram	(	const char *	histogramName,
		Bool_t	originalAxisBinning,
		Int_t **	binMap = `0`,
		const char *	histogramTitle = `0`,
		const char *	axisSteering = `0`
	)		const

Definition at line 591 of file TUnfoldBinning.cxx.

◆ CreateHistogram()

TH1 * TUnfoldBinning::CreateHistogram	(	const char *	histogramName,
		Bool_t	originalAxisBinning = `kFALSE`,
		Int_t **	binMap = `0`,
		const char *	histogramTitle = `0`,
		const char *	axisSteering = `0`
	)		const

Definition at line 522 of file TUnfoldBinning.cxx.

◆ CreateHistogramOfMigrations()

TH2D * TUnfoldBinning::CreateHistogramOfMigrations	(	TUnfoldBinning const *	xAxis,
		TUnfoldBinning const *	yAxis,
		char const *	histogramName,
		Bool_t	originalXAxisBinning = `kFALSE`,
		Bool_t	originalYAxisBinning = `kFALSE`,
		char const *	histogramTitle = `0`
	)

static

Definition at line 644 of file TUnfoldBinning.cxx.

◆ DecodeAxisSteering()

void TUnfoldBinning::DecodeAxisSteering	(	const char *	axisSteering,
		const char *	options,
		Int_t *	isOptionGiven
	)		const

Definition at line 1680 of file TUnfoldBinning.cxx.

◆ ExtractHistogram()

TH1 * TUnfoldBinning::ExtractHistogram	(	const char *	histogramName,
		const TH1 *	globalBins,
		const TH2 *	globalBinsEmatrix = `0`,
		Bool_t	originalAxisBinning = `kTRUE`,
		const char *	axisSteering = `0`
	)		const

Definition at line 1087 of file TUnfoldBinning.cxx.

◆ FillBinMapRecursive()

Int_t TUnfoldBinning::FillBinMapRecursive	(	Int_t	startBin,
		const char *	axisSteering,
		Int_t *	binMap
	)		const

protected

Definition at line 915 of file TUnfoldBinning.cxx.

◆ FillBinMapSingleNode()

Int_t TUnfoldBinning::FillBinMapSingleNode	(	const TH1 *	hist,
		Int_t	startBin,
		Int_t	nDim,
		const Int_t *	axisList,
		const char *	axisSteering,
		Int_t *	binMap
	)		const

protected

Definition at line 939 of file TUnfoldBinning.cxx.

◆ FindNode()

TUnfoldBinning const * TUnfoldBinning::FindNode ( char const * name ) const

Definition at line 398 of file TUnfoldBinning.cxx.

◆ GetBinFactor()

Double_t TUnfoldBinning::GetBinFactor ( Int_t iBin ) const

virtual

Definition at line 1323 of file TUnfoldBinning.cxx.

◆ GetBinLocation()

const TUnfoldBinning * TUnfoldBinning::GetBinLocation	(	Int_t	binTHxx,
		const char *	axisSteering,
		Int_t	axisBins[MAXDIM]
	)		const

Definition at line 1410 of file TUnfoldBinning.cxx.

◆ GetBinLocationRecursive()

const TUnfoldBinning * TUnfoldBinning::GetBinLocationRecursive	(	Int_t &	offset,
		const char *	axisSteering,
		Int_t	axisBins[MAXDIM]
	)		const

protected

Definition at line 1441 of file TUnfoldBinning.cxx.

◆ GetBinName()

TString TUnfoldBinning::GetBinName ( Int_t iBin ) const

Definition at line 1255 of file TUnfoldBinning.cxx.

◆ GetBinNeighbours()

void TUnfoldBinning::GetBinNeighbours	(	Int_t	globalBin,
		Int_t	axis,
		Int_t *	prev,
		Double_t *	distPrev,
		Int_t *	next,
		Double_t *	distNext
	)		const

Definition at line 1350 of file TUnfoldBinning.cxx.

◆ GetBinSize()

Double_t TUnfoldBinning::GetBinSize ( Int_t iBin ) const

Definition at line 1296 of file TUnfoldBinning.cxx.

◆ GetBinUnderflowOverflowStatus()

void TUnfoldBinning::GetBinUnderflowOverflowStatus	(	Int_t	iBin,
		Int_t *	uStatus,
		Int_t *	oStatus
	)		const

Definition at line 1388 of file TUnfoldBinning.cxx.

◆ GetChildNode()

TUnfoldBinning const* TUnfoldBinning::GetChildNode ( void ) const

inline

Definition at line 82 of file TUnfoldBinning.h.

◆ GetDistributionAverageBinSize()

Double_t TUnfoldBinning::GetDistributionAverageBinSize	(	Int_t	axis,
		Bool_t	includeUnderflow,
		Bool_t	includeOverflow
	)		const

virtual

Definition at line 1529 of file TUnfoldBinning.cxx.

◆ GetDistributionAxisLabel()

TString TUnfoldBinning::GetDistributionAxisLabel ( Int_t axis ) const

inline

Definition at line 128 of file TUnfoldBinning.h.

◆ GetDistributionBinCenter()

Double_t TUnfoldBinning::GetDistributionBinCenter	(	Int_t	axis,
		Int_t	bin
	)		const

virtual

Definition at line 1580 of file TUnfoldBinning.cxx.

◆ GetDistributionBinning()

TVectorD const* TUnfoldBinning::GetDistributionBinning ( Int_t axis ) const

inline

Definition at line 126 of file TUnfoldBinning.h.

◆ GetDistributionDimension()

Int_t TUnfoldBinning::GetDistributionDimension ( void ) const

inline

Definition at line 124 of file TUnfoldBinning.h.

◆ GetDistributionNumberOfBins()

Int_t TUnfoldBinning::GetDistributionNumberOfBins ( void ) const

inline

Definition at line 123 of file TUnfoldBinning.h.

◆ GetDistributionOverflowBinWidth()

Double_t TUnfoldBinning::GetDistributionOverflowBinWidth ( Int_t axis ) const

virtual

Definition at line 1571 of file TUnfoldBinning.cxx.

◆ GetDistributionUnderflowBinWidth()

Double_t TUnfoldBinning::GetDistributionUnderflowBinWidth ( Int_t axis ) const

virtual

Definition at line 1563 of file TUnfoldBinning.cxx.

◆ GetEndBin()

Int_t TUnfoldBinning::GetEndBin ( void ) const

inline

Definition at line 106 of file TUnfoldBinning.h.

◆ GetGlobalBinNumber() [1/5]

Int_t TUnfoldBinning::GetGlobalBinNumber ( Double_t x ) const

Definition at line 1147 of file TUnfoldBinning.cxx.

◆ GetGlobalBinNumber() [2/5]

Int_t TUnfoldBinning::GetGlobalBinNumber	(	Double_t	x,
		Double_t	y
	)		const

Definition at line 1160 of file TUnfoldBinning.cxx.

◆ GetGlobalBinNumber() [3/5]

Int_t TUnfoldBinning::GetGlobalBinNumber	(	Double_t	x,
		Double_t	y,
		Double_t	z
	)		const

Definition at line 1177 of file TUnfoldBinning.cxx.

◆ GetGlobalBinNumber() [4/5]

Int_t TUnfoldBinning::GetGlobalBinNumber	(	Double_t	x0,
		Double_t	x1,
		Double_t	x2,
		Double_t	x3
	)		const

Definition at line 1195 of file TUnfoldBinning.cxx.

◆ GetGlobalBinNumber() [5/5]

Int_t TUnfoldBinning::GetGlobalBinNumber ( const Double_t * x ) const

Definition at line 1213 of file TUnfoldBinning.cxx.

◆ GetNextNode()

TUnfoldBinning const* TUnfoldBinning::GetNextNode ( void ) const

inline

Definition at line 84 of file TUnfoldBinning.h.

◆ GetNonemptyNode()

const TUnfoldBinning * TUnfoldBinning::GetNonemptyNode ( void ) const

protected

Definition at line 735 of file TUnfoldBinning.cxx.

◆ GetParentNode()

TUnfoldBinning const* TUnfoldBinning::GetParentNode ( void ) const

inline

Definition at line 85 of file TUnfoldBinning.h.

◆ GetPrevNode()

TUnfoldBinning const* TUnfoldBinning::GetPrevNode ( void ) const

inline

Definition at line 83 of file TUnfoldBinning.h.

◆ GetRootNode() [1/2]

TUnfoldBinning * TUnfoldBinning::GetRootNode ( void )

protected

Definition at line 413 of file TUnfoldBinning.cxx.

◆ GetRootNode() [2/2]

TUnfoldBinning const * TUnfoldBinning::GetRootNode ( void ) const

protected

Definition at line 421 of file TUnfoldBinning.cxx.

◆ GetStartBin()

Int_t TUnfoldBinning::GetStartBin ( void ) const

inline

Definition at line 105 of file TUnfoldBinning.h.

◆ GetTH1xNumberOfBins()

Int_t TUnfoldBinning::GetTH1xNumberOfBins	(	Bool_t	originalAxisBinning = `kTRUE`,
		const char *	axisSteering = `0`
	)		const

Definition at line 498 of file TUnfoldBinning.cxx.

◆ GetTHxxBinning()

Int_t TUnfoldBinning::GetTHxxBinning	(	Int_t	maxDim,
		Int_t *	axisBins,
		Int_t *	axisList,
		const char *	axisSteering
	)		const

protected

Definition at line 698 of file TUnfoldBinning.cxx.

◆ GetTHxxBinningSingleNode()

Int_t TUnfoldBinning::GetTHxxBinningSingleNode	(	Int_t	maxDim,
		Int_t *	axisBins,
		Int_t *	axisList,
		const char *	axisSteering
	)		const

protected

Definition at line 758 of file TUnfoldBinning.cxx.

◆ GetTHxxBinsRecursive()

Int_t TUnfoldBinning::GetTHxxBinsRecursive ( const char * axisSteering ) const

protected

Definition at line 830 of file TUnfoldBinning.cxx.

◆ HasUnconnectedBins()

Bool_t TUnfoldBinning::HasUnconnectedBins ( void ) const

protected

Definition at line 1522 of file TUnfoldBinning.cxx.

◆ Initialize()

void TUnfoldBinning::Initialize ( Int_t nBins )

protected

Definition at line 78 of file TUnfoldBinning.cxx.

◆ PrintStream()

void TUnfoldBinning::PrintStream	(	std::ostream &	out,
		Int_t	indent = `0`
	)		const

Definition at line 340 of file TUnfoldBinning.cxx.

◆ SetBinFactorFunction()

void TUnfoldBinning::SetBinFactorFunction	(	Double_t	normalisation,
		TF1 *	userFunc = `0`
	)

inline

Definition at line 78 of file TUnfoldBinning.h.

◆ ToAxisBins()

TUnfoldBinning const * TUnfoldBinning::ToAxisBins	(	Int_t	globalBin,
		Int_t *	axisBins
	)		const

protected

Definition at line 1634 of file TUnfoldBinning.cxx.

◆ ToGlobalBin()

Int_t TUnfoldBinning::ToGlobalBin ( Int_t const * axisBins ) const

protected

Definition at line 1600 of file TUnfoldBinning.cxx.

◆ UpdateFirstLastBin()

Int_t TUnfoldBinning::UpdateFirstLastBin ( Bool_t startWithRootNode = kTRUE )

protected

Definition at line 96 of file TUnfoldBinning.cxx.

Member Data Documentation

◆ childNode

TUnfoldBinning* TUnfoldBinning::childNode

protected

Definition at line 53 of file TUnfoldBinning.h.

◆ fAxisLabelList

TObjArray* TUnfoldBinning::fAxisLabelList

protected

Definition at line 57 of file TUnfoldBinning.h.

◆ fAxisList

TObjArray* TUnfoldBinning::fAxisList

protected

Definition at line 56 of file TUnfoldBinning.h.

◆ fBinFactorConstant

Double_t TUnfoldBinning::fBinFactorConstant

protected

Definition at line 63 of file TUnfoldBinning.h.

◆ fBinFactorFunction

TF1* TUnfoldBinning::fBinFactorFunction

protected

Definition at line 62 of file TUnfoldBinning.h.

◆ fDistributionSize

Int_t TUnfoldBinning::fDistributionSize

protected

Definition at line 59 of file TUnfoldBinning.h.

◆ fFirstBin

Int_t TUnfoldBinning::fFirstBin

protected

Definition at line 60 of file TUnfoldBinning.h.

◆ fHasOverflow

Int_t TUnfoldBinning::fHasOverflow

protected

Definition at line 58 of file TUnfoldBinning.h.

◆ fHasUnderflow

Int_t TUnfoldBinning::fHasUnderflow

protected

Definition at line 58 of file TUnfoldBinning.h.

◆ fLastBin

Int_t TUnfoldBinning::fLastBin

protected

Definition at line 61 of file TUnfoldBinning.h.

◆ nextNode

TUnfoldBinning* TUnfoldBinning::nextNode

protected

Definition at line 54 of file TUnfoldBinning.h.

◆ parentNode

TUnfoldBinning* TUnfoldBinning::parentNode

protected

Definition at line 52 of file TUnfoldBinning.h.

◆ prevNode

TUnfoldBinning* TUnfoldBinning::prevNode

protected

Definition at line 55 of file TUnfoldBinning.h.

The documentation for this class was generated from the following files:

hist/hist/inc/TUnfoldBinning.h
hist/hist/src/TUnfoldBinning.cxx

Complex binning schemes

Choice of the regularisation

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Member Enumeration Documentation

◆ anonymous enum

Constructor & Destructor Documentation

◆ TUnfoldBinning() [1/2]

◆ TUnfoldBinning() [2/2]

◆ ~TUnfoldBinning()

Member Function Documentation

◆ AddAxis() [1/3]

◆ AddAxis() [2/3]

◆ AddAxis() [3/3]

◆ AddBinning() [1/2]

◆ AddBinning() [2/2]

◆ BuildHistogramTitle()

◆ BuildHistogramTitle2D()

◆ CreateBinMap()

◆ CreateErrorMatrixHistogram()

◆ CreateHistogram()

◆ CreateHistogramOfMigrations()

◆ DecodeAxisSteering()

◆ ExtractHistogram()

◆ FillBinMapRecursive()

◆ FillBinMapSingleNode()

◆ FindNode()

◆ GetBinFactor()

◆ GetBinLocation()

◆ GetBinLocationRecursive()

◆ GetBinName()

◆ GetBinNeighbours()

◆ GetBinSize()

◆ GetBinUnderflowOverflowStatus()

◆ GetChildNode()

◆ GetDistributionAverageBinSize()

◆ GetDistributionAxisLabel()

◆ GetDistributionBinCenter()

◆ GetDistributionBinning()

◆ GetDistributionDimension()

◆ GetDistributionNumberOfBins()

◆ GetDistributionOverflowBinWidth()

◆ GetDistributionUnderflowBinWidth()

◆ GetEndBin()

◆ GetGlobalBinNumber() [1/5]

◆ GetGlobalBinNumber() [2/5]

◆ GetGlobalBinNumber() [3/5]

◆ GetGlobalBinNumber() [4/5]

◆ GetGlobalBinNumber() [5/5]

◆ GetNextNode()

◆ GetNonemptyNode()

◆ GetParentNode()

◆ GetPrevNode()

◆ GetRootNode() [1/2]

◆ GetRootNode() [2/2]

◆ GetStartBin()

◆ GetTH1xNumberOfBins()

◆ GetTHxxBinning()

◆ GetTHxxBinningSingleNode()

◆ GetTHxxBinsRecursive()

◆ HasUnconnectedBins()

◆ Initialize()

◆ PrintStream()

◆ SetBinFactorFunction()

◆ ToAxisBins()

◆ ToGlobalBin()

◆ UpdateFirstLastBin()

Member Data Documentation

◆ childNode

◆ fAxisLabelList

◆ fAxisList

◆ fBinFactorConstant

◆ fBinFactorFunction

◆ fDistributionSize

◆ fFirstBin

◆ fHasOverflow

◆ fHasUnderflow