RooHist Class Reference

A RooHist is a graphical representation of binned data based on the TGraphAsymmErrors class.

Error bars are calculated using either Poisson or Binomial statistics. A RooHist is used to represent histograms in a RooPlot.

Definition at line 27 of file RooHist.h.

Public Member Functions
	RooHist ()
	Default constructor.
	RooHist (const RooAbsReal &f, RooAbsRealLValue &x, Double_t xErrorFrac=1.0, Double_t scaleFactor=1.0, const RooArgSet *normVars=0, const RooFitResult *fr=0)
	Create histogram from a pdf or function.
	RooHist (const RooHist &hist1, const RooHist &hist2, Double_t wgt1=1.0, Double_t wgt2=1.0, RooAbsData::ErrorType etype=RooAbsData::Poisson, Double_t xErrorFrac=1.0)
	Create histogram as sum of two existing histograms.
	RooHist (const TH1 &data, Double_t nominalBinWidth=0, Double_t nSigma=1, RooAbsData::ErrorType=RooAbsData::Poisson, Double_t xErrorFrac=1.0, Bool_t correctForBinWidth=kTRUE, Double_t scaleFactor=1.)
	Create a histogram from the contents of the specified TH1 object which may have fixed or variable bin widths.
	RooHist (const TH1 &data1, const TH1 &data2, Double_t nominalBinWidth=0, Double_t nSigma=1, RooAbsData::ErrorType=RooAbsData::Poisson, Double_t xErrorFrac=1.0, Bool_t efficiency=kFALSE, Double_t scaleFactor=1.0)
	Create a histogram from the asymmetry between the specified TH1 objects which may have fixed or variable bin widths, but which must both have the same binning.
	RooHist (Double_t nominalBinWidth, Double_t nSigma=1, Double_t xErrorFrac=1.0, Double_t scaleFactor=1.0)
	Create an empty histogram that can be filled with the addBin() and addAsymmetryBin() methods.
virtual	~RooHist ()
	Destructor.
void	addAsymmetryBin (Axis_t binCenter, Int_t n1, Int_t n2, Double_t binWidth=0, Double_t xErrorFrac=1.0, Double_t scaleFactor=1.0)
	Add a bin to this histogram with the value (n1-n2)/(n1+n2) using an error bar calculated with Binomial statistics.
void	addAsymmetryBinWithError (Axis_t binCenter, Double_t n1, Double_t n2, Double_t en1, Double_t en2, Double_t binWidth=0, Double_t xErrorFrac=1.0, Double_t scaleFactor=1.0)
	Add a bin to this histogram with the value (n1-n2)/(n1+n2) using an error bar calculated with Binomial statistics.
void	addBin (Axis_t binCenter, Double_t n, Double_t binWidth=0, Double_t xErrorFrac=1.0, Double_t scaleFactor=1.0)
	Add a bin to this histogram with the specified integer bin contents and using an error bar calculated with Poisson statistics.
void	addBinWithError (Axis_t binCenter, Double_t n, Double_t elow, Double_t ehigh, Double_t binWidth=0, Double_t xErrorFrac=1.0, Bool_t correctForBinWidth=kTRUE, Double_t scaleFactor=1.0)
	Add a bin to this histogram with the specified bin contents and error.
void	addBinWithXYError (Axis_t binCenter, Double_t n, Double_t exlow, Double_t exhigh, Double_t eylow, Double_t eyhigh, Double_t scaleFactor=1.0)
	Add a bin to this histogram with the specified bin contents and error.
void	addEfficiencyBin (Axis_t binCenter, Int_t n1, Int_t n2, Double_t binWidth=0, Double_t xErrorFrac=1.0, Double_t scaleFactor=1.0)
	Add a bin to this histogram with the value n1/(n1+n2) using an error bar calculated with Binomial statistics.
void	addEfficiencyBinWithError (Axis_t binCenter, Double_t n1, Double_t n2, Double_t en1, Double_t en2, Double_t binWidth=0, Double_t xErrorFrac=1.0, Double_t scaleFactor=1.0)
	Add a bin to this histogram with the value n1/(n1+n2) using an error bar calculated with Binomial statistics.
Double_t	getFitRangeBinW () const
	Return (average) bin width of this RooHist.
Double_t	getFitRangeNEvt () const
	Return the number of events of the dataset associated with this RooHist.
Double_t	getFitRangeNEvt (Double_t xlo, Double_t xhi) const
	Calculate integral of histogram in given range.
Double_t	getNominalBinWidth () const
Bool_t	hasIdenticalBinning (const RooHist &other) const
	Return kTRUE if binning of this RooHist is identical to that of 'other'.
Bool_t	isIdentical (const RooHist &other, Double_t tol=1e-6) const
	Return kTRUE if contents of this RooHist is identical within given relative tolerance to that of 'other'.
RooHist *	makePullHist (const RooCurve &curve, bool useAverage=false) const
RooHist *	makeResidHist (const RooCurve &curve, bool normalize=false, bool useAverage=false) const
	Create and return RooHist containing residuals w.r.t to given curve.
virtual void	Print (Option_t *options=0) const
	Print graph and errors values.
virtual void	printClassName (std::ostream &os) const
	Print class name of RooHist.
virtual void	printMultiline (std::ostream &os, Int_t content, Bool_t verbose=kFALSE, TString indent="") const
	Print info about this histogram to the specified output stream.
virtual void	printName (std::ostream &os) const
	Print name of RooHist.
virtual void	printTitle (std::ostream &os) const
	Print title of RooHist.
