A RooPlot is a plot frame and a container for graphics objects within that frame.

As a frame, it provides the TH1-style public interface for settting plot ranges, configuring axes, etc. As a container, it holds an arbitrary set of objects that might be histograms of data, curves representing a fit model, or text labels. Use the Draw() method to draw a frame and the objects it contains. Use the various add...() methods to add objects to be drawn. In general, the add...() methods create a private copy of the object you pass them and return a pointer to this copy. The caller owns the input object and this class owns the returned object. All RooAbsReal and RooAbsData derived classes implement plotOn() functions that facilitate to plot themselves on a given RooPlot, e.g.

RooPlot *frame = x.frame() ;
data.plotOn(frame) ;
pdf.plotOn(frame) ;

These high level functions also take care of any projections or other mappings that need to be made to plot a multi-dimensional object onto a one-dimensional plot.

Definition at line 41 of file RooPlot.h.

Classes
class	DrawOpt

Public Member Functions
	RooPlot ()
	Default constructor coverity[UNINIT_CTOR]. More...

	RooPlot (const char name, const char title, const RooAbsRealLValue &var, Double_t xmin, Double_t xmax, Int_t nBins)
	Create an 1-dimensional with all properties taken from 'var', but with an explicit range [xmin,xmax] and a default binning of 'nbins'. More...

	RooPlot (const RooAbsRealLValue &var, Double_t xmin, Double_t xmax, Int_t nBins)
	Create an 1-dimensional with all properties taken from 'var', but with an explicit range [xmin,xmax] and a default binning of 'nbins'. More...

	RooPlot (Double_t xmin, Double_t xmax)
	Constructor of RooPlot with range [xmin,xmax]. More...

	RooPlot (Double_t xmin, Double_t xmax, Double_t ymin, Double_t ymax)
	Construct of a two-dimensioanl RooPlot with ranges [xmin,xmax] x [ymin,ymax]. More...

	RooPlot (const RooAbsRealLValue &var1, const RooAbsRealLValue &var2)
	Construct a two-dimensional RooPlot with ranges and properties taken from variables var1 and var2. More...

	RooPlot (const RooAbsRealLValue &var1, const RooAbsRealLValue &var2, Double_t xmin, Double_t xmax, Double_t ymin, Double_t ymax)
	Construct a two-dimensional RooPlot with ranges and properties taken from variables var1 and var2 but with an overriding range definition of [xmin,xmax] x [ymin,ymax]. More...

virtual	~RooPlot ()
	Destructor. More...

void	addObject (TObject obj, Option_t drawOptions="", Bool_t invisible=kFALSE)
	Add a generic object to this plot. More...

void	addPlotable (RooPlotable plotable, Option_t drawOptions="", Bool_t invisible=kFALSE, Bool_t refreshNorm=kFALSE)
	Add the specified plotable object to our plot. More...

void	addTH1 (TH1 hist, Option_t drawOptions="", Bool_t invisible=kFALSE)
	Add a TH1 histogram object to this plot. More...

void	Browse (TBrowser *b)
	Plot RooPlot when double-clicked in browser. More...

Double_t	chiSquare (int nFitParam=0) const

Double_t	chiSquare (const char pdfname, const char histname, int nFitParam=0) const
	Calculate and return reduced chi-squared of curve with given name with respect to histogram with given name. More...

virtual Int_t	defaultPrintContents (Option_t *opt) const
	Define default print options, for a given print style. More...

virtual void	Draw (Option_t *options=0)
	Draw this plot and all of the elements it contains. More...

Bool_t	drawAfter (const char after, const char target)
	Change the order in which our contained objects are drawn so that the target object is drawn just after the specified object. More...

Bool_t	drawBefore (const char before, const char target)
	Change the order in which our contained objects are drawn so that the target object is drawn just before the specified object. More...

RooPlot *	emptyClone (const char *name)
	Return empty clone of current RooPlot. More...

TObject *	findObject (const char name, const TClass clas=0) const
	Find the named object in our list of items and return a pointer to it. More...

TAttFill *	getAttFill (const char *name=0) const
	Return a pointer to the fill attributes of the named object in this plot, or zero if the named object does not exist or does not have fill attributes. More...

TAttLine *	getAttLine (const char *name=0) const
	Return a pointer to the line attributes of the named object in this plot, or zero if the named object does not exist or does not have line attributes. More...

TAttMarker *	getAttMarker (const char *name=0) const
	Return a pointer to the marker attributes of the named object in this plot, or zero if the named object does not exist or does not have marker attributes. More...

TAttText *	getAttText (const char *name=0) const
	Return a pointer to the text attributes of the named object in this plot, or zero if the named object does not exist or does not have text attributes. More...

virtual Stat_t	GetBinContent (Int_t) const
	A plot object is a frame without any bin contents of its own so this method always returns zero. More...

virtual Stat_t	GetBinContent (Int_t, Int_t) const
	A plot object is a frame without any bin contents of its own so this method always returns zero. More...

virtual Stat_t	GetBinContent (Int_t, Int_t, Int_t) const
	A plot object is a frame without any bin contents of its own so this method always returns zero. More...

