Logo ROOT   6.19/01
Reference Guide
RooPlot Class Reference

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 44 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...
 
std::unique_ptr< TLegendBuildLegend () const
 Build a legend that contains all objects that have been drawn on the plot. More...
 
Double_t chiSquare (int nFitParam=0) const
 Shortcut for RooPlot::chiSquare(const char* pdfname, const char* histname, int nFitParam=0) More...
 
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...
 
RooPlotemptyClone (const char *name)
 Return empty clone of current RooPlot. More...
 
TObjectfindObject (const char *name, const TClass *clas=0) const
 Find the named object in our list of items and return a pointer to it. More...
 
TAttFillgetAttFill (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...
 
TAttLinegetAttLine (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...
 
TAttMarkergetAttMarker (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...
 
TAttTextgetAttText (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...
 
RooCurvegetCurve (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
 Return the bin width that is being used to normalise the PDF. More...
 
Double_t getFitRangeNEvt () const
 Return the number of events in the fit range. More...
 
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...
 
RooHistgetHist (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 RooArgSetgetNormVars () const
 
TObjectgetObject (Int_t idx) const
 Return the name of the object at slot 'idx' in this RooPlot. More...
 
Double_t getPadFactor () const
 
RooAbsRealLValuegetPlotVar () const
 
TAxisGetXaxis () const
 
TAxisGetYaxis () 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...
 
RooHistpullHist (const char *histname=0, const char *pdfname=0, bool useAverage=false) const
 Uses residHist() and sets normalize=true. More...
 
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...
 
RooHistresidHist (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 ()
 TNamed destructor. More...
 
virtual void Clear (Option_t *option="")
 Set name and title to empty strings (""). More...
 
virtual TObjectClone (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...
 
TNamedoperator= (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...
 
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. 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 TObjectDrawClone (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 TObjectFindObject (const char *name) const
 Must be redefined in derived classes. More...
 
virtual TObjectFindObject (const TObject *obj) const
 Must be redefined in derived classes. More...
 
virtual Option_tGetDrawOption () 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_tGetOption () 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...
 
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. 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...
 
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). 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...
 
voidoperator new (size_t sz)
 
voidoperator new (size_t sz, void *vp)
 
voidoperator new[] (size_t sz)
 
voidoperator new[] (size_t sz, void *vp)
 
TObjectoperator= (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...
 
R__ALWAYS_INLINE 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 RooPlotframe (const RooAbsRealLValue &var, Double_t xmin, Double_t xmax, Int_t nBins)
 Create a new frame for a given variable in x. More...
 
static RooPlotframeWithLabels (const RooAbsRealLValue &var)
 Create a new frame for a given variable in x, adding bin labels. More...
 
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, 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
}
 

#include <RooPlot.h>

Inheritance diagram for RooPlot:
[legend]

Constructor & Destructor Documentation

◆ RooPlot() [1/8]

RooPlot::RooPlot ( )

Default constructor coverity[UNINIT_CTOR].

Definition at line 85 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 209 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 239 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 99 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 124 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 147 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 183 of file RooPlot.cxx.

◆ ~RooPlot()

RooPlot::~RooPlot ( )
virtual

Destructor.

Definition at line 376 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 77 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 443 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 591 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 462 of file RooPlot.cxx.

◆ Browse()

void RooPlot::Browse ( TBrowser b)
virtual

Plot RooPlot when double-clicked in browser.

Reimplemented from TObject.

Definition at line 1323 of file RooPlot.cxx.

◆ BuildLegend()

std::unique_ptr< TLegend > RooPlot::BuildLegend ( ) const

Build a legend that contains all objects that have been drawn on the plot.

Definition at line 1384 of file RooPlot.cxx.

◆ caller()

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

Utility function.

Definition at line 1087 of file RooPlot.cxx.

◆ chiSquare() [1/2]

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

Shortcut for RooPlot::chiSquare(const char* pdfname, const char* histname, int nFitParam=0)

Definition at line 176 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.

Parameters
[in]curvenameName of the curve or nullptr for last curve
[in]histnameName of the histogram to compare to or nullptr for last added histogram
[in]nFitParamIf non-zero, reduce the number of degrees of freedom by this number. This means that the curve was fitted to the data with nFitParam floating parameters, which needs to be reflected in the calculation of \(\chi^2 / \mathrm{ndf}\).
Returns
\( \chi^2 / \mathrm{ndf} \)

Definition at line 1131 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 1269 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 712 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 986 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 975 of file RooPlot.cxx.

◆ emptyClone()

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

Return empty clone of current RooPlot.

Definition at line 326 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 1003 of file RooPlot.cxx.

◆ frame()

RooPlot * RooPlot::frame ( const RooAbsRealLValue var,
Double_t  xmin,
Double_t  xmax,
Int_t  nBins 
)
static

Create a new frame for a given variable in x.

This is just a wrapper for the RooPlot constructor with the same interface.

More details.

Parameters
[in]varThe variable on the x-axis
[in]xminLeft edge of the x-axis
[in]xmaxRight edge of the x-axis
[in]nBinsnumber of bins on the x-axis

Definition at line 277 of file RooPlot.cxx.

◆ frameWithLabels()

RooPlot * RooPlot::frameWithLabels ( const RooAbsRealLValue var)
static

Create a new frame for a given variable in x, adding bin labels.

The binning will be extracted from the variable given. The bin labels will be set as "%g-%g" for the left and right edges of each bin of the given variable.

More details.

Parameters
[in]varThe variable on the x-axis

Definition at line 289 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 897 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 887 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 907 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 917 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 411 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 420 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 430 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 928 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 1028 of file RooPlot.cxx.

◆ getFitRangeBinW()

Double_t RooPlot::getFitRangeBinW ( ) const
inline

Return the bin width that is being used to normalise the PDF.

Definition at line 144 of file RooPlot.h.

◆ getFitRangeNEvt() [1/2]

Double_t RooPlot::getFitRangeNEvt ( ) const
inline

Return the number of events in the fit range.

Definition at line 141 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 1220 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 938 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 1055 of file RooPlot.cxx.

◆ GetMaximum()

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

Definition at line 1281 of file RooPlot.cxx.

◆ GetMinimum()

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

Definition at line 1280 of file RooPlot.cxx.

◆ GetNbinsX()

Int_t RooPlot::GetNbinsX ( ) const

Definition at line 1278 of file RooPlot.cxx.

◆ GetNdivisions()

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

Definition at line 1279 of file RooPlot.cxx.

◆ getNormVars()

const RooArgSet* RooPlot::getNormVars ( ) const
inline

Definition at line 148 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 871 of file RooPlot.cxx.

◆ getPadFactor()

Double_t RooPlot::getPadFactor ( ) const
inline

Definition at line 145 of file RooPlot.h.

◆ getPlotVar()

RooAbsRealLValue* RooPlot::getPlotVar ( ) const
inline

Definition at line 139 of file RooPlot.h.

◆ GetXaxis()

TAxis * RooPlot::GetXaxis ( ) const

Definition at line 1276 of file RooPlot.cxx.

◆ GetYaxis()

TAxis * RooPlot::GetYaxis ( ) const

Definition at line 1277 of file RooPlot.cxx.

◆ histName()

TString RooPlot::histName ( ) const
protected

Construct automatic name of internal TH1.

Definition at line 363 of file RooPlot.cxx.

◆ initialize()

void RooPlot::initialize ( void  )
protected

Perform initialization that is common to all constructors.

Definition at line 337 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 855 of file RooPlot.cxx.

◆ numItems()

Stat_t RooPlot::numItems ( ) const
inline

Definition at line 115 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 134 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 772 of file RooPlot.cxx.

◆ printClassName()

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

Print frame class name.

Reimplemented from RooPrintable.

Definition at line 763 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 815 of file RooPlot.cxx.

◆ printName()

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

Print frame name.

Reimplemented from RooPrintable.

Definition at line 745 of file RooPlot.cxx.

◆ printTitle()

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

Print frame title.

Reimplemented from RooPrintable.

Definition at line 754 of file RooPlot.cxx.

◆ printValue()

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

Print frame arguments.

Reimplemented from RooPrintable.

Definition at line 786 of file RooPlot.cxx.

◆ pullHist()

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

Uses residHist() and sets normalize=true.

Definition at line 181 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 950 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 1157 of file RooPlot.cxx.

◆ setAddDirectoryStatus()

Bool_t RooPlot::setAddDirectoryStatus ( Bool_t  flag)
static

Definition at line 78 of file RooPlot.cxx.

◆ SetAxisColor()

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

Definition at line 1284 of file RooPlot.cxx.

◆ SetAxisRange()

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

Definition at line 1285 of file RooPlot.cxx.

◆ SetBarOffset()

void RooPlot::SetBarOffset ( Float_t  offset = 0.25)

Definition at line 1286 of file RooPlot.cxx.

◆ SetBarWidth()

void RooPlot::SetBarWidth ( Float_t  width = 0.5)

Definition at line 1287 of file RooPlot.cxx.

◆ SetContour()

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

Definition at line 1288 of file RooPlot.cxx.

◆ SetContourLevel()

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

Definition at line 1289 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 1290 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 1040 of file RooPlot.cxx.

◆ SetFillAttributes()

void RooPlot::SetFillAttributes ( )

Definition at line 1291 of file RooPlot.cxx.

◆ SetFillColor()

void RooPlot::SetFillColor ( Color_t  fcolor)

Definition at line 1292 of file RooPlot.cxx.

◆ SetFillStyle()

void RooPlot::SetFillStyle ( Style_t  fstyle)

Definition at line 1293 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 1068 of file RooPlot.cxx.

◆ SetLabelColor()

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

Definition at line 1294 of file RooPlot.cxx.

◆ SetLabelFont()

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

Definition at line 1295 of file RooPlot.cxx.

◆ SetLabelOffset()

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

Definition at line 1296 of file RooPlot.cxx.

◆ SetLabelSize()

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

Definition at line 1297 of file RooPlot.cxx.

◆ SetLineAttributes()

void RooPlot::SetLineAttributes ( )

Definition at line 1298 of file RooPlot.cxx.

◆ SetLineColor()

void RooPlot::SetLineColor ( Color_t  lcolor)

Definition at line 1299 of file RooPlot.cxx.

◆ SetLineStyle()

void RooPlot::SetLineStyle ( Style_t  lstyle)

Definition at line 1300 of file RooPlot.cxx.

◆ SetLineWidth()

void RooPlot::SetLineWidth ( Width_t  lwidth)

Definition at line 1301 of file RooPlot.cxx.

◆ SetMarkerAttributes()

void RooPlot::SetMarkerAttributes ( )

Definition at line 1302 of file RooPlot.cxx.

◆ SetMarkerColor()

void RooPlot::SetMarkerColor ( Color_t  tcolor = 1)

Definition at line 1303 of file RooPlot.cxx.

◆ SetMarkerSize()

void RooPlot::SetMarkerSize ( Size_t  msize = 1)

Definition at line 1304 of file RooPlot.cxx.

◆ SetMarkerStyle()

void RooPlot::SetMarkerStyle ( Style_t  mstyle = 1)

Definition at line 1305 of file RooPlot.cxx.

◆ SetMaximum()

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

Set maximum value of Y axis.

Definition at line 1102 of file RooPlot.cxx.

◆ SetMinimum()

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

Set minimum value of Y axis.

Definition at line 1112 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 1236 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 1247 of file RooPlot.cxx.

◆ SetNdivisions()

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

Definition at line 1306 of file RooPlot.cxx.

◆ SetOption()

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

Definition at line 1307 of file RooPlot.cxx.

◆ setPadFactor()

void RooPlot::setPadFactor ( Double_t  factor)
inline

Definition at line 146 of file RooPlot.h.

◆ SetStats()

void RooPlot::SetStats ( Bool_t  stats = kTRUE)

Definition at line 1308 of file RooPlot.cxx.

◆ SetTickLength()

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

Definition at line 1309 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 1258 of file RooPlot.cxx.

◆ SetTitleFont()

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

Definition at line 1310 of file RooPlot.cxx.

◆ SetTitleOffset()

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

Definition at line 1311 of file RooPlot.cxx.

◆ SetTitleSize()

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

Definition at line 1312 of file RooPlot.cxx.

◆ SetXTitle()

void RooPlot::SetXTitle ( const char *  title)

Definition at line 1313 of file RooPlot.cxx.

◆ SetYTitle()

void RooPlot::SetYTitle ( const char *  title)

Definition at line 1314 of file RooPlot.cxx.

◆ SetZTitle()

void RooPlot::SetZTitle ( const char *  title)

Definition at line 1315 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 625 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 637 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 401 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 680 of file RooPlot.cxx.

Member Data Documentation

◆ _addDirStatus

Bool_t RooPlot::_addDirStatus = kTRUE
staticprotected

non-persistent

Definition at line 231 of file RooPlot.h.

◆ _defYmax

Double_t RooPlot::_defYmax
protected

Definition at line 227 of file RooPlot.h.

◆ _defYmin

Double_t RooPlot::_defYmin
protected

non-persistent

Definition at line 226 of file RooPlot.h.

◆ _dir

TDirectory* RooPlot::_dir
protected

Definition at line 229 of file RooPlot.h.

◆ _hist

TH1* RooPlot::_hist
protected

Definition at line 212 of file RooPlot.h.

◆ _items

RooList RooPlot::_items
protected

Definition at line 214 of file RooPlot.h.

◆ _iterator

TIterator* RooPlot::_iterator
protected

Definition at line 224 of file RooPlot.h.

◆ _normBinWidth

Double_t RooPlot::_normBinWidth
protected

Definition at line 222 of file RooPlot.h.

◆ _normNumEvts

Double_t RooPlot::_normNumEvts
protected

Pointer to normalization object ;.

Definition at line 221 of file RooPlot.h.

◆ _normObj

const RooPlotable* RooPlot::_normObj
protected

Definition at line 220 of file RooPlot.h.

◆ _normVars

RooArgSet* RooPlot::_normVars
protected

Definition at line 218 of file RooPlot.h.

◆ _padFactor

Double_t RooPlot::_padFactor
protected

Definition at line 215 of file RooPlot.h.

◆ _plotVarClone

RooAbsRealLValue* RooPlot::_plotVarClone
protected

Definition at line 216 of file RooPlot.h.

◆ _plotVarSet

RooArgSet* RooPlot::_plotVarSet
protected

Definition at line 217 of file RooPlot.h.

Libraries for RooPlot:
[legend]

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