void	setRawEntries (Double_t n)
Public Member Functions inherited from TGraphAsymmErrors
	TGraphAsymmErrors ()
	TGraphAsymmErrors default constructor.
	TGraphAsymmErrors (const char *filename, const char *format="%lg %lg %lg %lg %lg %lg", Option_t *option="")
	TGraphAsymmErrors constructor reading input from filename filename is assumed to contain at least 2 columns of numbers.
	TGraphAsymmErrors (const TGraphAsymmErrors &gr)
	TGraphAsymmErrors copy constructor.
	TGraphAsymmErrors (const TH1 *h)
	TGraphAsymmErrors constructor importing its parameters from the TH1 object passed as argument the low and high errors are set to the bin error of the histogram.
	TGraphAsymmErrors (const TH1 *pass, const TH1 *total, Option_t *option="")
	Creates a TGraphAsymmErrors by dividing two input TH1 histograms: pass/total.
	TGraphAsymmErrors (const TVectorD &vx, const TVectorD &vy, const TVectorD &vexl, const TVectorD &vexh, const TVectorD &veyl, const TVectorD &veyh)
	Constructor with six vectors of doubles in input A grapherrors is built with the X coordinates taken from vx and Y coord from vy and the errors from vectors vexl/h and veyl/h.
	TGraphAsymmErrors (const TVectorF &vx, const TVectorF &vy, const TVectorF &vexl, const TVectorF &vexh, const TVectorF &veyl, const TVectorF &veyh)
	Constructor with six vectors of floats in input A grapherrors is built with the X coordinates taken from vx and Y coord from vy and the errors from vectors vexl/h and veyl/h.
	TGraphAsymmErrors (Int_t n)
	TGraphAsymmErrors normal constructor.
	TGraphAsymmErrors (Int_t n, const Double_t *x, const Double_t *y, const Double_t *exl=0, const Double_t *exh=0, const Double_t *eyl=0, const Double_t *eyh=0)
	TGraphAsymmErrors normal constructor.
	TGraphAsymmErrors (Int_t n, const Float_t *x, const Float_t *y, const Float_t *exl=0, const Float_t *exh=0, const Float_t *eyl=0, const Float_t *eyh=0)
	TGraphAsymmErrors normal constructor.
virtual	~TGraphAsymmErrors ()
	TGraphAsymmErrors default destructor.
virtual void	Apply (TF1 *f)
	Apply a function to all data points y = f(x,y)
virtual void	BayesDivide (const TH1 *pass, const TH1 *total, Option_t *opt="")
	This function is only kept for backward compatibility.
virtual void	ComputeRange (Double_t &xmin, Double_t &ymin, Double_t &xmax, Double_t &ymax) const
	Compute Range.
virtual void	Divide (const TH1 *pass, const TH1 *total, Option_t *opt="cp")
	Fill this TGraphAsymmErrors by dividing two 1-dimensional histograms pass/total.
Double_t	GetErrorX (Int_t bin) const
	This function is called by GraphFitChisquare.
Double_t	GetErrorXhigh (Int_t i) const
	Get high error on X.
Double_t	GetErrorXlow (Int_t i) const
	Get low error on X.
Double_t	GetErrorY (Int_t bin) const
	This function is called by GraphFitChisquare.
Double_t	GetErrorYhigh (Int_t i) const
	Get high error on Y.
Double_t	GetErrorYlow (Int_t i) const
	Get low error on Y.
Double_t *	GetEXhigh () const
Double_t *	GetEXlow () const
Double_t *	GetEYhigh () const
Double_t *	GetEYlow () const
virtual Int_t	Merge (TCollection *list)
	Adds all graphs with asymmetric errors from the collection to this graph.
TGraphAsymmErrors &	operator= (const TGraphAsymmErrors &gr)
	TGraphAsymmErrors assignment operator.
virtual void	SavePrimitive (std::ostream &out, Option_t *option="")
	Save primitive as a C++ statement(s) on output stream out.
virtual void	SetPointError (Double_t exl, Double_t exh, Double_t eyl, Double_t eyh)
	Set ex and ey values for point pointed by the mouse.
virtual void	SetPointError (Int_t i, Double_t exl, Double_t exh, Double_t eyl, Double_t eyh)
	Set ex and ey values for point number i.
virtual void	SetPointEXhigh (Int_t i, Double_t exh)
	Set EXhigh for point i.
virtual void	SetPointEXlow (Int_t i, Double_t exl)
	Set EXlow for point i.
virtual void	SetPointEYhigh (Int_t i, Double_t eyh)
	Set EYhigh for point i.
virtual void	SetPointEYlow (Int_t i, Double_t eyl)
	Set EYlow for point i.
Public Member Functions inherited from TGraph
	TGraph ()
	Graph default constructor.
	TGraph (const char *filename, const char *format="%lg %lg", Option_t *option="")
	Graph constructor reading input from filename.
	TGraph (const TF1 *f, Option_t *option="")
	Graph constructor importing its parameters from the TF1 object passed as argument.
	TGraph (const TGraph &gr)
	Copy constructor for this graph.
	TGraph (const TH1 *h)
	Graph constructor importing its parameters from the TH1 object passed as argument.
	TGraph (const TVectorD &vx, const TVectorD &vy)
	Graph constructor with two vectors of doubles in input A graph is build with the X coordinates taken from vx and Y coord from vy The number of points in the graph is the minimum of number of points in vx and vy.
	TGraph (const TVectorF &vx, const TVectorF &vy)
	Graph constructor with two vectors of floats in input A graph is build with the X coordinates taken from vx and Y coord from vy The number of points in the graph is the minimum of number of points in vx and vy.
	TGraph (Int_t n)
	Constructor with only the number of points set the arrays x and y will be set later.
	TGraph (Int_t n, const Double_t *x, const Double_t *y)
	Graph normal constructor with doubles.
	TGraph (Int_t n, const Float_t *x, const Float_t *y)
	Graph normal constructor with floats.
	TGraph (Int_t n, const Int_t *x, const Int_t *y)
	Graph normal constructor with ints.
virtual	~TGraph ()
	Graph default destructor.
virtual void	AddPoint (Double_t x, Double_t y)
	Append a new point to the graph.
virtual void	Browse (TBrowser *b)
	Browse.
virtual Double_t	Chisquare (TF1 *f1, Option_t *option="") const
	Return the chisquare of this graph with respect to f1.
virtual Int_t	DistancetoPrimitive (Int_t px, Int_t py)
	Compute distance from point px,py to a graph.
virtual void	Draw (Option_t *chopt="")
	Draw this graph with its current attributes.
virtual void	DrawGraph (Int_t n, const Double_t *x=nullptr, const Double_t *y=nullptr, Option_t *option="")
	Draw this graph with new attributes.
virtual void	DrawGraph (Int_t n, const Float_t *x, const Float_t *y, Option_t *option="")
	Draw this graph with new attributes.