RooCurve *	getCurve (const char *name=0) const
	Return a RooCurve pointer of the named object in this plot, or zero if the named object does not exist or is not a RooCurve. More...

TString	getDrawOptions (const char *name) const
	Return the Draw() options registered for the named object. More...

Double_t	getFitRangeBinW () const

Double_t	getFitRangeNEvt () const

Double_t	getFitRangeNEvt (Double_t xlo, Double_t xhi) const
	Return the number of events that is associated with the range [xlo,xhi] This method is only fully functional for ranges not equal to the full range if the object that inserted the normalization data provided a link to an external object that can calculate the event count in in sub ranges. More...

RooHist *	getHist (const char *name=0) const
	Return a RooCurve pointer of the named object in this plot, or zero if the named object does not exist or is not a RooCurve. More...

Bool_t	getInvisible (const char *name) const
	Returns true of object with given name is set to be invisible. More...

Double_t	GetMaximum (Double_t maxval=FLT_MAX) const

Double_t	GetMinimum (Double_t minval=-FLT_MAX) const

Int_t	GetNbinsX () const

Int_t	GetNdivisions (Option_t *axis="X") const

const RooArgSet *	getNormVars () const

TObject *	getObject (Int_t idx) const
	Return the name of the object at slot 'idx' in this RooPlot. More...

Double_t	getPadFactor () const

RooAbsRealLValue *	getPlotVar () const

TAxis *	GetXaxis () const

TAxis *	GetYaxis () const

const char *	nameOf (Int_t idx) const
	Return the name of the object at slot 'idx' in this RooPlot. More...

Stat_t	numItems () const

virtual void	Print (Option_t *options=0) const
	Print TNamed name and title. More...

virtual void	printArgs (std::ostream &os) const
	Interface for printing of object arguments. More...

virtual void	printClassName (std::ostream &os) const
	Print frame class name. More...

virtual void	printMultiline (std::ostream &os, Int_t content, Bool_t verbose=kFALSE, TString indent="") const
	Frame detailed printing. More...

virtual void	printName (std::ostream &os) const
	Print frame name. More...

virtual void	printTitle (std::ostream &os) const
	Print frame title. More...

virtual void	printValue (std::ostream &os) const
	Print frame arguments. More...

RooHist *	pullHist (const char histname=0, const char pdfname=0, bool useAverage=false) const

void	remove (const char *name=0, Bool_t deleteToo=kTRUE)
	Remove object with given name, or last object added if no name is given. More...

RooHist *	residHist (const char histname=0, const char pdfname=0, bool normalize=false, bool useAverage=kFALSE) const
	Return a RooHist containing the residuals of histogram 'histname' with respect to curve 'curvename'. More...

void	SetAxisColor (Color_t color=1, Option_t *axis="X")

void	SetAxisRange (Double_t xmin, Double_t xmax, Option_t *axis="X")

void	SetBarOffset (Float_t offset=0.25)

void	SetBarWidth (Float_t width=0.5)

void	SetContour (Int_t nlevels, const Double_t *levels=0)

void	SetContourLevel (Int_t level, Double_t value)

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

Bool_t	setDrawOptions (const char *name, TString options)
	Register the specified drawing options for the named object. More...

void	SetFillAttributes ()

void	SetFillColor (Color_t fcolor)

void	SetFillStyle (Style_t fstyle)

void	setInvisible (const char *name, Bool_t flag=kTRUE)
	If flag is true object with 'name' is set to be invisible i.e. More...

void	SetLabelColor (Color_t color=1, Option_t *axis="X")

void	SetLabelFont (Style_t font=62, Option_t *axis="X")

void	SetLabelOffset (Float_t offset=0.005, Option_t *axis="X")

void	SetLabelSize (Float_t size=0.02, Option_t *axis="X")

void	SetLineAttributes ()

void	SetLineColor (Color_t lcolor)

void	SetLineStyle (Style_t lstyle)

void	SetLineWidth (Width_t lwidth)

void	SetMarkerAttributes ()

void	SetMarkerColor (Color_t tcolor=1)

void	SetMarkerSize (Size_t msize=1)

void	SetMarkerStyle (Style_t mstyle=1)

virtual void	SetMaximum (Double_t maximum=-1111)
	Set maximum value of Y axis. More...

virtual void	SetMinimum (Double_t minimum=-1111)
	Set minimum value of Y axis. More...

void	SetName (const char *name)
	Set the name of the RooPlot to 'name'. More...

void	SetNameTitle (const char name, const char title)
	Set the name and title of the RooPlot to 'name' and 'title'. More...

void	SetNdivisions (Int_t n=510, Option_t *axis="X")

void	SetOption (Option_t *option=" ")

void	setPadFactor (Double_t factor)

void	SetStats (Bool_t stats=kTRUE)

void	SetTickLength (Float_t length=0.02, Option_t *axis="X")

void	SetTitle (const char *name)
	Set the title of the RooPlot to 'title'. More...

void	SetTitleFont (Style_t font=62, Option_t *axis="X")

void	SetTitleOffset (Float_t offset=1, Option_t *axis="X")

void	SetTitleSize (Float_t size=0.02, Option_t *axis="X")

void	SetXTitle (const char *title)

