Logo ROOT   6.07/09
Reference Guide
TTree.h
Go to the documentation of this file.
1 // @(#)root/tree:$Id$
2 // Author: Rene Brun 12/01/96
3 
4 /*************************************************************************
5  * Copyright (C) 1995-2000, Rene Brun and Fons Rademakers. *
6  * All rights reserved. *
7  * *
8  * For the licensing terms see $ROOTSYS/LICENSE. *
9  * For the list of contributors see $ROOTSYS/README/CREDITS. *
10  *************************************************************************/
11 
12 #ifndef ROOT_TTree
13 #define ROOT_TTree
14 
15 //////////////////////////////////////////////////////////////////////////
16 // //
17 // TTree //
18 // //
19 // A TTree object is a list of TBranch. //
20 // To Create a TTree object one must: //
21 // - Create the TTree header via the TTree constructor //
22 // - Call the TBranch constructor for every branch. //
23 // //
24 // To Fill this object, use member function Fill with no parameters. //
25 // The Fill function loops on all defined TBranch. //
26 // //
27 //////////////////////////////////////////////////////////////////////////
28 
29 #ifndef ROOT_TBranch
30 #include "TBranch.h"
31 #endif
32 
33 #ifndef ROOT_TObjArray
34 #include "TObjArray.h"
35 #endif
36 
37 #ifndef ROOT_TAttLine
38 #include "TAttLine.h"
39 #endif
40 
41 #ifndef ROOT_TAttFill
42 #include "TAttFill.h"
43 #endif
44 
45 #ifndef ROOT_TAttMarker
46 #include "TAttMarker.h"
47 #endif
48 
49 #ifndef ROOT_TArrayD
50 #include "TArrayD.h"
51 #endif
52 
53 #ifndef ROOT_TArrayI
54 #include "TArrayI.h"
55 #endif
56 
57 #ifndef ROOT_TBuffer
58 #include "TBuffer.h"
59 #endif
60 
61 #ifndef ROOT_TDataType
62 #include "TDataType.h"
63 #endif
64 
65 #ifndef ROOT_TClass
66 #include "TClass.h"
67 #endif
68 
69 #ifndef ROOT_TVirtualTreePlayer
70 #include "TVirtualTreePlayer.h"
71 #endif
72 
73 class TBranch;
74 class TBrowser;
75 class TFile;
76 class TDirectory;
77 class TLeaf;
78 class TH1;
79 class TTreeFormula;
80 class TPolyMarker;
81 class TEventList;
82 class TEntryList;
83 class TList;
84 class TSQLResult;
85 class TSelector;
86 class TPrincipal;
87 class TFriendElement;
88 class TCut;
89 class TVirtualIndex;
90 class TBranchRef;
91 class TBasket;
92 class TStreamerInfo;
93 class TTreeCache;
94 class TTreeCloner;
95 class TFileMergeInfo;
96 class TVirtualPerfStats;
97 
98 class TTree : public TNamed, public TAttLine, public TAttFill, public TAttMarker {
99 
100 protected:
101  Long64_t fEntries; ///< Number of entries
102  Long64_t fTotBytes; ///< Total number of bytes in all branches before compression
103  Long64_t fZipBytes; ///< Total number of bytes in all branches after compression
104  Long64_t fSavedBytes; ///< Number of autosaved bytes
105  Long64_t fFlushedBytes; ///< Number of auto-flushed bytes
106  Double_t fWeight; ///< Tree weight (see TTree::SetWeight)
107  Int_t fTimerInterval; ///< Timer interval in milliseconds
108  Int_t fScanField; ///< Number of runs before prompting in Scan
109  Int_t fUpdate; ///< Update frequency for EntryLoop
110  Int_t fDefaultEntryOffsetLen; ///< Initial Length of fEntryOffset table in the basket buffers
111  Int_t fNClusterRange; ///< Number of Cluster range in addition to the one defined by 'AutoFlush'
112  Int_t fMaxClusterRange; ///<! Memory allocated for the cluster range.
113  Long64_t fMaxEntries; ///< Maximum number of entries in case of circular buffers
114  Long64_t fMaxEntryLoop; ///< Maximum number of entries to process
115  Long64_t fMaxVirtualSize; ///< Maximum total size of buffers kept in memory
116  Long64_t fAutoSave; ///< Autosave tree when fAutoSave entries written or -fAutoSave (compressed) bytes produced
117  Long64_t fAutoFlush; ///< Auto-flush tree when fAutoFlush entries written or -fAutoFlush (compressed) bytes produced
118  Long64_t fEstimate; ///< Number of entries to estimate histogram limits
119  Long64_t *fClusterRangeEnd; ///<[fNClusterRange] Last entry of a cluster range.
120  Long64_t *fClusterSize; ///<[fNClusterRange] Number of entries in each cluster for a given range.
121  Long64_t fCacheSize; ///<! Maximum size of file buffers
122  Long64_t fChainOffset; ///<! Offset of 1st entry of this Tree in a TChain
123  Long64_t fReadEntry; ///<! Number of the entry being processed
124  std::atomic<Long64_t> fTotalBuffers; ///<! Total number of bytes in branch buffers
125  Int_t fPacketSize; ///<! Number of entries in one packet for parallel root
126  Int_t fNfill; ///<! Local for EntryLoop
127  Int_t fDebug; ///<! Debug level
128  Long64_t fDebugMin; ///<! First entry number to debug
129  Long64_t fDebugMax; ///<! Last entry number to debug
130  Int_t fMakeClass; ///<! not zero when processing code generated by MakeClass
131  Int_t fFileNumber; ///<! current file number (if file extensions)
132  TObject *fNotify; ///<! Object to be notified when loading a Tree
133  TDirectory *fDirectory; ///<! Pointer to directory holding this tree
134  TObjArray fBranches; ///< List of Branches
135  TObjArray fLeaves; ///< Direct pointers to individual branch leaves
136  TList *fAliases; ///< List of aliases for expressions based on the tree branches.
137  TEventList *fEventList; ///<! Pointer to event selection list (if one)
138  TEntryList *fEntryList; ///<! Pointer to event selection list (if one)
139  TArrayD fIndexValues; ///< Sorted index values
140  TArrayI fIndex; ///< Index of sorted values
141  TVirtualIndex *fTreeIndex; ///< Pointer to the tree Index (if any)
142  TList *fFriends; ///< pointer to list of friend elements
143  TVirtualPerfStats *fPerfStats; ///<! pointer to the current perf stats object
144  TList *fUserInfo; ///< pointer to a list of user objects associated to this Tree
145  TVirtualTreePlayer *fPlayer; ///<! Pointer to current Tree player
146  TList *fClones; ///<! List of cloned trees which share our addresses
147  TBranchRef *fBranchRef; ///< Branch supporting the TRefTable (if any)
148  UInt_t fFriendLockStatus; ///<! Record which method is locking the friend recursion
149  TBuffer *fTransientBuffer; ///<! Pointer to the current transient buffer.
150  Bool_t fCacheDoAutoInit; ///<! true if cache auto creation or resize check is needed
151  Bool_t fCacheUserSet; ///<! true if the cache setting was explicitly given by user
152  Bool_t fIMTEnabled; ///<! true if implicit multi-threading is enabled for this tree
153  UInt_t fNEntriesSinceSorting; ///<! Number of entries processed since the last re-sorting of branches
154  std::vector<std::pair<Long64_t,TBranch*>> fSortedBranches; ///<! Branches sorted by average task time
155 
156  static Int_t fgBranchStyle; ///< Old/New branch style
157  static Long64_t fgMaxTreeSize; ///< Maximum size of a file containing a Tree
158 
159 private:
160  TTree(const TTree& tt); // not implemented
161  TTree& operator=(const TTree& tt); // not implemented
162 
164  void SortBranchesByTime();
165 
166 protected:
167  void AddClone(TTree*);
168  virtual void KeepCircular();
169  virtual TBranch *BranchImp(const char* branchname, const char* classname, TClass* ptrClass, void* addobj, Int_t bufsize, Int_t splitlevel);
170  virtual TBranch *BranchImp(const char* branchname, TClass* ptrClass, void* addobj, Int_t bufsize, Int_t splitlevel);
171  virtual TBranch *BranchImpRef(const char* branchname, const char* classname, TClass* ptrClass, void* addobj, Int_t bufsize, Int_t splitlevel);
172  virtual TBranch *BranchImpRef(const char* branchname, TClass* ptrClass, EDataType datatype, void* addobj, Int_t bufsize, Int_t splitlevel);
173  virtual Int_t CheckBranchAddressType(TBranch* branch, TClass* ptrClass, EDataType datatype, Bool_t ptr);
174  virtual TBranch *BronchExec(const char* name, const char* classname, void* addobj, Bool_t isptrptr, Int_t bufsize, Int_t splitlevel);
175  friend TBranch *TTreeBranchImpRef(TTree *tree, const char* branchname, TClass* ptrClass, EDataType datatype, void* addobj, Int_t bufsize, Int_t splitlevel);
176  Int_t SetBranchAddressImp(TBranch *branch, void* addr, TBranch** ptr);
177  virtual TLeaf *GetLeafImpl(const char* branchname, const char* leafname);
178 
179  Long64_t GetCacheAutoSize(Bool_t withDefault = kFALSE) const;
180  char GetNewlineValue(std::istream &inputStream);
182  void ImportClusterRanges(TTree *fromtree);
183  void MoveReadCache(TFile *src, TDirectory *dir);
184  Int_t SetCacheSizeAux(Bool_t autocache = kTRUE, Long64_t cacheSize = 0);
185 
186  class TFriendLock {
187  // Helper class to prevent infinite recursion in the
188  // usage of TTree Friends. Implemented in TTree.cxx.
189  TTree *fTree; // Pointer to the locked tree
190  UInt_t fMethodBit; // BIT for the locked method
191  Bool_t fPrevious; // Previous value of the BIT.
192 
193  protected:
194  TFriendLock(const TFriendLock&);
196 
197  public:
198  TFriendLock(TTree* tree, UInt_t methodbit);
199  ~TFriendLock();
200  };
201  friend class TFriendLock;
202  // So that the index class can use TFriendLock:
203  friend class TTreeIndex;
204  friend class TChainIndex;
205  // So that the TTreeCloner can access the protected interfaces
206  friend class TTreeCloner;
207 
208  // use to update fFriendLockStatus
218  kGetLeaf = BIT(8),
220  kPrint = BIT(10),
223  };
224 
225 public:
226  // Used as the max value for any TTree range operation.
228 
229  // SetBranchAddress return values
234  kMismatch = -2,
236  kMatch = 0,
240  kVoidPtr = 4,
242  };
243 
244  // TTree status bits
245  enum {
248  };
249 
250  // Split level modifier
251  enum {
253  };
254 
256  {
257  private:
258  TTree *fTree; // TTree upon which we are iterating.
259  Int_t fClusterRange; // Which cluster range are we looking at.
260  Long64_t fStartEntry; // Where does the cluster start.
261  Long64_t fNextEntry; // Where does the cluster end (exclusive).
262 
263  Long64_t GetEstimatedClusterSize();
264 
265  protected:
266  friend class TTree;
267  TClusterIterator(TTree *tree, Long64_t firstEntry);
268 
269  public:
270  // Intentionally used the default copy constructor and default destructor
271  // as the TClusterIterator does not own the TTree.
272  // TClusterIterator(const TClusterIterator&);
273  // ~TClusterIterator();
274 
275  // No public constructors, the iterator must be
276  // created via TTree::GetClusterIterator
277 
278  // Move on to the next cluster and return the starting entry
279  // of this next cluster
280  Long64_t Next();
281 
282  // Return the start entry of the current cluster.
284  return fStartEntry;
285  }
286 
287  // Return the first entry of the next cluster.
289  return fNextEntry;
290  }
291 
292  Long64_t operator()() { return Next(); }
293  };
294 
295  TTree();
296  TTree(const char* name, const char* title, Int_t splitlevel = 99);
297  virtual ~TTree();
298 
299  virtual Int_t AddBranchToCache(const char *bname, Bool_t subbranches = kFALSE);
300  virtual Int_t AddBranchToCache(TBranch *branch, Bool_t subbranches = kFALSE);
301  virtual Int_t DropBranchFromCache(const char *bname, Bool_t subbranches = kFALSE);
302  virtual Int_t DropBranchFromCache(TBranch *branch, Bool_t subbranches = kFALSE);
303  virtual TFriendElement *AddFriend(const char* treename, const char* filename = "");
304  virtual TFriendElement *AddFriend(const char* treename, TFile* file);
305  virtual TFriendElement *AddFriend(TTree* tree, const char* alias = "", Bool_t warn = kFALSE);
306  virtual void AddTotBytes(Int_t tot) { fTotBytes += tot; }
307  virtual void AddZipBytes(Int_t zip) { fZipBytes += zip; }
308  virtual Long64_t AutoSave(Option_t* option = "");
309  virtual Int_t Branch(TCollection* list, Int_t bufsize = 32000, Int_t splitlevel = 99, const char* name = "");
310  virtual Int_t Branch(TList* list, Int_t bufsize = 32000, Int_t splitlevel = 99);
311  virtual Int_t Branch(const char* folder, Int_t bufsize = 32000, Int_t splitlevel = 99);
312  virtual TBranch *Branch(const char* name, void* address, const char* leaflist, Int_t bufsize = 32000);
313  TBranch *Branch(const char* name, char* address, const char* leaflist, Int_t bufsize = 32000)
314  {
315  // Overload to avoid confusion between this signature and the template instance.
316  return Branch(name,(void*)address,leaflist,bufsize);
317  }
318  TBranch *Branch(const char* name, Long_t address, const char* leaflist, Int_t bufsize = 32000)
319  {
320  // Overload to avoid confusion between this signature and the template instance.
321  return Branch(name,(void*)address,leaflist,bufsize);
322  }
323  TBranch *Branch(const char* name, int address, const char* leaflist, Int_t bufsize = 32000)
324  {
325  // Overload to avoid confusion between this signature and the template instance.
326  return Branch(name,(void*)(Long_t)address,leaflist,bufsize);
327  }
328 #if !defined(__CINT__)
329  virtual TBranch *Branch(const char* name, const char* classname, void* addobj, Int_t bufsize = 32000, Int_t splitlevel = 99);
330 #endif
331  template <class T> TBranch *Branch(const char* name, const char* classname, T* obj, Int_t bufsize = 32000, Int_t splitlevel = 99)
332  {
333  // See BranchImpRed for details. Here we __ignore
334  return BranchImpRef(name, classname, TBuffer::GetClass(typeid(T)), obj, bufsize, splitlevel);
335  }
336  template <class T> TBranch *Branch(const char* name, const char* classname, T** addobj, Int_t bufsize = 32000, Int_t splitlevel = 99)
337  {
338  // See BranchImp for details
339  return BranchImp(name, classname, TBuffer::GetClass(typeid(T)), addobj, bufsize, splitlevel);
340  }
341  template <class T> TBranch *Branch(const char* name, T** addobj, Int_t bufsize = 32000, Int_t splitlevel = 99)
342  {
343  // See BranchImp for details
344  return BranchImp(name, TBuffer::GetClass(typeid(T)), addobj, bufsize, splitlevel);
345  }
346  template <class T> TBranch *Branch(const char* name, T* obj, Int_t bufsize = 32000, Int_t splitlevel = 99)
347  {
348  // See BranchImp for details
349  return BranchImpRef(name, TBuffer::GetClass(typeid(T)), TDataType::GetType(typeid(T)), obj, bufsize, splitlevel);
350  }
351  virtual TBranch *Bronch(const char* name, const char* classname, void* addobj, Int_t bufsize = 32000, Int_t splitlevel = 99);
352  virtual TBranch *BranchOld(const char* name, const char* classname, void* addobj, Int_t bufsize = 32000, Int_t splitlevel = 1);
353  virtual TBranch *BranchRef();
354  virtual void Browse(TBrowser*);
355  virtual Int_t BuildIndex(const char* majorname, const char* minorname = "0");
356  TStreamerInfo *BuildStreamerInfo(TClass* cl, void* pointer = 0, Bool_t canOptimize = kTRUE);
357  virtual TFile *ChangeFile(TFile* file);
358  virtual TTree *CloneTree(Long64_t nentries = -1, Option_t* option = "");
359  virtual void CopyAddresses(TTree*,Bool_t undo = kFALSE);
360  virtual Long64_t CopyEntries(TTree* tree, Long64_t nentries = -1, Option_t *option = "");
361  virtual TTree *CopyTree(const char* selection, Option_t* option = "", Long64_t nentries = kMaxEntries, Long64_t firstentry = 0);
362  virtual TBasket *CreateBasket(TBranch*);
363  virtual void DirectoryAutoAdd(TDirectory *);
364  Int_t Debug() const { return fDebug; }
365  virtual void Delete(Option_t* option = ""); // *MENU*
366  virtual void Draw(Option_t* opt) { Draw(opt, "", "", kMaxEntries, 0); }
367  virtual Long64_t Draw(const char* varexp, const TCut& selection, Option_t* option = "", Long64_t nentries = kMaxEntries, Long64_t firstentry = 0);
368  virtual Long64_t Draw(const char* varexp, const char* selection, Option_t* option = "", Long64_t nentries = kMaxEntries, Long64_t firstentry = 0); // *MENU*
369  virtual void DropBaskets();
370  virtual void DropBuffers(Int_t nbytes);
371  virtual Int_t Fill();
372  virtual TBranch *FindBranch(const char* name);
373  virtual TLeaf *FindLeaf(const char* name);
374  virtual Int_t Fit(const char* funcname, const char* varexp, const char* selection = "", Option_t* option = "", Option_t* goption = "", Long64_t nentries = kMaxEntries, Long64_t firstentry = 0); // *MENU*
375  virtual Int_t FlushBaskets() const;
376  virtual const char *GetAlias(const char* aliasName) const;
377  virtual Long64_t GetAutoFlush() const {return fAutoFlush;}
378  virtual Long64_t GetAutoSave() const {return fAutoSave;}
379  virtual TBranch *GetBranch(const char* name);
380  virtual TBranchRef *GetBranchRef() const { return fBranchRef; };
381  virtual Bool_t GetBranchStatus(const char* branchname) const;
382  static Int_t GetBranchStyle();
383  virtual Long64_t GetCacheSize() const { return fCacheSize; }
384  virtual TClusterIterator GetClusterIterator(Long64_t firstentry);
385  virtual Long64_t GetChainEntryNumber(Long64_t entry) const { return entry; }
386  virtual Long64_t GetChainOffset() const { return fChainOffset; }
387  TFile *GetCurrentFile() const;
389  Long64_t GetDebugMax() const { return fDebugMax; }
390  Long64_t GetDebugMin() const { return fDebugMin; }
391  TDirectory *GetDirectory() const { return fDirectory; }
392  virtual Long64_t GetEntries() const { return fEntries; }
393  virtual Long64_t GetEntries(const char *selection);
394  virtual Long64_t GetEntriesFast() const { return fEntries; }
395  virtual Long64_t GetEntriesFriend() const;
396  virtual Long64_t GetEstimate() const { return fEstimate; }
397  virtual Int_t GetEntry(Long64_t entry = 0, Int_t getall = 0);
398  Int_t GetEvent(Long64_t entry = 0, Int_t getall = 0) { return GetEntry(entry, getall); }
399  virtual Int_t GetEntryWithIndex(Int_t major, Int_t minor = 0);
400  virtual Long64_t GetEntryNumberWithBestIndex(Long64_t major, Long64_t minor = 0) const;
401  virtual Long64_t GetEntryNumberWithIndex(Long64_t major, Long64_t minor = 0) const;
402  TEventList *GetEventList() const { return fEventList; }
403  virtual TEntryList *GetEntryList();
404  virtual Long64_t GetEntryNumber(Long64_t entry) const;
405  virtual Int_t GetFileNumber() const { return fFileNumber; }
406  virtual TTree *GetFriend(const char*) const;
407  virtual const char *GetFriendAlias(TTree*) const;
409  virtual Bool_t GetImplicitMT() { return fIMTEnabled; }
410  virtual Int_t *GetIndex() { return &fIndex.fArray[0]; }
411  virtual Double_t *GetIndexValues() { return &fIndexValues.fArray[0]; }
413  virtual TLeaf *GetLeaf(const char* branchname, const char* leafname);
414  virtual TLeaf *GetLeaf(const char* name);
415  virtual TList *GetListOfClones() { return fClones; }
416  virtual TObjArray *GetListOfBranches() { return &fBranches; }
417  virtual TObjArray *GetListOfLeaves() { return &fLeaves; }
418  virtual TList *GetListOfFriends() const { return fFriends; }
419  virtual TList *GetListOfAliases() const { return fAliases; }
420 
421  // GetMakeClass is left non-virtual for efficiency reason.
422  // Making it virtual affects the performance of the I/O
423  Int_t GetMakeClass() const { return fMakeClass; }
424 
425  virtual Long64_t GetMaxEntryLoop() const { return fMaxEntryLoop; }
426  virtual Double_t GetMaximum(const char* columname);
427  static Long64_t GetMaxTreeSize();
428  virtual Long64_t GetMaxVirtualSize() const { return fMaxVirtualSize; }
429  virtual Double_t GetMinimum(const char* columname);
430  virtual Int_t GetNbranches() { return fBranches.GetEntriesFast(); }
431  TObject *GetNotify() const { return fNotify; }
433  virtual Int_t GetPacketSize() const { return fPacketSize; }
434  virtual TVirtualPerfStats *GetPerfStats() const { return fPerfStats; }
435  virtual Long64_t GetReadEntry() const { return fReadEntry; }
436  virtual Long64_t GetReadEvent() const { return fReadEntry; }
437  virtual Int_t GetScanField() const { return fScanField; }
440  virtual Int_t GetTimerInterval() const { return fTimerInterval; }
442  virtual Long64_t GetTotBytes() const { return fTotBytes; }
443  virtual TTree *GetTree() const { return const_cast<TTree*>(this); }
444  virtual TVirtualIndex *GetTreeIndex() const { return fTreeIndex; }
445  virtual Int_t GetTreeNumber() const { return 0; }
446  virtual Int_t GetUpdate() const { return fUpdate; }
447  virtual TList *GetUserInfo();
448  // See TSelectorDraw::GetVar
449  TTreeFormula *GetVar(Int_t i) { return GetPlayer()->GetVar(i); }
450  // See TSelectorDraw::GetVar
451  TTreeFormula *GetVar1() { return GetPlayer()->GetVar1(); }
452  // See TSelectorDraw::GetVar
453  TTreeFormula *GetVar2() { return GetPlayer()->GetVar2(); }
454  // See TSelectorDraw::GetVar
455  TTreeFormula *GetVar3() { return GetPlayer()->GetVar3(); }
456  // See TSelectorDraw::GetVar
457  TTreeFormula *GetVar4() { return GetPlayer()->GetVar4(); }
458  // See TSelectorDraw::GetVal
459  virtual Double_t *GetVal(Int_t i) { return GetPlayer()->GetVal(i); }
460  // See TSelectorDraw::GetVal
461  virtual Double_t *GetV1() { return GetPlayer()->GetV1(); }
462  // See TSelectorDraw::GetVal
463  virtual Double_t *GetV2() { return GetPlayer()->GetV2(); }
464  // See TSelectorDraw::GetVal
465  virtual Double_t *GetV3() { return GetPlayer()->GetV3(); }
466  // See TSelectorDraw::GetVal
467  virtual Double_t *GetV4() { return GetPlayer()->GetV4(); }
468  virtual Double_t *GetW() { return GetPlayer()->GetW(); }
469  virtual Double_t GetWeight() const { return fWeight; }
470  virtual Long64_t GetZipBytes() const { return fZipBytes; }
471  virtual void IncrementTotalBuffers(Int_t nbytes) { fTotalBuffers += nbytes; }
472  Bool_t IsFolder() const { return kTRUE; }
473  virtual Int_t LoadBaskets(Long64_t maxmemory = 2000000000);
474  virtual Long64_t LoadTree(Long64_t entry);
475  virtual Long64_t LoadTreeFriend(Long64_t entry, TTree* T);
476  virtual Int_t MakeClass(const char* classname = 0, Option_t* option = "");
477  virtual Int_t MakeCode(const char* filename = 0);
478  virtual Int_t MakeProxy(const char* classname, const char* macrofilename = 0, const char* cutfilename = 0, const char* option = 0, Int_t maxUnrolling = 3);
479  virtual Int_t MakeSelector(const char* selector = 0, Option_t* option = "");
480  Bool_t MemoryFull(Int_t nbytes);
481  virtual Long64_t Merge(TCollection* list, Option_t* option = "");
482  virtual Long64_t Merge(TCollection* list, TFileMergeInfo *info);
483  static TTree *MergeTrees(TList* list, Option_t* option = "");
484  virtual Bool_t Notify();
485  virtual void OptimizeBaskets(ULong64_t maxMemory=10000000, Float_t minComp=1.1, Option_t *option="");
486  TPrincipal *Principal(const char* varexp = "", const char* selection = "", Option_t* option = "np", Long64_t nentries = kMaxEntries, Long64_t firstentry = 0);
487  virtual void Print(Option_t* option = "") const; // *MENU*
488  virtual void PrintCacheStats(Option_t* option = "") const;
489  virtual Long64_t Process(const char* filename, Option_t* option = "", Long64_t nentries = kMaxEntries, Long64_t firstentry = 0); // *MENU*
490 #if defined(__CINT__)
491 #if defined(R__MANUAL_DICT)
492  virtual Long64_t Process(void* selector, Option_t* option = "", Long64_t nentries = kMaxEntries, Long64_t firstentry = 0);
493 #endif
494 #else
495  virtual Long64_t Process(TSelector* selector, Option_t* option = "", Long64_t nentries = kMaxEntries, Long64_t firstentry = 0);
496 #endif
497  virtual Long64_t Project(const char* hname, const char* varexp, const char* selection = "", Option_t* option = "", Long64_t nentries = kMaxEntries, Long64_t firstentry = 0);
498  virtual TSQLResult *Query(const char* varexp = "", const char* selection = "", Option_t* option = "", Long64_t nentries = kMaxEntries, Long64_t firstentry = 0);
499  virtual Long64_t ReadFile(const char* filename, const char* branchDescriptor = "", char delimiter = ' ');
500  virtual Long64_t ReadStream(std::istream& inputStream, const char* branchDescriptor = "", char delimiter = ' ');
501  virtual void Refresh();
502  virtual void RecursiveRemove(TObject *obj);
503  virtual void RemoveFriend(TTree*);
504  virtual void Reset(Option_t* option = "");
505  virtual void ResetAfterMerge(TFileMergeInfo *);
506  virtual void ResetBranchAddress(TBranch *);
507  virtual void ResetBranchAddresses();
508  virtual Long64_t Scan(const char* varexp = "", const char* selection = "", Option_t* option = "", Long64_t nentries = kMaxEntries, Long64_t firstentry = 0); // *MENU*
509  virtual Bool_t SetAlias(const char* aliasName, const char* aliasFormula);
510  virtual void SetAutoSave(Long64_t autos = -300000000);
511  virtual void SetAutoFlush(Long64_t autof = -30000000);
512  virtual void SetBasketSize(const char* bname, Int_t buffsize = 16000);
513 #if !defined(__CINT__)
514  virtual Int_t SetBranchAddress(const char *bname,void *add, TBranch **ptr = 0);
515 #endif
516  virtual Int_t SetBranchAddress(const char *bname,void *add, TClass *realClass, EDataType datatype, Bool_t isptr);
517  virtual Int_t SetBranchAddress(const char *bname,void *add, TBranch **ptr, TClass *realClass, EDataType datatype, Bool_t isptr);
518  template <class T> Int_t SetBranchAddress(const char *bname, T **add, TBranch **ptr = 0) {
519  TClass *cl = TClass::GetClass(typeid(T));
521  if (cl==0) type = TDataType::GetType(typeid(T));
522  return SetBranchAddress(bname,add,ptr,cl,type,true);
523  }
524 #ifndef R__NO_CLASS_TEMPLATE_SPECIALIZATION
525  // This can only be used when the template overload resolution can distinguish between
526  // T* and T**
527  template <class T> Int_t SetBranchAddress(const char *bname, T *add, TBranch **ptr = 0) {
528  TClass *cl = TClass::GetClass(typeid(T));
530  if (cl==0) type = TDataType::GetType(typeid(T));
531  return SetBranchAddress(bname,add,ptr,cl,type,false);
532  }
533 #endif
534  virtual void SetBranchStatus(const char* bname, Bool_t status = 1, UInt_t* found = 0);
535  static void SetBranchStyle(Int_t style = 1); //style=0 for old branch, =1 for new branch style
536  virtual Int_t SetCacheSize(Long64_t cachesize = -1);
538  virtual void SetCacheLearnEntries(Int_t n=10);
539  virtual void SetChainOffset(Long64_t offset = 0) { fChainOffset=offset; }
540  virtual void SetCircular(Long64_t maxEntries);
541  virtual void SetDebug(Int_t level = 1, Long64_t min = 0, Long64_t max = 9999999); // *MENU*
542  virtual void SetDefaultEntryOffsetLen(Int_t newdefault, Bool_t updateExisting = kFALSE);
543  virtual void SetDirectory(TDirectory* dir);
544  virtual Long64_t SetEntries(Long64_t n = -1);
545  virtual void SetEstimate(Long64_t nentries = 1000000);
546  virtual void SetFileNumber(Int_t number = 0);
547  virtual void SetEventList(TEventList* list);
548  virtual void SetEntryList(TEntryList* list, Option_t *opt="");
549  virtual void SetImplicitMT(Bool_t enabled) { fIMTEnabled = enabled; }
550  virtual void SetMakeClass(Int_t make);
551  virtual void SetMaxEntryLoop(Long64_t maxev = kMaxEntries) { fMaxEntryLoop = maxev; } // *MENU*
552  static void SetMaxTreeSize(Long64_t maxsize = 1900000000);
553  virtual void SetMaxVirtualSize(Long64_t size = 0) { fMaxVirtualSize = size; } // *MENU*
554  virtual void SetName(const char* name); // *MENU*
555  virtual void SetNotify(TObject* obj) { fNotify = obj; }
556  virtual void SetObject(const char* name, const char* title);
557  virtual void SetParallelUnzip(Bool_t opt=kTRUE, Float_t RelSize=-1);
558  virtual void SetPerfStats(TVirtualPerfStats* perf);
559  virtual void SetScanField(Int_t n = 50) { fScanField = n; } // *MENU*
560  virtual void SetTimerInterval(Int_t msec = 333) { fTimerInterval=msec; }
561  virtual void SetTreeIndex(TVirtualIndex* index);
562  virtual void SetWeight(Double_t w = 1, Option_t* option = "");
563  virtual void SetUpdate(Int_t freq = 0) { fUpdate = freq; }
564  virtual void Show(Long64_t entry = -1, Int_t lenmax = 20);
565  virtual void StartViewer(); // *MENU*
566  virtual Int_t StopCacheLearningPhase();
567  virtual Int_t UnbinnedFit(const char* funcname, const char* varexp, const char* selection = "", Option_t* option = "", Long64_t nentries = kMaxEntries, Long64_t firstentry = 0);
568  void UseCurrentStyle();
569  virtual Int_t Write(const char *name=0, Int_t option=0, Int_t bufsize=0);
570  virtual Int_t Write(const char *name=0, Int_t option=0, Int_t bufsize=0) const;
571 
572 
573  ClassDef(TTree,19) //Tree descriptor (the main ROOT I/O class)
574 };
575 
576 //////////////////////////////////////////////////////////////////////////
577 // //
578 // TTreeFriendLeafIter //
579 // //
580 // Iterator on all the leaves in a TTree and its friend //
581 // //
582 //////////////////////////////////////////////////////////////////////////
583 
585 
586 protected:
587  TTree *fTree; ///< tree being iterated
588  TIterator *fLeafIter; ///< current leaf sub-iterator.
589  TIterator *fTreeIter; ///< current tree sub-iterator.
590  Bool_t fDirection; ///< iteration direction
591 
592  TTreeFriendLeafIter() : fTree(0), fLeafIter(0), fTreeIter(0),
593  fDirection(0) { }
594 
595 public:
596  TTreeFriendLeafIter(const TTree* t, Bool_t dir = kIterForward);
598  ~TTreeFriendLeafIter() { SafeDelete(fLeafIter); SafeDelete(fTreeIter); }
599  TIterator &operator=(const TIterator &rhs);
601 
602  const TCollection *GetCollection() const { return 0; }
603  Option_t *GetOption() const;
604  TObject *Next();
605  void Reset() { SafeDelete(fLeafIter); SafeDelete(fTreeIter); }
606  Bool_t operator !=(const TIterator&) const {
607  // TODO: Implement me
608  return false;
609  }
611  // TODO: Implement me
612  return false;
613  }
614  TObject *operator*() const {
615  // TODO: Implement me
616  return nullptr;
617  }
618  ClassDef(TTreeFriendLeafIter,0) //Linked list iterator
619  };
620 
621 
622 #endif
virtual Double_t * GetV3()
Definition: TTree.h:465
TBranch * Branch(const char *name, const char *classname, T **addobj, Int_t bufsize=32000, Int_t splitlevel=99)
Definition: TTree.h:336
Describe Streamer information for one class version.
Definition: TStreamerInfo.h:47
virtual TBranch * FindBranch(const char *name)
Return the branch that correspond to the path &#39;branchname&#39;, which can include the name of the tree or...
Definition: TTree.cxx:4557
virtual TTreeFormula * GetVar(Int_t) const =0
Double_t fWeight
Tree weight (see TTree::SetWeight)
Definition: TTree.h:106
A TLeaf describes individual elements of a TBranch See TBranch structure in TTree.
Definition: TLeaf.h:37
Bool_t IsFolder() const
Returns kTRUE in case object contains browsable objects (like containers or lists of other objects)...
Definition: TTree.h:472
virtual void AddTotBytes(Int_t tot)
Definition: TTree.h:306
TTreeCache * GetReadCache(TFile *file, Bool_t create=kFALSE)
Find and return the TTreeCache registered with the file and which may contain branches for us...
Definition: TTree.cxx:5830
virtual TList * GetListOfAliases() const
Definition: TTree.h:419
virtual TList * GetListOfClones()
Definition: TTree.h:415
TStreamerInfo * BuildStreamerInfo(TClass *cl, void *pointer=0, Bool_t canOptimize=kTRUE)
Build StreamerInfo for class cl.
Definition: TTree.cxx:2551
An array of TObjects.
Definition: TObjArray.h:39
Long64_t fDebugMin
! First entry number to debug
Definition: TTree.h:128
TBranch * Branch(const char *name, T **addobj, Int_t bufsize=32000, Int_t splitlevel=99)
Definition: TTree.h:341
Principal Components Analysis (PCA)
Definition: TPrincipal.h:28
TTree * fTree
tree being iterated
Definition: TTree.h:587
Long64_t GetNextEntry()
Definition: TTree.h:288
virtual Long64_t GetAutoSave() const
Definition: TTree.h:378
Bool_t fPrevious
Definition: TTree.h:191
virtual void OptimizeBaskets(ULong64_t maxMemory=10000000, Float_t minComp=1.1, Option_t *option="")
This function may be called after having filled some entries in a Tree Using the information in the e...
Definition: TTree.cxx:6532
virtual const char * GetFriendAlias(TTree *) const
If the &#39;tree&#39; is a friend, this method returns its alias name.
Definition: TTree.cxx:5553
Bool_t MemoryFull(Int_t nbytes)
Check if adding nbytes to memory we are still below MaxVirtualsize.
Definition: TTree.cxx:6339
virtual TBranch * BranchImpRef(const char *branchname, const char *classname, TClass *ptrClass, void *addobj, Int_t bufsize, Int_t splitlevel)
Same as TTree::Branch but automatic detection of the class name.
Definition: TTree.cxx:1471
virtual TVirtualPerfStats * GetPerfStats() const
Definition: TTree.h:434
virtual Int_t MakeCode(const char *filename=0)
Generate a skeleton function for this tree.
Definition: TTree.cxx:6142
long long Long64_t
Definition: RtypesCore.h:69
TTreeFormula * GetVar2()
Definition: TTree.h:453
TIterator * fTreeIter
current tree sub-iterator.
Definition: TTree.h:589
Abstract interface for Tree Index.
Definition: TVirtualIndex.h:31
static constexpr Long64_t kMaxEntries
virtual Int_t StopCacheLearningPhase()
Stop the cache learning phase.
Definition: TTree.cxx:8709
virtual void SetBranchStatus(const char *bname, Bool_t status=1, UInt_t *found=0)
Set branch status to Process or DoNotProcess.
Definition: TTree.cxx:7865
virtual void IncrementTotalBuffers(Int_t nbytes)
Definition: TTree.h:471
virtual void Delete(Option_t *option="")
Delete this tree from memory or/and disk.
Definition: TTree.cxx:3562
Int_t GetType() const
Definition: TDataType.h:70
static Int_t fgBranchStyle
Old/New branch style.
Definition: TTree.h:156
virtual void AddZipBytes(Int_t zip)
Definition: TTree.h:307
virtual Double_t * GetV4()
Definition: TTree.h:467
virtual Int_t LoadBaskets(Long64_t maxmemory=2000000000)
Read in memory all baskets from all branches up to the limit of maxmemory bytes.
Definition: TTree.cxx:5946
float Float_t
Definition: RtypesCore.h:53
static Long64_t GetMaxTreeSize()
Static function which returns the tree file size limit in bytes.
Definition: TTree.cxx:5777
virtual void SetParallelUnzip(Bool_t opt=kTRUE, Float_t RelSize=-1)
Enable or disable parallel unzipping of Tree buffers.
Definition: TTree.cxx:8550
Provides the interface for the PROOF internal performance measurement and event tracing.
const char Option_t
Definition: RtypesCore.h:62
virtual Bool_t Notify()
Function called when loading a new class library.
Definition: TTree.cxx:6508
TTree()
Default constructor and I/O constructor.
Definition: TTree.cxx:649
TEventList * GetEventList() const
Definition: TTree.h:402
virtual Long64_t GetReadEntry() const
Definition: TTree.h:435
TBuffer * fTransientBuffer
! Pointer to the current transient buffer.
Definition: TTree.h:149
double T(double x)
Definition: ChebyshevPol.h:34
virtual Int_t Fit(const char *funcname, const char *varexp, const char *selection="", Option_t *option="", Option_t *goption="", Long64_t nentries=kMaxEntries, Long64_t firstentry=0)
Fit a projected item(s) from a tree.
Definition: TTree.cxx:4785
TIterator * fLeafIter
current leaf sub-iterator.
Definition: TTree.h:588
TList * fFriends
pointer to list of friend elements
Definition: TTree.h:142
TPrincipal * Principal(const char *varexp="", const char *selection="", Option_t *option="np", Long64_t nentries=kMaxEntries, Long64_t firstentry=0)
Interface to the Principal Components Analysis class.
Definition: TTree.cxx:6670
virtual Int_t Fill()
Fill all branches.
Definition: TTree.cxx:4374
virtual TEntryList * GetEntryList()
Returns the entry list, set to this tree.
Definition: TTree.cxx:5376
virtual void SetMaxEntryLoop(Long64_t maxev=kMaxEntries)
Definition: TTree.h:551
virtual TH1 * GetHistogram() const =0
const TCollection * GetCollection() const
Definition: TTree.h:602
Long64_t GetCacheAutoSize(Bool_t withDefault=kFALSE) const
Used for automatic sizing of the cache.
Definition: TTree.cxx:4991
static void SetBranchStyle(Int_t style=1)
Set the current branch style.
Definition: TTree.cxx:7991
A specialized TFileCacheRead object for a TTree.
Definition: TTreeCache.h:34
virtual TLeaf * GetLeaf(const char *branchname, const char *leafname)
Return pointer to the 1st Leaf named name in any Branch of this Tree or any branch in the list of fri...
Definition: TTree.cxx:5702
virtual Long64_t GetEntriesFriend() const
Return pointer to the 1st Leaf named name in any Branch of this Tree or any branch in the list of fri...
Definition: TTree.cxx:5085
TTree * fTree
Definition: TTree.h:189
A ROOT file is a suite of consecutive data records (TKey instances) with a well defined format...
Definition: TFile.h:50
virtual TLeaf * GetLeafImpl(const char *branchname, const char *leafname)
Return pointer to the 1st Leaf named name in any Branch of this Tree or any branch in the list of fri...
Definition: TTree.cxx:5612
TTreeFormula * GetSelect()
Definition: TTree.h:438
Buffer base class used for serializing objects.
Definition: TBuffer.h:42
TDirectory * fDirectory
! Pointer to directory holding this tree
Definition: TTree.h:133
Int_t fMakeClass
! not zero when processing code generated by MakeClass
Definition: TTree.h:130
virtual TBasket * CreateBasket(TBranch *)
Create a basket for this tree and given branch.
Definition: TTree.cxx:3546
virtual void SetAutoSave(Long64_t autos=-300000000)
This function may be called at the start of a program to change the default value for fAutoSave (and ...
Definition: TTree.cxx:7676
virtual Int_t GetEntry(Long64_t entry=0, Int_t getall=0)
Read all branches of entry and return total number of bytes read.
Definition: TTree.cxx:5210
virtual TTree * GetFriend(const char *) const
Return a pointer to the TTree friend whose name or alias is &#39;friendname.
Definition: TTree.cxx:5496
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.
Definition: TTree.cxx:6270
virtual Long64_t GetChainEntryNumber(Long64_t entry) const
Definition: TTree.h:385
int Int_t
Definition: RtypesCore.h:41
bool Bool_t
Definition: RtypesCore.h:59
virtual void PrintCacheStats(Option_t *option="") const
print statistics about the TreeCache for this tree, like ******TreeCache statistics for file: cms2...
Definition: TTree.cxx:6803
Long64_t GetDebugMin() const
Definition: TTree.h:390
const Bool_t kFALSE
Definition: Rtypes.h:92
virtual void Browse(TBrowser *)
Browse content of the TTree.
Definition: TTree.cxx:2511
constexpr std::array< decltype(std::declval< F >)(std::declval< int >))), N > make(F f)
virtual Long64_t GetZipBytes() const
Definition: TTree.h:470
virtual Long64_t GetEntryNumber(Long64_t entry) const
Return entry number corresponding to entry.
Definition: TTree.cxx:5387
Int_t fScanField
Number of runs before prompting in Scan.
Definition: TTree.h:108
virtual Int_t FlushBaskets() const
Write to disk all the basket that have not yet been individually written.
Definition: TTree.cxx:4799
Int_t GetEntriesFast() const
Definition: TObjArray.h:66
virtual TTree * CloneTree(Long64_t nentries=-1, Option_t *option="")
Create a clone of this tree and copy nentries.
Definition: TTree.cxx:3003
virtual TTree * CopyTree(const char *selection, Option_t *option="", Long64_t nentries=kMaxEntries, Long64_t firstentry=0)
Copy a tree with selection.
Definition: TTree.cxx:3534
virtual TVirtualIndex * GetTreeIndex() const
Definition: TTree.h:444
virtual void KeepCircular()
Keep a maximum of fMaxEntries in memory.
Definition: TTree.cxx:5910
TArrayD fIndexValues
Sorted index values.
Definition: TTree.h:139
virtual Double_t * GetVal(Int_t) const =0
virtual Long64_t GetEstimate() const
Definition: TTree.h:396
TFile * GetCurrentFile() const
Return pointer to the current file.
Definition: TTree.cxx:5052
Long64_t fMaxEntryLoop
Maximum number of entries to process.
Definition: TTree.h:114
TVirtualTreePlayer * GetPlayer()
Load the TTreePlayer (if not already done).
Definition: TTree.cxx:5816
virtual void SetMaxVirtualSize(Long64_t size=0)
Definition: TTree.h:553
virtual TSQLResult * Query(const char *varexp="", const char *selection="", Option_t *option="", Long64_t nentries=kMaxEntries, Long64_t firstentry=0)
Loop over entries and return a TSQLResult object containing entries following selection.
Definition: TTree.cxx:6944
A Tree Index with majorname and minorname.
Definition: TTreeIndex.h:32
ELockStatusBits
Definition: TTree.h:209
Long64_t fStartEntry
Definition: TTree.h:260
Iterator abstract base class.
Definition: TIterator.h:32
virtual TTreeFormula * GetVar2() const =0
Array of integers (32 bits per element).
Definition: TArrayI.h:29
virtual Long64_t GetChainOffset() const
Definition: TTree.h:386
virtual void Refresh()
Refresh contents of this tree and its branches from the current status on disk.
Definition: TTree.cxx:7338
virtual void SetFileNumber(Int_t number=0)
Set fFileNumber to number.
Definition: TTree.cxx:8448
virtual Double_t GetMinimum(const char *columname)
Return minimum of column with name columname.
Definition: TTree.cxx:5787
virtual void DirectoryAutoAdd(TDirectory *)
Called by TKey and TObject::Clone to automatically add us to a directory when we are read from a file...
Definition: TTree.cxx:3634
TTree & operator=(const TTree &tt)
virtual Double_t * GetV4() const =0
virtual void StartViewer()
Start the TTreeViewer on this tree.
Definition: TTree.cxx:8694
virtual TList * GetListOfFriends() const
Definition: TTree.h:418
virtual Long64_t Merge(TCollection *list, Option_t *option="")
Merge the trees in the TList into this tree.
Definition: TTree.cxx:6396
Marker Attributes class.
Definition: TAttMarker.h:24
virtual void Print(Option_t *option="") const
Print a summary of the tree contents.
Definition: TTree.cxx:6689
virtual Int_t GetEntryWithIndex(Int_t major, Int_t minor=0)
Read entry corresponding to major and minor number.
Definition: TTree.cxx:5449
TList * fAliases
List of aliases for expressions based on the tree branches.
Definition: TTree.h:136
TBranch * Branch(const char *name, Long_t address, const char *leaflist, Int_t bufsize=32000)
Definition: TTree.h:318
#define SafeDelete(p)
Definition: RConfig.h:499
virtual Double_t * GetW() const =0
virtual TObjArray * GetListOfBranches()
Definition: TTree.h:416
Helper class to iterate over cluster of baskets.
Definition: TTree.h:255
TVirtualTreePlayer * fPlayer
! Pointer to current Tree player
Definition: TTree.h:145
Fill Area Attributes class.
Definition: TAttFill.h:24
void ImportClusterRanges(TTree *fromtree)
Appends the cluster range information stored in &#39;fromtree&#39; to this tree, including the value of fAuto...
Definition: TTree.cxx:5871
virtual void SetAutoFlush(Long64_t autof=-30000000)
This function may be called at the start of a program to change the default value for fAutoFlush...
Definition: TTree.cxx:7591
#define ClassDef(name, id)
Definition: Rtypes.h:254
virtual Long64_t GetSelectedRows()
Definition: TTree.h:439
TTreeFormula * GetVar(Int_t i)
Definition: TTree.h:449
virtual Long64_t CopyEntries(TTree *tree, Long64_t nentries=-1, Option_t *option="")
Copy nentries from given tree to this tree.
Definition: TTree.cxx:3365
virtual Int_t SetBranchAddress(const char *bname, void *add, TBranch **ptr=0)
Change branch address, dealing with clone trees properly.
Definition: TTree.cxx:7719
Int_t fNfill
! Local for EntryLoop
Definition: TTree.h:126
TText * tt
Definition: textangle.C:16
virtual void SetObject(const char *name, const char *title)
Change the name and title of this tree.
Definition: TTree.cxx:8519
The TNamed class is the base class for all named ROOT classes.
Definition: TNamed.h:33
virtual Long64_t LoadTree(Long64_t entry)
Set current entry.
Definition: TTree.cxx:5967
Bool_t fCacheUserSet
! true if the cache setting was explicitly given by user
Definition: TTree.h:151
virtual void SetTreeIndex(TVirtualIndex *index)
The current TreeIndex is replaced by the new index.
Definition: TTree.cxx:8581
Int_t fMaxClusterRange
! Memory allocated for the cluster range.
Definition: TTree.h:112
static Int_t GetBranchStyle()
Static function returning the current branch style.
Definition: TTree.cxx:4979
virtual Int_t BuildIndex(const char *majorname, const char *minorname="0")
Build a Tree Index (default is TTreeIndex).
Definition: TTree.cxx:2536
virtual Int_t UnbinnedFit(const char *funcname, const char *varexp, const char *selection="", Option_t *option="", Long64_t nentries=kMaxEntries, Long64_t firstentry=0)
Unbinned fit of one or more variable(s) from a tree.
Definition: TTree.cxx:8952
virtual TBranch * BranchOld(const char *name, const char *classname, void *addobj, Int_t bufsize=32000, Int_t splitlevel=1)
Create a new TTree BranchObject.
Definition: TTree.cxx:1884
virtual Int_t GetNbranches()
Definition: TTree.h:430
virtual void Show(Long64_t entry=-1, Int_t lenmax=20)
Print values of all active leaves for entry.
Definition: TTree.cxx:8620
TBranchRef * fBranchRef
Branch supporting the TRefTable (if any)
Definition: TTree.h:147
virtual Int_t MakeClass(const char *classname=0, Option_t *option="")
Generate a skeleton analysis class for this tree.
Definition: TTree.cxx:6109
virtual TClusterIterator GetClusterIterator(Long64_t firstentry)
Return an iterator over the cluster of baskets starting at firstentry.
Definition: TTree.cxx:5041
static TClass * GetClass(const std::type_info &typeinfo)
Forward to TROOT::GetClass().
Definition: TBuffer.cxx:297
UInt_t fFriendLockStatus
! Record which method is locking the friend recursion
Definition: TTree.h:148
Double_t * fArray
Definition: TArrayD.h:32
const int maxsize
Int_t fTimerInterval
Timer interval in milliseconds.
Definition: TTree.h:107
virtual Option_t * GetOption() const
Definition: TObject.h:115
virtual TFriendElement * AddFriend(const char *treename, const char *filename="")
Add a TFriendElement to the list of friends.
Definition: TTree.cxx:1184
const Bool_t kIterForward
Definition: TCollection.h:43
virtual Long64_t Scan(const char *varexp="", const char *selection="", Option_t *option="", Long64_t nentries=kMaxEntries, Long64_t firstentry=0)
Loop over tree entries and print entries passing selection.
Definition: TTree.cxx:7494
Long64_t fFlushedBytes
Number of auto-flushed bytes.
Definition: TTree.h:105
UInt_t fNEntriesSinceSorting
! Number of entries processed since the last re-sorting of branches
Definition: TTree.h:153
virtual Long64_t GetReadEvent() const
Definition: TTree.h:436
virtual Double_t * GetV2() const =0
virtual Long64_t GetSelectedRows() const =0
Bool_t operator!=(const TDatime &d1, const TDatime &d2)
Definition: TDatime.h:103
virtual Double_t GetMaximum(const char *columname)
Return maximum of column with name columname.
Definition: TTree.cxx:5748
virtual void RemoveFriend(TTree *)
Remove a friend from the list of friends.
Definition: TTree.cxx:7377
virtual TList * GetUserInfo()
Return a pointer to the list containing user objects associated to this tree.
Definition: TTree.cxx:5855
virtual void SetCacheLearnEntries(Int_t n=10)
Interface to TTreeCache to set the number of entries for the learning phase.
Definition: TTree.cxx:8184
A branch containing and managing a TRefTable for TRef autoloading.
Definition: TBranchRef.h:33
Long64_t fZipBytes
Total number of bytes in all branches after compression.
Definition: TTree.h:103
Long64_t fDebugMax
! Last entry number to debug
Definition: TTree.h:129
virtual TBranch * BranchImp(const char *branchname, const char *classname, TClass *ptrClass, void *addobj, Int_t bufsize, Int_t splitlevel)
Same as TTree::Branch() with added check that addobj matches className.
Definition: TTree.cxx:1390
TBranch * Branch(const char *name, char *address, const char *leaflist, Int_t bufsize=32000)
Definition: TTree.h:313
TTreeFormula * GetVar4()
Definition: TTree.h:457
Used to pass a selection expression to the Tree drawing routine.
Definition: TTreeFormula.h:64
virtual void SetEventList(TEventList *list)
This function transfroms the given TEventList into a TEntryList The new TEntryList is owned by the TT...
Definition: TTree.cxx:8385
void UseCurrentStyle()
Replace current attributes by current style.
Definition: TTree.cxx:8964
A specialized string object used for TTree selections.
Definition: TCut.h:27
A doubly linked list.
Definition: TList.h:47
virtual TBranch * GetBranch(const char *name)
Return pointer to the branch with the given name in this tree or its friends.
Definition: TTree.cxx:4868
Bool_t fCacheDoAutoInit
! true if cache auto creation or resize check is needed
Definition: TTree.h:150
Int_t SetBranchAddress(const char *bname, T **add, TBranch **ptr=0)
Definition: TTree.h:518
TH1 * GetHistogram()
Definition: TTree.h:408
TObjArray fLeaves
Direct pointers to individual branch leaves.
Definition: TTree.h:135
virtual TTreeFormula * GetVar1() const =0
Long64_t * fClusterRangeEnd
[fNClusterRange] Last entry of a cluster range.
Definition: TTree.h:119
virtual Long64_t GetTotBytes() const
Definition: TTree.h:442
TObject * GetNotify() const
Definition: TTree.h:431
Using a TBrowser one can browse all ROOT objects.
Definition: TBrowser.h:41
Int_t fNClusterRange
Number of Cluster range in addition to the one defined by &#39;AutoFlush&#39;.
Definition: TTree.h:111
virtual Int_t GetTimerInterval() const
Definition: TTree.h:440
TEntryList * fEntryList
! Pointer to event selection list (if one)
Definition: TTree.h:138
virtual Long64_t GetMaxEntryLoop() const
Definition: TTree.h:425
TBranch * Branch(const char *name, int address, const char *leaflist, Int_t bufsize=32000)
Definition: TTree.h:323
virtual Int_t Write(const char *name=0, Int_t option=0, Int_t bufsize=0)
Write this object to the current directory.
Definition: TTree.cxx:9001
virtual void SetEstimate(Long64_t nentries=1000000)
Set number of entries to estimate variable limits.
Definition: TTree.cxx:8426
ESetBranchAddressStatus
Definition: TTree.h:230
Long64_t fChainOffset
! Offset of 1st entry of this Tree in a TChain
Definition: TTree.h:122
virtual Long64_t GetCacheSize() const
Definition: TTree.h:383
~TFriendLock()
Restore the state of tree the same as before we set the lock.
Definition: TTree.cxx:507
Long64_t * fClusterSize
[fNClusterRange] Number of entries in each cluster for a given range.
Definition: TTree.h:120
virtual Double_t * GetV2()
Definition: TTree.h:463
virtual void SetUpdate(Int_t freq=0)
Definition: TTree.h:563
TVirtualPerfStats * fPerfStats
! pointer to the current perf stats object
Definition: TTree.h:143
virtual Int_t GetTreeNumber() const
Definition: TTree.h:445
TDirectory * GetDirectory() const
Definition: TTree.h:391
Long64_t fReadEntry
! Number of the entry being processed
Definition: TTree.h:123
virtual ~TTree()
Destructor.
Definition: TTree.cxx:828
Collection abstract base class.
Definition: TCollection.h:48
virtual const char * GetAlias(const char *aliasName) const
Returns the expanded value of the alias. Search in the friends if any.
Definition: TTree.cxx:4827
TList * fUserInfo
pointer to a list of user objects associated to this Tree
Definition: TTree.h:144
TObjArray fBranches
List of Branches.
Definition: TTree.h:134
virtual void SetNotify(TObject *obj)
Definition: TTree.h:555
unsigned int UInt_t
Definition: RtypesCore.h:42
void InitializeSortedBranches()
Initializes the vector of top-level branches and sorts it by branch size.
Definition: TTree.cxx:5331
friend TBranch * TTreeBranchImpRef(TTree *tree, const char *branchname, TClass *ptrClass, EDataType datatype, void *addobj, Int_t bufsize, Int_t splitlevel)
static void SetMaxTreeSize(Long64_t maxsize=1900000000)
Set the maximum size in bytes of a Tree file (static function).
Definition: TTree.cxx:8482
Manages buffers for branches of a Tree.
Definition: TBasket.h:38
TTreeFormula * GetVar3()
Definition: TTree.h:455
virtual TBranchRef * GetBranchRef() const
Definition: TTree.h:380
A TEventList object is a list of selected events (entries) in a TTree.
Definition: TEventList.h:33
virtual TLeaf * FindLeaf(const char *name)
Find leaf..
Definition: TTree.cxx:4629
virtual Long64_t GetEntryNumberWithIndex(Long64_t major, Long64_t minor=0) const
Return entry number corresponding to major and minor number.
Definition: TTree.cxx:5432
TArrayI fIndex
Index of sorted values.
Definition: TTree.h:140
The ROOT global object gROOT contains a list of all defined classes.
Definition: TClass.h:81
virtual Double_t * GetV1() const =0
Bool_t fIMTEnabled
! true if implicit multi-threading is enabled for this tree
Definition: TTree.h:152
virtual void ResetBranchAddress(TBranch *)
Tell all of our branches to set their addresses to zero.
Definition: TTree.cxx:7465
Bool_t fDirection
iteration direction
Definition: TTree.h:590
TEventList * fEventList
! Pointer to event selection list (if one)
Definition: TTree.h:137
virtual TBranch * Bronch(const char *name, const char *classname, void *addobj, Int_t bufsize=32000, Int_t splitlevel=99)
Create a new TTree BranchElement.
Definition: TTree.cxx:2214
virtual Long64_t GetMaxVirtualSize() const
Definition: TTree.h:428
Long64_t fMaxEntries
Maximum number of entries in case of circular buffers.
Definition: TTree.h:113
void AddClone(TTree *)
Add a cloned tree to our list of trees to be notified whenever we change our branch addresses or when...
Definition: TTree.cxx:1099
char GetNewlineValue(std::istream &inputStream)
Determine which newline this file is using.
Definition: TTree.cxx:7014
virtual Int_t DropBranchFromCache(const char *bname, Bool_t subbranches=kFALSE)
Remove the branch with name &#39;bname&#39; from the Tree cache.
Definition: TTree.cxx:1022
virtual Int_t * GetIndex()
Definition: TTree.h:410
Long64_t fAutoSave
Autosave tree when fAutoSave entries written or -fAutoSave (compressed) bytes produced.
Definition: TTree.h:116
virtual TTreeFormula * GetVar3() const =0
virtual Int_t CheckBranchAddressType(TBranch *branch, TClass *ptrClass, EDataType datatype, Bool_t ptr)
Check whether or not the address described by the last 3 parameters matches the content of the branch...
Definition: TTree.cxx:2739
virtual void SetDebug(Int_t level=1, Long64_t min=0, Long64_t max=9999999)
Set the debug level and the debug range.
Definition: TTree.cxx:8247
virtual Long64_t Process(const char *filename, Option_t *option="", Long64_t nentries=kMaxEntries, Long64_t firstentry=0)
Process this tree executing the TSelector code in the specified filename.
Definition: TTree.cxx:6881
TBranch * Branch(const char *name, T *obj, Int_t bufsize=32000, Int_t splitlevel=99)
Definition: TTree.h:346
long Long_t
Definition: RtypesCore.h:50
virtual Long64_t ReadStream(std::istream &inputStream, const char *branchDescriptor="", char delimiter= ' ')
Create or simply read branches from an input stream.
Definition: TTree.cxx:7041
virtual void DropBuffers(Int_t nbytes)
Drop branch buffers to accommodate nbytes below MaxVirtualsize.
Definition: TTree.cxx:4306
virtual void SetMakeClass(Int_t make)
Set all the branches in this TTree to be in decomposed object mode (also known as MakeClass mode)...
Definition: TTree.cxx:8462
virtual void SetWeight(Double_t w=1, Option_t *option="")
Set tree weight.
Definition: TTree.cxx:8609
TBranch * Branch(const char *name, const char *classname, T *obj, Int_t bufsize=32000, Int_t splitlevel=99)
Definition: TTree.h:331
A PolyMarker is defined by an array on N points in a 2-D space.
Definition: TPolyMarker.h:37
virtual void SetDirectory(TDirectory *dir)
Change the tree&#39;s directory.
Definition: TTree.cxx:8285
virtual Long64_t LoadTreeFriend(Long64_t entry, TTree *T)
Load entry on behalf of our master tree, we may use an index.
Definition: TTree.cxx:6059
virtual Long64_t GetAutoFlush() const
Definition: TTree.h:377
Long64_t fMaxVirtualSize
Maximum total size of buffers kept in memory.
Definition: TTree.h:115
Int_t GetEvent(Long64_t entry=0, Int_t getall=0)
Definition: TTree.h:398
virtual void SetEntryList(TEntryList *list, Option_t *opt="")
Set an EntryList.
Definition: TTree.cxx:8362
double Double_t
Definition: RtypesCore.h:55
Long64_t GetStartEntry()
Definition: TTree.h:283
virtual Double_t * GetW()
Definition: TTree.h:468
Int_t * fArray
Definition: TArrayI.h:32
Long64_t fTotBytes
Total number of bytes in all branches before compression.
Definition: TTree.h:102
virtual Int_t GetUpdate() const
Definition: TTree.h:446
Describe directory structure in memory.
Definition: TDirectory.h:44
virtual void SetPerfStats(TVirtualPerfStats *perf)
Set perf stats.
Definition: TTree.cxx:8564
std::vector< std::pair< Long64_t, TBranch * > > fSortedBranches
! Branches sorted by average task time
Definition: TTree.h:154
void SortBranchesByTime()
Sorts top-level branches by the last average task time recorded per branch.
Definition: TTree.cxx:5355
virtual Long64_t GetEntriesFast() const
Definition: TTree.h:394
int type
Definition: TGX11.cxx:120
unsigned long long ULong64_t
Definition: RtypesCore.h:70
Long64_t GetDebugMax() const
Definition: TTree.h:389
Long64_t fAutoFlush
Auto-flush tree when fAutoFlush entries written or -fAutoFlush (compressed) bytes produced...
Definition: TTree.h:117
virtual Bool_t GetImplicitMT()
Definition: TTree.h:409
virtual void ResetBranchAddresses()
Tell all of our branches to drop their current objects and allocate new ones.
Definition: TTree.cxx:7475
virtual void Draw(Option_t *opt)
Default Draw method for all objects.
Definition: TTree.h:366
TCanvas * style()
Definition: style.C:1
int nentries
Definition: THbookFile.cxx:89
EDataType
Definition: TDataType.h:30
Int_t fDefaultEntryOffsetLen
Initial Length of fEntryOffset table in the basket buffers.
Definition: TTree.h:110
The TH1 histogram class.
Definition: TH1.h:80
virtual TTree * GetTree() const
Definition: TTree.h:443
Long64_t fEstimate
Number of entries to estimate histogram limits.
Definition: TTree.h:118
UInt_t fMethodBit
Definition: TTree.h:190
Helper class to prevent infinite recursion in the usage of TTree Friends.
Definition: TTree.h:186
static TClass * GetClass(const char *name, Bool_t load=kTRUE, Bool_t silent=kFALSE)
Static method returning pointer to TClass of the specified class name.
Definition: TClass.cxx:2882
virtual Int_t SetCacheSize(Long64_t cachesize=-1)
Set maximum size of the file cache .
Definition: TTree.cxx:8007
Int_t fDebug
! Debug level
Definition: TTree.h:127
Int_t SetCacheSizeAux(Bool_t autocache=kTRUE, Long64_t cacheSize=0)
Set the size of the file cache and create it if possible.
Definition: TTree.cxx:8033
#define BIT(n)
Definition: Rtypes.h:120
Array of doubles (64 bits per element).
Definition: TArrayD.h:29
virtual void SetBasketSize(const char *bname, Int_t buffsize=16000)
Set a branch&#39;s basket size.
Definition: TTree.cxx:7692
virtual TBranch * BranchRef()
Build the optional branch supporting the TRefTable.
Definition: TTree.cxx:2138
virtual void ResetAfterMerge(TFileMergeInfo *)
Resets the state of this TTree after a merge (keep the customization but forget the data)...
Definition: TTree.cxx:7434
virtual Bool_t SetAlias(const char *aliasName, const char *aliasFormula)
Set a tree variable alias.
Definition: TTree.cxx:7536
Int_t fFileNumber
! current file number (if file extensions)
Definition: TTree.h:131
Mother of all ROOT objects.
Definition: TObject.h:44
virtual Long64_t ReadFile(const char *filename, const char *branchDescriptor="", char delimiter= ' ')
Create or simply read branches from filename.
Definition: TTree.cxx:6995
Int_t fUpdate
Update frequency for EntryLoop.
Definition: TTree.h:109
Long64_t operator()()
Definition: TTree.h:292
virtual Int_t Branch(TCollection *list, Int_t bufsize=32000, Int_t splitlevel=99, const char *name="")
Create one branch for each element in the collection.
Definition: TTree.cxx:1651
virtual Int_t GetFileNumber() const
Definition: TTree.h:405
Long64_t fEntries
Number of entries.
Definition: TTree.h:101
TList * fClones
! List of cloned trees which share our addresses
Definition: TTree.h:146
virtual Int_t MakeSelector(const char *selector=0, Option_t *option="")
Generate skeleton selector class for this tree.
Definition: TTree.cxx:6324
TBuffer * GetTransientBuffer(Int_t size)
Returns the transient buffer currently used by this TTree for reading/writing baskets.
Definition: TTree.cxx:917
Int_t Debug() const
Definition: TTree.h:364
Class implementing or helping the various TTree cloning method.
Definition: TTreeCloner.h:40
virtual Double_t * GetVal(Int_t i)
Definition: TTree.h:459
Abstract base class defining the interface for the plugins that implement Draw, Scan, Process, MakeProxy, etc.
Definition: file.py:1
TObject * operator*() const
Return current object or nullptr.
Definition: TTree.h:614
A TFriendElement TF describes a TTree object TF in a file.
Long64_t fNextEntry
Definition: TTree.h:261
Iterator on all the leaves in a TTree and its friend.
Definition: TTree.h:584
virtual TBranch * BronchExec(const char *name, const char *classname, void *addobj, Bool_t isptrptr, Int_t bufsize, Int_t splitlevel)
Helper function implementing TTree::Bronch and TTree::Branch(const char *name, T &obj);.
Definition: TTree.cxx:2222
virtual void RecursiveRemove(TObject *obj)
Make sure that obj (which is being deleted or will soon be) is no longer referenced by this TTree...
Definition: TTree.cxx:7307
virtual Double_t * GetV3() const =0
virtual void SetCircular(Long64_t maxEntries)
Enable/Disable circularity for this tree.
Definition: TTree.cxx:8211
virtual void Reset(Option_t *option="")
Reset baskets, buffers and entries count in all branches and leaves.
Definition: TTree.cxx:7403
Definition: tree.py:1
std::atomic< Long64_t > fTotalBuffers
! Total number of bytes in branch buffers
Definition: TTree.h:124
virtual void SetTimerInterval(Int_t msec=333)
Definition: TTree.h:560
TObject * fNotify
! Object to be notified when loading a Tree
Definition: TTree.h:132
virtual Int_t SetCacheEntryRange(Long64_t first, Long64_t last)
interface to TTreeCache to set the cache entry range
Definition: TTree.cxx:8150
virtual Long64_t GetEntries() const
Definition: TTree.h:392
TTreeFormula * GetVar1()
Definition: TTree.h:451
A TTree object has a header with a name and a title.
Definition: TTree.h:98
TVirtualIndex * fTreeIndex
Pointer to the tree Index (if any)
Definition: TTree.h:141
TFriendLock & operator=(const TFriendLock &)
Assignment operator.
Definition: TTree.cxx:494
Int_t SetBranchAddressImp(TBranch *branch, void *addr, TBranch **ptr)
Change branch address, dealing with clone trees properly.
Definition: TTree.cxx:7776
virtual void SetDefaultEntryOffsetLen(Int_t newdefault, Bool_t updateExisting=kFALSE)
Update the default value for the branch&#39;s fEntryOffsetLen.
Definition: TTree.cxx:8259
virtual Double_t GetWeight() const
Definition: TTree.h:469
Int_t GetMakeClass() const
Definition: TTree.h:423
Definition: first.py:1
virtual void DropBaskets()
Remove some baskets from memory.
Definition: TTree.cxx:4293
virtual TIterator * GetIteratorOnAllLeaves(Bool_t dir=kIterForward)
Creates a new iterator that will go through all the leaves on the tree itself and its friend...
Definition: TTree.cxx:5596
virtual void SetImplicitMT(Bool_t enabled)
Definition: TTree.h:549
static Long64_t fgMaxTreeSize
Maximum size of a file containing a Tree.
Definition: TTree.h:157
virtual Long64_t SetEntries(Long64_t n=-1)
Change number of entries in the tree.
Definition: TTree.cxx:8330
virtual TTreeFormula * GetVar4() const =0
virtual TFile * ChangeFile(TFile *file)
Called by TTree::Fill() when file has reached its maximum fgMaxTreeSize.
Definition: TTree.cxx:2626
static TTree * MergeTrees(TList *list, Option_t *option="")
Static function merging the trees in the TList into a new tree.
Definition: TTree.cxx:6353
A TTree is a list of TBranches.
Definition: TBranch.h:58
virtual Bool_t GetBranchStatus(const char *branchname) const
Return status of branch with name branchname.
Definition: TTree.cxx:4964
A TSelector object is used by the TTree::Draw, TTree::Scan, TTree::Process to navigate in a TTree and...
Definition: TSelector.h:39
const Bool_t kTRUE
Definition: Rtypes.h:91
A List of entry numbers in a TTree or TChain.
Definition: TEntryList.h:27
virtual Long64_t GetEntryNumberWithBestIndex(Long64_t major, Long64_t minor=0) const
Return entry number corresponding to major and minor number.
Definition: TTree.cxx:5412
virtual Int_t AddBranchToCache(const char *bname, Bool_t subbranches=kFALSE)
Add branch with name bname to the Tree cache.
Definition: TTree.cxx:939
virtual TTreeFormula * GetSelect() const =0
Int_t fPacketSize
! Number of entries in one packet for parallel root
Definition: TTree.h:125
virtual Int_t GetPacketSize() const
Definition: TTree.h:433
const Int_t n
Definition: legend1.C:16
virtual Long64_t Project(const char *hname, const char *varexp, const char *selection="", Option_t *option="", Long64_t nentries=kMaxEntries, Long64_t firstentry=0)
Make a projection of a tree using selections.
Definition: TTree.cxx:6929
virtual void SetScanField(Int_t n=50)
Definition: TTree.h:559
Line Attributes class.
Definition: TAttLine.h:24
virtual Double_t * GetV1()
Definition: TTree.h:461
Int_t SetBranchAddress(const char *bname, T *add, TBranch **ptr=0)
Definition: TTree.h:527
static constexpr Long64_t kMaxEntries
Definition: TTree.h:227
char name[80]
Definition: TGX11.cxx:109
TFriendLock(const TFriendLock &)
Copy constructor.
Definition: TTree.cxx:484
Int_t GetDefaultEntryOffsetLen() const
Definition: TTree.h:388
virtual Int_t GetScanField() const
Definition: TTree.h:437
virtual void SetName(const char *name)
Change the name of this tree.
Definition: TTree.cxx:8490
A Chain Index.
Definition: TChainIndex.h:41
void MoveReadCache(TFile *src, TDirectory *dir)
Move a cache from a file to the current file in dir.
Definition: TTree.cxx:6486
virtual void CopyAddresses(TTree *, Bool_t undo=kFALSE)
Set branch addresses of passed tree equal to ours.
Definition: TTree.cxx:3158
virtual TObjArray * GetListOfLeaves()
Definition: TTree.h:417
Long64_t fSavedBytes
Number of autosaved bytes.
Definition: TTree.h:104
Long64_t fCacheSize
! Maximum size of file buffers
Definition: TTree.h:121
virtual void SetChainOffset(Long64_t offset=0)
Definition: TTree.h:539
virtual Long64_t AutoSave(Option_t *option="")
AutoSave tree header every fAutoSave bytes.
Definition: TTree.cxx:1336
virtual Double_t * GetIndexValues()
Definition: TTree.h:411