Logo ROOT   6.10/09
Reference Guide
List of all members | Public Member Functions | Protected Member Functions | Protected Attributes | Private Member Functions | List of all members
TTreePlayer Class Reference

Implement some of the functionality of the class TTree requiring access to extra libraries (Histogram, display, etc).

Definition at line 37 of file TTreePlayer.h.

Public Member Functions

 TTreePlayer ()
 Default Tree constructor. More...
 
virtual ~TTreePlayer ()
 Tree destructor. More...
 
virtual TVirtualIndexBuildIndex (const TTree *T, const char *majorname, const char *minorname)
 Build the index for the tree (see TTree::BuildIndex) More...
 
virtual TTreeCopyTree (const char *selection, Option_t *option, Long64_t nentries, Long64_t firstentry)
 Copy a Tree with selection, make a clone of this Tree header, then copy the selected entries. More...
 
virtual Long64_t DrawScript (const char *wrapperPrefix, const char *macrofilename, const char *cutfilename, Option_t *option, Long64_t nentries, Long64_t firstentry)
 Draw the result of a C++ script. More...
 
virtual Long64_t DrawSelect (const char *varexp, const char *selection, Option_t *option, Long64_t nentries, Long64_t firstentry)
 Draw expression varexp for specified entries that matches the selection. More...
 
virtual Int_t Fit (const char *formula, const char *varexp, const char *selection, Option_t *option, Option_t *goption, Long64_t nentries, Long64_t firstentry)
 Fit a projected item(s) from a Tree. More...
 
virtual Int_t GetDimension () const
 
virtual Long64_t GetEntries (const char *selection)
 Return the number of entries matching the selection. More...
 
virtual Long64_t GetEntriesToProcess (Long64_t firstentry, Long64_t nentries) const
 return the number of entries to be processed this function checks that nentries is not bigger than the number of entries in the Tree or in the associated TEventlist More...
 
TH1GetHistogram () const
 
virtual Int_t GetNfill () const
 
const char * GetScanFileName () const
 
TTreeFormulaGetSelect () const
 
virtual Long64_t GetSelectedRows () const
 
TSelectorGetSelector () const
 
TSelectorGetSelectorFromFile () const
 
virtual Double_tGetV1 () const
 
virtual Double_tGetV2 () const
 
virtual Double_tGetV3 () const
 
virtual Double_tGetV4 () const
 
virtual Double_tGetVal (Int_t i) const
 
TTreeFormulaGetVar (Int_t i) const
 
TTreeFormulaGetVar1 () const
 
TTreeFormulaGetVar2 () const
 
TTreeFormulaGetVar3 () const
 
TTreeFormulaGetVar4 () const
 
virtual Double_tGetW () const
 
virtual Int_t MakeClass (const char *classname, Option_t *option)
 Generate skeleton analysis class for this Tree. More...
 
virtual Int_t MakeCode (const char *filename)
 Generate skeleton function for this Tree. More...
 
virtual Int_t MakeProxy (const char *classname, const char *macrofilename=0, const char *cutfilename=0, const char *option=0, Int_t maxUnrolling=3)
 Generate a skeleton analysis class for this Tree using TBranchProxy. More...
 
virtual Int_t MakeReader (const char *classname, Option_t *option)
 Generate skeleton selector class for this tree. More...
 
TPrincipalPrincipal (const char *varexp, const char *selection, Option_t *option, Long64_t nentries, Long64_t firstentry)
 Interface to the Principal Components Analysis class. More...
 
virtual Long64_t Process (const char *filename, Option_t *option, Long64_t nentries, Long64_t firstentry)
 Process this tree executing the TSelector code in the specified filename. More...
 
virtual Long64_t Process (TSelector *selector, Option_t *option, Long64_t nentries, Long64_t firstentry)
 Process this tree executing the code in the specified selector. More...
 
virtual TSQLResultQuery (const char *varexp, const char *selection, Option_t *option, Long64_t nentries, Long64_t firstentry)
 Loop on Tree and return TSQLResult object containing entries passing selection. More...
 
virtual void RecursiveRemove (TObject *obj)
 cleanup pointers in the player pointing to obj More...
 
virtual Long64_t Scan (const char *varexp, const char *selection, Option_t *option, Long64_t nentries, Long64_t firstentry)
 Loop on Tree and print entries passing selection. More...
 
Bool_t ScanRedirected ()
 
virtual void SetEstimate (Long64_t n)
 Set number of entries to estimate variable limits. More...
 
void SetScanFileName (const char *name)
 
void SetScanRedirect (Bool_t on=kFALSE)
 
virtual void SetTree (TTree *t)
 
virtual void StartViewer (Int_t ww, Int_t wh)
 Start the TTreeViewer on this TTree. More...
 
virtual Int_t UnbinnedFit (const char *formula, const char *varexp, const char *selection, Option_t *option, Long64_t nentries, Long64_t firstentry)
 Unbinned fit of one or more variable(s) from a Tree. More...
 
virtual void UpdateFormulaLeaves ()
 this function is called by TChain::LoadTree when a new Tree is loaded. More...
 
- Public Member Functions inherited from TVirtualTreePlayer
 TVirtualTreePlayer ()
 
virtual ~TVirtualTreePlayer ()
 Common destructor. More...
 
- Public Member Functions inherited from TObject
 TObject ()
 TObject constructor. More...
 
 TObject (const TObject &object)
 TObject copy ctor. More...
 
virtual ~TObject ()
 TObject destructor. More...
 
