Manages entry lists from different files, when they are not loaded in memory at the same time.
This entry list should only be used when processing a TChain (see TChain::SetEntryList() function). File naming convention:
If one of the list files can't be opened, or there is an error reading a list from the file, this list is skipped and the entry loop continues on the next list.
Definition at line 40 of file TEntryListFromFile.h.
Public Member Functions | |
TEntryListFromFile () | |
TEntryListFromFile (const char *filename, const char *listname, Int_t nfiles) | |
File naming convention: | |
virtual | ~TEntryListFromFile () |
d-tor | |
virtual void | Add (const TEntryList *) |
Add 2 entry lists. | |
virtual Int_t | Contains (Long64_t, TTree *) |
virtual Bool_t | Enter (Long64_t, TTree *) |
Add entry #entry to the list. | |
virtual TEntryList * | GetCurrentList () const |
virtual Long64_t | GetEntries () |
Returns the total number of entries in the list. | |
virtual Long64_t | GetEntriesFast () const |
virtual Long64_t | GetEntry (Long64_t index) |
Returns entry #index See also Next() for a faster alternative. | |
virtual Long64_t | GetEntryAndTree (Long64_t index, Int_t &treenum) |
Return the entry corresponding to the index parameter and the number of the tree, where this entry is. | |
virtual TEntryList * | GetEntryList (const char *, const char *, Option_t *) |
Return the entry list, corresponding to treename and filename By default, the filename is first tried as is, and then, if the corresponding list is not found, the filename is expanded to the absolute path, and compared again. | |
virtual const char * | GetFileName () const |
virtual Long64_t | GetN () const |
virtual const char * | GetTreeName () const |
virtual Int_t | GetTreeNumber () const |
virtual Int_t | LoadList (Int_t listnumber) |
Loads the list #listnumber This is the only function that can modify fCurrent and fFile data members. | |
virtual Int_t | Merge (TCollection *) |
Merge this list with the lists from the collection. | |
virtual Long64_t | Next () |
Returns the next entry in the list. | |
virtual void | OptimizeStorage () |
Checks if the array representation is more economical and if so, switches to it. | |
virtual void | Print (const Option_t *option="") const |
Print info about this list. | |
virtual Bool_t | Remove (Long64_t, TTree *) |
Remove entry #entry from the list. | |
virtual void | SetFileNames (TObjArray *names) |
virtual void | SetNFiles (Int_t nfiles) |
virtual void | SetTree (const char *, const char *) |
If a list for a tree with such name and filename exists, sets it as the current sublist If not, creates this list and sets it as the current sublist. | |
virtual void | SetTree (const TTree *) |
If a list for a tree with such name and filename exists, sets it as the current sublist If not, creates this list and sets it as the current sublist The name of the file, where the tree is, is taken as tree->GetTree()->GetCurrentFile()->GetName() , and then expanded either to the absolute path, or to full url. | |
virtual void | SetTreeNumber (Int_t index) |
virtual void | Subtract (const TEntryList *) |
Remove all the entries of this entry list, that are contained in elist. | |
Public Member Functions inherited from TEntryList | |
TEntryList () | |
default c-tor | |
TEntryList (const char *name, const char *title) | |
c-tor with name and title | |
TEntryList (const char *name, const char *title, const char *treename, const char *filename) | |
c-tor with name and title, which also sets the treename and the filename | |
TEntryList (const char *name, const char *title, const TTree *tree) | |
constructor with name and title, which also sets the tree | |
TEntryList (const TEntryList &elist) | |
copy c-tor | |
TEntryList (const TTree *tree) | |
c-tor, which sets the tree | |
virtual | ~TEntryList () |
Destructor. | |
void | AddSubList (TEntryList *elist) |
Add a sub entry list to the current list. | |
virtual void | DirectoryAutoAdd (TDirectory *) |
Called by TKey and others to automatically add us to a directory when we are read from a file. | |
void | EnterRange (Long64_t start, Long64_t end, TTree *tree=nullptr, UInt_t step=1U) |
Enter all entries in a range in the TEntryList. | |
virtual TDirectory * | GetDirectory () const |
virtual Long64_t | GetEntriesToProcess () const |
virtual TList * | GetLists () const |
virtual Bool_t | GetReapplyCut () const |
Bool_t | IsValid () const |
virtual Int_t | RelocatePaths (const char *newloc, const char *oldloc=0) |
Relocate the file paths. | |
virtual void | Reset () |
Reset this list. | |
virtual Int_t | ScanPaths (TList *roots, Bool_t notify=kTRUE) |
Scan the paths to find the common roots. | |
virtual void | SetDirectory (TDirectory *dir) |
Add reference to directory dir. dir can be 0. | |
virtual void | SetEntriesToProcess (Long64_t nen) |
virtual void | SetFileName (const char *filename) |
virtual void | SetReapplyCut (Bool_t apply=kFALSE) |
virtual void | SetShift (Bool_t shift) |
virtual void | SetTreeName (const char *treename) |
Public Member Functions inherited from TNamed | |
TNamed () | |
TNamed (const char *name, const char *title) | |
TNamed (const TNamed &named) | |
TNamed copy ctor. | |
TNamed (const TString &name, const TString &title) | |
virtual | ~TNamed () |
TNamed destructor. | |
virtual void | Clear (Option_t *option="") |
Set name and title to empty strings (""). | |
virtual TObject * | Clone (const char *newname="") const |
Make a clone of an object using the Streamer facility. | |
virtual Int_t | Compare (const TObject *obj) const |
Compare two TNamed objects. | |
virtual void | Copy (TObject &named) const |
Copy this to obj. | |
virtual void | FillBuffer (char *&buffer) |
Encode TNamed into output buffer. | |
virtual const char * | GetName () const |
Returns name of object. | |
virtual const char * | GetTitle () const |
Returns title of object. | |
virtual ULong_t | Hash () const |
Return hash value for this object. | |
virtual Bool_t | IsSortable () const |
virtual void | ls (Option_t *option="") const |
List TNamed name and title. | |
TNamed & | operator= (const TNamed &rhs) |
TNamed assignment operator. | |
virtual void | Print (Option_t *option="") const |
Print TNamed name and title. | |
virtual void | SetName (const char *name) |
Set the name of the TNamed. | |
virtual void | SetNameTitle (const char *name, const char *title) |
Set all the TNamed parameters (name and title). | |
virtual void | SetTitle (const char *title="") |
Set the title of the TNamed. | |
virtual Int_t | Sizeof () const |
Return size of the TNamed part of the TObject. | |
Public Member Functions inherited from TObject | |
TObject () | |
TObject constructor. | |
TObject (const TObject &object) | |
TObject copy ctor. | |
virtual | ~TObject () |
TObject destructor. | |
void | AbstractMethod (const char *method) const |
Use this method to implement an "abstract" method that you don't want to leave purely abstract. | |
virtual void | AppendPad (Option_t *option="") |
Append graphics object to current pad. | |
virtual void | Browse (TBrowser *b) |
Browse object. May be overridden for another default action. | |
ULong_t | CheckedHash () |
Check and record whether this class has a consistent Hash/RecursiveRemove setup (*) and then return the regular Hash value for this object. | |
virtual const char * | ClassName () const |
Returns name of class to which the object belongs. | |
virtual void | Delete (Option_t *option="") |
Delete this object. | |
virtual Int_t | DistancetoPrimitive (Int_t px, Int_t py) |
Computes distance from point (px,py) to the object. | |
virtual void | Draw (Option_t *option="") |
Default Draw method for all objects. | |
virtual void | DrawClass () const |
Draw class inheritance tree of the class to which this object belongs. | |
virtual TObject * | DrawClone (Option_t *option="") const |
Draw a clone of this object in the current selected pad for instance with: gROOT->SetSelectedPad(gPad) . | |
virtual void | Dump () const |
Dump contents of object on stdout. | |
virtual void | Error (const char *method, const char *msgfmt,...) const |
Issue error message. | |
virtual void | Execute (const char *method, const char *params, Int_t *error=0) |
Execute method on this object with the given parameter string, e.g. | |
virtual void | Execute (TMethod *method, TObjArray *params, Int_t *error=0) |
Execute method on this object with parameters stored in the TObjArray. | |
virtual void | ExecuteEvent (Int_t event, Int_t px, Int_t py) |
Execute action corresponding to an event at (px,py). | |
virtual void | Fatal (const char *method, const char *msgfmt,...) const |
Issue fatal error message. | |
virtual TObject * | FindObject (const char *name) const |
Must be redefined in derived classes. | |
virtual TObject * | FindObject (const TObject *obj) const |
Must be redefined in derived classes. | |
virtual Option_t * | GetDrawOption () const |
Get option used by the graphics system to draw this object. | |
virtual const char * | GetIconName () const |
Returns mime type name of object. | |
virtual char * | GetObjectInfo (Int_t px, Int_t py) const |
Returns string containing info about the object at position (px,py). | |
virtual Option_t * | GetOption () const |
virtual UInt_t | GetUniqueID () const |
Return the unique object id. | |
virtual Bool_t | HandleTimer (TTimer *timer) |
Execute action in response of a timer timing out. | |
Bool_t | HasInconsistentHash () const |
Return true is the type of this object is known to have an inconsistent setup for Hash and RecursiveRemove (i.e. | |
virtual void | Info (const char *method, const char *msgfmt,...) const |
Issue info message. | |
virtual Bool_t | InheritsFrom (const char *classname) const |
Returns kTRUE if object inherits from class "classname". | |
virtual Bool_t | InheritsFrom (const TClass *cl) const |
Returns kTRUE if object inherits from TClass cl. | |
virtual void | Inspect () const |
Dump contents of this object in a graphics canvas. | |
void | InvertBit (UInt_t f) |
Bool_t | IsDestructed () const |
IsDestructed. | |
virtual Bool_t | IsEqual (const TObject *obj) const |
Default equal comparison (objects are equal if they have the same address in memory). | |
virtual Bool_t | IsFolder () const |
Returns kTRUE in case object contains browsable objects (like containers or lists of other objects). | |
R__ALWAYS_INLINE Bool_t | IsOnHeap () const |
R__ALWAYS_INLINE Bool_t | IsZombie () const |
void | MayNotUse (const char *method) const |
Use this method to signal that a method (defined in a base class) may not be called in a derived class (in principle against good design since a child class should not provide less functionality than its parent, however, sometimes it is necessary). | |
virtual Bool_t | Notify () |
This method must be overridden to handle object notification. | |
void | Obsolete (const char *method, const char *asOfVers, const char *removedFromVers) const |
Use this method to declare a method obsolete. | |
void | operator delete (void *ptr) |
Operator delete. | |
void | operator delete[] (void *ptr) |
Operator delete []. | |
void * | operator new (size_t sz) |
void * | operator new (size_t sz, void *vp) |
void * | operator new[] (size_t sz) |
void * | operator new[] (size_t sz, void *vp) |
TObject & | operator= (const TObject &rhs) |
TObject assignment operator. | |
virtual void | Paint (Option_t *option="") |
This method must be overridden if a class wants to paint itself. | |
virtual void | Pop () |
Pop on object drawn in a pad to the top of the display list. | |
virtual Int_t | Read (const char *name) |
Read contents of object with specified name from the current directory. | |
virtual void | RecursiveRemove (TObject *obj) |
Recursively remove this object from a list. | |
void | ResetBit (UInt_t f) |
virtual void | SaveAs (const char *filename="", Option_t *option="") const |
Save this object in the file specified by filename. | |
virtual void | SavePrimitive (std::ostream &out, Option_t *option="") |
Save a primitive as a C++ statement(s) on output stream "out". | |
void | SetBit (UInt_t f) |
void | SetBit (UInt_t f, Bool_t set) |
Set or unset the user status bits as specified in f. | |
virtual void | SetDrawOption (Option_t *option="") |
Set drawing option for object. | |
virtual void | SetUniqueID (UInt_t uid) |
Set the unique object id. | |
virtual void | SysError (const char *method, const char *msgfmt,...) const |
Issue system error message. | |
R__ALWAYS_INLINE Bool_t | TestBit (UInt_t f) const |
Int_t | TestBits (UInt_t f) const |
virtual void | UseCurrentStyle () |
Set current style settings in this object This function is called when either TCanvas::UseCurrentStyle or TROOT::ForceStyle have been invoked. | |
virtual void | Warning (const char *method, const char *msgfmt,...) const |
Issue warning message. | |
virtual Int_t | Write (const char *name=0, Int_t option=0, Int_t bufsize=0) |
Write this object to the current directory. | |
virtual Int_t | Write (const char *name=0, Int_t option=0, Int_t bufsize=0) const |
Write this object to the current directory. | |
Protected Attributes | |
TFile * | fFile |
currently open file fCurrent points to the currently open list | |
TObjArray * | fFileNames |
! points to the fFiles data member of the corresponding chain | |
TString | fListFileName |
from this string names of all files can be found | |
TString | fListName |
name of the list | |
Long64_t * | fListOffset |
[fNFiles] numbers of entries in ind. lists | |
Int_t | fNFiles |
total number of files | |
Protected Attributes inherited from TEntryList | |
TObjArray * | fBlocks |
blocks with indices of passing events (TEntryListBlocks) | |
TEntryList * | fCurrent |
! currently filled entry list | |
TDirectory * | fDirectory |
! Pointer to directory holding this tree | |
Long64_t | fEntriesToProcess |
used on proof to set the number of entries to process in a packet | |
TString | fFileName |
name of the file, where the tree is | |
Long64_t | fLastIndexQueried |
! used to optimize GetEntry() function from a loop | |
Long64_t | fLastIndexReturned |
! used to optimize GetEntry() function from a loop | |
TList * | fLists |
a list of underlying entry lists for each tree of a chain | |
Long64_t | fN |
number of entries in the list | |
Int_t | fNBlocks |
number of TEntryListBlocks | |
Bool_t | fReapply |
If true, TTree::Draw will 'reapply' the original cut. | |
Bool_t | fShift |
! true when some sub-lists don't correspond to trees (when the entry list is used as input in TChain) | |
ULong_t | fStringHash |
! Hash value of a string of treename and filename | |
TString | fTreeName |
name of the tree | |
Int_t | fTreeNumber |
! the index of the tree in the chain (used when the entry list is used as input (TTree::SetEntryList()) | |
Protected Attributes inherited from TNamed | |
TString | fName |
TString | fTitle |
Static Protected Attributes | |
static constexpr auto | kBigNumber = std::numeric_limits<Long64_t>::max() |
Private Member Functions | |
TEntryListFromFile (const TEntryListFromFile &) | |
TEntryListFromFile & | operator= (const TEntryListFromFile &) |
Additional Inherited Members | |
Public Types inherited from TEntryList | |
enum | { kBlockSize = 64000 } |
Public Types inherited from TObject | |
enum | { kIsOnHeap = 0x01000000 , kNotDeleted = 0x02000000 , kZombie = 0x04000000 , kInconsistent = 0x08000000 , kBitMask = 0x00ffffff } |
enum | { kSingleKey = BIT(0) , kOverwrite = BIT(1) , kWriteDelete = BIT(2) } |
enum | EDeprecatedStatusBits { kObjInCanvas = BIT(3) } |
enum | EStatusBits { kCanDelete = BIT(0) , kMustCleanup = BIT(3) , kIsReferenced = BIT(4) , kHasUUID = BIT(5) , kCannotPick = BIT(6) , kNoContextMenu = BIT(8) , kInvalidObject = BIT(13) } |
Static Public Member Functions inherited from TEntryList | |
static Int_t | Relocate (const char *fn, const char *newroot, const char *oldroot=0, const char *enlnm=0) |
Relocate entry list 'enlnm' in file 'fn' replacing 'oldroot' with 'newroot' in filenames. | |
static Int_t | Scan (const char *fn, TList *roots) |
Scan TEntryList in 'fn' to find the common parts of paths. | |
Static Public Member Functions inherited from TObject | |
static Longptr_t | GetDtorOnly () |
Return destructor only flag. | |
static Bool_t | GetObjectStat () |
Get status of object stat flag. | |
static void | SetDtorOnly (void *obj) |
Set destructor only flag. | |
static void | SetObjectStat (Bool_t stat) |
Turn on/off tracking of objects in the TObjectTable. | |
Protected Types inherited from TObject | |
enum | { kOnlyPrepStep = BIT(3) } |
Protected Member Functions inherited from TEntryList | |
void | GetFileName (const char *filename, TString &fn, Bool_t *=0) |
To be able to re-localize the entry-list we identify the file by just the name and the anchor, i.e. | |
Protected Member Functions inherited from TObject | |
virtual void | DoError (int level, const char *location, const char *fmt, va_list va) const |
Interface to ErrorHandler (protected). | |
void | MakeZombie () |
#include <TEntryListFromFile.h>
|
private |
TEntryListFromFile::TEntryListFromFile | ( | ) |
Definition at line 43 of file TEntryListFromFile.cxx.
TEntryListFromFile::TEntryListFromFile | ( | const char * | filename, |
const char * | listname, | ||
Int_t | nfiles | ||
) |
File naming convention:
The TObjArray of chain elements is set by the TEntryListFromFile::SetFileNames() function.
If the list name is not specified, the first object of class TEntryList in the file is taken.
nfiles is the total number of files to process
Definition at line 64 of file TEntryListFromFile.cxx.
|
virtual |
d-tor
Definition at line 78 of file TEntryListFromFile.cxx.
|
inlinevirtual |
Add 2 entry lists.
[in] | elist | The list that should be added to the current one. |
Reimplemented from TEntryList.
Definition at line 63 of file TEntryListFromFile.h.
Reimplemented from TEntryList.
Definition at line 64 of file TEntryListFromFile.h.
Add entry #entry to the list.
Reimplemented from TEntryList.
Definition at line 65 of file TEntryListFromFile.h.
|
inlinevirtual |
Reimplemented from TEntryList.
Definition at line 66 of file TEntryListFromFile.h.
|
virtual |
Returns the total number of entries in the list.
If some lists have not been loaded, loads them.
Definition at line 166 of file TEntryListFromFile.cxx.
|
inlinevirtual |
Definition at line 72 of file TEntryListFromFile.h.
Returns entry #index See also Next() for a faster alternative.
Reimplemented from TEntryList.
Definition at line 90 of file TEntryListFromFile.cxx.
Return the entry corresponding to the index parameter and the number of the tree, where this entry is.
Reimplemented from TEntryList.
Definition at line 155 of file TEntryListFromFile.cxx.
|
inlinevirtual |
Return the entry list, corresponding to treename and filename By default, the filename is first tried as is, and then, if the corresponding list is not found, the filename is expanded to the absolute path, and compared again.
To avoid it, use option "ne"
Reimplemented from TEntryList.
Definition at line 67 of file TEntryListFromFile.h.
|
inlinevirtual |
Reimplemented from TEntryList.
Definition at line 76 of file TEntryListFromFile.h.
|
inlinevirtual |
Reimplemented from TEntryList.
Definition at line 74 of file TEntryListFromFile.h.
|
inlinevirtual |
Reimplemented from TEntryList.
Definition at line 75 of file TEntryListFromFile.h.
|
inlinevirtual |
Reimplemented from TEntryList.
Definition at line 77 of file TEntryListFromFile.h.
Loads the list #listnumber This is the only function that can modify fCurrent and fFile data members.
Definition at line 231 of file TEntryListFromFile.cxx.
|
inlinevirtual |
Merge this list with the lists from the collection.
Reimplemented from TEntryList.
Definition at line 81 of file TEntryListFromFile.h.
|
virtual |
Returns the next entry in the list.
Faster than GetEntry()
Reimplemented from TEntryList.
Definition at line 184 of file TEntryListFromFile.cxx.
|
private |
|
inlinevirtual |
Checks if the array representation is more economical and if so, switches to it.
Reimplemented from TEntryList.
Definition at line 84 of file TEntryListFromFile.h.
Print info about this list.
Reimplemented from TEntryList.
Definition at line 305 of file TEntryListFromFile.cxx.
Remove entry #entry from the list.
Reimplemented from TEntryList.
Definition at line 85 of file TEntryListFromFile.h.
Definition at line 91 of file TEntryListFromFile.h.
Definition at line 93 of file TEntryListFromFile.h.
|
inlinevirtual |
If a list for a tree with such name and filename exists, sets it as the current sublist If not, creates this list and sets it as the current sublist.
! the filename is taken as provided, no extensions to full path or url !
Reimplemented from TEntryList.
Definition at line 90 of file TEntryListFromFile.h.
If a list for a tree with such name and filename exists, sets it as the current sublist If not, creates this list and sets it as the current sublist The name of the file, where the tree is, is taken as tree->GetTree()->GetCurrentFile()->GetName()
, and then expanded either to the absolute path, or to full url.
If, for some reason, you want to provide the filename in a different format, use SetTree(const char *treename, const char *filename), where the filename is taken "as is".
Reimplemented from TEntryList.
Definition at line 89 of file TEntryListFromFile.h.
Reimplemented from TEntryList.
Definition at line 92 of file TEntryListFromFile.h.
|
inlinevirtual |
Remove all the entries of this entry list, that are contained in elist.
Reimplemented from TEntryList.
Definition at line 94 of file TEntryListFromFile.h.
|
protected |
currently open file fCurrent points to the currently open list
Definition at line 47 of file TEntryListFromFile.h.
|
protected |
! points to the fFiles data member of the corresponding chain
Definition at line 49 of file TEntryListFromFile.h.
|
protected |
from this string names of all files can be found
Definition at line 43 of file TEntryListFromFile.h.
|
protected |
name of the list
Definition at line 44 of file TEntryListFromFile.h.
|
protected |
[fNFiles] numbers of entries in ind. lists
Definition at line 46 of file TEntryListFromFile.h.
|
protected |
total number of files
Definition at line 45 of file TEntryListFromFile.h.
|
staticconstexprprotected |
Definition at line 52 of file TEntryListFromFile.h.