virtual void	DrawGraph (Int_t n, const Int_t *x, const Int_t *y, Option_t *option="")
	Draw this graph with new attributes.
virtual void	DrawPanel ()
	Display a panel with all graph drawing options.
virtual Double_t	Eval (Double_t x, TSpline *spline=nullptr, Option_t *option="") const
	Interpolate points in this graph at x using a TSpline.
virtual void	ExecuteEvent (Int_t event, Int_t px, Int_t py)
	Execute action corresponding to one event.
virtual void	Expand (Int_t newsize)
	If array sizes <= newsize, expand storage to 2*newsize.
virtual void	Expand (Int_t newsize, Int_t step)
	If graph capacity is less than newsize points then make array sizes equal to least multiple of step to contain newsize points.
virtual TObject *	FindObject (const char *name) const
	Search object named name in the list of functions.
virtual TObject *	FindObject (const TObject *obj) const
	Search object obj in the list of functions.
virtual TFitResultPtr	Fit (const char *formula, Option_t *option="", Option_t *goption="", Axis_t xmin=0, Axis_t xmax=0)
	Fit this graph with function with name fname.
virtual TFitResultPtr	Fit (TF1 *f1, Option_t *option="", Option_t *goption="", Axis_t xmin=0, Axis_t xmax=0)
	Fit this graph with function f1.
virtual void	FitPanel ()
	Display a GUI panel with all graph fit options.
virtual Double_t	GetCorrelationFactor () const
	Return graph correlation factor.
virtual Double_t	GetCovariance () const
	Return covariance of vectors x,y.
Bool_t	GetEditable () const
	Return kTRUE if kNotEditable bit is not set, kFALSE otherwise.
virtual Double_t *	GetEX () const
virtual Double_t *	GetEXhighd () const
virtual Double_t *	GetEXlowd () const
virtual Double_t *	GetEY () const
virtual Double_t *	GetEYhighd () const
virtual Double_t *	GetEYlowd () const
TF1 *	GetFunction (const char *name) const
	Return pointer to function with name.
TH1F *	GetHistogram () const
	Returns a pointer to the histogram used to draw the axis Takes into account the two following cases.
TList *	GetListOfFunctions () const
Double_t	GetMaximum () const
Int_t	GetMaxSize () const
virtual Double_t	GetMean (Int_t axis=1) const
	Return mean value of X (axis=1) or Y (axis=2)
Double_t	GetMinimum () const
Int_t	GetN () const
virtual char *	GetObjectInfo (Int_t px, Int_t py) const
	Implementation to get information on point of graph at cursor position Adapted from class TH1.
virtual Int_t	GetPoint (Int_t i, Double_t &x, Double_t &y) const
	Get x and y values for point number i.
virtual Double_t	GetPointX (Int_t i) const
	Get x value for point i.
virtual Double_t	GetPointY (Int_t i) const
	Get y value for point i.
virtual Double_t	GetRMS (Int_t axis=1) const
	Return RMS of X (axis=1) or Y (axis=2)
Double_t *	GetX () const
TAxis *	GetXaxis () const
	Get x axis of the graph.
Double_t *	GetY () const
TAxis *	GetYaxis () const
	Get y axis of the graph.
virtual void	InitExpo (Double_t xmin=0, Double_t xmax=0)
	Compute Initial values of parameters for an exponential.
virtual void	InitGaus (Double_t xmin=0, Double_t xmax=0)
	Compute Initial values of parameters for a gaussian.
virtual void	InitPolynom (Double_t xmin=0, Double_t xmax=0)
	Compute Initial values of parameters for a polynom.
virtual Int_t	InsertPoint ()
	Insert a new point at the mouse position.
virtual void	InsertPointBefore (Int_t ipoint, Double_t x, Double_t y)
	Insert a new point with coordinates (x,y) before the point number ipoint.
virtual Double_t	Integral (Int_t first=0, Int_t last=-1) const
	Integrate the TGraph data within a given (index) range.
virtual Bool_t	IsEditable () const
virtual Bool_t	IsHighlight () const
virtual Int_t	IsInside (Double_t x, Double_t y) const
	Return 1 if the point (x,y) is inside the polygon defined by the graph vertices 0 otherwise.
virtual void	LeastSquareFit (Int_t m, Double_t *a, Double_t xmin=0, Double_t xmax=0)
	Least squares polynomial fitting without weights.
virtual void	LeastSquareLinearFit (Int_t n, Double_t &a0, Double_t &a1, Int_t &ifail, Double_t xmin=0, Double_t xmax=0)
	Least square linear fit without weights.
virtual void	MovePoints (Double_t dx, Double_t dy, Bool_t logx=kFALSE, Bool_t logy=kFALSE)
	Move all graph points on specified values dx,dy If log argument specified, calculation done in logarithmic scale like: new_value = exp( log(old_value) + delta );.
TGraph &	operator= (const TGraph &)
	Equal operator for this graph.
virtual void	Paint (Option_t *chopt="")
	Draw this graph with its current attributes.
void	PaintGraph (Int_t npoints, const Double_t *x, const Double_t *y, Option_t *chopt)
	Draw the (x,y) as a graph.
void	PaintGrapHist (Int_t npoints, const Double_t *x, const Double_t *y, Option_t *chopt)
	Draw the (x,y) as a histogram.
virtual void	PaintStats (TF1 *fit)
	Draw the stats.
virtual void	RecursiveRemove (TObject *obj)
	Recursively remove object from the list of functions.
virtual Int_t	RemovePoint ()
	Delete point close to the mouse position.
virtual Int_t	RemovePoint (Int_t ipoint)
	Delete point number ipoint.
virtual void	Set (Int_t n)
	Set number of points in the graph Existing coordinates are preserved New coordinates above fNpoints are preset to 0.
virtual void	SetEditable (Bool_t editable=kTRUE)
	if editable=kFALSE, the graph cannot be modified with the mouse by default a TGraph is editable
virtual void	SetHighlight (Bool_t set=kTRUE)
	Set highlight (enable/disble) mode for the graph by default highlight mode is disable.
virtual void	SetHistogram (TH1F *h)
virtual void	SetMaximum (Double_t maximum=-1111)
	Set the maximum of the graph.