void AbstractMethod (const char *method) const
 Use this method to implement an "abstract" method that you don't want to leave purely abstract. More...
 
virtual void AppendPad (Option_t *option="")
 Append graphics object to current pad. More...
 
virtual void Browse (TBrowser *b)
 Browse object. May be overridden for another default action. More...
 
virtual const char * ClassName () const
 Returns name of class to which the object belongs. More...
 
virtual void Clear (Option_t *="")
 
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 abstract method. More...
 
virtual void Copy (TObject &object) const
 Copy this to obj. More...
 
virtual void Delete (Option_t *option="")
 Delete this object. More...
 
virtual Int_t DistancetoPrimitive (Int_t px, Int_t py)
 Computes distance from point (px,py) to the object. More...
 
virtual void Draw (Option_t *option="")
 Default Draw method for all objects. More...
 
virtual void DrawClass () const
 Draw class inheritance tree of the class to which this object belongs. More...
 
virtual 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 const char * GetName () const
 Returns 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 const char * GetTitle () const
 Returns title of object. More...
 
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 ULong_t Hash () const
 Return hash value for this object. 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
 
virtual Bool_t IsSortable () const
 
Bool_t IsZombie () const
 
virtual void ls (Option_t *option="") const
 The ls function lists the contents of a class on stdout. More...
 
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 void Print (Option_t *option="") const
 This method must be overridden when a class wants to print itself. More...
 
virtual Int_t Read (const char *name)
 Read contents of object with specified name from the current directory. More...
 
void ResetBit (UInt_t f)
 
virtual void SaveAs (const char *filename="", Option_t *option="") const
 Save this object in the file specified by filename. More...
 
virtual void SavePrimitive (std::ostream &out, Option_t *option="")
 Save a primitive as a C++ statement(s) on output stream "out". More...
 
void SetBit (UInt_t f, Bool_t set)
 Set or unset the user status bits as specified in f. More...
 
void SetBit (UInt_t f)
 
virtual void SetDrawOption (Option_t *option="")
 Set drawing option for object. More...
 
virtual void SetUniqueID (UInt_t uid)
 Set the unique object id. More...
 
virtual void SysError (const char *method, const char *msgfmt,...) const
 Issue system error message. More...
 
Bool_t TestBit (UInt_t f) const
 
Int_t TestBits (UInt_t f) const
 
virtual void UseCurrentStyle ()
 Set current style settings in this object This function is called when either TCanvas::UseCurrentStyle or TROOT::ForceStyle have been invoked. More...
 
virtual void Warning (const char *method, const char *msgfmt,...) const
 Issue warning message. More...
 
virtual Int_t Write (const char *name=0, Int_t option=0, Int_t bufsize=0)
 Write this object to the current directory. More...
 
virtual Int_t Write (const char *name=0, Int_t option=0, Int_t bufsize=0) const
 Write this object to the current directory. More...
 

Protected Member Functions

void DeleteSelectorFromFile ()
 Delete any selector created by this object. More...
 
const char * GetNameByIndex (TString &varexp, Int_t *index, Int_t colindex)
 Set to the selector address when it's entry list needs to be updated by the UpdateFormulaLeaves function. More...
 
void TakeAction (Int_t nfill, Int_t &npoints, Int_t &action, TObject *obj, Option_t *option)
 
void TakeEstimate (Int_t nfill, Int_t &npoints, Int_t action, TObject *obj, Option_t *option)
 
- 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

Int_t fDimension
 
TListfFormulaList
 input list to the selector More...
 
TH1fHistogram
 
TListfInput
 Pointer to the actual class of the TSelectorFromFile. More...
 
const char * fScanFileName
 
Bool_t fScanRedirect
 Pointer to current Tree. More...
 
Long64_t fSelectedRows
 
TSelectorDrawfSelector
 Pointer to histogram used for the projection. More...
 
TClassfSelectorClass
 Pointer to a user defined selector created by this TTreePlayer object. More...
 
TSelectorfSelectorFromFile
 Pointer to current selector. More...
 
TSelectorfSelectorUpdate
 Pointer to a list of coordinated list TTreeFormula (used by Scan and Query) More...
 
TTreefTree
 

Private Member Functions

 TTreePlayer (const TTreePlayer &)
 
TTreePlayeroperator= (const TTreePlayer &)
 

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)
}
 
- Static Public Member Functions inherited from TVirtualTreePlayer
static TVirtualTreePlayerGetCurrentPlayer ()
 Static function: return the current player (if any) More...
 
static void SetPlayer (const char *player)
 Static function to set an alternative Tree player. More...
 
static TVirtualTreePlayerTreePlayer (TTree *obj)
 Static function returning a pointer to a Tree player. More...
 
- 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 Attributes inherited from TVirtualTreePlayer
static constexpr Long64_t kMaxEntries = std::numeric_limits<Long64_t>::max()
 

#include <TTreePlayer.h>

Inheritance diagram for TTreePlayer:
[legend]

Constructor & Destructor Documentation

◆ TTreePlayer() [1/2]

TTreePlayer::TTreePlayer ( const TTreePlayer )
private

◆ TTreePlayer() [2/2]

TTreePlayer::TTreePlayer ( )

Default Tree constructor.

Definition at line 98 of file TTreePlayer.cxx.

◆ ~TTreePlayer()

TTreePlayer::~TTreePlayer ( )
virtual

Tree destructor.

Definition at line 127 of file TTreePlayer.cxx.

Member Function Documentation

◆ BuildIndex()