void	SetYTitle (const char *title)

void	SetZTitle (const char *title)

void	updateNormVars (const RooArgSet &vars)
	Install the given set of observables are reference normalization variables for this frame. More...

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 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 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	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 selected pad for instance with: `gROOT->SetSelectedPad(gPad)`. 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	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...

Public Member Functions inherited from RooPrintable
	RooPrintable ()

virtual	~RooPrintable ()

virtual StyleOption	defaultPrintStyle (Option_t *opt) const

virtual void	printAddress (std::ostream &os) const
	Print class name of object. More...

virtual void	printExtras (std::ostream &os) const
	Interface to print extras of object. More...

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'. More...

virtual void	printTree (std::ostream &os, TString indent="") const
	Interface for tree structure printing of object. More...

Static Public Member Functions
static Bool_t	addDirectoryStatus ()

static Bool_t	setAddDirectoryStatus (Bool_t flag)

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...

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(). More...

static void	nameFieldLength (Int_t newLen)
	Set length of field reserved from printing name of RooAbsArgs in multi-line collection printing to given amount. More...

Protected Member Functions
	RooPlot (const RooPlot &other)

TString	caller (const char *method) const
	Utility function. More...

TString	histName () const
	Construct automatic name of internal TH1. More...

void	initialize ()
	Perform initialization that is common to all constructors. More...

void	updateFitRangeNorm (const TH1 *hist)
	Update our plot normalization over our plot variable's fit range, which will be determined by the first suitable object added to our plot. More...

void	updateFitRangeNorm (const RooPlotable *rp, Bool_t refeshNorm=kFALSE)
	Update our plot normalization over our plot variable's fit range, which will be determined by the first suitable object added to our plot. More...

void	updateYAxis (Double_t ymin, Double_t ymax, const char *label="")
	Update our y-axis limits to accomodate an object whose spread in y is (ymin,ymax). More...

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
Double_t	_defYmax

Double_t	_defYmin
	non-persistent More...

TDirectory *	_dir

TH1 *	_hist

RooList	_items

TIterator *	_iterator

Double_t	_normBinWidth

Double_t	_normNumEvts
	Pointer to normalization object ;. More...

const RooPlotable *	_normObj

RooArgSet *	_normVars

Double_t	_padFactor

RooAbsRealLValue *	_plotVarClone

RooArgSet *	_plotVarSet

Protected Attributes inherited from TNamed
TString	fName

TString	fTitle

Static Protected Attributes
static Bool_t	_addDirStatus = kTRUE
	non-persistent More...

Static Protected Attributes inherited from RooPrintable
static Int_t	_nameLength

Additional Inherited Members
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 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 }

#include <RooPlot.h>

Inheritance diagram for RooPlot:

[legend]

Constructor & Destructor Documentation

◆ RooPlot() [1/8]

RooPlot::RooPlot ( )

Default constructor coverity[UNINIT_CTOR].

Definition at line 87 of file RooPlot.cxx.

◆ RooPlot() [2/8]

RooPlot::RooPlot	(	const char *	name,
		const char *	title,
		const RooAbsRealLValue &	var,
		Double_t	xmin,
		Double_t	xmax,
		Int_t	nBins
	)

Create an 1-dimensional with all properties taken from 'var', but with an explicit range [xmin,xmax] and a default binning of 'nbins'.

Definition at line 211 of file RooPlot.cxx.

◆ RooPlot() [3/8]

RooPlot::RooPlot	(	const RooAbsRealLValue &	var,
		Double_t	xmin,
		Double_t	xmax,
		Int_t	nBins
	)

Create an 1-dimensional with all properties taken from 'var', but with an explicit range [xmin,xmax] and a default binning of 'nbins'.

Definition at line 241 of file RooPlot.cxx.

◆ RooPlot() [4/8]

RooPlot::RooPlot	(	Double_t	xmin,
		Double_t	xmax
	)

Constructor of RooPlot with range [xmin,xmax].

Definition at line 101 of file RooPlot.cxx.

◆ RooPlot() [5/8]

RooPlot::RooPlot	(	Double_t	xmin,
		Double_t	xmax,
		Double_t	ymin,
		Double_t	ymax
	)

Construct of a two-dimensioanl RooPlot with ranges [xmin,xmax] x [ymin,ymax].

Definition at line 126 of file RooPlot.cxx.

◆ RooPlot() [6/8]

RooPlot::RooPlot	(	const RooAbsRealLValue &	var1,
		const RooAbsRealLValue &	var2
	)

Construct a two-dimensional RooPlot with ranges and properties taken from variables var1 and var2.

Definition at line 149 of file RooPlot.cxx.

◆ RooPlot() [7/8]

RooPlot::RooPlot	(	const RooAbsRealLValue &	var1,
		const RooAbsRealLValue &	var2,
		Double_t	xmin,
		Double_t	xmax,
		Double_t	ymin,
		Double_t	ymax
	)

Construct a two-dimensional RooPlot with ranges and properties taken from variables var1 and var2 but with an overriding range definition of [xmin,xmax] x [ymin,ymax].

Definition at line 185 of file RooPlot.cxx.

◆ ~RooPlot()