virtual void	SetMinimum (Double_t minimum=-1111)
	Set the minimum of the graph.
virtual void	SetName (const char *name="")
	Set graph name.
virtual void	SetNameTitle (const char *name="", const char *title="")
	Set graph name and title.
virtual void	SetPoint (Int_t i, Double_t x, Double_t y)
	Set x and y values for point number i.
virtual void	SetPointX (Int_t i, Double_t x)
	Set x value for point i.
virtual void	SetPointY (Int_t i, Double_t y)
	Set y value for point i.
virtual void	SetTitle (const char *title="")
	Change (i.e.
virtual void	Sort (Bool_t(*greater)(const TGraph *, Int_t, Int_t)=&TGraph::CompareX, Bool_t ascending=kTRUE, Int_t low=0, Int_t high=-1111)
	Sorts the points of this TGraph using in-place quicksort (see e.g.
virtual void	UseCurrentStyle ()
	Set current style settings in this graph This function is called when either TCanvas::UseCurrentStyle or TROOT::ForceStyle have been invoked.
void	Zero (Int_t &k, Double_t AZ, Double_t BZ, Double_t E2, Double_t &X, Double_t &Y, Int_t maxiterations)
	Find zero of a continuous function.
Public Member Functions inherited from TNamed
	TNamed ()
	TNamed (const char *name, const char *title)
	TNamed (const TNamed &named)
	TNamed copy ctor.
	TNamed (const TString &name, const TString &title)
virtual	~TNamed ()
	TNamed destructor.
virtual void	Clear (Option_t *option="")
	Set name and title to empty strings ("").
virtual TObject *	Clone (const char *newname="") const
	Make a clone of an object using the Streamer facility.
virtual Int_t	Compare (const TObject *obj) const
	Compare two TNamed objects.
virtual void	Copy (TObject &named) const
	Copy this to obj.
virtual void	FillBuffer (char *&buffer)
	Encode TNamed into output buffer.
virtual const char *	GetName () const
	Returns name of object.
virtual const char *	GetTitle () const
	Returns title of object.
virtual ULong_t	Hash () const
	Return hash value for this object.
virtual Bool_t	IsSortable () const
virtual void	ls (Option_t *option="") const
	List TNamed name and title.
TNamed &	operator= (const TNamed &rhs)
	TNamed assignment operator.
virtual Int_t	Sizeof () const
	Return size of the TNamed part of the TObject.
Public Member Functions inherited from TObject
	TObject ()
	TObject constructor.
	TObject (const TObject &object)
	TObject copy ctor.
virtual	~TObject ()
	TObject destructor.
void	AbstractMethod (const char *method) const
	Use this method to implement an "abstract" method that you don't want to leave purely abstract.
virtual void	AppendPad (Option_t *option="")
	Append graphics object to current pad.
ULong_t	CheckedHash ()
	Check and record whether this class has a consistent Hash/RecursiveRemove setup (*) and then return the regular Hash value for this object.
virtual const char *	ClassName () const
	Returns name of class to which the object belongs.
virtual void	Delete (Option_t *option="")
	Delete this object.
virtual void	DrawClass () const
	Draw class inheritance tree of the class to which this object belongs.
virtual TObject *	DrawClone (Option_t *option="") const
	Draw a clone of this object in the current selected pad for instance with: gROOT->SetSelectedPad(gPad).
virtual void	Dump () const
	Dump contents of object on stdout.
virtual void	Error (const char *method, const char *msgfmt,...) const
	Issue error message.
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.
virtual void	Execute (TMethod *method, TObjArray *params, Int_t *error=0)
	Execute method on this object with parameters stored in the TObjArray.
virtual void	Fatal (const char *method, const char *msgfmt,...) const
	Issue fatal error message.
virtual Option_t *	GetDrawOption () const
	Get option used by the graphics system to draw this object.
virtual const char *	GetIconName () const
	Returns mime type name of object.
virtual Option_t *	GetOption () const
virtual UInt_t	GetUniqueID () const
	Return the unique object id.
virtual Bool_t	HandleTimer (TTimer *timer)
	Execute action in response of a timer timing out.
Bool_t	HasInconsistentHash () const
	Return true is the type of this object is known to have an inconsistent setup for Hash and RecursiveRemove (i.e.
virtual void	Info (const char *method, const char *msgfmt,...) const
	Issue info message.
virtual Bool_t	InheritsFrom (const char *classname) const
	Returns kTRUE if object inherits from class "classname".
virtual Bool_t	InheritsFrom (const TClass *cl) const
	Returns kTRUE if object inherits from TClass cl.
virtual void	Inspect () const
	Dump contents of this object in a graphics canvas.
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).
virtual Bool_t	IsFolder () const
	Returns kTRUE in case object contains browsable objects (like containers or lists of other objects).
R__ALWAYS_INLINE Bool_t	IsOnHeap () const
R__ALWAYS_INLINE 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).
virtual Bool_t	Notify ()
	This method must be overridden to handle object notification.
void	Obsolete (const char *method, const char *asOfVers, const char *removedFromVers) const
	Use this method to declare a method obsolete.
void	operator delete (void *ptr)
	Operator delete.
void	operator delete[] (void *ptr)
	Operator delete [].
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.
virtual void	Pop ()
	Pop on object drawn in a pad to the top of the display list.
virtual Int_t	Read (const char *name)
	Read contents of object with specified name from the current directory.
void	ResetBit (UInt_t f)
virtual void	SaveAs (const char *filename="", Option_t *option="") const
	Save this object in the file specified by filename.
void	SetBit (UInt_t f)
void	SetBit (UInt_t f, Bool_t set)
	Set or unset the user status bits as specified in f.
virtual void	SetDrawOption (Option_t *option="")
	Set drawing option for object.
virtual void	SetUniqueID (UInt_t uid)
	Set the unique object id.
virtual void	SysError (const char *method, const char *msgfmt,...) const
	Issue system error message.
R__ALWAYS_INLINE Bool_t	TestBit (UInt_t f) const
Int_t	TestBits (UInt_t f) const
virtual void	Warning (const char *method, const char *msgfmt,...) const
	Issue warning message.
virtual Int_t	Write (const char *name=0, Int_t option=0, Int_t bufsize=0)
	Write this object to the current directory.
virtual Int_t	Write (const char *name=0, Int_t option=0, Int_t bufsize=0) const
	Write this object to the current directory.
Public Member Functions inherited from TAttLine
	TAttLine ()
	AttLine default constructor.
	TAttLine (Color_t lcolor, Style_t lstyle, Width_t lwidth)
	AttLine normal constructor.
virtual	~TAttLine ()
	AttLine destructor.
void	Copy (TAttLine &attline) const
	Copy this line attributes to a new TAttLine.
Int_t	DistancetoLine (Int_t px, Int_t py, Double_t xp1, Double_t yp1, Double_t xp2, Double_t yp2)
	Compute distance from point px,py to a line.
virtual Color_t	GetLineColor () const
	Return the line color.
virtual Style_t	GetLineStyle () const
	Return the line style.
virtual Width_t	GetLineWidth () const
	Return the line width.
virtual void	Modify ()
	Change current line attributes if necessary.
virtual void	ResetAttLine (Option_t *option="")
	Reset this line attributes to default values.
virtual void	SaveLineAttributes (std::ostream &out, const char *name, Int_t coldef=1, Int_t stydef=1, Int_t widdef=1)
	Save line attributes as C++ statement(s) on output stream out.
virtual void	SetLineAttributes ()
	Invoke the DialogCanvas Line attributes.
virtual void	SetLineColor (Color_t lcolor)
	Set the line color.
virtual void	SetLineColorAlpha (Color_t lcolor, Float_t lalpha)
	Set a transparent line color.
virtual void	SetLineStyle (Style_t lstyle)
	Set the line style.
virtual void	SetLineWidth (Width_t lwidth)
	Set the line width.
Public Member Functions inherited from TAttFill
	TAttFill ()
	AttFill default constructor.
	TAttFill (Color_t fcolor, Style_t fstyle)
	AttFill normal constructor.
virtual	~TAttFill ()
	AttFill destructor.
void	Copy (TAttFill &attfill) const
	Copy this fill attributes to a new TAttFill.
virtual Color_t	GetFillColor () const
	Return the fill area color.
virtual Style_t	GetFillStyle () const
	Return the fill area style.
virtual Bool_t	IsTransparent () const
virtual void	Modify ()
	Change current fill area attributes if necessary.
virtual void	ResetAttFill (Option_t *option="")
	Reset this fill attributes to default values.
virtual void	SaveFillAttributes (std::ostream &out, const char *name, Int_t coldef=1, Int_t stydef=1001)
	Save fill attributes as C++ statement(s) on output stream out.
virtual void	SetFillAttributes ()
	Invoke the DialogCanvas Fill attributes.
virtual void	SetFillColor (Color_t fcolor)
	Set the fill area color.
virtual void	SetFillColorAlpha (Color_t fcolor, Float_t falpha)
	Set a transparent fill color.
virtual void	SetFillStyle (Style_t fstyle)
	Set the fill area style.
Public Member Functions inherited from TAttMarker
	TAttMarker ()
	TAttMarker default constructor.
	TAttMarker (Color_t color, Style_t style, Size_t msize)
	TAttMarker normal constructor.
virtual	~TAttMarker ()
	TAttMarker destructor.
void	Copy (TAttMarker &attmarker) const
	Copy this marker attributes to a new TAttMarker.
virtual Color_t	GetMarkerColor () const
	Return the marker color.
virtual Size_t	GetMarkerSize () const
	Return the marker size.
virtual Style_t	GetMarkerStyle () const
	Return the marker style.
virtual void	Modify ()
	Change current marker attributes if necessary.
virtual void	ResetAttMarker (Option_t *toption="")
	Reset this marker attributes to the default values.
virtual void	SaveMarkerAttributes (std::ostream &out, const char *name, Int_t coldef=1, Int_t stydef=1, Int_t sizdef=1)
	Save line attributes as C++ statement(s) on output stream out.
virtual void	SetMarkerAttributes ()
	Invoke the DialogCanvas Marker attributes.
virtual void	SetMarkerColor (Color_t mcolor=1)
	Set the marker color.
virtual void	SetMarkerColorAlpha (Color_t mcolor, Float_t malpha)
	Set a transparent marker color.
virtual void	SetMarkerSize (Size_t msize=1)
	Set the marker size.
virtual void	SetMarkerStyle (Style_t mstyle=1)
	Set the marker style.
Public Member Functions inherited from RooPlotable
	RooPlotable ()
virtual	~RooPlotable ()
TObject *	crossCast ()
	Return cast of RooPlotable as TObject.
const char *	getYAxisLabel () const
Double_t	getYAxisMax () const
Double_t	getYAxisMin () const
void	setYAxisLabel (const char *label)
void	setYAxisLimits (Double_t ymin, Double_t ymax)
void	updateYAxisLimits (Double_t y)
Public Member Functions inherited from RooPrintable
	RooPrintable ()
virtual	~RooPrintable ()
virtual Int_t	defaultPrintContents (Option_t *opt) const
	Default choice of contents to be printed (name and value)
virtual StyleOption	defaultPrintStyle (Option_t *opt) const
virtual void	printAddress (std::ostream &os) const
	Print class name of object.
virtual void	printArgs (std::ostream &os) const
	Interface for printing of object arguments.
virtual void	printExtras (std::ostream &os) const
	Interface to print extras of object.
virtual void	printStream (std::ostream &os, Int_t contents, StyleOption style, TString indent="") const
	Print description of object on ostream, printing contents set by contents integer, which is interpreted as an OR of 'enum ContentsOptions' values and in the style given by 'enum StyleOption'.
virtual void	printTree (std::ostream &os, TString indent="") const
	Interface for tree structure printing of object.
virtual void	printValue (std::ostream &os) const
	Interface to print value of object.

Protected Member Functions
void	initialize ()
	Perform common initialization for all constructors.
Int_t	roundBin (Double_t y)
	Return the nearest positive integer to the input value and print a warning if an adjustment is required.
Protected Member Functions inherited from TGraphAsymmErrors
virtual Double_t **	Allocate (Int_t size)
	Allocate internal data structures for size points.
virtual void	CopyAndRelease (Double_t **newarrays, Int_t ibegin, Int_t iend, Int_t obegin)
	Copy and release.
virtual Bool_t	CopyPoints (Double_t **arrays, Int_t ibegin, Int_t iend, Int_t obegin)
	Copy errors from fE*** to arrays[] or to f Copy points.
Bool_t	CtorAllocate ()
	Should be called from ctors after fNpoints has been set Note: This function should be called only from the constructor since it does not delete previously existing arrays.
virtual Bool_t	DoMerge (const TGraph *g)
	protected function to perform the merge operation of a graph with asymmetric errors
virtual void	FillZero (Int_t begin, Int_t end, Bool_t from_ctor=kTRUE)
	Set zero values for point arrays in the range [begin, end)
virtual void	SwapPoints (Int_t pos1, Int_t pos2)
	Swap points.
Protected Member Functions inherited from TGraph
Double_t **	AllocateArrays (Int_t Narrays, Int_t arraySize)
	Allocate arrays.
Bool_t	CtorAllocate ()
	In constructors set fNpoints than call this method.
Double_t **	ExpandAndCopy (Int_t size, Int_t iend)
	if size > fMaxSize allocate new arrays of 2*size points and copy iend first points.
Double_t **	ShrinkAndCopy (Int_t size, Int_t iend)
	if size*2 <= fMaxSize allocate new arrays of size points, copy points [0,oend).
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).
void	MakeZombie ()