TVirtualIndex * TTreePlayer::BuildIndex ( const TTree T,
const char *  majorname,
const char *  minorname 
)
virtual

Build the index for the tree (see TTree::BuildIndex)

Implements TVirtualTreePlayer.

Definition at line 141 of file TTreePlayer.cxx.

◆ CopyTree()

TTree * TTreePlayer::CopyTree ( const char *  selection,
Option_t option,
Long64_t  nentries,
Long64_t  firstentry 
)
virtual

Copy a Tree with selection, make a clone of this Tree header, then copy the selected entries.

  • selection is a standard selection expression (see TTreePlayer::Draw)
  • option is reserved for possible future use
  • nentries is the number of entries to process (default is all)
  • first is the first entry to process (default is 0)

IMPORTANT: The copied tree stays connected with this tree until this tree is deleted. In particular, any changes in branch addresses in this tree are forwarded to the clone trees. Any changes made to the branch addresses of the copied trees are over-ridden anytime this tree changes its branch addresses. Once this tree is deleted, all the addresses of the copied tree are reset to their default values.

The following example illustrates how to copy some events from the Tree generated in $ROOTSYS/test/Event

gSystem->Load("libEvent");
TFile f("Event.root");
TTree *T = (TTree*)f.Get("T");
Event *event = new Event();
T->SetBranchAddress("event",&event);
TFile f2("Event2.root","recreate");
TTree *T2 = T->CopyTree("fNtrack<595");
T2->Write();

Implements TVirtualTreePlayer.

Definition at line 186 of file TTreePlayer.cxx.

◆ DeleteSelectorFromFile()

void TTreePlayer::DeleteSelectorFromFile ( )
protected

Delete any selector created by this object.

The selector has been created using TSelector::GetSelector(file)

Definition at line 251 of file TTreePlayer.cxx.

◆ DrawScript()

Long64_t TTreePlayer::DrawScript ( const char *  wrapperPrefix,
const char *  macrofilename,
const char *  cutfilename,
Option_t option,
Long64_t  nentries,
Long64_t  firstentry 
)
virtual

Draw the result of a C++ script.

The macrofilename and optionally cutfilename are assumed to contain at least a method with the same name as the file. The method should return a value that can be automatically cast to respectively a double and a boolean.

Both methods will be executed in a context such that the branch names can be used as C++ variables. This is accomplished by generating a TTreeProxy (see MakeProxy) and including the files in the proper location.

If the branch name can not be used a proper C++ symbol name, it will be modified as follow:

  • white spaces are removed
  • if the leading character is not a letter, an underscore is inserted
  • < and > are replace by underscores
  • * is replaced by st
  • & is replaced by rf

If a cutfilename is specified, for each entry, we execute

if (cutfilename()) htemp->Fill(macrofilename());

If no cutfilename is specified, for each entry we execute

htemp(macrofilename());

The default for the histogram are the same as for TTreePlayer::DrawSelect

Implements TVirtualTreePlayer.

Definition at line 294 of file TTreePlayer.cxx.

◆ DrawSelect()

Long64_t TTreePlayer::DrawSelect ( const char *  varexp0,
const char *  selection,
Option_t option,
Long64_t  nentries,
Long64_t  firstentry 
)
virtual

Draw expression varexp for specified entries that matches the selection.

Returns -1 in case of error or number of selected events in case of success.

See the documentation of TTree::Draw for the complete details.

Implements TVirtualTreePlayer.

Definition at line 338 of file TTreePlayer.cxx.

◆ Fit()

Int_t TTreePlayer::Fit ( const char *  formula,
const char *  varexp,
const char *  selection,
Option_t option,
Option_t goption,
Long64_t  nentries,
Long64_t  firstentry 
)
virtual

Fit a projected item(s) from a Tree.

Returns -1 in case of error or number of selected events in case of success.

The formula is a TF1 expression.

See TTree::Draw for explanations of the other parameters.

By default the temporary histogram created is called htemp. If varexp contains >>hnew , the new histogram created is called hnew and it is kept in the current directory. Example:

tree.Fit("pol4","sqrt(x)>>hsqrt","y>0")
will fit sqrt(x) and save the histogram as "hsqrt" in the current
directory.

The function returns the status of the histogram fit (see TH1::Fit) If no entries were selected, the function returns -1; (i.e. fitResult is null if the fit is OK)

Implements TVirtualTreePlayer.

Definition at line 560 of file TTreePlayer.cxx.

◆ GetDimension()

virtual Int_t TTreePlayer::GetDimension ( ) const
inlinevirtual

Implements TVirtualTreePlayer.

Definition at line 76 of file TTreePlayer.h.

◆ GetEntries()

Long64_t TTreePlayer::GetEntries ( const char *  selection)
virtual

Return the number of entries matching the selection.

Return -1 in case of errors.

If the selection uses any arrays or containers, we return the number of entries where at least one element match the selection. GetEntries is implemented using the selector class TSelectorEntries, which can be used directly (see code in TTreePlayer::GetEntries) for additional option. If SetEventList was used on the TTree or TChain, only that subset of entries will be considered.

Implements TVirtualTreePlayer.

Definition at line 590 of file TTreePlayer.cxx.

◆ GetEntriesToProcess()

Long64_t TTreePlayer::GetEntriesToProcess ( Long64_t  firstentry,
Long64_t  nentries 
) const
virtual

return the number of entries to be processed this function checks that nentries is not bigger than the number of entries in the Tree or in the associated TEventlist

Definition at line 603 of file TTreePlayer.cxx.

◆ GetHistogram()