RooPlot::~RooPlot ( )

virtual

Destructor.

Definition at line 325 of file RooPlot.cxx.

◆ RooPlot() [8/8]

RooPlot::RooPlot ( const RooPlot & other )

protected

Member Function Documentation

◆ addDirectoryStatus()

Bool_t RooPlot::addDirectoryStatus ( )

static

Definition at line 79 of file RooPlot.cxx.

◆ addObject()

void RooPlot::addObject	(	TObject *	obj,
		Option_t *	drawOptions = `""`,
		Bool_t	invisible = `kFALSE`
	)

Add a generic object to this plot.

The specified options will be used to Draw() this object later. The caller transfers ownership of the object with this call, and the object will be deleted when its containing plot object is destroyed.

Definition at line 392 of file RooPlot.cxx.

◆ addPlotable()

void RooPlot::addPlotable	(	RooPlotable *	plotable,
		Option_t *	drawOptions = `""`,
		Bool_t	invisible = `kFALSE`,
		Bool_t	refreshNorm = `kFALSE`
	)

Add the specified plotable object to our plot.

Increase our y-axis limits to fit this object if necessary. The default lower-limit is zero unless we are plotting an object that takes on negative values. This call transfers ownership of the plotable object to this class. The plotable object will be deleted when this plot object is deleted.

Definition at line 447 of file RooPlot.cxx.

◆ addTH1()

void RooPlot::addTH1	(	TH1 *	hist,
		Option_t *	drawOptions = `""`,
		Bool_t	invisible = `kFALSE`
	)

Add a TH1 histogram object to this plot.

The specified options will be used to Draw() this object later. "SAME" will be added to the options if they are not already present. The caller transfers ownership of the object with this call, and the object will be deleted when its containing plot object is destroyed.

Definition at line 411 of file RooPlot.cxx.

◆ Browse()

void RooPlot::Browse ( TBrowser * b )

virtual

Plot RooPlot when double-clicked in browser.

Reimplemented from TObject.

Definition at line 1164 of file RooPlot.cxx.

◆ caller()

TString RooPlot::caller ( const char * method ) const

protected

Utility function.

Definition at line 934 of file RooPlot.cxx.

◆ chiSquare() [1/2]

Double_t RooPlot::chiSquare ( int nFitParam = 0 ) const

inline

Definition at line 166 of file RooPlot.h.

◆ chiSquare() [2/2]

Double_t RooPlot::chiSquare	(	const char *	curvename,
		const char *	histname,
		int	nFitParam = `0`
	)		const

Calculate and return reduced chi-squared of curve with given name with respect to histogram with given name.

If nFitParam is non-zero, it is used to reduce the number of degrees of freedom for a chi^2 for a curve that was fitted to the data with that number of floating parameters

Definition at line 972 of file RooPlot.cxx.

◆ defaultPrintContents()

Int_t RooPlot::defaultPrintContents ( Option_t * opt ) const

virtual

Define default print options, for a given print style.

Reimplemented from RooPrintable.

Definition at line 1110 of file RooPlot.cxx.

◆ Draw()

void RooPlot::Draw ( Option_t * option = 0 )

virtual

Draw this plot and all of the elements it contains.

The specified options only apply to the drawing of our frame. The options specified in our add...() methods will be used to draw each object we contain.

Reimplemented from TObject.

Definition at line 559 of file RooPlot.cxx.

◆ drawAfter()

Bool_t RooPlot::drawAfter	(	const char *	after,
		const char *	target
	)

Change the order in which our contained objects are drawn so that the target object is drawn just after the specified object.

Returns kFALSE if either object does not exist.

Definition at line 833 of file RooPlot.cxx.

◆ drawBefore()

Bool_t RooPlot::drawBefore	(	const char *	before,
		const char *	target
	)

Change the order in which our contained objects are drawn so that the target object is drawn just before the specified object.

Returns kFALSE if either object does not exist.

Definition at line 822 of file RooPlot.cxx.

◆ emptyClone()

RooPlot * RooPlot::emptyClone ( const char * name )

Return empty clone of current RooPlot.

Definition at line 275 of file RooPlot.cxx.

◆ findObject()

TObject * RooPlot::findObject	(	const char *	name,
		const TClass *	clas = `0`
	)		const

Find the named object in our list of items and return a pointer to it.

Return zero and print a warning message if the named object cannot be found. If no name is supplied the last object added is returned.

Note that the returned pointer is to a TObject and so will generally need casting. Use the getAtt...() methods to change the drawing style attributes of a contained object directly.

Definition at line 850 of file RooPlot.cxx.

◆ getAttFill()

TAttFill * RooPlot::getAttFill ( const char * name = 0 ) const

Return a pointer to the fill attributes of the named object in this plot, or zero if the named object does not exist or does not have fill attributes.

Definition at line 744 of file RooPlot.cxx.

◆ getAttLine()

TAttLine * RooPlot::getAttLine ( const char * name = 0 ) const

Return a pointer to the line attributes of the named object in this plot, or zero if the named object does not exist or does not have line attributes.

Definition at line 734 of file RooPlot.cxx.

◆ getAttMarker()

TAttMarker * RooPlot::getAttMarker ( const char * name = 0 ) const