Private Attributes
Double_t	_entries
Double_t	_nominalBinWidth
Double_t	_nSigma
Double_t	_rawEntries

Additional Inherited Members
Public Types inherited from TGraph
enum	EStatusBits {   kClipFrame = BIT(10) , kResetHisto = BIT(17) , kNotEditable = BIT(18) , kIsSortedX = BIT(19) ,   kIsHighlight = BIT(20) }
Public Types inherited from TObject
enum	{   kIsOnHeap = 0x01000000 , kNotDeleted = 0x02000000 , kZombie = 0x04000000 , kInconsistent = 0x08000000 ,   kBitMask = 0x00ffffff }
enum	{ kSingleKey = BIT(0) , kOverwrite = BIT(1) , kWriteDelete = BIT(2) }
enum	EDeprecatedStatusBits { kObjInCanvas = BIT(3) }
enum	EStatusBits {   kCanDelete = BIT(0) , kMustCleanup = BIT(3) , kIsReferenced = BIT(4) , kHasUUID = BIT(5) ,   kCannotPick = BIT(6) , kNoContextMenu = BIT(8) , kInvalidObject = BIT(13) }
Public Types inherited from RooPrintable
enum	ContentsOption {   kName =1 , kClassName =2 , kValue =4 , kArgs =8 ,   kExtras =16 , kAddress =32 , kTitle =64 , kCollectionHeader =128 }
enum	StyleOption {   kInline =1 , kSingleLine =2 , kStandard =3 , kVerbose =4 ,   kTreeStructure =5 }
Static Public Member Functions inherited from TGraph
static Bool_t	CompareArg (const TGraph *gr, Int_t left, Int_t right)
	Return kTRUE if point number "left"'s argument (angle with respect to positive x-axis) is bigger than that of point number "right".