TH1* TTreePlayer::GetHistogram ( ) const
inlinevirtual

Implements TVirtualTreePlayer.

Definition at line 77 of file TTreePlayer.h.

◆ GetNameByIndex()

const char * TTreePlayer::GetNameByIndex ( TString varexp,
Int_t index,
Int_t  colindex 
)
protected

Set to the selector address when it's entry list needs to be updated by the UpdateFormulaLeaves function.

Return name corresponding to colindex in varexp.

  • varexp is a string of names separated by :
  • index is an array with pointers to the start of name[i] in varexp

Definition at line 623 of file TTreePlayer.cxx.

◆ GetNfill()

virtual Int_t TTreePlayer::GetNfill ( ) const
inlinevirtual

Implements TVirtualTreePlayer.

Definition at line 80 of file TTreePlayer.h.

◆ GetScanFileName()

const char* TTreePlayer::GetScanFileName ( ) const
inline

Definition at line 81 of file TTreePlayer.h.

◆ GetSelect()

TTreeFormula* TTreePlayer::GetSelect ( ) const
inlinevirtual

Implements TVirtualTreePlayer.

Definition at line 82 of file TTreePlayer.h.

◆ GetSelectedRows()

virtual Long64_t TTreePlayer::GetSelectedRows ( ) const
inlinevirtual

Implements TVirtualTreePlayer.

Definition at line 83 of file TTreePlayer.h.

◆ GetSelector()

TSelector* TTreePlayer::GetSelector ( ) const
inline

Definition at line 84 of file TTreePlayer.h.

◆ GetSelectorFromFile()

TSelector* TTreePlayer::GetSelectorFromFile ( ) const
inline

Definition at line 85 of file TTreePlayer.h.

◆ GetV1()

virtual Double_t* TTreePlayer::GetV1 ( ) const
inlinevirtual

Implements TVirtualTreePlayer.

Definition at line 99 of file TTreePlayer.h.

◆ GetV2()

virtual Double_t* TTreePlayer::GetV2 ( ) const
inlinevirtual

Implements TVirtualTreePlayer.

Definition at line 101 of file TTreePlayer.h.

◆ GetV3()

virtual Double_t* TTreePlayer::GetV3 ( ) const
inlinevirtual

Implements TVirtualTreePlayer.

Definition at line 103 of file TTreePlayer.h.

◆ GetV4()

virtual Double_t* TTreePlayer::GetV4 ( ) const
inlinevirtual

Implements TVirtualTreePlayer.

Definition at line 105 of file TTreePlayer.h.

◆ GetVal()

virtual Double_t* TTreePlayer::GetVal ( Int_t  i) const
inlinevirtual

Implements TVirtualTreePlayer.

Definition at line 97 of file TTreePlayer.h.

◆ GetVar()

TTreeFormula* TTreePlayer::GetVar ( Int_t  i) const
inlinevirtual

Implements TVirtualTreePlayer.

Definition at line 87 of file TTreePlayer.h.

◆ GetVar1()

TTreeFormula* TTreePlayer::GetVar1 ( ) const
inlinevirtual

Implements TVirtualTreePlayer.

Definition at line 89 of file TTreePlayer.h.

◆ GetVar2()

TTreeFormula* TTreePlayer::GetVar2 ( ) const
inlinevirtual

Implements TVirtualTreePlayer.

Definition at line 91 of file TTreePlayer.h.

◆ GetVar3()

TTreeFormula* TTreePlayer::GetVar3 ( ) const
inlinevirtual

Implements TVirtualTreePlayer.

Definition at line 93 of file TTreePlayer.h.

◆ GetVar4()

TTreeFormula* TTreePlayer::GetVar4 ( ) const
inlinevirtual

Implements TVirtualTreePlayer.

Definition at line 95 of file TTreePlayer.h.

◆ GetW()

virtual Double_t* TTreePlayer::GetW ( ) const
inlinevirtual

Implements TVirtualTreePlayer.

Definition at line 106 of file TTreePlayer.h.

◆ MakeClass()

Int_t TTreePlayer::MakeClass ( const char *  classname,
Option_t option 
)
virtual

Generate skeleton analysis class for this Tree.

The following files are produced: classname.h and classname.C If classname is 0, classname will be called "nameoftree.

The generated code in classname.h includes the following:

  • Identification of the original Tree and Input file name
  • Definition of analysis class (data and functions)
  • the following class functions:
    • constructor (connecting by default the Tree file)
    • GetEntry(Long64_t entry)
    • Init(TTree *tree) to initialize a new TTree
    • Show(Long64_t entry) to read and Dump entry

The generated code in classname.C includes only the main analysis function Loop.

To use this function:

  • connect your Tree file (eg: TFile f("myfile.root");)
  • T->MakeClass("MyClass");

where T is the name of the Tree in file myfile.root and MyClass.h, MyClass.C the name of the files created by this function. In a ROOT session, you can do:

root> .L MyClass.C
root> MyClass t
root> t.GetEntry(12); // Fill t data members with entry number 12
root> t.Show(); // Show values of entry 12
root> t.Show(16); // Read and show values of entry 16
root> t.Loop(); // Loop on all entries