Return a pointer to the marker attributes of the named object in this plot, or zero if the named object does not exist or does not have marker attributes.

Definition at line 754 of file RooPlot.cxx.

◆ getAttText()

TAttText * RooPlot::getAttText ( const char * name = 0 ) const

Return a pointer to the text attributes of the named object in this plot, or zero if the named object does not exist or does not have text attributes.

Definition at line 764 of file RooPlot.cxx.

◆ GetBinContent() [1/3]

Stat_t RooPlot::GetBinContent ( Int_t ) const

virtual

A plot object is a frame without any bin contents of its own so this method always returns zero.

Definition at line 360 of file RooPlot.cxx.

◆ GetBinContent() [2/3]

Stat_t RooPlot::GetBinContent	(	Int_t	,
		Int_t
	)		const

virtual

A plot object is a frame without any bin contents of its own so this method always returns zero.

Definition at line 369 of file RooPlot.cxx.

◆ GetBinContent() [3/3]

Stat_t RooPlot::GetBinContent	(	Int_t	,
		Int_t	,
		Int_t
	)		const

virtual

A plot object is a frame without any bin contents of its own so this method always returns zero.

Definition at line 379 of file RooPlot.cxx.

◆ getCurve()

RooCurve * RooPlot::getCurve ( const char * name = 0 ) const

Return a RooCurve pointer of the named object in this plot, or zero if the named object does not exist or is not a RooCurve.

Definition at line 775 of file RooPlot.cxx.

◆ getDrawOptions()

TString RooPlot::getDrawOptions ( const char * name ) const

Return the Draw() options registered for the named object.

Return an empty string if the named object cannot be found.

Definition at line 875 of file RooPlot.cxx.

◆ getFitRangeBinW()

Double_t RooPlot::getFitRangeBinW ( ) const

inline

Definition at line 135 of file RooPlot.h.

◆ getFitRangeNEvt() [1/2]

Double_t RooPlot::getFitRangeNEvt ( ) const

inline

Definition at line 133 of file RooPlot.h.

◆ getFitRangeNEvt() [2/2]

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

Return the number of events that is associated with the range [xlo,xhi] This method is only fully functional for ranges not equal to the full range if the object that inserted the normalization data provided a link to an external object that can calculate the event count in in sub ranges.

An error will be printed if this function is used on sub-ranges while that information is not available

Definition at line 1061 of file RooPlot.cxx.

◆ getHist()

RooHist * RooPlot::getHist ( const char * name = 0 ) const

Return a RooCurve pointer of the named object in this plot, or zero if the named object does not exist or is not a RooCurve.

Definition at line 785 of file RooPlot.cxx.

◆ getInvisible()

Bool_t RooPlot::getInvisible ( const char * name ) const

Returns true of object with given name is set to be invisible.

Definition at line 902 of file RooPlot.cxx.

◆ GetMaximum()

Double_t RooPlot::GetMaximum ( Double_t maxval = FLT_MAX ) const

Definition at line 1122 of file RooPlot.cxx.

◆ GetMinimum()

Double_t RooPlot::GetMinimum ( Double_t minval = -FLT_MAX ) const

Definition at line 1121 of file RooPlot.cxx.

◆ GetNbinsX()

Int_t RooPlot::GetNbinsX ( ) const

Definition at line 1119 of file RooPlot.cxx.

◆ GetNdivisions()

Int_t RooPlot::GetNdivisions ( Option_t * axis = "X" ) const

Definition at line 1120 of file RooPlot.cxx.

◆ getNormVars()

const RooArgSet* RooPlot::getNormVars ( ) const

inline

Definition at line 139 of file RooPlot.h.

◆ getObject()

TObject * RooPlot::getObject ( Int_t idx ) const

Return the name of the object at slot 'idx' in this RooPlot.

If the given index is out of range, return a null pointer

Definition at line 718 of file RooPlot.cxx.

◆ getPadFactor()

Double_t RooPlot::getPadFactor ( ) const

inline

Definition at line 136 of file RooPlot.h.

◆ getPlotVar()

RooAbsRealLValue* RooPlot::getPlotVar ( ) const

inline

Definition at line 132 of file RooPlot.h.

◆ GetXaxis()

TAxis * RooPlot::GetXaxis ( ) const

Definition at line 1117 of file RooPlot.cxx.

◆ GetYaxis()

TAxis * RooPlot::GetYaxis ( ) const

Definition at line 1118 of file RooPlot.cxx.

◆ histName()

TString RooPlot::histName ( ) const

protected

Construct automatic name of internal TH1.

Definition at line 312 of file RooPlot.cxx.

◆ initialize()

void RooPlot::initialize ( void )

protected

Perform initialization that is common to all constructors.

Definition at line 286 of file RooPlot.cxx.

◆ nameOf()

const char * RooPlot::nameOf ( Int_t idx ) const

Return the name of the object at slot 'idx' in this RooPlot.

If the given index is out of range, return a null pointer

Definition at line 702 of file RooPlot.cxx.

◆ numItems()

Stat_t RooPlot::numItems ( ) const

inline

Definition at line 109 of file RooPlot.h.