static Bool_t	CompareRadius (const TGraph *gr, Int_t left, Int_t right)
	Return kTRUE if point number "left"'s distance to origin is bigger than that of point number "right".
static Bool_t	CompareX (const TGraph *gr, Int_t left, Int_t right)
	Return kTRUE if fX[left] > fX[right]. Can be used by Sort.
static Bool_t	CompareY (const TGraph *gr, Int_t left, Int_t right)
	Return kTRUE if fY[left] > fY[right]. Can be used by Sort.
Static Public Member Functions inherited from TObject
static Long_t	GetDtorOnly ()
	Return destructor only flag.
static Bool_t	GetObjectStat ()
	Get status of object stat flag.
static void	SetDtorOnly (void *obj)
	Set destructor only flag.
static void	SetObjectStat (Bool_t stat)
	Turn on/off tracking of objects in the TObjectTable.
Static Public Member Functions inherited from TAttMarker
static Width_t	GetMarkerLineWidth (Style_t style)
	Internal helper function that returns the line width of the given marker style (0 = filled marker)
static Style_t	GetMarkerStyleBase (Style_t style)
	Internal helper function that returns the corresponding marker style with line width 1 for the given style.
Static Public Member Functions inherited from RooPrintable
static std::ostream &	defaultPrintStream (std::ostream *os=0)
	Return a reference to the current default stream to use in Print().
static void	nameFieldLength (Int_t newLen)
	Set length of field reserved from printing name of RooAbsArgs in multi-line collection printing to given amount.
Protected Types inherited from TObject
enum	{ kOnlyPrepStep = BIT(3) }
Static Protected Member Functions inherited from TGraph
static void	SwapValues (Double_t *arr, Int_t pos1, Int_t pos2)
	Swap values.
Protected Attributes inherited from TGraphAsymmErrors
Double_t *	fEXhigh
	[fNpoints] array of X high errors
Double_t *	fEXlow
	[fNpoints] array of X low errors
Double_t *	fEYhigh
	[fNpoints] array of Y high errors
Double_t *	fEYlow
	[fNpoints] array of Y low errors
Protected Attributes inherited from TGraph
TList *	fFunctions
	Pointer to list of functions (fits and user)
TH1F *	fHistogram
	Pointer to histogram used for drawing axis.
Double_t	fMaximum
	Maximum value for plotting along y.
Int_t	fMaxSize
	!Current dimension of arrays fX and fY
Double_t	fMinimum
	Minimum value for plotting along y.
Int_t	fNpoints
	Number of points <= fMaxSize.
Double_t *	fX
	[fNpoints] array of X points
Double_t *	fY
	[fNpoints] array of Y points
Protected Attributes inherited from TNamed
TString	fName
TString	fTitle
Protected Attributes inherited from TAttLine
Color_t	fLineColor
	Line color.
Style_t	fLineStyle
	Line style.
Width_t	fLineWidth
	Line width.
Protected Attributes inherited from TAttFill
Color_t	fFillColor
	Fill area color.
Style_t	fFillStyle
	Fill area style.
Protected Attributes inherited from TAttMarker
Color_t	fMarkerColor
	Marker color.