NOTE: Do not use the code generated for one Tree in case of a TChain. Maximum dimensions calculated on the basis of one TTree only might be too small when processing all the TTrees in one TChain. Instead of myTree.MakeClass(.., use myChain.MakeClass(..

Implements TVirtualTreePlayer.

Definition at line 719 of file TTreePlayer.cxx.

◆ MakeCode()

Int_t TTreePlayer::MakeCode ( const char *  filename)
virtual

Generate skeleton function for this Tree.

The function code is written on filename. If filename is 0, filename will be called nameoftree.C

The generated code includes the following:

  • Identification of the original Tree and Input file name
  • Connection of the Tree file
  • Declaration of Tree variables
  • Setting of branches addresses
  • A skeleton for the entry loop

To use this function:

  • connect your Tree file (eg: TFile f("myfile.root");)
  • T->MakeCode("anal.C"); where T is the name of the Tree in file myfile.root and anal.C the name of the file created by this function.

NOTE: Since the implementation of this function, a new and better function TTree::MakeClass() has been developed.

Implements TVirtualTreePlayer.

Definition at line 1549 of file TTreePlayer.cxx.

◆ MakeProxy()

Int_t TTreePlayer::MakeProxy ( const char *  proxyClassname,
const char *  macrofilename = 0,
const char *  cutfilename = 0,
const char *  option = 0,
Int_t  maxUnrolling = 3 
)
virtual

Generate a skeleton analysis class for this Tree using TBranchProxy.

TBranchProxy is the base of a class hierarchy implementing an indirect access to the content of the branches of a TTree.

"proxyClassname" is expected to be of the form:

[path/]fileprefix

The skeleton will then be generated in the file:

fileprefix.h

located in the current directory or in 'path/' if it is specified. The class generated will be named 'fileprefix'. If the fileprefix contains a period, the right side of the period will be used as the extension (instead of 'h') and the left side will be used as the classname.

"macrofilename" and optionally "cutfilename" are expected to point to source file which will be included in by the generated skeletong. Method of the same name as the file(minus the extension and path) will be called by the generated skeleton's Process method as follow:

[if (cutfilename())] htemp->Fill(macrofilename());

"option" can be used select some of the optional features during the code generation. The possible options are:

  • nohist : indicates that the generated ProcessFill should not fill the histogram.

'maxUnrolling' controls how deep in the class hierarchy does the system 'unroll' class that are not split. 'unrolling' a class will allow direct access to its data members a class (this emulates the behavior of TTreeFormula).

The main features of this skeleton are:

  • on-demand loading of branches
  • ability to use the 'branchname' as if it was a data member
  • protection against array out-of-bound
  • ability to use the branch data as object (when the user code is available)

For example with Event.root, if

Double_t somepx = fTracks.fPx[2];

is executed by one of the method of the skeleton, somepx will be updated with the current value of fPx of the 3rd track.

Both macrofilename and the optional cutfilename are expected to be the name of source files which contain at least a free standing function with the signature:

x_t macrofilename(); // i.e function with the same name as the file

and

y_t cutfilename(); // i.e function with the same name as the file

x_t and y_t needs to be types that can convert respectively to a double and a bool (because the skeleton uses:

if (cutfilename()) htemp->Fill(macrofilename());

This 2 functions are run in a context such that the branch names are available as local variables of the correct (read-only) type.

Note that if you use the same 'variable' twice, it is more efficient to 'cache' the value. For example

Int_t n = fEventNumber; // Read fEventNumber
if (n<10 || n>10) { ... }

is more efficient than

if (fEventNumber<10 || fEventNumber>10)

Access to TClonesArray.

If a branch (or member) is a TClonesArray (let's say fTracks), you can access the TClonesArray itself by using ->:

fTracks->GetLast();

However this will load the full TClonesArray object and its content. To quickly read the size of the TClonesArray use (note the dot):

fTracks.GetEntries();

This will read only the size from disk if the TClonesArray has been split. To access the content of the TClonesArray, use the [] operator:

float px = fTracks[i].fPx; // fPx of the i-th track

Warning:

The variable actually use for access are 'wrapper' around the real data type (to add autoload for example) and hence getting to the data involves the implicit call to a C++ conversion operator. This conversion is automatic in most case. However it is not invoked in a few cases, in particular in variadic function (like printf). So when using printf you should either explicitly cast the value or use any intermediary variable:

fprintf(stdout,"trs[%d].a = %d\n",i,(int)trs.a[i]);

Also, optionally, the generated selector will also call methods named macrofilename_methodname in each of 6 main selector methods if the method macrofilename_methodname exist (Where macrofilename is stripped of its extension).

Concretely, with the script named h1analysisProxy.C,

  • The method calls the method (if it exist)
  • Begin -> void h1analysisProxy_Begin(TTree*);
  • SlaveBegin -> void h1analysisProxy_SlaveBegin(TTree*);
  • Notify -> Bool_t h1analysisProxy_Notify();
  • Process -> Bool_t h1analysisProxy_Process(Long64_t);
  • SlaveTerminate -> void h1analysisProxy_SlaveTerminate();
  • Terminate -> void h1analysisProxy_Terminate();

If a file name macrofilename.h (or .hh, .hpp, .hxx, .hPP, .hXX) exist it is included before the declaration of the proxy class. This can be used in particular to insure that the include files needed by the macro file are properly loaded.

The default histogram is accessible via the variable named 'htemp'.

If the library of the classes describing the data in the branch is loaded, the skeleton will add the needed include statements and give the ability to access the object stored in the branches.

To draw px using the file `hsimple.root (generated by the hsimple.C tutorial), we need a file named hsimple.cxx:

double hsimple() {
return px;
}

MakeProxy can then be used indirectly via the TTree::Draw interface as follow:

new TFile("hsimple.root")
ntuple->Draw("hsimple.cxx");

A more complete example is available in the tutorials directory: h1analysisProxy.cxx , h1analysProxy.h and h1analysisProxyCut.C which reimplement the selector found in h1analysis.C

Implements TVirtualTreePlayer.

Definition at line 1914 of file TTreePlayer.cxx.

◆ MakeReader()

Int_t TTreePlayer::MakeReader ( const char *  classname,
Option_t option 
)
virtual

Generate skeleton selector class for this tree.

The following files are produced: classname.h and classname.C. If classname is 0, the selector will be called "nameoftree". The option can be used to specify the branches that will have a data member.

  • If option is empty, readers will be generated for each leaf.
  • If option is "@", readers will be generated for the topmost branches.
  • Individual branches can also be picked by their name:
    • "X" generates readers for leaves of X.
    • "@X" generates a reader for X as a whole.
    • "@X;Y" generates a reader for X as a whole and also readers for the leaves of Y.
  • For further examples see the figure below.
ttree_makeselector_option_examples.png

The generated code in classname.h includes the following:

  • Identification of the original Tree and Input file name
  • Definition of selector class (data and functions)
  • The following class functions:
    • constructor and destructor
    • void Begin(TTree *tree)
    • void SlaveBegin(TTree *tree)
    • void Init(TTree *tree)
    • Bool_t Notify()
    • Bool_t Process(Long64_t entry)
    • void Terminate()
    • void SlaveTerminate()

The selector derives from TSelector. The generated code in classname.C includes empty functions defined above.

To use this function:

  • connect your Tree file (eg: TFile f("myfile.root");)
  • T->MakeSelector("myselect"); where T is the name of the Tree in file myfile.root and myselect.h, myselect.C the name of the files created by this function.

In a ROOT session, you can do:

root > T->Process("myselect.C")

Implements TVirtualTreePlayer.

Definition at line 1974 of file TTreePlayer.cxx.

◆ operator=()

TTreePlayer& TTreePlayer::operator= ( const TTreePlayer )
private

◆ Principal()

TPrincipal * TTreePlayer::Principal ( const char *  varexp,
const char *  selection,
Option_t option,
Long64_t  nentries,
Long64_t  firstentry 
)
virtual

Interface to the Principal Components Analysis class.

Create an instance of TPrincipal Fill it with the selected variables

  • if option "n" is specified, the TPrincipal object is filled with normalized variables.
  • If option "p" is specified, compute the principal components
  • If option "p" and "d" print results of analysis
  • If option "p" and "h" generate standard histograms
  • If option "p" and "c" generate code of conversion functions

return a pointer to the TPrincipal object. It is the user responsibility to delete this object.

The option default value is "np"

See TTreePlayer::DrawSelect for explanation of the other parameters.

Implements TVirtualTreePlayer.

Definition at line 2004 of file TTreePlayer.cxx.

◆ Process() [1/2]

Long64_t TTreePlayer::Process ( const char *  filename,
Option_t option,
Long64_t  nentries,
Long64_t  firstentry 
)
virtual

Process this tree executing the TSelector code in the specified filename.

The return value is -1 in case of error and TSelector::GetStatus() in in case of success.

The code in filename is loaded (interpreted or compiled, see below), filename must contain a valid class implementation derived from TSelector, where TSelector has the following member functions:

  • Begin(): called every time a loop on the tree starts, a convenient place to create your histograms.
  • SlaveBegin(): called after Begin(), when on PROOF called only on the slave servers.
  • Process(): called for each event, in this function you decide what to read and fill your histograms.
  • SlaveTerminate: called at the end of the loop on the tree, when on PROOF called only on the slave servers.
  • Terminate(): called at the end of the loop on the tree, a convenient place to draw/fit your histograms.

If filename is of the form file.C, the file will be interpreted. If filename is of the form file.C++, the file file.C will be compiled and dynamically loaded.

If filename is of the form file.C+, the file file.C will be compiled and dynamically loaded. At next call, if file.C is older than file.o and file.so, the file.C is not compiled, only file.so is loaded.

NOTE 1

It may be more interesting to invoke directly the other Process function accepting a TSelector* as argument.eg

MySelector *selector = (MySelector*)TSelector::GetSelector(filename);
selector->CallSomeFunction(..);
mytree.Process(selector,..);

NOTE 2

One should not call this function twice with the same selector file in the same script. If this is required, proceed as indicated in NOTE1, by getting a pointer to the corresponding TSelector,eg ### workaround 1

void stubs1() {
TSelector *selector = TSelector::GetSelector("h1test.C");
TFile *f1 = new TFile("stubs_nood_le1.root");
TTree *h1 = (TTree*)f1->Get("h1");
h1->Process(selector);
TFile *f2 = new TFile("stubs_nood_le1_coarse.root");
TTree *h2 = (TTree*)f2->Get("h1");
h2->Process(selector);
}

or use ACLIC to compile the selector

workaround 2

void stubs2() {
TFile *f1 = new TFile("stubs_nood_le1.root");
TTree *h1 = (TTree*)f1->Get("h1");
h1->Process("h1test.C+");
TFile *f2 = new TFile("stubs_nood_le1_coarse.root");
TTree *h2 = (TTree*)f2->Get("h1");
h2->Process("h1test.C+");
}

Implements TVirtualTreePlayer.

Definition at line 2186 of file TTreePlayer.cxx.

◆ Process() [2/2]

Long64_t TTreePlayer::Process ( TSelector selector,
Option_t option,
Long64_t  nentries,
Long64_t  firstentry 
)
virtual

Process this tree executing the code in the specified selector.

The return value is -1 in case of error and TSelector::GetStatus() in in case of success.

The TSelector class has the following member functions:

  • Begin(): called every time a loop on the tree starts, a convenient place to create your histograms.
  • SlaveBegin(): called after Begin(), when on PROOF called only on the slave servers.
  • Process(): called for each event, in this function you decide what to read and fill your histograms.
  • SlaveTerminate: called at the end of the loop on the tree, when on PROOF called only on the slave servers.
  • Terminate(): called at the end of the loop on the tree, a convenient place to draw/fit your histograms.

    If the Tree (Chain) has an associated EventList, the loop is on the nentries of the EventList, starting at firstentry, otherwise the loop is on the specified Tree entries.

Implements TVirtualTreePlayer.

Definition at line 2226 of file TTreePlayer.cxx.

◆ Query()

TSQLResult * TTreePlayer::Query ( const char *  varexp,
const char *  selection,
Option_t option,
Long64_t  nentries,
Long64_t  firstentry 
)
virtual

Loop on Tree and return TSQLResult object containing entries passing selection.

If varexp is 0 (or "") then print only first 8 columns. If varexp = "*" print all columns. Otherwise a columns selection can be made using "var1:var2:var3". In case of error 0 is returned otherwise a TSQLResult object which must be deleted by the user.

Implements TVirtualTreePlayer.

Definition at line 2798 of file TTreePlayer.cxx.

◆ RecursiveRemove()

void TTreePlayer::RecursiveRemove ( TObject obj)
virtual

cleanup pointers in the player pointing to obj

Reimplemented from TObject.

Definition at line 2340 of file TTreePlayer.cxx.

◆ Scan()

Long64_t TTreePlayer::Scan ( const char *  varexp,
const char *  selection,
Option_t option,
Long64_t  nentries,
Long64_t  firstentry 
)
virtual

Loop on Tree and print entries passing selection.

If varexp is 0 (or "") then print only first 8 columns. If varexp = "*" print all columns. Otherwise a columns selection can be made using "var1:var2:var3". The function returns the number of entries passing the selection.

By default 50 rows are shown and you are asked for <CR> to see the next 50 rows.

You can change the default number of rows to be shown before <CR> via mytree->SetScanField(maxrows) where maxrows is 50 by default. if maxrows is set to 0 all rows of the Tree are shown.

This option is interesting when dumping the contents of a Tree to an ascii file, eg from the command line

tree->SetScanField(0);
tree->Scan("*"); >tree.log

will create a file tree.log

Arrays (within an entry) are printed in their linear forms. If several arrays with multiple dimensions are printed together, they will NOT be synchronized. For example print arr1[4][2] and arr2[2][3] will results in a printing similar to:

***********************************************
* Row * Instance * arr1 * arr2 *
***********************************************
* x * 0 * arr1[0][0]* arr2[0][0]*
* x * 1 * arr1[0][1]* arr2[0][1]*
* x * 2 * arr1[1][0]* arr2[0][2]*
* x * 3 * arr1[1][1]* arr2[1][0]*
* x * 4 * arr1[2][0]* arr2[1][1]*
* x * 5 * arr1[2][1]* arr2[1][2]*
* x * 6 * arr1[3][0]* *
* x * 7 * arr1[3][1]* *

However, if there is a selection criterion which is an array, then all the formulas will be synchronized with the selection criterion (see TTreePlayer::DrawSelect for more information).

The options string can contains the following parameters:

  • lenmax=dd Where 'dd' is the maximum number of elements per array that should be printed. If 'dd' is 0, all elements are printed (this is the default)
  • colsize=ss Where 'ss' will be used as the default size for all the column If this options is not specified, the default column size is 9
  • precision=pp Where 'pp' will be used as the default 'precision' for the printing format.
  • col=xxx Where 'xxx' is colon (:) delimited list of printing format for each column. The format string should follow the printf format specification. The value given will be prefixed by % and, if no conversion specifier is given, will be suffixed by the letter g. before being passed to fprintf. If no format is specified for a column, the default is used (aka ${colsize}.${precision}g )

For example:

tree->Scan("a:b:c","","colsize=30 precision=3 col=::20.10:#x:5ld");

Will print 3 columns, the first 2 columns will be 30 characters long, the third columns will be 20 characters long. The printing format used for the columns (assuming they are numbers) will be respectively:

%30.3g %30.3g %20.10g %#x %5ld

Implements TVirtualTreePlayer.

Definition at line 2418 of file TTreePlayer.cxx.

◆ ScanRedirected()

Bool_t TTreePlayer::ScanRedirected ( )
inline

Definition at line 120 of file TTreePlayer.h.

◆ SetEstimate()

void TTreePlayer::SetEstimate ( Long64_t  n)
virtual

Set number of entries to estimate variable limits.

Implements TVirtualTreePlayer.

Definition at line 2931 of file TTreePlayer.cxx.

◆ SetScanFileName()

void TTreePlayer::SetScanFileName ( const char *  name)
inline

Definition at line 125 of file TTreePlayer.h.

◆ SetScanRedirect()

void TTreePlayer::SetScanRedirect ( Bool_t  on = kFALSE)
inline

Definition at line 124 of file TTreePlayer.h.

◆ SetTree()

virtual void TTreePlayer::SetTree ( TTree t)
inlinevirtual

Implements TVirtualTreePlayer.

Definition at line 126 of file TTreePlayer.h.

◆ StartViewer()

void TTreePlayer::StartViewer ( Int_t  ww,
Int_t  wh 
)
virtual

Start the TTreeViewer on this TTree.

  • ww is the width of the canvas in pixels
  • wh is the height of the canvas in pixels

Implements TVirtualTreePlayer.

Definition at line 2942 of file TTreePlayer.cxx.

◆ TakeAction()

void TTreePlayer::TakeAction ( Int_t  nfill,
Int_t npoints,
Int_t action,
TObject obj,
Option_t option 
)
protected

◆ TakeEstimate()

void TTreePlayer::TakeEstimate ( Int_t  nfill,
Int_t npoints,
Int_t  action,
TObject obj,
Option_t option 
)
protected

◆ UnbinnedFit()

Int_t TTreePlayer::UnbinnedFit ( const char *  funcname,
const char *  varexp,
const char *  selection,
Option_t option,
Long64_t  nentries,
Long64_t  firstentry 
)
virtual

Unbinned fit of one or more variable(s) from a Tree.

funcname is a TF1 function.

See TTree::Draw for explanations of the other parameters.

Fit the variable varexp using the function funcname using the selection cuts given by selection.

The list of fit options is given in parameter option.

  • option = "Q" Quiet mode (minimum printing)
  • option = "V" Verbose mode (default is between Q and V)
  • option = "E" Perform better Errors estimation using Minos technique
  • option = "M" More. Improve fit results
  • option = "D" Draw the projected histogram with the fitted function normalized to the number of selected rows and multiplied by the bin width

You can specify boundary limits for some or all parameters via

func->SetParLimits(p_number, parmin, parmax);

if parmin>=parmax, the parameter is fixed

Note that you are not forced to fix the limits for all parameters. For example, if you fit a function with 6 parameters, you can do:

func->SetParameters(0,3.1,1.e-6,0.1,-8,100);
func->SetParLimits(4,-10,-4);
func->SetParLimits(5, 1,1);

With this setup, parameters 0->3 can vary freely

  • Parameter 4 has boundaries [-10,-4] with initial value -8
  • Parameter 5 is fixed to 100.

    For the fit to be meaningful, the function must be self-normalized.

i.e. It must have the same integral regardless of the parameter settings. Otherwise the fit will effectively just maximize the area.

It is mandatory to have a normalization variable which is fixed for the fit. e.g.

TF1* f1 = new TF1("f1", "gaus(0)/sqrt(2*3.14159)/[2]", 0, 5);
f1->SetParameters(1, 3.1, 0.01);
f1->SetParLimits(0, 1, 1); // fix the normalization parameter to 1
data->UnbinnedFit("f1", "jpsimass", "jpsipt>3.0");

1, 2 and 3 Dimensional fits are supported. See also TTree::Fit

Return status

The function return the status of the fit in the following form

fitResult = migradResult + 10*minosResult + 100*hesseResult + 1000*improveResult
  • The fitResult is 0 is the fit is OK.
  • The fitResult is negative in case of an error not connected with the fit.
  • The number of entries used in the fit can be obtained via
    mytree.GetSelectedRows();
  • If the number of selected entries is null the function returns -1

new implementation using new Fitter classes

Implements TVirtualTreePlayer.

Definition at line 3029 of file TTreePlayer.cxx.

◆ UpdateFormulaLeaves()

void TTreePlayer::UpdateFormulaLeaves ( )
virtual

this function is called by TChain::LoadTree when a new Tree is loaded.

Because Trees in a TChain may have a different list of leaves, one must update the leaves numbers in the TTreeFormula used by the TreePlayer.

Implements TVirtualTreePlayer.

Definition at line 3126 of file TTreePlayer.cxx.

Member Data Documentation

◆ fDimension

Int_t TTreePlayer::fDimension
protected

Definition at line 47 of file TTreePlayer.h.

◆ fFormulaList

TList* TTreePlayer::fFormulaList
protected

input list to the selector

Definition at line 54 of file TTreePlayer.h.

◆ fHistogram

TH1* TTreePlayer::fHistogram
protected

Definition at line 49 of file TTreePlayer.h.

◆ fInput

TList* TTreePlayer::fInput
protected

Pointer to the actual class of the TSelectorFromFile.

Definition at line 53 of file TTreePlayer.h.

◆ fScanFileName

const char* TTreePlayer::fScanFileName
protected

Definition at line 46 of file TTreePlayer.h.

◆ fScanRedirect

Bool_t TTreePlayer::fScanRedirect
protected

Pointer to current Tree.

Definition at line 45 of file TTreePlayer.h.

◆ fSelectedRows

Long64_t TTreePlayer::fSelectedRows
protected

Definition at line 48 of file TTreePlayer.h.

◆ fSelector

TSelectorDraw* TTreePlayer::fSelector
protected

Pointer to histogram used for the projection.

Definition at line 50 of file TTreePlayer.h.

◆ fSelectorClass

TClass* TTreePlayer::fSelectorClass
protected

Pointer to a user defined selector created by this TTreePlayer object.

Definition at line 52 of file TTreePlayer.h.

◆ fSelectorFromFile

TSelector* TTreePlayer::fSelectorFromFile
protected

Pointer to current selector.

Definition at line 51 of file TTreePlayer.h.

◆ fSelectorUpdate

TSelector* TTreePlayer::fSelectorUpdate
protected

Pointer to a list of coordinated list TTreeFormula (used by Scan and Query)

Definition at line 55 of file TTreePlayer.h.

◆ fTree

TTree* TTreePlayer::fTree
protected

Definition at line 44 of file TTreePlayer.h.


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