◆ Print()

virtual void RooPlot::Print ( Option_t * option = 0 ) const

inlinevirtual

Print TNamed name and title.

Reimplemented from TNamed.

Definition at line 127 of file RooPlot.h.

◆ printArgs()

void RooPlot::printArgs ( std::ostream & os ) const

virtual

Interface for printing of object arguments.

Arguments are loosely defined as external server objects in this context

Reimplemented from RooPrintable.

Definition at line 619 of file RooPlot.cxx.

◆ printClassName()

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

virtual

Print frame class name.

Reimplemented from RooPrintable.

Definition at line 610 of file RooPlot.cxx.

◆ printMultiline()

void RooPlot::printMultiline	(	std::ostream &	os,
		Int_t	content,
		Bool_t	verbose = `kFALSE`,
		TString	indent = `""`
	)		const

virtual

Frame detailed printing.

Reimplemented from RooPrintable.

Definition at line 662 of file RooPlot.cxx.

◆ printName()

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

virtual

Print frame name.

Reimplemented from RooPrintable.

Definition at line 592 of file RooPlot.cxx.

◆ printTitle()

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

virtual

Print frame title.

Reimplemented from RooPrintable.

Definition at line 601 of file RooPlot.cxx.

◆ printValue()

void RooPlot::printValue ( std::ostream & os ) const

virtual

Print frame arguments.

Reimplemented from RooPrintable.

Definition at line 633 of file RooPlot.cxx.

◆ pullHist()

RooHist* RooPlot::pullHist	(	const char *	histname = `0`,
		const char *	pdfname = `0`,
		bool	useAverage = `false`
	)		const

inline

Definition at line 170 of file RooPlot.h.

◆ remove()

void RooPlot::remove	(	const char *	name = `0`,
		Bool_t	deleteToo = `kTRUE`
	)

Remove object with given name, or last object added if no name is given.

If deleteToo is true (default), the object removed from the RooPlot is also deleted.

Definition at line 797 of file RooPlot.cxx.

◆ residHist()

RooHist * RooPlot::residHist	(	const char *	histname = `0`,
		const char *	curvename = `0`,
		bool	normalize = `false`,
		bool	useAverage = `kFALSE`
	)		const

Return a RooHist containing the residuals of histogram 'histname' with respect to curve 'curvename'.

If normalize is true the residuals are divided by the error on the histogram, effectively returning a pull histogram

Definition at line 998 of file RooPlot.cxx.

◆ setAddDirectoryStatus()

Bool_t RooPlot::setAddDirectoryStatus ( Bool_t flag )

static

Definition at line 80 of file RooPlot.cxx.

◆ SetAxisColor()

void RooPlot::SetAxisColor	(	Color_t	color = `1`,
		Option_t *	axis = `"X"`
	)

Definition at line 1125 of file RooPlot.cxx.

◆ SetAxisRange()

void RooPlot::SetAxisRange	(	Double_t	xmin,
		Double_t	xmax,
		Option_t *	axis = `"X"`
	)

Definition at line 1126 of file RooPlot.cxx.

◆ SetBarOffset()

void RooPlot::SetBarOffset ( Float_t offset = 0.25 )

Definition at line 1127 of file RooPlot.cxx.

◆ SetBarWidth()

void RooPlot::SetBarWidth ( Float_t width = 0.5 )

Definition at line 1128 of file RooPlot.cxx.

◆ SetContour()

void RooPlot::SetContour	(	Int_t	nlevels,
		const Double_t *	levels = `0`
	)

Definition at line 1129 of file RooPlot.cxx.

◆ SetContourLevel()

void RooPlot::SetContourLevel	(	Int_t	level,
		Double_t	value
	)

Definition at line 1130 of file RooPlot.cxx.

◆ SetDrawOption()

void RooPlot::SetDrawOption ( Option_t * option = "" )

virtual

Set drawing option for object.

This option only affects the drawing style and is stored in the option field of the TObjOptLink supporting a TPad's primitive list (TList). Note that it does not make sense to call object.SetDrawOption(option) before having called object.Draw().

Reimplemented from TObject.

Definition at line 1131 of file RooPlot.cxx.

◆ setDrawOptions()

Bool_t RooPlot::setDrawOptions	(	const char *	name,
		TString	options
	)

Register the specified drawing options for the named object.

Return kFALSE if the named object cannot be found.

Definition at line 887 of file RooPlot.cxx.

◆ SetFillAttributes()

void RooPlot::SetFillAttributes ( )

Definition at line 1132 of file RooPlot.cxx.

◆ SetFillColor()

void RooPlot::SetFillColor ( Color_t fcolor )

Definition at line 1133 of file RooPlot.cxx.

◆ SetFillStyle()

void RooPlot::SetFillStyle ( Style_t fstyle )

Definition at line 1134 of file RooPlot.cxx.

◆ setInvisible()

void RooPlot::setInvisible	(	const char *	name,
		Bool_t	flag = `kTRUE`
	)

If flag is true object with 'name' is set to be invisible i.e.

it is not drawn when Draw() is called

Definition at line 915 of file RooPlot.cxx.

◆ SetLabelColor()