Size_t	fMarkerSize
	Marker size.
Style_t	fMarkerStyle
	Marker style.
Protected Attributes inherited from RooPlotable
Double_t	_normValue
TString	_yAxisLabel
Double_t	_ymax
Double_t	_ymin
Static Protected Attributes inherited from RooPrintable
static Int_t	_nameLength

#include <RooHist.h>

Inheritance diagram for RooHist:

Constructor & Destructor Documentation

RooHist() [1/6]

RooHist::RooHist

(

)

Default constructor.

Definition at line 50 of file RooHist.cxx.

RooHist() [2/6]

RooHist::RooHist	(	Double_t	nominalBinWidth,
		Double_t	nSigma = 1,
		Double_t	xErrorFrac = 1.0,
		Double_t	scaleFactor = 1.0
	)

Create an empty histogram that can be filled with the addBin() and addAsymmetryBin() methods.

Use the optional parameter to specify the confidence level in units of sigma to use for calculating error bars. The nominal bin width specifies the default used by addBin(), and is used to set the relative normalization of bins with different widths.

Definition at line 68 of file RooHist.cxx.

RooHist() [3/6]

RooHist::RooHist	(	const TH1 &	data,
		Double_t	nominalBinWidth = 0,
		Double_t	nSigma = 1,
		RooAbsData::ErrorType	etype = RooAbsData::Poisson,
		Double_t	xErrorFrac = 1.0,
		Bool_t	correctForBinWidth = kTRUE,
		Double_t	scaleFactor = 1.
	)

Create a histogram from the contents of the specified TH1 object which may have fixed or variable bin widths.

Error bars are calculated using Poisson statistics. Prints a warning and rounds any bins with non-integer contents. Use the optional parameter to specify the confidence level in units of sigma to use for calculating error bars. The nominal bin width specifies the default used by addBin(), and is used to set the relative normalization of bins with different widths. If not set, the nominal bin width is calculated as range/nbins.

Definition at line 86 of file RooHist.cxx.

RooHist() [4/6]

RooHist::RooHist	(	const TH1 &	data1,
		const TH1 &	data2,
		Double_t	nominalBinWidth = 0,
		Double_t	nSigma = 1,
		RooAbsData::ErrorType	etype = RooAbsData::Poisson,
		Double_t	xErrorFrac = 1.0,
		Bool_t	efficiency = kFALSE,
		Double_t	scaleFactor = 1.0
	)

Create a histogram from the asymmetry between the specified TH1 objects which may have fixed or variable bin widths, but which must both have the same binning.

The asymmetry is calculated as (1-2)/(1+2). Error bars are calculated using Binomial statistics. Prints a warning and rounds any bins with non-integer contents. Use the optional parameter to specify the confidence level in units of sigma to use for calculating error bars. The nominal bin width specifies the default used by addAsymmetryBin(), and is used to set the relative normalization of bins with different widths. If not set, the nominal bin width is calculated as range/nbins.

Definition at line 133 of file RooHist.cxx.

RooHist() [5/6]

RooHist::RooHist	(	const RooHist &	hist1,
		const RooHist &	hist2,
		Double_t	wgt1 = 1.0,
		Double_t	wgt2 = 1.0,
		RooAbsData::ErrorType	etype = RooAbsData::Poisson,
		Double_t	xErrorFrac = 1.0
	)

Create histogram as sum of two existing histograms.

If Poisson errors are selected the histograms are added and Poisson confidence intervals are calculated for the summed content. If wgt1 and wgt2 are not 1 in this mode, a warning message is printed. If SumW2 errors are selected the histograms are added and the histograms errors are added in quadrature, taking the weights into account.

Definition at line 206 of file RooHist.cxx.

RooHist() [6/6]

RooHist::RooHist	(	const RooAbsReal &	f,
		RooAbsRealLValue &	x,
		Double_t	xErrorFrac = 1.0,
		Double_t	scaleFactor = 1.0,
		const RooArgSet *	normVars = 0,
		const RooFitResult *	fr = 0
	)

Create histogram from a pdf or function.

Errors are computed based on the fit result provided.

This signature is intended for unfolding/deconvolution scenarios, where a pdf is constructed as "data minus background" and is thus intended to be displayed as "data" (or at least data-like). Usage of this signature is triggered by the draw style "P" in RooAbsReal::plotOn.

More details.

Parameters

[in]	f	The function to be plotted.
[in]	x	The variable on the x-axis
[in]	xErrorFrac	Size of the errror in x as a fraction of the bin width
[in]	scaleFactor	arbitrary scaling of the y-values
[in]	normVars	variables over which to normalize

Definition at line 277 of file RooHist.cxx.

~RooHist()

RooHist::~RooHist ( )

virtual

Destructor.

Definition at line 623 of file RooHist.cxx.

Member Function Documentation

addAsymmetryBin()

void RooHist::addAsymmetryBin	(	Axis_t	binCenter,
		Int_t	n1,
		Int_t	n2,
		Double_t	binWidth = 0,
		Double_t	xErrorFrac = 1.0,
		Double_t	scaleFactor = 1.0
	)

Add a bin to this histogram with the value (n1-n2)/(n1+n2) using an error bar calculated with Binomial statistics.

Definition at line 517 of file RooHist.cxx.

addAsymmetryBinWithError()

void RooHist::addAsymmetryBinWithError	(	Axis_t	binCenter,
		Double_t	n1,
		Double_t	n2,
		Double_t	en1,
		Double_t	en2,
		Double_t	binWidth = 0,
		Double_t	xErrorFrac = 1.0,
		Double_t	scaleFactor = 1.0
	)

Add a bin to this histogram with the value (n1-n2)/(n1+n2) using an error bar calculated with Binomial statistics.

Definition at line 543 of file RooHist.cxx.

addBin()

void RooHist::addBin	(	Axis_t	binCenter,
		Double_t	n,
		Double_t	binWidth = 0,
		Double_t	xErrorFrac = 1.0,
		Double_t	scaleFactor = 1.0
	)

Add a bin to this histogram with the specified integer bin contents and using an error bar calculated with Poisson statistics.

The bin width is used to set the relative scale of bins with different widths.

Definition at line 422 of file RooHist.cxx.

