Logo ROOT  
Reference Guide
 
Loading...
Searching...
No Matches
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#include "Compression.h"
30#include "ROOT/TIOFeatures.hxx"
31#include "TArrayD.h"
32#include "TArrayI.h"
33#include "TAttFill.h"
34#include "TAttLine.h"
35#include "TAttMarker.h"
36#include "TClass.h"
37#include "TDataType.h"
38#include "TDirectory.h"
39#include "TObjArray.h"
40#include "TVirtualTreePlayer.h"
41
42#ifdef R__LESS_INCLUDES
43class TBranch;
44class TList;
45#else
46#include "TBranch.h"
47// #include "TBuffer.h"
48#include "TList.h"
49#endif
50
51#include <array>
52#include <atomic>
53#include <vector>
54#include <utility>
55
56class TBuffer;
57class TBrowser;
58class TFile;
59class TLeaf;
60class TH1;
61class TTreeFormula;
62class TPolyMarker;
63class TEventList;
64class TEntryList;
65class TSQLResult;
66class TSelector;
67class TPrincipal;
68class TFriendElement;
69class TCut;
70class TVirtualIndex;
71class TBranchRef;
72class TBasket;
73class TStreamerInfo;
74class TTree;
75class TTreeCache;
76class TTreeCloner;
77class TFileMergeInfo;
79
82
84 Int_t bufsize = 32000, Int_t splitlevel = 99);
85TBranch *CallBranchImp(TTree &tree, const char *branchname, TClass *ptrClass, void *addobj, Int_t bufsize = 32000,
86 Int_t splitlevel = 99);
87}
88
89class TTree : public TNamed, public TAttLine, public TAttFill, public TAttMarker {
90
92
93protected:
94 Long64_t fEntries; ///< Number of entries
95// NOTE: cannot use std::atomic for these counters as it cannot be serialized.
96 Long64_t fTotBytes; ///< Total number of bytes in all branches before compression
97 Long64_t fZipBytes; ///< Total number of bytes in all branches after compression
98 Long64_t fSavedBytes; ///< Number of autosaved bytes
99 Long64_t fFlushedBytes; ///< Number of auto-flushed bytes
100 Double_t fWeight; ///< Tree weight (see TTree::SetWeight)
101 Int_t fTimerInterval; ///< Timer interval in milliseconds
102 Int_t fScanField; ///< Number of runs before prompting in Scan
103 Int_t fUpdate; ///< Update frequency for EntryLoop
104 Int_t fDefaultEntryOffsetLen; ///< Initial Length of fEntryOffset table in the basket buffers
105 Int_t fNClusterRange; ///< Number of Cluster range in addition to the one defined by 'AutoFlush'
106 Int_t fMaxClusterRange; ///<! Memory allocated for the cluster range.
107 Long64_t fMaxEntries; ///< Maximum number of entries in case of circular buffers
108 Long64_t fMaxEntryLoop; ///< Maximum number of entries to process
109 Long64_t fMaxVirtualSize; ///< Maximum total size of buffers kept in memory
110 Long64_t fAutoSave; ///< Autosave tree when fAutoSave entries written or -fAutoSave (compressed) bytes produced
111 Long64_t fAutoFlush; ///< Auto-flush tree when fAutoFlush entries written or -fAutoFlush (compressed) bytes produced
112 Long64_t fEstimate; ///< Number of entries to estimate histogram limits
113 Long64_t *fClusterRangeEnd; ///<[fNClusterRange] Last entry of a cluster range.
114 Long64_t *fClusterSize; ///<[fNClusterRange] Number of entries in each cluster for a given range.
115 Long64_t fCacheSize; ///<! Maximum size of file buffers
116 Long64_t fChainOffset; ///<! Offset of 1st entry of this Tree in a TChain
117 Long64_t fReadEntry; ///<! Number of the entry being processed
118 std::atomic<Long64_t> fTotalBuffers; ///<! Total number of bytes in branch buffers
119 Int_t fPacketSize; ///<! Number of entries in one packet for parallel root
120 Int_t fNfill; ///<! Local for EntryLoop
121 Int_t fDebug; ///<! Debug level
122 Long64_t fDebugMin; ///<! First entry number to debug
123 Long64_t fDebugMax; ///<! Last entry number to debug
124 TIOFeatures fIOFeatures{0}; ///< IO features to define for newly-written baskets and branches.
125 Int_t fMakeClass; ///<! not zero when processing code generated by MakeClass
126 Int_t fFileNumber; ///<! current file number (if file extensions)
127 /// Object to be notified when loading a Tree.
128 /// TTree::LoadTree() and TChain::LoadTree() will call fNotify->Notify().
129 /// Usually points to a TNotifyLink if this is a TChain.
131 TDirectory *fDirectory; ///<! Pointer to directory holding this tree
132 TObjArray fBranches; ///< List of Branches
133 TObjArray fLeaves; ///< Direct pointers to individual branch leaves
134 TList *fAliases; ///< List of aliases for expressions based on the tree branches.
135 TEventList *fEventList; ///<! Pointer to event selection list (if one)
136 TEntryList *fEntryList; ///<! Pointer to event selection list (if one)
137 TArrayD fIndexValues; ///< Sorted index values
138 TArrayI fIndex; ///< Index of sorted values
139 TVirtualIndex *fTreeIndex; ///< Pointer to the tree Index (if any)
140 TList *fFriends; ///< pointer to list of friend elements
141 TList *fExternalFriends; ///<! List of TFriendsElement pointing to us and need to be notified of LoadTree. Content not owned.
142 TVirtualPerfStats *fPerfStats; ///<! pointer to the current perf stats object
143 TList *fUserInfo; ///< pointer to a list of user objects associated to this Tree
144 TVirtualTreePlayer *fPlayer; ///<! Pointer to current Tree player
145 TList *fClones; ///<! List of cloned trees which share our addresses
146 TBranchRef *fBranchRef; ///< Branch supporting the TRefTable (if any)
147 UInt_t fFriendLockStatus; ///<! Record which method is locking the friend recursion
148 TBuffer *fTransientBuffer; ///<! Pointer to the current transient buffer.
149 bool fCacheDoAutoInit; ///<! true if cache auto creation or resize check is needed
150 bool fCacheDoClusterPrefetch;///<! true if cache is prefetching whole clusters
151 bool fCacheUserSet; ///<! true if the cache setting was explicitly given by user
152 bool 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 to be processed in parallel when IMT is on, sorted by average task time
155 std::vector<TBranch*> fSeqBranches; ///<! Branches to be processed sequentially when IMT is on
156 Float_t fTargetMemoryRatio{1.1f}; ///<! Ratio for memory usage in uncompressed buffers versus actual occupancy. 1.0
157 /// indicates basket should be resized to exact memory usage, but causes significant
158/// memory churn.
159#ifdef R__TRACK_BASKET_ALLOC_TIME
160 mutable std::atomic<ULong64_t> fAllocationTime{0}; ///<! Time spent reallocating basket memory buffers, in microseconds.
161#endif
162 mutable std::atomic<UInt_t> fAllocationCount{0}; ///<! Number of reallocations basket memory buffers.
163
164 static Int_t fgBranchStyle; ///< Old/New branch style
165 static Long64_t fgMaxTreeSize; ///< Maximum size of a file containing a Tree
166
167private:
168 // For simplicity, although fIMTFlush is always disabled in non-IMT builds, we don't #ifdef it out.
169 mutable bool fIMTFlush{false}; ///<! True if we are doing a multithreaded flush.
170 mutable std::atomic<Long64_t> fIMTTotBytes; ///<! Total bytes for the IMT flush baskets
171 mutable std::atomic<Long64_t> fIMTZipBytes; ///<! Zip bytes for the IMT flush baskets.
172
173 std::unordered_map<std::string, TBranch *>
174 fNamesToBranches; ///<! maps names to their branches, useful when retrieving branches by name
175
177 void SortBranchesByTime();
178 Int_t FlushBasketsImpl() const;
179 void MarkEventCluster();
181
182 void RegisterBranchFullName(std::pair<std::string, TBranch *> &&kv) { fNamesToBranches.insert(kv); }
184
185 Int_t
186 SetBranchAddressImp(const char *bname, void *add, TBranch **ptr, TClass *realClass, EDataType datatype, bool isptr);
187
188protected:
194 virtual void KeepCircular();
195 virtual TBranch *BranchImp(const char* branchname, const char* classname, TClass* ptrClass, void* addobj, Int_t bufsize, Int_t splitlevel);
197 virtual TBranch *BranchImpRef(const char* branchname, const char* classname, TClass* ptrClass, void* addobj, Int_t bufsize, Int_t splitlevel);
199 virtual TBranch *BranchImpArr(const char* branchname, EDataType datatype, std::size_t N, void* addobj, Int_t bufsize, Int_t splitlevel);
201 virtual TBranch *BronchExec(const char* name, const char* classname, void* addobj, bool isptrptr, Int_t bufsize, Int_t splitlevel);
204 virtual TLeaf *GetLeafImpl(const char* branchname, const char* leafname);
205
207 char GetNewlineValue(std::istream &inputStream);
209 void MoveReadCache(TFile *src, TDirectory *dir);
210 Int_t SetCacheSizeAux(bool autocache = true, Long64_t cacheSize = 0);
211
214 // This overload is used when setting the branch address of friends of this tree. When registering the branches
215 // to be found later, we can't know a priori which friend will have branch 'bname'. TTree and TChain have different
216 // ways to deal with the fact that we should not print spurious error messages that a branch cannot be found
217 // if it is not in one particular friend but in another
218 virtual Int_t SetBranchAddress(const char *bname, void *add, TBranch **ptr, TClass *realClass, EDataType datatype,
220
222 // Helper class to prevent infinite recursion in the
223 // usage of TTree Friends. Implemented in TTree.cxx.
224 TTree *fTree; // Pointer to the locked tree
225 UInt_t fMethodBit; // BIT for the locked method
226 bool fPrevious; // Previous value of the BIT.
227
228 protected:
229 TFriendLock(const TFriendLock&);
231
232 public:
234 ~TFriendLock();
235 };
236 friend class TFriendLock;
237 // So that the index class can use TFriendLock:
238 friend class TTreeIndex;
239 friend class TChainIndex;
240 // So that the TTreeCloner can access the protected interfaces
241 friend class TTreeCloner;
242
243 // use to update fFriendLockStatus
260
261public:
262 // Used as the max value for any TTree range operation.
264
265 // SetBranchAddress return values
282
283 // TTree status bits
287 /// If set, the branch's buffers will grow until an event cluster boundary is hit,
288 /// guaranteeing a basket per cluster. This mode does not provide any guarantee on the
289 /// memory bounds in the case of extremely large events.
291 /// If set, signals that this TTree is the output of the processing of another TTree, and
292 /// the entries are reshuffled w.r.t. to the original TTree. As a safety measure, a TTree
293 /// with this bit set cannot add friends nor can be added as a friend. If you know what
294 /// you are doing, you can manually unset this bit with `ResetBit(EStatusBits::kEntriesReshuffled)`.
295 kEntriesReshuffled = BIT(19) // bits 15-18 are used by TChain
296 };
297
298 // Split level modifier
299 enum {
301 };
302
304 {
305 private:
306 TTree *fTree; // TTree upon which we are iterating.
307 Int_t fClusterRange; // Which cluster range are we looking at.
308 Long64_t fStartEntry; // Where does the cluster start.
309 Long64_t fNextEntry; // Where does the cluster end (exclusive).
310 Long64_t fEstimatedSize; // If positive, the calculated estimated tree size.
311
313
314 protected:
315 friend class TTree;
317
318 public:
319 // Intentionally used the default copy constructor and default destructor
320 // as the TClusterIterator does not own the TTree.
321 // TClusterIterator(const TClusterIterator&);
322 // ~TClusterIterator();
323
324 // No public constructors, the iterator must be
325 // created via TTree::GetClusterIterator
326
327 // Move on to the next cluster and return the starting entry
328 // of this next cluster
329 Long64_t Next();
330
331 // Move on to the previous cluster and return the starting entry
332 // of this previous cluster
334
335 // Return the start entry of the current cluster.
337 return fStartEntry;
338 }
339
340 // Return the first entry of the next cluster.
342 return fNextEntry;
343 }
344
345 Long64_t operator()() { return Next(); }
346 };
347
348 TTree();
349 TTree(const char* name, const char* title, Int_t splitlevel = 99, TDirectory* dir = gDirectory);
350 ~TTree() override;
351
352 TTree(const TTree& tt) = delete;
353 TTree& operator=(const TTree& tt) = delete;
354
355 virtual Int_t AddBranchToCache(const char *bname, bool subbranches = false);
356 virtual Int_t AddBranchToCache(TBranch *branch, bool subbranches = false);
357 virtual Int_t DropBranchFromCache(const char *bname, bool subbranches = false);
358 virtual Int_t DropBranchFromCache(TBranch *branch, bool subbranches = false);
359 void AddClone(TTree*);
360 virtual TFriendElement *AddFriend(const char* treename, const char* filename = "");
361 virtual TFriendElement *AddFriend(const char* treename, TFile* file);
362 virtual TFriendElement *AddFriend(TTree* tree, const char* alias = "", bool warn = false);
363 // As the TBasket invokes Add{Tot,Zip}Bytes on its parent tree, we must do these updates in a thread-safe
364 // manner only when we are flushing multiple baskets in parallel.
365 virtual void AddTotBytes(Int_t tot) { if (fIMTFlush) { fIMTTotBytes += tot; } else { fTotBytes += tot; } }
366 virtual void AddZipBytes(Int_t zip) { if (fIMTFlush) { fIMTZipBytes += zip; } else { fZipBytes += zip; } }
367// NOTE: these counters aren't thread safe like the ones above.
368#ifdef R__TRACK_BASKET_ALLOC_TIME
369 void AddAllocationTime(ULong64_t time) { fAllocationTime += time; }
370#endif
372 virtual Long64_t AutoSave(Option_t* option = "");
373
374 /// Add a new branch, and infer the data type from the type of `obj` being passed.
375 ///
376 /// \note This and the next overload should cover most cases for creating a branch. Try to use these two whenever
377 /// possible, unless e.g. type conversions are needed.
378 ///
379 /// \param[in] name Name of the branch to be created.
380 /// \param[in] obj Address of the object to be added. Make sure to pass a pointer to the actual type/class that
381 /// should be stored in the tree (no pointers to base classes). When calling Fill(), the current value of the type/object will be saved.
382 /// \param[in] bufsize The buffer size in bytes for this branch. When the buffer is full, it is compressed and written to disc.
383 /// The default value of 32000 bytes and should be ok for most simple types. Larger buffers (e.g. 256000) if your Tree is not split and each entry is large (Megabytes).
384 /// A small value for bufsize is beneficial if entries in the Tree are accessed randomly and the Tree is in split mode.
385 /// \param[in] splitlevel If T is a class or struct and splitlevel > 0, the members of the object are serialised as separate branches.
386 /// \return Pointer to the TBranch that was created. The branch is owned by the tree.
387 template <class T> TBranch *Branch(const char* name, T* obj, Int_t bufsize = 32000, Int_t splitlevel = 99)
388 {
389 return BranchImpRef(name, TClass::GetClass<T>(), TDataType::GetType(typeid(T)), obj, bufsize, splitlevel);
390 }
391
392 /// Add a new branch, and infer the data type from the array `addobj` being passed.
393 ///
394 /// \note This and the previous overload should cover most cases for creating a branch. Try to use these two whenever
395 /// possible, unless e.g. type conversions are needed.
396 ///
397 /// \param[in] name Name of the branch to be created.
398 /// \param[in] addobj Array of the objects to be added. When calling Fill(), the current value of the type/object will be saved.
399 /// \param[in] bufsize he buffer size in bytes for this branch. When the buffer is full, it is compressed and written to disc.
400 /// The default value of 32000 bytes and should be ok for most simple types. Larger buffers (e.g. 256000) if your Tree is not split and each entry is large (Megabytes).
401 /// A small value for bufsize is beneficial if entries in the Tree are accessed randomly and the Tree is in split mode.
402 /// \param[in] splitlevel If T is a class or struct and splitlevel > 0, the members of the object are serialised as separate branches.
403 /// \return Pointer to the TBranch that was created. The branch is owned by the tree.
404 template <class T> TBranch *Branch(const char* name, T** addobj, Int_t bufsize = 32000, Int_t splitlevel = 99)
405 {
406 return BranchImp(name, TClass::GetClass<T>(), addobj, bufsize, splitlevel);
407 }
408
409 virtual Int_t Branch(TCollection* list, Int_t bufsize = 32000, Int_t splitlevel = 99, const char* name = "");
410 virtual Int_t Branch(TList* list, Int_t bufsize = 32000, Int_t splitlevel = 99);
411 virtual Int_t Branch(const char* folder, Int_t bufsize = 32000, Int_t splitlevel = 99);
412 virtual TBranch *Branch(const char* name, void* address, const char* leaflist, Int_t bufsize = 32000);
413 TBranch *Branch(const char* name, char* address, const char* leaflist, Int_t bufsize = 32000)
414 {
415 // Overload to avoid confusion between this signature and the template instance.
416 return Branch(name,(void*)address,leaflist,bufsize);
417 }
418 TBranch *Branch(const char* name, Longptr_t address, const char* leaflist, Int_t bufsize = 32000)
419 {
420 // Overload to avoid confusion between this signature and the template instance.
421 return Branch(name,(void*)address,leaflist,bufsize);
422 }
423 TBranch *Branch(const char* name, int address, const char* leaflist, Int_t bufsize = 32000)
424 {
425 // Overload to avoid confusion between this signature and the template instance.
426 return Branch(name,(void*)(Longptr_t)address,leaflist,bufsize);
427 }
428 virtual TBranch *Branch(const char* name, const char* classname, void* addobj, Int_t bufsize = 32000, Int_t splitlevel = 99);
429 template <class T> TBranch *Branch(const char* name, const char* classname, T* obj, Int_t bufsize = 32000, Int_t splitlevel = 99)
430 {
431 // See BranchImpRed for details. Here we __ignore
432 return BranchImpRef(name, classname, TClass::GetClass<T>(), obj, bufsize, splitlevel);
433 }
434 template <class T> TBranch *Branch(const char* name, const char* classname, T** addobj, Int_t bufsize = 32000, Int_t splitlevel = 99)
435 {
436 // See BranchImp for details
437 return BranchImp(name, classname, TClass::GetClass<T>(), addobj, bufsize, splitlevel);
438 }
439 template <typename T, std::size_t N> TBranch *Branch(const char* name, std::array<T, N> *obj, Int_t bufsize = 32000, Int_t splitlevel = 99)
440 {
441 TClass *cl = TClass::GetClass<T>();
442 if (cl) {
443 TClass *arrCl = TClass::GetClass<std::array<T, N>>();
444 Error("Branch","std::array of objects not yet supported as top level branch object (the class is %s)",
445 arrCl ? arrCl->GetName() : cl->GetName());
446 return nullptr;
447 }
448 return BranchImpArr(name, TDataType::GetType(typeid(T)), N, obj, bufsize, splitlevel);
449 }
450 virtual TBranch *Bronch(const char* name, const char* classname, void* addobj, Int_t bufsize = 32000, Int_t splitlevel = 99);
451 virtual TBranch *BranchOld(const char* name, const char* classname, void* addobj, Int_t bufsize = 32000, Int_t splitlevel = 1);
452 virtual TBranch *BranchRef();
453 void Browse(TBrowser*) override;
454 virtual Int_t BuildIndex(const char *majorname, const char *minorname = "0", bool long64major = false, bool long64minor = false);
455 /// Build index with only a major formula. Minor formula will be set to "0" ie skip.
456 /// \see TTree::BuildIndex(const char *, const char *, bool, bool)
457 Int_t BuildIndex(const char *majorname, bool long64major) { return BuildIndex(majorname, "0", long64major, false); }
458 TStreamerInfo *BuildStreamerInfo(TClass* cl, void *pointer = nullptr, bool canOptimize = true);
459 virtual TFile *ChangeFile(TFile* file);
460 virtual TTree *CloneTree(Long64_t nentries = -1, Option_t* option = "");
461 virtual void CopyAddresses(TTree*,bool undo = false);
462 virtual Long64_t CopyEntries(TTree* tree, Long64_t nentries = -1, Option_t *option = "", bool needCopyAddresses = false);
464 virtual TBasket *CreateBasket(TBranch*);
465 virtual void DirectoryAutoAdd(TDirectory *);
466 Int_t Debug() const { return fDebug; }
467 void Delete(Option_t* option = "") override; // *MENU*
468 void Draw(Option_t* opt) override { Draw(opt, "", "", kMaxEntries, 0); }
469 virtual Long64_t Draw(const char* varexp, const TCut& selection, Option_t* option = "", Long64_t nentries = kMaxEntries, Long64_t firstentry = 0);
470 virtual Long64_t Draw(const char* varexp, const char* selection, Option_t* option = "", Long64_t nentries = kMaxEntries, Long64_t firstentry = 0); // *MENU*
471 virtual void DropBaskets();
472 virtual void DropBuffers(Int_t nbytes);
473 bool EnableCache();
474 virtual Int_t Fill();
475 virtual TBranch *FindBranch(const char* name);
476 virtual TLeaf *FindLeaf(const char* name);
477 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*
478 virtual Int_t FlushBaskets(bool create_cluster = true) const;
479 virtual const char *GetAlias(const char* aliasName) const;
481#ifdef R__TRACK_BASKET_ALLOC_TIME
483#endif
484 virtual Long64_t GetAutoFlush() const {return fAutoFlush;}
485 virtual Long64_t GetAutoSave() const {return fAutoSave;}
486 virtual TBranch *GetBranch(const char* name);
487 virtual TBranchRef *GetBranchRef() const { return fBranchRef; };
488 virtual bool GetBranchStatus(const char* branchname) const;
489 static Int_t GetBranchStyle();
490 virtual Long64_t GetCacheSize() const { return fCacheSize; }
491 virtual TClusterIterator GetClusterIterator(Long64_t firstentry);
493 virtual Long64_t GetChainOffset() const { return fChainOffset; }
494 virtual bool GetClusterPrefetch() const { return fCacheDoClusterPrefetch; }
495 TFile *GetCurrentFile() const;
497 Long64_t GetDebugMax() const { return fDebugMax; }
498 Long64_t GetDebugMin() const { return fDebugMin; }
499 TDirectory *GetDirectory() const { return fDirectory; }
500 virtual Long64_t GetEntries() const { return fEntries; }
501 virtual Long64_t GetEntries(const char *selection);
502 /// Return a number greater or equal to the total number of entries in the
503 /// dataset.
504 ///
505 /// \note If you are interested in the total number of entries in a TChain,
506 /// this function will give that number once the last file of the chain
507 /// is opened. In general, using this instead of GetEntries will avoid
508 /// opening all files in the chain which could be very costly for very
509 /// large number of files stored at a remote location.
510 ///
511 /// The logic depends on whether the dataset is a TTree or a TChain. In the
512 /// first case, it simply returns the total number of entries in the tree. In
513 /// the latter case, it depends on which point of the processing of the chain
514 /// this function is called. During most of the chain processing, this
515 /// function will return TTree::kMaxEntries. When the chain arrives at the
516 /// last file, then the function will return the accumulated total number of
517 /// entries in the whole chain. A notable use case where this function
518 /// becomes quite useful is when writing the following for loop to traverse
519 /// the entries in the dataset:
520 ///
521 /// \code{.cpp}
522 /// for(Long64_t ievent = 0; ievent < dataset.GetEntriesFast(); ievent++) {
523 /// // Do something with the event in the dataset
524 /// }
525 /// \endcode
526 ///
527 /// In the example above, independently on whether the dataset is a TTree or
528 /// a TChain, the GetEntriesFast call will provide the correct stopping
529 /// condition for the loop (i.e. the total number of entries). In the TChain
530 /// case, calling GetEntries instead would open all the files in the chain
531 /// upfront which could be costly.
532 ///
533 /// The functionality offered by this method can also be seen when used in
534 /// conjunction with LoadTree. For a call like <tt> LoadTree(ievent) </tt>,
535 /// the condition <tt> ievent < dataset.GetEntriesFast() </tt> is only
536 /// satisfied if \p ievent is strictly smaller than the total number of
537 /// entries in the dataset. In fact, even when the dataset is a TChain, the
538 /// first time LoadTree is called with an entry number that belongs to the
539 /// last file of the chain, this will update the internal data member of the
540 /// class so that the next call to GetEntriesFast returns the total number
541 /// of entries in the dataset.
542 virtual Long64_t GetEntriesFast() const { return fEntries; }
543 virtual Long64_t GetEntriesFriend() const;
544 virtual Long64_t GetEstimate() const { return fEstimate; }
545 virtual Int_t GetEntry(Long64_t entry, Int_t getall = 0);
550 TEventList *GetEventList() const { return fEventList; }
551 virtual TEntryList *GetEntryList();
552 virtual Long64_t GetEntryNumber(Long64_t entry) const;
553 virtual Int_t GetFileNumber() const { return fFileNumber; }
554 virtual TTree *GetFriend(const char*) const;
555 virtual const char *GetFriendAlias(TTree*) const;
557 virtual bool GetImplicitMT() { return fIMTEnabled; }
558 virtual Int_t *GetIndex() { return &fIndex.fArray[0]; }
559 virtual Double_t *GetIndexValues() { return &fIndexValues.fArray[0]; }
561 virtual TIterator *GetIteratorOnAllLeaves(bool dir = kIterForward);
562 virtual TLeaf *GetLeaf(const char* branchname, const char* leafname);
563 virtual TLeaf *GetLeaf(const char* name);
564 virtual TList *GetListOfClones() { return fClones; }
565 virtual TObjArray *GetListOfBranches() { return &fBranches; }
566 virtual TObjArray *GetListOfLeaves() { return &fLeaves; }
567 virtual TList *GetListOfFriends() const { return fFriends; }
568 virtual TList *GetListOfAliases() const { return fAliases; }
569
570 // GetMakeClass is left non-virtual for efficiency reason.
571 // Making it virtual affects the performance of the I/O
572 Int_t GetMakeClass() const { return fMakeClass; }
573
574 virtual Long64_t GetMaxEntryLoop() const { return fMaxEntryLoop; }
575 virtual Double_t GetMaximum(const char* columname);
576 static Long64_t GetMaxTreeSize();
577 virtual Long64_t GetMaxVirtualSize() const { return fMaxVirtualSize; }
578 virtual Double_t GetMinimum(const char* columname);
580 TObject *GetNotify() const { return fNotify; }
582 virtual Int_t GetPacketSize() const { return fPacketSize; }
583 virtual TVirtualPerfStats *GetPerfStats() const { return fPerfStats; }
584 TTreeCache *GetReadCache(TFile *file) const;
585 TTreeCache *GetReadCache(TFile *file, bool create);
586 virtual Long64_t GetReadEntry() const { return fReadEntry; }
587 virtual Long64_t GetReadEvent() const { return fReadEntry; }
588 virtual Int_t GetScanField() const { return fScanField; }
591 virtual Int_t GetTimerInterval() const { return fTimerInterval; }
593 virtual Long64_t GetTotBytes() const { return fTotBytes; }
594 virtual TTree *GetTree() const { return const_cast<TTree*>(this); }
595 virtual TVirtualIndex *GetTreeIndex() const { return fTreeIndex; }
596 virtual Int_t GetTreeNumber() const { return 0; }
598 virtual Int_t GetUpdate() const { return fUpdate; }
599 virtual TList *GetUserInfo();
600 // See TSelectorDraw::GetVar
602 // See TSelectorDraw::GetVar
604 // See TSelectorDraw::GetVar
606 // See TSelectorDraw::GetVar
608 // See TSelectorDraw::GetVar
610 // See TSelectorDraw::GetVal
611 virtual Double_t *GetVal(Int_t i) { return GetPlayer()->GetVal(i); }
612 // See TSelectorDraw::GetVal
613 virtual Double_t *GetV1() { return GetPlayer()->GetV1(); }
614 // See TSelectorDraw::GetVal
615 virtual Double_t *GetV2() { return GetPlayer()->GetV2(); }
616 // See TSelectorDraw::GetVal
617 virtual Double_t *GetV3() { return GetPlayer()->GetV3(); }
618 // See TSelectorDraw::GetVal
619 virtual Double_t *GetV4() { return GetPlayer()->GetV4(); }
620 virtual Double_t *GetW() { return GetPlayer()->GetW(); }
621 virtual Double_t GetWeight() const { return fWeight; }
622 virtual Long64_t GetZipBytes() const { return fZipBytes; }
624 bool IsFolder() const override { return true; }
625 virtual bool InPlaceClone(TDirectory *newdirectory, const char *options = "");
626 virtual Int_t LoadBaskets(Long64_t maxmemory = 2000000000);
629 virtual Int_t MakeClass(const char *classname = nullptr, Option_t* option = "");
630 virtual Int_t MakeCode(const char *filename = nullptr);
631 virtual Int_t MakeProxy(const char* classname, const char* macrofilename = nullptr, const char* cutfilename = nullptr, const char* option = nullptr, Int_t maxUnrolling = 3);
632 virtual Int_t MakeSelector(const char *selector = nullptr, Option_t *option = "");
633 bool MemoryFull(Int_t nbytes);
634 virtual Long64_t Merge(TCollection* list, Option_t* option = "");
636 static TTree *MergeTrees(TList* list, Option_t* option = "");
637 bool Notify() override;
638 virtual void OptimizeBaskets(ULong64_t maxMemory=10000000, Float_t minComp=1.1, Option_t *option="");
639 TPrincipal *Principal(const char* varexp = "", const char* selection = "", Option_t* option = "np", Long64_t nentries = kMaxEntries, Long64_t firstentry = 0);
640 void Print(Option_t* option = "") const override; // *MENU*
641 virtual void PrintCacheStats(Option_t* option = "") const;
642 virtual Long64_t Process(const char* filename, Option_t* option = "", Long64_t nentries = kMaxEntries, Long64_t firstentry = 0); // *MENU*
644 virtual Long64_t Project(const char* hname, const char* varexp, const char* selection = "", Option_t* option = "", Long64_t nentries = kMaxEntries, Long64_t firstentry = 0);
645 virtual TSQLResult *Query(const char* varexp = "", const char* selection = "", Option_t* option = "", Long64_t nentries = kMaxEntries, Long64_t firstentry = 0);
646 virtual Long64_t ReadFile(const char* filename, const char* branchDescriptor = "", char delimiter = ' ');
647 virtual Long64_t ReadStream(std::istream& inputStream, const char* branchDescriptor = "", char delimiter = ' ');
648 virtual void Refresh();
650 virtual void RemoveExternalFriend(TFriendElement *);
651 virtual void RemoveFriend(TTree*);
652 void RecursiveRemove(TObject *obj) override;
653 virtual void Reset(Option_t* option = "");
654 virtual void ResetAfterMerge(TFileMergeInfo *);
655 virtual void ResetBranchAddress(TBranch *);
656 virtual void ResetBranchAddresses();
657 virtual Long64_t Scan(const char* varexp = "", const char* selection = "", Option_t* option = "", Long64_t nentries = kMaxEntries, Long64_t firstentry = 0); // *MENU*
658 virtual bool SetAlias(const char* aliasName, const char* aliasFormula);
659 virtual void SetAutoSave(Long64_t autos = -300000000);
660 virtual void SetAutoFlush(Long64_t autof = -30000000);
661 virtual void SetBasketSize(const char* bname, Int_t buffsize = 16000);
662 virtual Int_t SetBranchAddress(const char *bname,void *add, TBranch **ptr = nullptr);
663 virtual Int_t SetBranchAddress(const char *bname,void *add, TClass *realClass, EDataType datatype, bool isptr);
664 virtual Int_t SetBranchAddress(const char *bname,void *add, TBranch **ptr, TClass *realClass, EDataType datatype, bool isptr);
665 template <class T> Int_t SetBranchAddress(const char *bname, T **add, TBranch **ptr = nullptr) {
666 TClass *cl = TClass::GetClass<T>();
668 if (!cl) type = TDataType::GetType(typeid(T));
669 return SetBranchAddress(bname,add,ptr,cl,type,true);
670 }
671#ifndef R__NO_CLASS_TEMPLATE_SPECIALIZATION
672 // This can only be used when the template overload resolution can distinguish between
673 // T* and T**
674 template <class T> Int_t SetBranchAddress(const char *bname, T *add, TBranch **ptr = nullptr) {
675 TClass *cl = TClass::GetClass<T>();
677 if (!cl) type = TDataType::GetType(typeid(T));
678 return SetBranchAddress(bname,add,ptr,cl,type,false);
679 }
680#endif
681 virtual void SetBranchStatus(const char* bname, bool status = true, UInt_t* found = nullptr);
682 static void SetBranchStyle(Int_t style = 1); //style=0 for old branch, =1 for new branch style
683 virtual Int_t SetCacheSize(Long64_t cachesize = -1);
684 virtual Int_t SetCacheEntryRange(Long64_t first, Long64_t last);
685 virtual void SetCacheLearnEntries(Int_t n=10);
687 virtual void SetCircular(Long64_t maxEntries);
689 virtual void SetDebug(Int_t level = 1, Long64_t min = 0, Long64_t max = 9999999); // *MENU*
690 virtual void SetDefaultEntryOffsetLen(Int_t newdefault, bool updateExisting = false);
691 virtual void SetDirectory(TDirectory* dir);
692 virtual Long64_t SetEntries(Long64_t n = -1);
693 virtual void SetEstimate(Long64_t nentries = 1000000);
695 virtual void SetFileNumber(Int_t number = 0);
696 virtual void SetEventList(TEventList* list);
697 virtual void SetEntryList(TEntryList* list, Option_t *opt="");
698 virtual void SetImplicitMT(bool enabled) { fIMTEnabled = enabled; }
699 virtual void SetMakeClass(Int_t make);
701 static void SetMaxTreeSize(Long64_t maxsize = 100000000000LL);
702 virtual void SetMaxVirtualSize(Long64_t size = 0) { fMaxVirtualSize = size; } // *MENU*
703 void SetName(const char* name) override; // *MENU*
704
705 /**
706 * @brief Sets the address of the object to be notified when the tree is loaded.
707 *
708 * The method TObject::Notify is called for the given object when the tree
709 * is loaded. Specifically this occurs in the TTree::LoadTree method. To
710 * remove the notification call this method with nullptr:
711 * @code tree->SetNotify(nullptr); @endcode
712 *
713 * If this is a TChain, `obj` is most often going to be a TNotifyLink.
714 *
715 * @param[in] obj Pointer to a TObject to be notified.
716 */
717 virtual void SetNotify(TObject* obj);
718
719 virtual void SetObject(const char* name, const char* title);
720 virtual void SetParallelUnzip(bool opt=true, Float_t RelSize=-1);
721 virtual void SetPerfStats(TVirtualPerfStats* perf);
722 /**
723 * \brief Sets the default maximum number of lines to be shown before `<CR>` when calling Scan().
724 * \param n the maximum number of lines. Default=50, if 0, all entries of the Tree are shown
725 * and there is no need to press `<CR>` or `q` to exit the function.
726 * \see TTreePlayer::Scan for more details on how to redirect the output to an ASCII file
727 */
728 virtual void SetScanField(Int_t n = 50) { fScanField = n; } // *MENU*
731 virtual void SetTreeIndex(TVirtualIndex* index);
732 virtual void SetWeight(Double_t w = 1, Option_t* option = "");
733 virtual void SetUpdate(Int_t freq = 0) { fUpdate = freq; }
734 virtual void Show(Long64_t entry = -1, Int_t lenmax = 20);
735 virtual void StartViewer(); // *MENU*
737 virtual Int_t UnbinnedFit(const char* funcname, const char* varexp, const char* selection = "", Option_t* option = "", Long64_t nentries = kMaxEntries, Long64_t firstentry = 0);
738 void UseCurrentStyle() override;
739 Int_t Write(const char *name=nullptr, Int_t option=0, Int_t bufsize=0) override;
740 Int_t Write(const char *name=nullptr, Int_t option=0, Int_t bufsize=0) const override;
741
742 ClassDefOverride(TTree, 20) // Tree descriptor (the main ROOT I/O class)
743};
744
745//////////////////////////////////////////////////////////////////////////
746// //
747// TTreeFriendLeafIter //
748// //
749// Iterator on all the leaves in a TTree and its friend //
750// //
751//////////////////////////////////////////////////////////////////////////
752
754
755protected:
756 TTree *fTree; ///< tree being iterated
757 TIterator *fLeafIter; ///< current leaf sub-iterator.
758 TIterator *fTreeIter; ///< current tree sub-iterator.
759 bool fDirection; ///< iteration direction
760
761 TTreeFriendLeafIter() : fTree(nullptr), fLeafIter(nullptr), fTreeIter(nullptr),
762 fDirection(false) { }
763
764public:
765 TTreeFriendLeafIter(const TTree* t, bool dir = kIterForward);
768 TIterator &operator=(const TIterator &rhs) override;
770
771 const TCollection *GetCollection() const override { return nullptr; }
772 Option_t *GetOption() const override;
773 TObject *Next() override;
775 bool operator !=(const TIterator&) const override {
776 // TODO: Implement me
777 return false;
778 }
779 bool operator !=(const TTreeFriendLeafIter&) const {
780 // TODO: Implement me
781 return false;
782 }
783 TObject *operator*() const override {
784 // TODO: Implement me
785 return nullptr;
786 }
787 ClassDefOverride(TTreeFriendLeafIter,0) //Linked list iterator
788 };
789
790
791#endif
#define SafeDelete(p)
Definition RConfig.hxx:533
size_t size(const MatrixT &matrix)
retrieve the size of a square matrix
int Int_t
Signed integer 4 bytes (int)
Definition RtypesCore.h:59
long Longptr_t
Integer large enough to hold a pointer (platform-dependent)
Definition RtypesCore.h:89
unsigned int UInt_t
Unsigned integer 4 bytes (unsigned int)
Definition RtypesCore.h:60
float Float_t
Float 4 bytes (float)
Definition RtypesCore.h:71
double Double_t
Double 8 bytes.
Definition RtypesCore.h:73
long long Long64_t
Portable signed long integer 8 bytes.
Definition RtypesCore.h:83
unsigned long long ULong64_t
Portable unsigned long integer 8 bytes.
Definition RtypesCore.h:84
const char Option_t
Option string (const char)
Definition RtypesCore.h:80
#define BIT(n)
Definition Rtypes.h:91
#define ClassDefOverride(name, id)
Definition Rtypes.h:348
const Bool_t kIterForward
Definition TCollection.h:42
ROOT::Detail::TRangeCast< T, true > TRangeDynCast
TRangeDynCast is an adapter class that allows the typed iteration through a TCollection.
EDataType
Definition TDataType.h:28
@ kOther_t
Definition TDataType.h:32
#define gDirectory
Definition TDirectory.h:385
#define N
Option_t Option_t option
Option_t Option_t TPoint TPoint const char GetTextMagnitude GetFillStyle GetLineColor GetLineWidth GetMarkerStyle GetTextAlign GetTextColor GetTextSize void char Point_t Rectangle_t WindowAttributes_t Float_t Float_t Float_t Int_t Int_t UInt_t UInt_t Rectangle_t Int_t Int_t Window_t TString Int_t GCValues_t GetPrimarySelectionOwner GetDisplay GetScreen GetColormap GetNativeEvent const char const char dpyName wid window const char font_name cursor keysym reg const char only_if_exist regb h Point_t winding char text const char depth char const char Int_t count const char ColorStruct_t color const char filename
Option_t Option_t TPoint TPoint const char GetTextMagnitude GetFillStyle GetLineColor GetLineWidth GetMarkerStyle GetTextAlign GetTextColor GetTextSize void char Point_t Rectangle_t WindowAttributes_t Float_t Float_t Float_t Int_t Int_t UInt_t UInt_t Rectangle_t Int_t Int_t Window_t TString Int_t GCValues_t GetPrimarySelectionOwner GetDisplay GetScreen GetColormap GetNativeEvent const char const char dpyName wid window const char font_name cursor keysym reg const char only_if_exist regb h Point_t winding char text const char depth char const char Int_t count const char ColorStruct_t color const char Pixmap_t Pixmap_t PictureAttributes_t attr const char char ret_data h unsigned char height h offset
Option_t Option_t TPoint TPoint const char GetTextMagnitude GetFillStyle GetLineColor GetLineWidth GetMarkerStyle GetTextAlign GetTextColor GetTextSize void char Point_t Rectangle_t WindowAttributes_t index
Option_t Option_t TPoint TPoint const char GetTextMagnitude GetFillStyle GetLineColor GetLineWidth GetMarkerStyle GetTextAlign GetTextColor GetTextSize void char Point_t Rectangle_t src
Option_t Option_t TPoint TPoint const char GetTextMagnitude GetFillStyle GetLineColor GetLineWidth GetMarkerStyle GetTextAlign GetTextColor GetTextSize void char Point_t Rectangle_t WindowAttributes_t Float_t Float_t Float_t Int_t Int_t UInt_t UInt_t Rectangle_t Int_t Int_t Window_t TString Int_t GCValues_t GetPrimarySelectionOwner GetDisplay GetScreen GetColormap GetNativeEvent const char const char dpyName wid window const char font_name cursor keysym reg const char only_if_exist regb h Point_t winding char text const char depth char const char Int_t count const char ColorStruct_t color const char Pixmap_t Pixmap_t PictureAttributes_t attr const char char ret_data h unsigned char height h Atom_t Int_t ULong_t ULong_t unsigned char prop_list Atom_t Atom_t Atom_t Time_t type
Option_t Option_t style
char name[80]
Definition TGX11.cxx:110
int nentries
TIOFeatures provides the end-user with the ability to change the IO behavior of data written via a TT...
Array of doubles (64 bits per element).
Definition TArrayD.h:27
Double_t * fArray
Definition TArrayD.h:30
Array of integers (32 bits per element).
Definition TArrayI.h:27
Int_t * fArray
Definition TArrayI.h:30
Fill Area Attributes class.
Definition TAttFill.h:20
Line Attributes class.
Definition TAttLine.h:20
Marker Attributes class.
Definition TAttMarker.h:20
Manages buffers for branches of a Tree.
Definition TBasket.h:34
A branch containing and managing a TRefTable for TRef autoloading.
Definition TBranchRef.h:34
A TTree is a list of TBranches.
Definition TBranch.h:93
Using a TBrowser one can browse all ROOT objects.
Definition TBrowser.h:37
Buffer base class used for serializing objects.
Definition TBuffer.h:43
A Chain Index.
Definition TChainIndex.h:40
TClass instances represent classes, structs and namespaces in the ROOT type system.
Definition TClass.h:84
Collection abstract base class.
Definition TCollection.h:65
A specialized string object used for TTree selections.
Definition TCut.h:25
Int_t GetType() const
Definition TDataType.h:68
Describe directory structure in memory.
Definition TDirectory.h:45
A List of entry numbers in a TTree or TChain.
Definition TEntryList.h:26
<div class="legacybox"><h2>Legacy Code</h2> TEventList is a legacy interface: there will be no bug fi...
Definition TEventList.h:31
A ROOT file is an on-disk file, usually with extension .root, that stores objects in a file-system-li...
Definition TFile.h:131
A TFriendElement TF describes a TTree object TF in a file.
TH1 is the base class of all histogram classes in ROOT.
Definition TH1.h:109
Iterator abstract base class.
Definition TIterator.h:30
A TLeaf describes individual elements of a TBranch See TBranch structure in TTree.
Definition TLeaf.h:57
A doubly linked list.
Definition TList.h:38
The TNamed class is the base class for all named ROOT classes.
Definition TNamed.h:29
const char * GetName() const override
Returns name of object.
Definition TNamed.h:49
An array of TObjects.
Definition TObjArray.h:31
Int_t GetEntriesFast() const
Definition TObjArray.h:58
Mother of all ROOT objects.
Definition TObject.h:41
virtual void Error(const char *method, const char *msgfmt,...) const
Issue error message.
Definition TObject.cxx:1072
A PolyMarker is defined by an array on N points in a 2-D space.
Definition TPolyMarker.h:31
Principal Components Analysis (PCA)
Definition TPrincipal.h:21
A TSelector object is used by the TTree::Draw, TTree::Scan, TTree::Process to navigate in a TTree and...
Definition TSelector.h:31
Describes a persistent version of a class.
A cache to speed-up the reading of ROOT datasets.
Definition TTreeCache.h:32
Class implementing or helping the various TTree cloning method.
Definition TTreeCloner.h:31
Used to pass a selection expression to the Tree drawing routine.
Iterator on all the leaves in a TTree and its friend.
Definition TTree.h:753
bool operator!=(const TIterator &) const override
Compare two iterator objects.
Definition TTree.h:775
const TCollection * GetCollection() const override
Definition TTree.h:771
TTree * fTree
tree being iterated
Definition TTree.h:756
TObject * operator*() const override
Return current object or nullptr.
Definition TTree.h:783
void Reset() override
Definition TTree.h:774
TIterator & operator=(const TIterator &rhs) override
Overridden assignment operator. Does NOT copy the 'cursor' location!
Definition TTree.cxx:10013
~TTreeFriendLeafIter() override
Definition TTree.h:767
TObject * Next() override
Go the next friend element.
Definition TTree.cxx:10036
TIterator * fLeafIter
current leaf sub-iterator.
Definition TTree.h:757
Option_t * GetOption() const override
Returns the object option stored in the list.
Definition TTree.cxx:10075
TIterator * fTreeIter
current tree sub-iterator.
Definition TTree.h:758
bool fDirection
iteration direction
Definition TTree.h:759
A Tree Index with majorname and minorname.
Definition TTreeIndex.h:29
Helper class to iterate over cluster of baskets.
Definition TTree.h:304
Long64_t GetEstimatedClusterSize()
Estimate the cluster size.
Definition TTree.cxx:639
Long64_t Previous()
Move on to the previous cluster and return the starting entry of this previous cluster.
Definition TTree.cxx:722
Long64_t GetStartEntry()
Definition TTree.h:336
Long64_t operator()()
Definition TTree.h:345
Long64_t Next()
Move on to the next cluster and return the starting entry of this next cluster.
Definition TTree.cxx:678
Long64_t GetNextEntry()
Definition TTree.h:341
Long64_t fEstimatedSize
Definition TTree.h:310
TClusterIterator(TTree *tree, Long64_t firstEntry)
Regular constructor.
Definition TTree.cxx:588
Helper class to prevent infinite recursion in the usage of TTree Friends.
Definition TTree.h:221
TFriendLock & operator=(const TFriendLock &)
Assignment operator.
Definition TTree.cxx:554
UInt_t fMethodBit
Definition TTree.h:225
TTree * fTree
Definition TTree.h:224
~TFriendLock()
Restore the state of tree the same as before we set the lock.
Definition TTree.cxx:567
A TTree represents a columnar dataset.
Definition TTree.h:89
virtual Int_t Fill()
Fill all branches.
Definition TTree.cxx:4654
virtual TFriendElement * AddFriend(const char *treename, const char *filename="")
Add a TFriendElement to the list of friends.
Definition TTree.cxx:1360
TBranchRef * fBranchRef
Branch supporting the TRefTable (if any)
Definition TTree.h:146
TStreamerInfo * BuildStreamerInfo(TClass *cl, void *pointer=nullptr, bool canOptimize=true)
Build StreamerInfo for class cl.
Definition TTree.cxx:2683
TBranch * GetBranchFromFriends(const char *branchName)
Returns a pointer to the branch with the given name, if it can be found in the list of friends of thi...
Definition TTree.cxx:5379
virtual Int_t SetBranchAddress(const char *bname, void *add, TBranch **ptr, TClass *realClass, EDataType datatype, bool isptr, bool suppressMissingBranchError)
Definition TTree.cxx:8638
virtual TBranch * FindBranch(const char *name)
Return the branch that correspond to the path 'branchname', which can include the name of the tree or...
Definition TTree.cxx:4891
virtual TVirtualPerfStats * GetPerfStats() const
Definition TTree.h:583
virtual void SetTimerInterval(Int_t msec=333)
Definition TTree.h:730
virtual void SetBranchStatus(const char *bname, bool status=true, UInt_t *found=nullptr)
Set branch status to Process or DoNotProcess.
Definition TTree.cxx:8742
TTreeFormula * GetSelect()
Definition TTree.h:589
bool EnableCache()
Enable the TTreeCache unless explicitly disabled for this TTree by a prior call to SetCacheSize(0).
Definition TTree.cxx:2716
virtual TBranch * GetBranch(const char *name)
Return pointer to the branch with the given name in this tree or its friends.
Definition TTree.cxx:5431
virtual Int_t GetScanField() const
Definition TTree.h:588
static Int_t GetBranchStyle()
Static function returning the current branch style.
Definition TTree.cxx:5472
TList * fFriends
pointer to list of friend elements
Definition TTree.h:140
bool fIMTEnabled
! true if implicit multi-threading is enabled for this tree
Definition TTree.h:152
virtual Long64_t GetChainEntryNumber(Long64_t entry) const
Definition TTree.h:492
virtual bool GetBranchStatus(const char *branchname) const
Return status of branch with name branchname.
Definition TTree.cxx:5457
UInt_t fFriendLockStatus
! Record which method is locking the friend recursion
Definition TTree.h:147
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:6180
Long64_t fTotBytes
Total number of bytes in all branches before compression.
Definition TTree.h:96
virtual Int_t FlushBaskets(bool create_cluster=true) const
Write to disk all the basket that have not yet been individually written and create an event cluster ...
Definition TTree.cxx:5179
Int_t GetDefaultEntryOffsetLen() const
Definition TTree.h:496
Int_t fMaxClusterRange
! Memory allocated for the cluster range.
Definition TTree.h:106
virtual void Show(Long64_t entry=-1, Int_t lenmax=20)
Print values of all active leaves for entry.
Definition TTree.cxx:9604
TEventList * fEventList
! Pointer to event selection list (if one)
Definition TTree.h:135
virtual Long64_t GetAutoSave() const
Definition TTree.h:485
virtual Int_t StopCacheLearningPhase()
Stop the cache learning phase.
Definition TTree.cxx:9693
virtual Int_t GetEntry(Long64_t entry, Int_t getall=0)
Read all branches of entry and return total number of bytes read.
Definition TTree.cxx:5719
std::vector< std::pair< Long64_t, TBranch * > > fSortedBranches
! Branches to be processed in parallel when IMT is on, sorted by average task time
Definition TTree.h:154
virtual void SetCircular(Long64_t maxEntries)
Enable/Disable circularity for this tree.
Definition TTree.cxx:9100
virtual Long64_t GetEstimate() const
Definition TTree.h:544
Long64_t GetDebugMax() const
Definition TTree.h:497
Long64_t fSavedBytes
Number of autosaved bytes.
Definition TTree.h:98
virtual Int_t AddBranchToCache(const char *bname, bool subbranches=false)
Add branch with name bname to the Tree cache.
Definition TTree.cxx:1087
Long64_t GetMedianClusterSize()
Estimate the median cluster size for the TTree.
Definition TTree.cxx:8467
virtual TClusterIterator GetClusterIterator(Long64_t firstentry)
Return an iterator over the cluster of baskets starting at firstentry.
Definition TTree.cxx:5544
virtual void ResetBranchAddress(TBranch *)
Tell a branch to set its address to zero.
Definition TTree.cxx:8221
bool fCacheUserSet
! true if the cache setting was explicitly given by user
Definition TTree.h:151
char GetNewlineValue(std::istream &inputStream)
Determine which newline this file is using.
Definition TTree.cxx:7744
TBranch * Branch(const char *name, T **addobj, Int_t bufsize=32000, Int_t splitlevel=99)
Add a new branch, and infer the data type from the array addobj being passed.
Definition TTree.h:404
TIOFeatures fIOFeatures
IO features to define for newly-written baskets and branches.
Definition TTree.h:124
virtual Long64_t GetSelectedRows()
Definition TTree.h:590
void AddAllocationCount(UInt_t count)
Definition TTree.h:371
virtual void SetMaxEntryLoop(Long64_t maxev=kMaxEntries)
Definition TTree.h:700
virtual Long64_t GetEntryNumberWithIndex(Long64_t major, Long64_t minor=0) const
Return entry number corresponding to major and minor number.
Definition TTree.cxx:5991
Long64_t fDebugMin
! First entry number to debug
Definition TTree.h:122
virtual Long64_t SetEntries(Long64_t n=-1)
Change number of entries in the tree.
Definition TTree.cxx:9219
virtual TObjArray * GetListOfLeaves()
Definition TTree.h:566
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:2105
virtual Int_t GetEntryWithIndex(Long64_t major, Long64_t minor=0)
Read entry corresponding to major and minor number.
Definition TTree.cxx:6009
Long64_t GetCacheAutoSize(bool withDefault=false)
Used for automatic sizing of the cache.
Definition TTree.cxx:5484
virtual TBranch * BranchRef()
Build the optional branch supporting the TRefTable.
Definition TTree.cxx:2359
TFile * GetCurrentFile() const
Return pointer to the current file.
Definition TTree.cxx:5556
TObject * GetNotify() const
Definition TTree.h:580
TList * fAliases
List of aliases for expressions based on the tree branches.
Definition TTree.h:134
TBranch * Branch(const char *name, Longptr_t address, const char *leaflist, Int_t bufsize=32000)
Definition TTree.h:418
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:3760
virtual Int_t DropBranchFromCache(const char *bname, bool subbranches=false)
Remove the branch with name 'bname' from the Tree cache.
Definition TTree.cxx:1170
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:5129
Long64_t * fClusterRangeEnd
[fNClusterRange] Last entry of a cluster range.
Definition TTree.h:113
std::atomic< Long64_t > fIMTZipBytes
! Zip bytes for the IMT flush baskets.
Definition TTree.h:171
void RecursiveRemove(TObject *obj) override
Make sure that obj (which is being deleted or will soon be) is no longer referenced by this TTree.
Definition TTree.cxx:8037
TVirtualTreePlayer * GetPlayer()
Load the TTreePlayer (if not already done).
Definition TTree.cxx:6387
virtual Int_t MakeProxy(const char *classname, const char *macrofilename=nullptr, const char *cutfilename=nullptr, const char *option=nullptr, Int_t maxUnrolling=3)
Generate a skeleton analysis class for this Tree using TBranchProxy.
Definition TTree.cxx:6850
Float_t fTargetMemoryRatio
! Ratio for memory usage in uncompressed buffers versus actual occupancy.
Definition TTree.h:156
virtual Double_t * GetIndexValues()
Definition TTree.h:559
virtual TList * GetListOfAliases() const
Definition TTree.h:568
virtual Long64_t ReadStream(std::istream &inputStream, const char *branchDescriptor="", char delimiter=' ')
Create or simply read branches from an input stream.
Definition TTree.cxx:7771
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:9136
Int_t fScanField
Number of runs before prompting in Scan.
Definition TTree.h:102
virtual Double_t GetWeight() const
Definition TTree.h:621
void Draw(Option_t *opt) override
Default Draw method for all objects.
Definition TTree.h:468
virtual TTree * GetFriend(const char *) const
Return a pointer to the TTree friend whose name or alias is friendname.
Definition TTree.cxx:6057
TTreeFormula * GetVar(Int_t i)
Definition TTree.h:601
virtual void SetNotify(TObject *obj)
Sets the address of the object to be notified when the tree is loaded.
Definition TTree.cxx:9450
virtual Double_t GetMaximum(const char *columname)
Return maximum of column with name columname.
Definition TTree.cxx:6317
virtual Long64_t GetEntryNumberWithBestIndex(Long64_t major, Long64_t minor=0) const
Return entry number corresponding to major and minor number.
Definition TTree.cxx:5971
static void SetMaxTreeSize(Long64_t maxsize=100000000000LL)
Set the maximum size in bytes of a Tree file (static function).
Definition TTree.cxx:9416
void Print(Option_t *option="") const override
Print a summary of the tree contents.
Definition TTree.cxx:7377
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:9923
Int_t fNClusterRange
Number of Cluster range in addition to the one defined by 'AutoFlush'.
Definition TTree.h:105
virtual void PrintCacheStats(Option_t *option="") const
Print statistics about the TreeCache for this tree.
Definition TTree.cxx:7529
TVirtualTreePlayer * fPlayer
! Pointer to current Tree player
Definition TTree.h:144
virtual TIterator * GetIteratorOnAllLeaves(bool dir=kIterForward)
Creates a new iterator that will go through all the leaves on the tree itself and its friend.
Definition TTree.cxx:6164
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:9396
virtual bool InPlaceClone(TDirectory *newdirectory, const char *options="")
Copy the content to a new new file, update this TTree with the new location information and attach th...
Definition TTree.cxx:7170
virtual void IncrementTotalBuffers(Int_t nbytes)
Definition TTree.h:623
TObjArray fBranches
List of Branches.
Definition TTree.h:132
TDirectory * GetDirectory() const
Definition TTree.h:499
bool fCacheDoAutoInit
! true if cache auto creation or resize check is needed
Definition TTree.h:149
TTreeCache * GetReadCache(TFile *file) const
Find and return the TTreeCache registered with the file and which may contain branches for us.
Definition TTree.cxx:6400
Long64_t fEntries
Number of entries.
Definition TTree.h:94
virtual TFile * ChangeFile(TFile *file)
Called by TTree::Fill() when file has reached its maximum fgMaxTreeSize.
Definition TTree.cxx:2780
@ kSplitCollectionOfPointers
Definition TTree.h:300
virtual TEntryList * GetEntryList()
Returns the entry list assigned to this tree.
Definition TTree.cxx:5935
virtual void SetWeight(Double_t w=1, Option_t *option="")
Set tree weight.
Definition TTree.cxx:9593
void InitializeBranchLists(bool checkLeafCount)
Divides the top-level branches into two vectors: (i) branches to be processed sequentially and (ii) b...
Definition TTree.cxx:5862
Long64_t * fClusterSize
[fNClusterRange] Number of entries in each cluster for a given range.
Definition TTree.h:114
Long64_t fFlushedBytes
Number of auto-flushed bytes.
Definition TTree.h:99
virtual void SetPerfStats(TVirtualPerfStats *perf)
Set perf stats.
Definition TTree.cxx:9548
TTreeFormula * GetVar2()
Definition TTree.h:605
std::atomic< Long64_t > fIMTTotBytes
! Total bytes for the IMT flush baskets
Definition TTree.h:170
virtual void SetCacheLearnEntries(Int_t n=10)
Interface to TTreeCache to set the number of entries for the learning phase.
Definition TTree.cxx:9073
Int_t SetBranchAddress(const char *bname, T *add, TBranch **ptr=nullptr)
Definition TTree.h:674
void SetTargetMemoryRatio(Float_t ratio)
Definition TTree.h:729
TEntryList * fEntryList
! Pointer to event selection list (if one)
Definition TTree.h:136
virtual TVirtualIndex * GetTreeIndex() const
Definition TTree.h:595
Int_t Debug() const
Definition TTree.h:466
TList * fExternalFriends
! List of TFriendsElement pointing to us and need to be notified of LoadTree. Content not owned.
Definition TTree.h:141
virtual Long64_t Merge(TCollection *list, Option_t *option="")
Merge the trees in the TList into this tree.
Definition TTree.cxx:6984
virtual void SetMaxVirtualSize(Long64_t size=0)
Definition TTree.h:702
virtual void DropBaskets()
Remove some baskets from memory.
Definition TTree.cxx:4569
virtual void SetAutoSave(Long64_t autos=-300000000)
In case of a program crash, it will be possible to recover the data in the tree up to the last AutoSa...
Definition TTree.cxx:8512
virtual bool GetClusterPrefetch() const
Definition TTree.h:494
TBranch * Branch(const char *name, const char *classname, T **addobj, Int_t bufsize=32000, Int_t splitlevel=99)
Definition TTree.h:434
Long64_t fMaxEntryLoop
Maximum number of entries to process.
Definition TTree.h:108
Int_t BuildIndex(const char *majorname, bool long64major)
Build index with only a major formula.
Definition TTree.h:457
friend TBranch * TTreeBranchImpRef(TTree *tree, const char *branchname, TClass *ptrClass, EDataType datatype, void *addobj, Int_t bufsize, Int_t splitlevel)
Float_t GetTargetMemoryRatio() const
Definition TTree.h:597
virtual void SetParallelUnzip(bool opt=true, Float_t RelSize=-1)
Enable or disable parallel unzipping of Tree buffers.
Definition TTree.cxx:9510
virtual void SetDirectory(TDirectory *dir)
Change the tree's directory.
Definition TTree.cxx:9174
void SortBranchesByTime()
Sorts top-level branches by the last average task time recorded per branch.
Definition TTree.cxx:5915
void Delete(Option_t *option="") override
Delete this tree from memory or/and disk.
Definition TTree.cxx:3788
virtual Int_t * GetIndex()
Definition TTree.h:558
virtual TBranchRef * GetBranchRef() const
Definition TTree.h:487
virtual Double_t * GetV3()
Definition TTree.h:617
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:7607
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:1663
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:9277
TBranch * Branch(const char *name, int address, const char *leaflist, Int_t bufsize=32000)
Definition TTree.h:423
void MoveReadCache(TFile *src, TDirectory *dir)
Move a cache from a file to the current file in dir.
Definition TTree.cxx:7141
TTree & operator=(const TTree &tt)=delete
Long64_t fAutoFlush
Auto-flush tree when fAutoFlush entries written or -fAutoFlush (compressed) bytes produced.
Definition TTree.h:111
Int_t fUpdate
Update frequency for EntryLoop.
Definition TTree.h:103
virtual void ResetAfterMerge(TFileMergeInfo *)
Resets the state of this TTree after a merge (keep the customization but forget the data).
Definition TTree.cxx:8190
TBranch * Branch(const char *name, std::array< T, N > *obj, Int_t bufsize=32000, Int_t splitlevel=99)
Definition TTree.h:439
virtual Long64_t GetEntries() const
Definition TTree.h:500
virtual void SetEstimate(Long64_t nentries=1000000)
Set number of entries to estimate variable limits.
Definition TTree.cxx:9318
Int_t fTimerInterval
Timer interval in milliseconds.
Definition TTree.h:101
Int_t fDebug
! Debug level
Definition TTree.h:121
Int_t SetCacheSizeAux(bool autocache=true, Long64_t cacheSize=0)
Set the size of the file cache and create it if possible.
Definition TTree.cxx:8919
virtual Long64_t AutoSave(Option_t *option="")
AutoSave tree header every fAutoSave bytes.
Definition TTree.cxx:1528
virtual Long64_t GetEntryNumber(Long64_t entry) const
Return entry number corresponding to entry.
Definition TTree.cxx:5946
virtual TTree * CloneTree(Long64_t nentries=-1, Option_t *option="")
Create a clone of this tree and copy nentries.
Definition TTree.cxx:3174
virtual bool GetImplicitMT()
Definition TTree.h:557
Int_t fFileNumber
! current file number (if file extensions)
Definition TTree.h:126
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:6277
virtual Long64_t GetZipBytes() const
Definition TTree.h:622
TObjArray fLeaves
Direct pointers to individual branch leaves.
Definition TTree.h:133
virtual void Reset(Option_t *option="")
Reset baskets, buffers and entries count in all branches and leaves.
Definition TTree.cxx:8159
virtual void SetImplicitMT(bool enabled)
Definition TTree.h:698
virtual void KeepCircular()
Keep a maximum of fMaxEntries in memory.
Definition TTree.cxx:6497
virtual void SetDefaultEntryOffsetLen(Int_t newdefault, bool updateExisting=false)
Update the default value for the branch's fEntryOffsetLen.
Definition TTree.cxx:9148
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:3860
Long64_t fMaxVirtualSize
Maximum total size of buffers kept in memory.
Definition TTree.h:109
virtual Long64_t GetTotBytes() const
Definition TTree.h:593
virtual Int_t MakeSelector(const char *selector=nullptr, Option_t *option="")
Generate skeleton selector class for this tree.
Definition TTree.cxx:6904
virtual void SetObject(const char *name, const char *title)
Change the name and title of this tree.
Definition TTree.cxx:9479
TVirtualPerfStats * fPerfStats
! pointer to the current perf stats object
Definition TTree.h:142
Double_t fWeight
Tree weight (see TTree::SetWeight)
Definition TTree.h:100
virtual void SetUpdate(Int_t freq=0)
Definition TTree.h:733
std::vector< TBranch * > fSeqBranches
! Branches to be processed sequentially when IMT is on
Definition TTree.h:155
Long64_t fDebugMax
! Last entry number to debug
Definition TTree.h:123
Int_t fDefaultEntryOffsetLen
Initial Length of fEntryOffset table in the basket buffers.
Definition TTree.h:104
TBranch * GetBranchFromSelf(const char *branchName)
Returns a pointer to the branch with the given name, if it can be found in this tree.
Definition TTree.cxx:5343
TTree()
Default constructor and I/O constructor.
Definition TTree.cxx:765
Long64_t fAutoSave
Autosave tree when fAutoSave entries written or -fAutoSave (compressed) bytes produced.
Definition TTree.h:110
TBranch * Branch(const char *name, T *obj, Int_t bufsize=32000, Int_t splitlevel=99)
Add a new branch, and infer the data type from the type of obj being passed.
Definition TTree.h:387
std::atomic< UInt_t > fAllocationCount
indicates basket should be resized to exact memory usage, but causes significant
Definition TTree.h:162
static TTree * MergeTrees(TList *list, Option_t *option="")
Static function merging the trees in the TList into a new tree.
Definition TTree.cxx:6935
bool MemoryFull(Int_t nbytes)
Check if adding nbytes to memory we are still below MaxVirtualsize.
Definition TTree.cxx:6919
TTreeFormula * GetVar4()
Definition TTree.h:609
virtual Long64_t GetReadEntry() const
Definition TTree.h:586
virtual TObjArray * GetListOfBranches()
Definition TTree.h:565
Long64_t fZipBytes
Total number of bytes in all branches after compression.
Definition TTree.h:97
virtual TTree * GetTree() const
Definition TTree.h:594
TBuffer * fTransientBuffer
! Pointer to the current transient buffer.
Definition TTree.h:148
virtual Double_t * GetVal(Int_t i)
Definition TTree.h:611
virtual void SetEntryList(TEntryList *list, Option_t *opt="")
Set an EntryList.
Definition TTree.cxx:9254
bool Notify() override
Function called when loading a new class library.
Definition TTree.cxx:7191
virtual void AddZipBytes(Int_t zip)
Definition TTree.h:366
virtual Long64_t LoadTree(Long64_t entry)
Set current entry.
Definition TTree.cxx:6555
virtual Long64_t ReadFile(const char *filename, const char *branchDescriptor="", char delimiter=' ')
Create or simply read branches from filename.
Definition TTree.cxx:7720
virtual const char * GetAlias(const char *aliasName) const
Returns the expanded value of the alias. Search in the friends if any.
Definition TTree.cxx:5276
ROOT::TIOFeatures SetIOFeatures(const ROOT::TIOFeatures &)
Provide the end-user with the ability to enable/disable various experimental IO features for this TTr...
Definition TTree.cxx:9338
friend class TFriendLock
Definition TTree.h:236
virtual TBasket * CreateBasket(TBranch *)
Create a basket for this tree and given branch.
Definition TTree.cxx:3772
TList * fUserInfo
pointer to a list of user objects associated to this Tree
Definition TTree.h:143
virtual Double_t GetMinimum(const char *columname)
Return minimum of column with name columname.
Definition TTree.cxx:6357
virtual void RemoveFriend(TTree *)
Remove a friend from the list of friends.
Definition TTree.cxx:8133
virtual Long64_t GetEntriesFast() const
Return a number greater or equal to the total number of entries in the dataset.
Definition TTree.h:542
void Browse(TBrowser *) override
Browse content of the TTree.
Definition TTree.cxx:2640
virtual Double_t * GetV1()
Definition TTree.h:613
virtual TList * GetUserInfo()
Return a pointer to the list containing user objects associated to this tree.
Definition TTree.cxx:6438
void RegisterBranchFullName(std::pair< std::string, TBranch * > &&kv)
Definition TTree.h:182
TEventList * GetEventList() const
Definition TTree.h:550
Long64_t fChainOffset
! Offset of 1st entry of this Tree in a TChain
Definition TTree.h:116
EStatusBits
Definition TTree.h:284
@ kOnlyFlushAtCluster
If set, the branch's buffers will grow until an event cluster boundary is hit, guaranteeing a basket ...
Definition TTree.h:290
@ kEntriesReshuffled
If set, signals that this TTree is the output of the processing of another TTree, and the entries are...
Definition TTree.h:295
@ kCircular
Definition TTree.h:286
@ kForceRead
Definition TTree.h:285
virtual Long64_t GetEntriesFriend() const
Returns a number corresponding to:
Definition TTree.cxx:5591
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:7668
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:2435
virtual void SetBasketSize(const char *bname, Int_t buffsize=16000)
Set a branch's basket size.
Definition TTree.cxx:8528
static void SetBranchStyle(Int_t style=1)
Set the current branch style.
Definition TTree.cxx:8873
virtual Long64_t GetReadEvent() const
Definition TTree.h:587
~TTree() override
Destructor.
Definition TTree.cxx:948
bool IsFolder() const override
Returns kTRUE in case object contains browsable objects (like containers or lists of other objects).
Definition TTree.h:624
void ImportClusterRanges(TTree *fromtree)
Appends the cluster range information stored in 'fromtree' to this tree, including the value of fAuto...
Definition TTree.cxx:6454
Long64_t fEstimate
Number of entries to estimate histogram limits.
Definition TTree.h:112
TH1 * GetHistogram()
Definition TTree.h:556
UInt_t GetAllocationCount() const
Definition TTree.h:480
Int_t FlushBasketsImpl() const
Internal implementation of the FlushBaskets algorithm.
Definition TTree.cxx:5196
Long64_t GetDebugMin() const
Definition TTree.h:498
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:6639
Int_t Write(const char *name=nullptr, Int_t option=0, Int_t bufsize=0) override
Write this object to the current directory.
Definition TTree.cxx:9974
TVirtualIndex * fTreeIndex
Pointer to the tree Index (if any)
Definition TTree.h:139
void UseCurrentStyle() override
Replace current attributes by current style.
Definition TTree.cxx:9935
virtual Int_t GetTreeNumber() const
Definition TTree.h:596
Int_t GetEvent(Long64_t entry, Int_t getall=0)
Definition TTree.h:546
TObject * fNotify
Object to be notified when loading a Tree.
Definition TTree.h:130
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:1582
virtual TList * GetListOfClones()
Definition TTree.h:564
Long64_t fCacheSize
! Maximum size of file buffers
Definition TTree.h:115
TList * fClones
! List of cloned trees which share our addresses
Definition TTree.h:145
std::atomic< Long64_t > fTotalBuffers
! Total number of bytes in branch buffers
Definition TTree.h:118
ELockStatusBits
Definition TTree.h:244
@ kFindBranch
Definition TTree.h:245
@ kResetBranchAddresses
Definition TTree.h:258
@ kFindLeaf
Definition TTree.h:246
@ kGetEntryWithIndex
Definition TTree.h:250
@ kPrint
Definition TTree.h:255
@ kGetFriend
Definition TTree.h:251
@ kGetBranch
Definition TTree.h:248
@ kSetBranchStatus
Definition TTree.h:257
@ kLoadTree
Definition TTree.h:254
@ kGetEntry
Definition TTree.h:249
@ kGetLeaf
Definition TTree.h:253
@ kRemoveFriend
Definition TTree.h:256
@ kGetFriendAlias
Definition TTree.h:252
@ kGetAlias
Definition TTree.h:247
virtual Double_t * GetV4()
Definition TTree.h:619
TBranch * Branch(const char *name, const char *classname, T *obj, Int_t bufsize=32000, Int_t splitlevel=99)
Definition TTree.h:429
TTreeFormula * GetVar3()
Definition TTree.h:607
virtual void SetTreeIndex(TVirtualIndex *index)
The current TreeIndex is replaced by the new index.
Definition TTree.cxx:9565
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.
Definition TTree.cxx:7215
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:7653
virtual Int_t SetCacheEntryRange(Long64_t first, Long64_t last)
interface to TTreeCache to set the cache entry range
Definition TTree.cxx:9039
static Long64_t GetMaxTreeSize()
Static function which returns the tree file size limit in bytes.
Definition TTree.cxx:6347
bool fCacheDoClusterPrefetch
! true if cache is prefetching whole clusters
Definition TTree.h:150
virtual bool SetAlias(const char *aliasName, const char *aliasFormula)
Set a tree variable alias.
Definition TTree.cxx:8311
virtual Int_t GetTimerInterval() const
Definition TTree.h:591
virtual void CopyAddresses(TTree *, bool undo=false)
Set branch addresses of passed tree equal to ours.
Definition TTree.cxx:3340
virtual void SetScanField(Int_t n=50)
Sets the default maximum number of lines to be shown before <CR> when calling Scan().
Definition TTree.h:728
virtual Int_t BuildIndex(const char *majorname, const char *minorname="0", bool long64major=false, bool long64minor=false)
Build a Tree Index (default is TTreeIndex).
Definition TTree.cxx:2668
TTree(const TTree &tt)=delete
Long64_t fMaxEntries
Maximum number of entries in case of circular buffers.
Definition TTree.h:107
Int_t SetBranchAddress(const char *bname, T **add, TBranch **ptr=nullptr)
Definition TTree.h:665
TBranch * Branch(const char *name, char *address, const char *leaflist, Int_t bufsize=32000)
Definition TTree.h:413
virtual void DropBuffers(Int_t nbytes)
Drop branch buffers to accommodate nbytes below MaxVirtualsize.
Definition TTree.cxx:4582
virtual TList * GetListOfFriends() const
Definition TTree.h:567
virtual void Refresh()
Refresh contents of this tree and its branches from the current status on disk.
Definition TTree.cxx:8072
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:8366
static Long64_t fgMaxTreeSize
Maximum size of a file containing a Tree.
Definition TTree.h:165
Long64_t fReadEntry
! Number of the entry being processed
Definition TTree.h:117
TArrayD fIndexValues
Sorted index values.
Definition TTree.h:137
void MarkEventCluster()
Mark the previous event as being at the end of the event cluster.
Definition TTree.cxx:8428
virtual Int_t GetNbranches()
Definition TTree.h:579
UInt_t fNEntriesSinceSorting
! Number of entries processed since the last re-sorting of branches
Definition TTree.h:153
virtual void SetClusterPrefetch(bool enabled)
Definition TTree.h:688
virtual void SetFileNumber(Int_t number=0)
Set fFileNumber to number.
Definition TTree.cxx:9361
virtual TLeaf * FindLeaf(const char *name)
Find first leaf containing searchname.
Definition TTree.cxx:4966
virtual void StartViewer()
Start the TTreeViewer on this tree.
Definition TTree.cxx:9678
Int_t GetMakeClass() const
Definition TTree.h:572
virtual Int_t MakeCode(const char *filename=nullptr)
Generate a skeleton function for this tree.
Definition TTree.cxx:6722
bool fIMTFlush
! True if we are doing a multithreaded flush.
Definition TTree.h:169
TDirectory * fDirectory
! Pointer to directory holding this tree
Definition TTree.h:131
ESetBranchAddressStatus
Definition TTree.h:266
@ kNeedEnableDecomposedObj
Definition TTree.h:278
@ kClassMismatch
Definition TTree.h:271
@ kNeedDisableDecomposedObj
Definition TTree.h:279
@ kVoidPtr
Definition TTree.h:276
@ kNoCheck
Definition TTree.h:277
@ kMatchConversionCollection
Definition TTree.h:274
@ kMissingCompiledCollectionProxy
Definition TTree.h:269
@ kMismatch
Definition TTree.h:270
@ kMatchConversion
Definition TTree.h:273
@ kInternalError
Definition TTree.h:268
@ kDecomposedObjMask
Definition TTree.h:280
@ kMatch
Definition TTree.h:272
@ kMissingBranch
Definition TTree.h:267
@ kMakeClass
Definition TTree.h:275
static Int_t fgBranchStyle
Old/New branch style.
Definition TTree.h:164
virtual void ResetBranchAddresses()
Tell all of our branches to drop their current objects and allocate new ones.
Definition TTree.cxx:8231
Int_t fNfill
! Local for EntryLoop
Definition TTree.h:120
void SetName(const char *name) override
Change the name of this tree.
Definition TTree.cxx:9424
virtual Long64_t GetCacheSize() const
Definition TTree.h:490
virtual void RegisterExternalFriend(TFriendElement *)
Record a TFriendElement that we need to warn when the chain switches to a new file (typically this is...
Definition TTree.cxx:8113
TArrayI fIndex
Index of sorted values.
Definition TTree.h:138
Int_t SetBranchAddressImp(const char *bname, void *add, TBranch **ptr, TClass *realClass, EDataType datatype, bool isptr)
Definition TTree.cxx:8578
virtual Int_t GetPacketSize() const
Definition TTree.h:582
virtual Int_t SetCacheSize(Long64_t cachesize=-1)
Set maximum size of the file cache .
Definition TTree.cxx:8891
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:1247
virtual Int_t CheckBranchAddressType(TBranch *branch, TClass *ptrClass, EDataType datatype, bool ptr)
Check whether or not the address described by the last 3 parameters matches the content of the branch...
Definition TTree.cxx:2902
TBuffer * GetTransientBuffer(Int_t size)
Returns the transient buffer currently used by this TTree for reading/writing baskets.
Definition TTree.cxx:1065
ROOT::TIOFeatures GetIOFeatures() const
Returns the current set of IO settings.
Definition TTree.cxx:6156
virtual Int_t MakeClass(const char *classname=nullptr, Option_t *option="")
Generate a skeleton analysis class for this tree.
Definition TTree.cxx:6689
virtual Int_t GetFileNumber() const
Definition TTree.h:553
virtual const char * GetFriendAlias(TTree *) const
If the 'tree' is a friend, this method returns its alias name.
Definition TTree.cxx:6114
virtual void SetChainOffset(Long64_t offset=0)
Definition TTree.h:686
virtual void RemoveExternalFriend(TFriendElement *)
Removes external friend.
Definition TTree.cxx:8124
virtual Double_t * GetW()
Definition TTree.h:620
TTreeFormula * GetVar1()
Definition TTree.h:603
virtual Double_t * GetV2()
Definition TTree.h:615
Int_t fPacketSize
! Number of entries in one packet for parallel root
Definition TTree.h:119
virtual Int_t GetUpdate() const
Definition TTree.h:598
virtual Long64_t GetChainOffset() const
Definition TTree.h:493
virtual TBranch * BranchImpArr(const char *branchname, EDataType datatype, std::size_t N, void *addobj, Int_t bufsize, Int_t splitlevel)
Definition TTree.cxx:1759
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:8269
virtual TBranch * BronchExec(const char *name, const char *classname, void *addobj, bool isptrptr, Int_t bufsize, Int_t splitlevel)
Helper function implementing TTree::Bronch and TTree::Branch(const char *name, T &obj);.
Definition TTree.cxx:2443
virtual Long64_t GetMaxEntryLoop() const
Definition TTree.h:574
virtual void AddTotBytes(Int_t tot)
Definition TTree.h:365
virtual Long64_t CopyEntries(TTree *tree, Long64_t nentries=-1, Option_t *option="", bool needCopyAddresses=false)
Copy nentries from given tree to this tree.
Definition TTree.cxx:3575
Int_t fMakeClass
! not zero when processing code generated by MakeClass
Definition TTree.h:125
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:6533
static constexpr Long64_t kMaxEntries
Definition TTree.h:263
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:7358
std::unordered_map< std::string, TBranch * > fNamesToBranches
! maps names to their branches, useful when retrieving branches by name
Definition TTree.h:174
virtual Long64_t GetAutoFlush() const
Definition TTree.h:484
virtual Long64_t GetMaxVirtualSize() const
Definition TTree.h:577
Abstract interface for Tree Index.
Provides the interface for the an internal performance measurement and event tracing.
Abstract base class defining the interface for the plugins that implement Draw, Scan,...
virtual TTreeFormula * GetVar1() const =0
virtual Double_t * GetV4() const =0
virtual Double_t * GetW() const =0
virtual TTreeFormula * GetVar4() const =0
virtual TTreeFormula * GetVar(Int_t) const =0
virtual Double_t * GetVal(Int_t) const =0
virtual TTreeFormula * GetVar2() const =0
virtual Double_t * GetV1() const =0
static constexpr Long64_t kMaxEntries
virtual TTreeFormula * GetVar3() const =0
virtual Double_t * GetV2() const =0
virtual TTreeFormula * GetSelect() const =0
virtual TH1 * GetHistogram() const =0
virtual Long64_t GetSelectedRows() const =0
virtual Double_t * GetV3() const =0
const Int_t n
Definition legend1.C:16
Namespace hosting functions and classes to retrieve tree information for internal use.
Definition RTTreeDS.hxx:49
TBranch * CallBranchImp(TTree &tree, const char *branchname, TClass *ptrClass, void *addobj, Int_t bufsize=32000, Int_t splitlevel=99)
Definition TTree.cxx:10087
TBranch * CallBranchImpRef(TTree &tree, const char *branchname, TClass *ptrClass, EDataType datatype, void *addobj, Int_t bufsize=32000, Int_t splitlevel=99)
Definition TTree.cxx:10081
void TBranch__SetTree(TTree *tree, TObjArray &branches)
Set the fTree member for all branches and sub branches.
Definition TTree.cxx:9727
th1 Draw()
auto * tt
Definition textangle.C:16