void RooPlot::SetLabelColor	(	Color_t	color = `1`,
		Option_t *	axis = `"X"`
	)

Definition at line 1135 of file RooPlot.cxx.

◆ SetLabelFont()

void RooPlot::SetLabelFont	(	Style_t	font = `62`,
		Option_t *	axis = `"X"`
	)

Definition at line 1136 of file RooPlot.cxx.

◆ SetLabelOffset()

void RooPlot::SetLabelOffset	(	Float_t	offset = `0.005`,
		Option_t *	axis = `"X"`
	)

Definition at line 1137 of file RooPlot.cxx.

◆ SetLabelSize()

void RooPlot::SetLabelSize	(	Float_t	size = `0.02`,
		Option_t *	axis = `"X"`
	)

Definition at line 1138 of file RooPlot.cxx.

◆ SetLineAttributes()

void RooPlot::SetLineAttributes ( )

Definition at line 1139 of file RooPlot.cxx.

◆ SetLineColor()

void RooPlot::SetLineColor ( Color_t lcolor )

Definition at line 1140 of file RooPlot.cxx.

◆ SetLineStyle()

void RooPlot::SetLineStyle ( Style_t lstyle )

Definition at line 1141 of file RooPlot.cxx.

◆ SetLineWidth()

void RooPlot::SetLineWidth ( Width_t lwidth )

Definition at line 1142 of file RooPlot.cxx.

◆ SetMarkerAttributes()

void RooPlot::SetMarkerAttributes ( )

Definition at line 1143 of file RooPlot.cxx.

◆ SetMarkerColor()

void RooPlot::SetMarkerColor ( Color_t tcolor = 1 )

Definition at line 1144 of file RooPlot.cxx.

◆ SetMarkerSize()

void RooPlot::SetMarkerSize ( Size_t msize = 1 )

Definition at line 1145 of file RooPlot.cxx.

◆ SetMarkerStyle()

void RooPlot::SetMarkerStyle ( Style_t mstyle = 1 )

Definition at line 1146 of file RooPlot.cxx.

◆ SetMaximum()

void RooPlot::SetMaximum ( Double_t maximum = -1111 )

virtual

Set maximum value of Y axis.

Definition at line 949 of file RooPlot.cxx.

◆ SetMinimum()

void RooPlot::SetMinimum ( Double_t minimum = -1111 )

virtual

Set minimum value of Y axis.

Definition at line 959 of file RooPlot.cxx.

◆ SetName()

void RooPlot::SetName ( const char * name )

virtual

Set the name of the RooPlot to 'name'.

Reimplemented from TNamed.

Definition at line 1077 of file RooPlot.cxx.

◆ SetNameTitle()

void RooPlot::SetNameTitle	(	const char *	name,
		const char *	title
	)

virtual

Set the name and title of the RooPlot to 'name' and 'title'.

Reimplemented from TNamed.

Definition at line 1088 of file RooPlot.cxx.

◆ SetNdivisions()

void RooPlot::SetNdivisions	(	Int_t	n = `510`,
		Option_t *	axis = `"X"`
	)

Definition at line 1147 of file RooPlot.cxx.

◆ SetOption()

void RooPlot::SetOption ( Option_t * option = " " )

Definition at line 1148 of file RooPlot.cxx.

◆ setPadFactor()

void RooPlot::setPadFactor ( Double_t factor )

inline

Definition at line 137 of file RooPlot.h.

◆ SetStats()

void RooPlot::SetStats ( Bool_t stats = kTRUE )

Definition at line 1149 of file RooPlot.cxx.

◆ SetTickLength()

void RooPlot::SetTickLength	(	Float_t	length = `0.02`,
		Option_t *	axis = `"X"`
	)

Definition at line 1150 of file RooPlot.cxx.

◆ SetTitle()

void RooPlot::SetTitle ( const char * name )

virtual

Set the title of the RooPlot to 'title'.

Reimplemented from TNamed.

Definition at line 1099 of file RooPlot.cxx.

◆ SetTitleFont()

void RooPlot::SetTitleFont	(	Style_t	font = `62`,
		Option_t *	axis = `"X"`
	)

Definition at line 1151 of file RooPlot.cxx.

◆ SetTitleOffset()

void RooPlot::SetTitleOffset	(	Float_t	offset = `1`,
		Option_t *	axis = `"X"`
	)

Definition at line 1152 of file RooPlot.cxx.

◆ SetTitleSize()

void RooPlot::SetTitleSize	(	Float_t	size = `0.02`,
		Option_t *	axis = `"X"`
	)

Definition at line 1153 of file RooPlot.cxx.

◆ SetXTitle()

void RooPlot::SetXTitle ( const char * title )

Definition at line 1154 of file RooPlot.cxx.

◆ SetYTitle()

void RooPlot::SetYTitle ( const char * title )

Definition at line 1155 of file RooPlot.cxx.

◆ SetZTitle()

void RooPlot::SetZTitle ( const char * title )

Definition at line 1156 of file RooPlot.cxx.

◆ updateFitRangeNorm() [1/2]

void RooPlot::updateFitRangeNorm ( const TH1 * hist )

protected

Update our plot normalization over our plot variable's fit range, which will be determined by the first suitable object added to our plot.