addBinWithError()

void RooHist::addBinWithError	(	Axis_t	binCenter,
		Double_t	n,
		Double_t	elow,
		Double_t	ehigh,
		Double_t	binWidth = 0,
		Double_t	xErrorFrac = 1.0,
		Bool_t	correctForBinWidth = kTRUE,
		Double_t	scaleFactor = 1.0
	)

Add a bin to this histogram with the specified bin contents and error.

The bin width is used to set the relative scale of bins with different widths.

Definition at line 472 of file RooHist.cxx.

addBinWithXYError()

void RooHist::addBinWithXYError	(	Axis_t	binCenter,
		Double_t	n,
		Double_t	exlow,
		Double_t	exhigh,
		Double_t	eylow,
		Double_t	eyhigh,
		Double_t	scaleFactor = 1.0
	)

Add a bin to this histogram with the specified bin contents and error.

The bin width is used to set the relative scale of bins with different widths.

Definition at line 497 of file RooHist.cxx.

addEfficiencyBin()

void RooHist::addEfficiencyBin	(	Axis_t	binCenter,
		Int_t	n1,
		Int_t	n2,
		Double_t	binWidth = 0,
		Double_t	xErrorFrac = 1.0,
		Double_t	scaleFactor = 1.0
	)

Add a bin to this histogram with the value n1/(n1+n2) using an error bar calculated with Binomial statistics.

Definition at line 569 of file RooHist.cxx.

addEfficiencyBinWithError()

void RooHist::addEfficiencyBinWithError	(	Axis_t	binCenter,
		Double_t	n1,
		Double_t	n2,
		Double_t	en1,
		Double_t	en2,
		Double_t	binWidth = 0,
		Double_t	xErrorFrac = 1.0,
		Double_t	scaleFactor = 1.0
	)

Add a bin to this histogram with the value n1/(n1+n2) using an error bar calculated with Binomial statistics.

Definition at line 596 of file RooHist.cxx.

getFitRangeBinW()

Double_t RooHist::getFitRangeBinW ( ) const

virtual

Return (average) bin width of this RooHist.

Implements RooPlotable.

Definition at line 391 of file RooHist.cxx.

getFitRangeNEvt() [1/2]

Double_t RooHist::getFitRangeNEvt ( ) const

virtual

Return the number of events of the dataset associated with this RooHist.

This is the number of events in the RooHist itself, unless a different value was specified through setRawEntries()

Implements RooPlotable.

Definition at line 351 of file RooHist.cxx.

getFitRangeNEvt() [2/2]

Double_t RooHist::getFitRangeNEvt ( Double_t  xlo, Double_t  xhi  ) const

virtual

Calculate integral of histogram in given range.

Implements RooPlotable.

Definition at line 360 of file RooHist.cxx.

getNominalBinWidth()

Double_t RooHist::getNominalBinWidth ( ) const

inline

Definition at line 71 of file RooHist.h.

hasIdenticalBinning()

Bool_t RooHist::hasIdenticalBinning

(

const RooHist &

other

)

const

Return kTRUE if binning of this RooHist is identical to that of 'other'.

Definition at line 632 of file RooHist.cxx.

initialize()

void RooHist::initialize ( )

protected

Perform common initialization for all constructors.

Definition at line 339 of file RooHist.cxx.

isIdentical()

Bool_t RooHist::isIdentical	(	const RooHist &	other,
		Double_t	tol = 1e-6
	)		const

Return kTRUE if contents of this RooHist is identical within given relative tolerance to that of 'other'.

Definition at line 662 of file RooHist.cxx.

makePullHist()

RooHist * RooHist::makePullHist ( const RooCurve &  curve, bool  useAverage = false  ) const

inline

Definition at line 77 of file RooHist.h.

makeResidHist()

RooHist * RooHist::makeResidHist	(	const RooCurve &	curve,
		bool	normalize = false,
		bool	useAverage = false
	)		const

Create and return RooHist containing residuals w.r.t to given curve.

If normalize is true, the residuals are normalized by the histogram errors creating a RooHist with pull values

Definition at line 750 of file RooHist.cxx.

Print()

virtual void RooHist::Print ( Option_t *  chopt = 0 ) const

inlinevirtual

Print graph and errors values.

Reimplemented from TGraphAsymmErrors.

Definition at line 63 of file RooHist.h.

printClassName()

void RooHist::printClassName ( std::ostream &  os ) const

virtual

Print class name of RooHist.

Reimplemented from RooPrintable.

Definition at line 738 of file RooHist.cxx.

printMultiline()

void RooHist::printMultiline ( std::ostream &  os, Int_t  contents, Bool_t  verbose = kFALSE, TString  indent = ""  ) const

virtual

Print info about this histogram to the specified output stream.

Standard: number of entries Shape: error CL and maximum value Verbose: print our bin contents and errors

Reimplemented from RooPlotable.

Definition at line 694 of file RooHist.cxx.

printName()

void RooHist::printName ( std::ostream &  os ) const

virtual

Print name of RooHist.

Reimplemented from RooPrintable.

Definition at line 718 of file RooHist.cxx.

printTitle()

void RooHist::printTitle ( std::ostream &  os ) const

virtual

Print title of RooHist.

Reimplemented from RooPrintable.

Definition at line 728 of file RooHist.cxx.

roundBin()

Int_t RooHist::roundBin ( Double_t  y )

protected

Return the nearest positive integer to the input value and print a warning if an adjustment is required.

Definition at line 402 of file RooHist.cxx.

setRawEntries()

void RooHist::setRawEntries ( Double_t  n )

inline

Definition at line 72 of file RooHist.h.

Member Data Documentation

_entries

Double_t RooHist::_entries

private

Definition at line 91 of file RooHist.h.

_nominalBinWidth

Double_t RooHist::_nominalBinWidth

private

Definition at line 89 of file RooHist.h.

_nSigma

Double_t RooHist::_nSigma

private

Definition at line 90 of file RooHist.h.

_rawEntries

Double_t RooHist::_rawEntries

private

Definition at line 92 of file RooHist.h.

Libraries for RooHist:

---

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

• roofit/roofitcore/inc/RooHist.h
• roofit/roofitcore/src/RooHist.cxx