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. | |
~TTreePlayer () override | |
Tree destructor. | |
TVirtualIndex * | BuildIndex (const TTree *T, const char *majorname, const char *minorname) override |
Build the index for the tree (see TTree::BuildIndex) | |
TTree * | CopyTree (const char *selection, Option_t *option, Long64_t nentries, Long64_t firstentry) override |
Copy a Tree with selection, make a clone of this Tree header, then copy the selected entries. | |
Long64_t | DrawScript (const char *wrapperPrefix, const char *macrofilename, const char *cutfilename, Option_t *option, Long64_t nentries, Long64_t firstentry) override |
Draw the result of a C++ script. | |
Long64_t | DrawSelect (const char *varexp, const char *selection, Option_t *option, Long64_t nentries, Long64_t firstentry) override |
Draw expression varexp for specified entries that matches the selection. | |
Int_t | Fit (const char *formula, const char *varexp, const char *selection, Option_t *option, Option_t *goption, Long64_t nentries, Long64_t firstentry) override |
Fit a projected item(s) from a Tree. | |
Int_t | GetDimension () const override |
Long64_t | GetEntries (const char *selection) override |
Return the number of entries matching the selection. | |
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 | |
TH1 * | GetHistogram () const override |
Int_t | GetNfill () const override |
const char * | GetScanFileName () const |
TTreeFormula * | GetSelect () const override |
Long64_t | GetSelectedRows () const override |
TSelector * | GetSelector () const override |
TSelector * | GetSelectorFromFile () const override |
Double_t * | GetV1 () const override |
See TSelectorDraw::GetVal. | |
Double_t * | GetV2 () const override |
See TSelectorDraw::GetVal. | |
Double_t * | GetV3 () const override |
See TSelectorDraw::GetVal. | |
Double_t * | GetV4 () const override |
See TSelectorDraw::GetVal. | |
Double_t * | GetVal (Int_t i) const override |
See TSelectorDraw::GetVal. | |
TTreeFormula * | GetVar (Int_t i) const override |
See TSelectorDraw::GetVar. | |
TTreeFormula * | GetVar1 () const override |
See TSelectorDraw::GetVar. | |
TTreeFormula * | GetVar2 () const override |
See TSelectorDraw::GetVar. | |
TTreeFormula * | GetVar3 () const override |
See TSelectorDraw::GetVar. | |
TTreeFormula * | GetVar4 () const override |
See TSelectorDraw::GetVar. | |
Double_t * | GetW () const override |
TClass * | IsA () const override |
Int_t | MakeClass (const char *classname, Option_t *option) override |
Generate skeleton analysis class for this Tree. | |
Int_t | MakeCode (const char *filename) override |
Generate skeleton function for this Tree. | |
Int_t | MakeProxy (const char *classname, const char *macrofilename=nullptr, const char *cutfilename=nullptr, const char *option=nullptr, Int_t maxUnrolling=3) override |
Generate a skeleton analysis class for this Tree using TBranchProxy. | |
Int_t | MakeReader (const char *classname, Option_t *option) override |
Generate skeleton selector class for this tree. | |
TPrincipal * | Principal (const char *varexp, const char *selection, Option_t *option, Long64_t nentries, Long64_t firstentry) override |
Interface to the Principal Components Analysis class. | |
Long64_t | Process (const char *filename, Option_t *option, Long64_t nentries, Long64_t firstentry) override |
Process this tree executing the TSelector code in the specified filename. | |
Long64_t | Process (TSelector *selector, Option_t *option, Long64_t nentries, Long64_t firstentry) override |
Process this tree executing the code in the specified selector. | |
TSQLResult * | Query (const char *varexp, const char *selection, Option_t *option, Long64_t nentries, Long64_t firstentry) override |
Loop on Tree and return TSQLResult object containing entries passing selection. | |
void | RecursiveRemove (TObject *obj) override |
cleanup pointers in the player pointing to obj | |
Long64_t | Scan (const char *varexp, const char *selection, Option_t *option, Long64_t nentries, Long64_t firstentry) override |
Loop on Tree and print entries passing selection. | |
bool | ScanRedirected () |
void | SetEstimate (Long64_t n) override |
Set number of entries to estimate variable limits. | |
void | SetScanFileName (const char *name) |
void | SetScanRedirect (bool on=false) |
void | SetTree (TTree *t) override |
void | StartViewer (Int_t ww, Int_t wh) override |
Start the TTreeViewer on this TTree. | |
void | Streamer (TBuffer &) override |
Stream an object of class TObject. | |
void | StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b) |
Int_t | UnbinnedFit (const char *formula, const char *varexp, const char *selection, Option_t *option, Long64_t nentries, Long64_t firstentry) override |
Unbinned fit of one or more variable(s) from a Tree. | |
void | UpdateFormulaLeaves () override |
this function is called by TChain::LoadTree when a new Tree is loaded. | |
Public Member Functions inherited from TVirtualTreePlayer | |
TVirtualTreePlayer () | |
~TVirtualTreePlayer () override | |
Common destructor. | |
TClass * | IsA () const override |
void | Streamer (TBuffer &) override |
Stream an object of class TObject. | |
void | StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b) |
Public Member Functions inherited from TObject | |
TObject () | |
TObject constructor. | |
TObject (const TObject &object) | |
TObject copy ctor. | |
virtual | ~TObject () |
TObject destructor. | |
void | AbstractMethod (const char *method) const |
Use this method to implement an "abstract" method that you don't want to leave purely abstract. | |
virtual void | AppendPad (Option_t *option="") |
Append graphics object to current pad. | |
virtual void | Browse (TBrowser *b) |
Browse object. May be overridden for another default action. | |
ULong_t | CheckedHash () |
Check and record whether this class has a consistent Hash/RecursiveRemove setup (*) and then return the regular Hash value for this object. | |
virtual const char * | ClassName () const |
Returns name of class to which the object belongs. | |
virtual void | Clear (Option_t *="") |
virtual TObject * | Clone (const char *newname="") const |
Make a clone of an object using the Streamer facility. | |
virtual Int_t | Compare (const TObject *obj) const |
Compare abstract method. | |
virtual void | Copy (TObject &object) const |
Copy this to obj. | |
virtual void | Delete (Option_t *option="") |
Delete this object. | |
virtual Int_t | DistancetoPrimitive (Int_t px, Int_t py) |
Computes distance from point (px,py) to the object. | |
virtual void | Draw (Option_t *option="") |
Default Draw method for all objects. | |
virtual void | DrawClass () const |
Draw class inheritance tree of the class to which this object belongs. | |
virtual TObject * | DrawClone (Option_t *option="") const |
Draw a clone of this object in the current selected pad with: gROOT->SetSelectedPad(c1) . | |
virtual void | Dump () const |
Dump contents of object on stdout. | |
virtual void | Error (const char *method, const char *msgfmt,...) const |
Issue error message. | |
virtual void | Execute (const char *method, const char *params, Int_t *error=nullptr) |
Execute method on this object with the given parameter string, e.g. | |
virtual void | Execute (TMethod *method, TObjArray *params, Int_t *error=nullptr) |
Execute method on this object with parameters stored in the TObjArray. | |
virtual void | ExecuteEvent (Int_t event, Int_t px, Int_t py) |
Execute action corresponding to an event at (px,py). | |
virtual void | Fatal (const char *method, const char *msgfmt,...) const |
Issue fatal error message. | |
virtual TObject * | FindObject (const char *name) const |
Must be redefined in derived classes. | |
virtual TObject * | FindObject (const TObject *obj) const |
Must be redefined in derived classes. | |
virtual Option_t * | GetDrawOption () const |
Get option used by the graphics system to draw this object. | |
virtual const char * | GetIconName () const |
Returns mime type name of object. | |
virtual const char * | GetName () const |
Returns name of object. | |
virtual char * | GetObjectInfo (Int_t px, Int_t py) const |
Returns string containing info about the object at position (px,py). | |
virtual Option_t * | GetOption () const |
virtual const char * | GetTitle () const |
Returns title of object. | |
virtual UInt_t | GetUniqueID () const |
Return the unique object id. | |
virtual Bool_t | HandleTimer (TTimer *timer) |
Execute action in response of a timer timing out. | |
virtual ULong_t | Hash () const |
Return hash value for this object. | |
Bool_t | HasInconsistentHash () const |
Return true is the type of this object is known to have an inconsistent setup for Hash and RecursiveRemove (i.e. | |
virtual void | Info (const char *method, const char *msgfmt,...) const |
Issue info message. | |
virtual Bool_t | InheritsFrom (const char *classname) const |
Returns kTRUE if object inherits from class "classname". | |
virtual Bool_t | InheritsFrom (const TClass *cl) const |
Returns kTRUE if object inherits from TClass cl. | |
virtual void | Inspect () const |
Dump contents of this object in a graphics canvas. | |
void | InvertBit (UInt_t f) |
Bool_t | IsDestructed () const |
IsDestructed. | |
virtual Bool_t | IsEqual (const TObject *obj) const |
Default equal comparison (objects are equal if they have the same address in memory). | |
virtual Bool_t | IsFolder () const |
Returns kTRUE in case object contains browsable objects (like containers or lists of other objects). | |
R__ALWAYS_INLINE Bool_t | IsOnHeap () const |
virtual Bool_t | IsSortable () const |
R__ALWAYS_INLINE Bool_t | IsZombie () const |
virtual void | ls (Option_t *option="") const |
The ls function lists the contents of a class on stdout. | |
void | MayNotUse (const char *method) const |
Use this method to signal that a method (defined in a base class) may not be called in a derived class (in principle against good design since a child class should not provide less functionality than its parent, however, sometimes it is necessary). | |
virtual Bool_t | Notify () |
This method must be overridden to handle object notification (the base implementation is no-op). | |
void | Obsolete (const char *method, const char *asOfVers, const char *removedFromVers) const |
Use this method to declare a method obsolete. | |
void | operator delete (void *ptr) |
Operator delete. | |
void | operator delete (void *ptr, void *vp) |
Only called by placement new when throwing an exception. | |
void | operator delete[] (void *ptr) |
Operator delete []. | |
void | operator delete[] (void *ptr, void *vp) |
Only called by placement new[] when throwing an exception. | |
void * | operator new (size_t sz) |
void * | operator new (size_t sz, void *vp) |
void * | operator new[] (size_t sz) |
void * | operator new[] (size_t sz, void *vp) |
TObject & | operator= (const TObject &rhs) |
TObject assignment operator. | |
virtual void | Paint (Option_t *option="") |
This method must be overridden if a class wants to paint itself. | |
virtual void | Pop () |
Pop on object drawn in a pad to the top of the display list. | |
virtual void | Print (Option_t *option="") const |
This method must be overridden when a class wants to print itself. | |
virtual Int_t | Read (const char *name) |
Read contents of object with specified name from the current directory. | |
void | ResetBit (UInt_t f) |
virtual void | SaveAs (const char *filename="", Option_t *option="") const |
Save this object in the file specified by filename. | |
virtual void | SavePrimitive (std::ostream &out, Option_t *option="") |
Save a primitive as a C++ statement(s) on output stream "out". | |
void | SetBit (UInt_t f) |
void | SetBit (UInt_t f, Bool_t set) |
Set or unset the user status bits as specified in f. | |
virtual void | SetDrawOption (Option_t *option="") |
Set drawing option for object. | |
virtual void | SetUniqueID (UInt_t uid) |
Set the unique object id. | |
void | StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b) |
virtual void | SysError (const char *method, const char *msgfmt,...) const |
Issue system error message. | |
R__ALWAYS_INLINE Bool_t | TestBit (UInt_t f) const |
Int_t | TestBits (UInt_t f) const |
virtual void | UseCurrentStyle () |
Set current style settings in this object This function is called when either TCanvas::UseCurrentStyle or TROOT::ForceStyle have been invoked. | |
virtual void | Warning (const char *method, const char *msgfmt,...) const |
Issue warning message. | |
virtual Int_t | Write (const char *name=nullptr, Int_t option=0, Int_t bufsize=0) |
Write this object to the current directory. | |
virtual Int_t | Write (const char *name=nullptr, Int_t option=0, Int_t bufsize=0) const |
Write this object to the current directory. | |
Static Public Member Functions | |
static TClass * | Class () |
static const char * | Class_Name () |
static constexpr Version_t | Class_Version () |
static const char * | DeclFileName () |
Static Public Member Functions inherited from TVirtualTreePlayer | |
static TClass * | Class () |
static const char * | Class_Name () |
static constexpr Version_t | Class_Version () |
static const char * | DeclFileName () |
static TVirtualTreePlayer * | GetCurrentPlayer () |
Static function: return the current player (if any) | |
static void | SetPlayer (const char *player) |
Static function to set an alternative Tree player. | |
static TVirtualTreePlayer * | TreePlayer (TTree *obj) |
Static function returning a pointer to a Tree player. | |
Static Public Member Functions inherited from TObject | |
static TClass * | Class () |
static const char * | Class_Name () |
static constexpr Version_t | Class_Version () |
static const char * | DeclFileName () |
static Longptr_t | GetDtorOnly () |
Return destructor only flag. | |
static Bool_t | GetObjectStat () |
Get status of object stat flag. | |
static void | SetDtorOnly (void *obj) |
Set destructor only flag. | |
static void | SetObjectStat (Bool_t stat) |
Turn on/off tracking of objects in the TObjectTable. | |
Protected Member Functions | |
void | DeleteSelectorFromFile () |
Delete any selector created by this object. | |
const char * | GetNameByIndex (TString &varexp, Int_t *index, Int_t colindex) |
Return name corresponding to colindex in varexp. | |
Protected Member Functions inherited from TObject | |
virtual void | DoError (int level, const char *location, const char *fmt, va_list va) const |
Interface to ErrorHandler (protected). | |
void | MakeZombie () |
Protected Attributes | |
Int_t | fDimension |
Dimension of the current expression. | |
TList * | fFormulaList |
! Pointer to a list of coordinated list TTreeFormula (used by Scan and Query) | |
TH1 * | fHistogram |
! Pointer to histogram used for the projection | |
TList * | fInput |
! input list to the selector | |
const char * | fScanFileName |
Name of the file where Scan is redirected. | |
bool | fScanRedirect |
Switch to redirect TTree::Scan output to a file. | |
Long64_t | fSelectedRows |
Number of selected entries. | |
TSelectorDraw * | fSelector |
! Pointer to current selector | |
TClass * | fSelectorClass |
! Pointer to the actual class of the TSelectorFromFile | |
TSelector * | fSelectorFromFile |
! Pointer to a user defined selector created by this TTreePlayer object | |
TSelector * | fSelectorUpdate |
! Set to the selector address when it's entry list needs to be updated by the UpdateFormulaLeaves function | |
TTree * | fTree |
! Pointer to current Tree | |
Private Member Functions | |
TTreePlayer (const TTreePlayer &)=delete | |
TTreePlayer & | operator= (const TTreePlayer &)=delete |
Additional Inherited Members | |
Public Types inherited from TObject | |
enum | { kIsOnHeap = 0x01000000 , kNotDeleted = 0x02000000 , kZombie = 0x04000000 , kInconsistent = 0x08000000 , kBitMask = 0x00ffffff } |
enum | { kSingleKey = (1ULL << ( 0 )) , kOverwrite = (1ULL << ( 1 )) , kWriteDelete = (1ULL << ( 2 )) } |
enum | EDeprecatedStatusBits { kObjInCanvas = (1ULL << ( 3 )) } |
enum | EStatusBits { kCanDelete = (1ULL << ( 0 )) , kMustCleanup = (1ULL << ( 3 )) , kIsReferenced = (1ULL << ( 4 )) , kHasUUID = (1ULL << ( 5 )) , kCannotPick = (1ULL << ( 6 )) , kNoContextMenu = (1ULL << ( 8 )) , kInvalidObject = (1ULL << ( 13 )) } |
Static Public Attributes inherited from TVirtualTreePlayer | |
static constexpr Long64_t | kMaxEntries = std::numeric_limits<Long64_t>::max() |
Protected Types inherited from TObject | |
enum | { kOnlyPrepStep = (1ULL << ( 3 )) } |
#include <TTreePlayer.h>
|
privatedelete |
TTreePlayer::TTreePlayer | ( | ) |
Default Tree constructor.
Definition at line 107 of file TTreePlayer.cxx.
|
override |
Tree destructor.
Definition at line 136 of file TTreePlayer.cxx.
|
overridevirtual |
Build the index for the tree (see TTree::BuildIndex)
Implements TVirtualTreePlayer.
Definition at line 150 of file TTreePlayer.cxx.
|
static |
|
inlinestaticconstexpr |
Definition at line 130 of file TTreePlayer.h.
|
overridevirtual |
Copy a Tree with selection, make a clone of this Tree header, then copy the selected entries.
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
Implements TVirtualTreePlayer.
Definition at line 195 of file TTreePlayer.cxx.
|
inlinestatic |
Definition at line 130 of file TTreePlayer.h.
|
protected |
Delete any selector created by this object.
The selector has been created using TSelector::GetSelector(file)
Definition at line 260 of file TTreePlayer.cxx.
|
overridevirtual |
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:
If a cutfilename is specified, for each entry, we execute
If no cutfilename is specified, for each entry we execute
The default for the histogram are the same as for TTreePlayer::DrawSelect
Implements TVirtualTreePlayer.
Definition at line 303 of file TTreePlayer.cxx.
|
overridevirtual |
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 347 of file TTreePlayer.cxx.
|
overridevirtual |
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:
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 569 of file TTreePlayer.cxx.
|
inlineoverridevirtual |
Implements TVirtualTreePlayer.
Definition at line 74 of file TTreePlayer.h.
|
overridevirtual |
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 599 of file TTreePlayer.cxx.
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 612 of file TTreePlayer.cxx.
|
inlineoverridevirtual |
Implements TVirtualTreePlayer.
Definition at line 75 of file TTreePlayer.h.
|
protected |
Return name corresponding to colindex in varexp.
Definition at line 632 of file TTreePlayer.cxx.
|
inlineoverridevirtual |
Implements TVirtualTreePlayer.
Definition at line 78 of file TTreePlayer.h.
|
inline |
Definition at line 79 of file TTreePlayer.h.
|
inlineoverridevirtual |
Implements TVirtualTreePlayer.
Definition at line 80 of file TTreePlayer.h.
|
inlineoverridevirtual |
Implements TVirtualTreePlayer.
Definition at line 81 of file TTreePlayer.h.
|
inlineoverridevirtual |
Implements TVirtualTreePlayer.
Definition at line 82 of file TTreePlayer.h.
|
inlineoverridevirtual |
Implements TVirtualTreePlayer.
Definition at line 83 of file TTreePlayer.h.
|
inlineoverridevirtual |
Implements TVirtualTreePlayer.
Definition at line 97 of file TTreePlayer.h.
|
inlineoverridevirtual |
Implements TVirtualTreePlayer.
Definition at line 99 of file TTreePlayer.h.
|
inlineoverridevirtual |
Implements TVirtualTreePlayer.
Definition at line 101 of file TTreePlayer.h.
|
inlineoverridevirtual |
Implements TVirtualTreePlayer.
Definition at line 103 of file TTreePlayer.h.
Implements TVirtualTreePlayer.
Definition at line 95 of file TTreePlayer.h.
|
inlineoverridevirtual |
Implements TVirtualTreePlayer.
Definition at line 85 of file TTreePlayer.h.
|
inlineoverridevirtual |
Implements TVirtualTreePlayer.
Definition at line 87 of file TTreePlayer.h.
|
inlineoverridevirtual |
Implements TVirtualTreePlayer.
Definition at line 89 of file TTreePlayer.h.
|
inlineoverridevirtual |
Implements TVirtualTreePlayer.
Definition at line 91 of file TTreePlayer.h.
|
inlineoverridevirtual |
Implements TVirtualTreePlayer.
Definition at line 93 of file TTreePlayer.h.
|
inlineoverridevirtual |
Implements TVirtualTreePlayer.
Definition at line 104 of file TTreePlayer.h.
|
inlineoverridevirtual |
Reimplemented from TObject.
Definition at line 130 of file TTreePlayer.h.
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:
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 730 of file TTreePlayer.cxx.
|
overridevirtual |
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:
To use this function:
NOTE: Since the implementation of this function, a new and better function TTree::MakeClass() has been developed.
Implements TVirtualTreePlayer.
Definition at line 1560 of file TTreePlayer.cxx.
|
overridevirtual |
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:
The skeleton will then be generated in the file:
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:
"option" can be used select some of the optional features during the code generation. The possible options are:
'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:
For example with Event.root, if
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:
and
x_t and y_t needs to be types that can convert respectively to a double and a bool (because the skeleton uses:
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
is more efficient than
Access to TClonesArray.
If a branch (or member) is a TClonesArray (let's say fTracks), you can access the TClonesArray itself by using ->:
However this will load the full TClonesArray object and its content. To quickly read the size of the TClonesArray use (note the dot):
This will read only the size from disk if the TClonesArray has been split. To access the content of the TClonesArray, use the [] operator:
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:
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,
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:
MakeProxy can then be used indirectly via the TTree::Draw interface as follow:
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 1925 of file TTreePlayer.cxx.
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.
The generated code in classname.h includes the following:
The selector derives from TSelector. The generated code in classname.C includes empty functions defined above.
To use this function:
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:
Implements TVirtualTreePlayer.
Definition at line 1985 of file TTreePlayer.cxx.
|
privatedelete |
|
overridevirtual |
Interface to the Principal Components Analysis class.
Create an instance of TPrincipal Fill it with the selected variables
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 2015 of file TTreePlayer.cxx.
|
overridevirtual |
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:
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.
It may be more interesting to invoke directly the other Process function accepting a TSelector* as argument.eg
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
or use ACLIC to compile the selector
Implements TVirtualTreePlayer.
Definition at line 2197 of file TTreePlayer.cxx.
|
overridevirtual |
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:
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 2237 of file TTreePlayer.cxx.
|
overridevirtual |
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 2824 of file TTreePlayer.cxx.
|
overridevirtual |
cleanup pointers in the player pointing to obj
Reimplemented from TObject.
Definition at line 2353 of file TTreePlayer.cxx.
|
overridevirtual |
Loop on Tree and print entries passing selection.
Interactive pagination break is on by default.
varexp | 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". |
selection | a text formula selecting which entries to scan |
firstentry | first entry to scan |
nentries | total number of entries to scan (starting from firstentry). Defaults to all entries. |
By default 50 lines are shown and you are asked for <CR>
or q
to see the next 50 lines. Depending on the Tree structure, one entry might be printed across several lines, distinguished by the Instance
column. You can change the default number of lines to be shown before <CR>
or q
via mytree->SetScanField(maxlines) where maxlines is 50 by default. If maxlines is set to 0 all entries of the Tree are shown, and you are not prompted to press <CR>
or q
to end the loop.
This option is interesting when dumping the contents of a Tree to an ascii file, eg from the command line.
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:
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).
option | The options string can contains the following parameters: |
For example:
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:
Implements TVirtualTreePlayer.
Definition at line 2445 of file TTreePlayer.cxx.
|
inline |
Definition at line 118 of file TTreePlayer.h.
|
overridevirtual |
Set number of entries to estimate variable limits.
Implements TVirtualTreePlayer.
Definition at line 2957 of file TTreePlayer.cxx.
|
inline |
Definition at line 123 of file TTreePlayer.h.
|
inline |
Definition at line 122 of file TTreePlayer.h.
|
inlineoverridevirtual |
Implements TVirtualTreePlayer.
Definition at line 124 of file TTreePlayer.h.
Start the TTreeViewer on this TTree.
Implements TVirtualTreePlayer.
Definition at line 2968 of file TTreePlayer.cxx.
|
overridevirtual |
|
inline |
Definition at line 130 of file TTreePlayer.h.
|
overridevirtual |
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.
You can specify boundary limits for some or all parameters via
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:
With this setup, parameters 0->3 can vary freely
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.
1, 2 and 3 Dimensional fits are supported. See also TTree::Fit
The function return the status of the fit in the following form
new implementation using new Fitter classes
Implements TVirtualTreePlayer.
Definition at line 3068 of file TTreePlayer.cxx.
|
overridevirtual |
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 3165 of file TTreePlayer.cxx.
|
protected |
Dimension of the current expression.
Definition at line 47 of file TTreePlayer.h.
|
protected |
! Pointer to a list of coordinated list TTreeFormula (used by Scan and Query)
Definition at line 54 of file TTreePlayer.h.
|
protected |
! Pointer to histogram used for the projection
Definition at line 49 of file TTreePlayer.h.
|
protected |
! input list to the selector
Definition at line 53 of file TTreePlayer.h.
|
protected |
Name of the file where Scan is redirected.
Definition at line 46 of file TTreePlayer.h.
|
protected |
Switch to redirect TTree::Scan output to a file.
Definition at line 45 of file TTreePlayer.h.
|
protected |
Number of selected entries.
Definition at line 48 of file TTreePlayer.h.
|
protected |
! Pointer to current selector
Definition at line 50 of file TTreePlayer.h.
|
protected |
! Pointer to the actual class of the TSelectorFromFile
Definition at line 52 of file TTreePlayer.h.
|
protected |
! Pointer to a user defined selector created by this TTreePlayer object
Definition at line 51 of file TTreePlayer.h.
|
protected |
! Set to the selector address when it's entry list needs to be updated by the UpdateFormulaLeaves function
Definition at line 55 of file TTreePlayer.h.
|
protected |
! Pointer to current Tree
Definition at line 44 of file TTreePlayer.h.