Definition at line 472 of file RooPlot.cxx.

◆ updateFitRangeNorm() [2/2]

void RooPlot::updateFitRangeNorm	(	const RooPlotable *	rp,
		Bool_t	refreshNorm = `kFALSE`
	)

protected

Update our plot normalization over our plot variable's fit range, which will be determined by the first suitable object added to our plot.

Definition at line 484 of file RooPlot.cxx.

◆ updateNormVars()

void RooPlot::updateNormVars ( const RooArgSet & vars )

Install the given set of observables are reference normalization variables for this frame.

These observables are e.g. later used to automatically project out observables when plotting functions on this frame. This function is only effective when called the first time on a frame

Definition at line 350 of file RooPlot.cxx.

◆ updateYAxis()

void RooPlot::updateYAxis	(	Double_t	ymin,
		Double_t	ymax,
		const char *	label = `""`
	)

protected

Update our y-axis limits to accomodate an object whose spread in y is (ymin,ymax).

Use the specified y-axis label if we don't have one assigned already.

Definition at line 527 of file RooPlot.cxx.

Member Data Documentation

◆ _addDirStatus

Bool_t RooPlot::_addDirStatus = kTRUE

staticprotected

non-persistent

Definition at line 220 of file RooPlot.h.

◆ _defYmax

Double_t RooPlot::_defYmax

protected

Definition at line 216 of file RooPlot.h.

◆ _defYmin

Double_t RooPlot::_defYmin

protected

non-persistent

Definition at line 215 of file RooPlot.h.

◆ _dir

TDirectory* RooPlot::_dir

protected

Definition at line 218 of file RooPlot.h.

◆ _hist

TH1* RooPlot::_hist

protected

Definition at line 201 of file RooPlot.h.

◆ _items

RooList RooPlot::_items

protected

Definition at line 203 of file RooPlot.h.

◆ _iterator

TIterator* RooPlot::_iterator

protected

Definition at line 213 of file RooPlot.h.

◆ _normBinWidth

Double_t RooPlot::_normBinWidth

protected

Definition at line 211 of file RooPlot.h.

◆ _normNumEvts

Double_t RooPlot::_normNumEvts

protected

Pointer to normalization object ;.

Definition at line 210 of file RooPlot.h.

◆ _normObj

const RooPlotable* RooPlot::_normObj

protected

Definition at line 209 of file RooPlot.h.

◆ _normVars

RooArgSet* RooPlot::_normVars

protected

Definition at line 207 of file RooPlot.h.

◆ _padFactor

Double_t RooPlot::_padFactor

protected

Definition at line 204 of file RooPlot.h.

◆ _plotVarClone

RooAbsRealLValue* RooPlot::_plotVarClone

protected

Definition at line 205 of file RooPlot.h.

◆ _plotVarSet

RooArgSet* RooPlot::_plotVarSet

protected

Definition at line 206 of file RooPlot.h.

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

roofit/roofitcore/inc/RooPlot.h
roofit/roofitcore/src/RooPlot.cxx

Classes

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Static Protected Attributes

Additional Inherited Members

Constructor & Destructor Documentation

◆ RooPlot() [1/8]

◆ RooPlot() [2/8]

◆ RooPlot() [3/8]

◆ RooPlot() [4/8]

◆ RooPlot() [5/8]

◆ RooPlot() [6/8]

◆ RooPlot() [7/8]

◆ ~RooPlot()

◆ RooPlot() [8/8]

Member Function Documentation

◆ addDirectoryStatus()

◆ addObject()

◆ addPlotable()

◆ addTH1()

◆ Browse()

◆ caller()

◆ chiSquare() [1/2]

◆ chiSquare() [2/2]

◆ defaultPrintContents()

◆ Draw()

◆ drawAfter()

◆ drawBefore()

◆ emptyClone()

◆ findObject()

◆ getAttFill()

◆ getAttLine()

◆ getAttMarker()

◆ getAttText()

◆ GetBinContent() [1/3]

◆ GetBinContent() [2/3]

◆ GetBinContent() [3/3]

◆ getCurve()

◆ getDrawOptions()

◆ getFitRangeBinW()

◆ getFitRangeNEvt() [1/2]

◆ getFitRangeNEvt() [2/2]

◆ getHist()

◆ getInvisible()

◆ GetMaximum()

◆ GetMinimum()

◆ GetNbinsX()

◆ GetNdivisions()

◆ getNormVars()

◆ getObject()

◆ getPadFactor()

◆ getPlotVar()

◆ GetXaxis()

◆ GetYaxis()

◆ histName()

◆ initialize()

◆ nameOf()

◆ numItems()

◆ Print()

◆ printArgs()

◆ printClassName()

◆ printMultiline()

◆ printName()

◆ printTitle()

◆ printValue()

◆ pullHist()

◆ remove()

◆ residHist()

◆ setAddDirectoryStatus()

◆ SetAxisColor()

◆ SetAxisRange()

◆ SetBarOffset()

◆ SetBarWidth()

◆ SetContour()

◆ SetContourLevel()

◆ SetDrawOption()

◆ setDrawOptions()

◆ SetFillAttributes()