Quick Links: ROOT Homepage Class Index Class Hierarchy

Source: header file source file viewVC header viewVC source

Sections: class description function members data members class charts

class TEntryListArray: public TEntryList

TEntryListArray: a list of entries and subentries in a TTree or TChain

TEntryListArray is an extension of TEntryList, used to hold selected entries and subentries (sublists) for when the user has a TTree with containers (vectors, arrays, ...).

Usage with TTree::Draw to select entries and subentries

To fill a list elist :

     tree->Draw(">> elist", "x > 0", "entrylistarray");

To use a list to select entries and subentries:

     tree->SetEntryList(elist);
     tree->Draw("y");
     tree->Draw("z");

Its main purpose is to improve the performance of a code that needs to apply complex cuts on TTree::Draw multiple times. After the first call above to TTree::Draw, a TEntryListArray is created and filled with the entries and the indices of the arrays that satisfied the selection cut (x > 0). In the subsequent calls to TTree::Draw, only these entries / subentries are used to fill histograms.

About the class

The class derives from TEntryList and can be used basically in the same way. This same class is used to keep entries and subentries, so there are two types of TEntryListArray's:

The ones that only hold subentries
- fEntry is set to the entry# for which the subentries correspond
- fSubLists must be 0
The ones that hold entries and eventually lists with subentries in fSubLists.
- fEntry = -1 for those
- If there are no sublists for a given entry, all the subentries will be used in the selection

Additions with respect to TEntryList

Data members:
- fSubLists: a container to hold the sublists
- fEntry: the entry number if the list is used to hold subentries
- fLastSubListQueried and fSubListIter: a pointer to the last sublist queried and an iterator to resume the loop from the last sublist queried (to speed up selection and insertion in TTree::Draw)
Public methods:
- Contains, Enter and Remove with subentry as argument
- GetSubListForEntry: to return the sublist corresponding to the given entry
Protected methods:
- AddEntriesAndSubLists: called by Add when adding two TEntryList arrays with sublists
- ConvertToTEntryListArray: convert TEntryList to TEntryListArray
- RemoveSubList: to remove the given sublist
- RemoveSubListForEntry: to remove the sublist corresponding to the given entry
- SetEntry: to get / set a sublist for the given entry

Function Members (Methods)

public:

virtual	~TEntryListArray()
void	TObject::AbstractMethod(const char* method) const
virtual void	Add(const TEntryList* elist)
virtual void	TObject::AppendPad(Option_t* option = "")
virtual void	TObject::Browse(TBrowser* b)
static TClass*	Class()
virtual const char*	TObject::ClassName() const
virtual void	TNamed::Clear(Option_t* option = "")
virtual TObject*	TNamed::Clone(const char* newname = "") const
virtual Int_t	TNamed::Compare(const TObject* obj) const
virtual Int_t	Contains(Long64_t entry, TTree* tree = 0)
virtual Int_t	Contains(Long64_t entry, TTree* tree, Long64_t subentry)
virtual void	TNamed::Copy(TObject& named) const
virtual void	TObject::Delete(Option_t* option = "")MENU
virtual void	TEntryList::DirectoryAutoAdd(TDirectory*)
virtual Int_t	TObject::DistancetoPrimitive(Int_t px, Int_t py)
virtual void	TObject::Draw(Option_t* option = "")
virtual void	TObject::DrawClass() constMENU
virtual TObject*	TObject::DrawClone(Option_t* option = "") constMENU
virtual void	TObject::Dump() constMENU
virtual Bool_t	Enter(Long64_t entry, TTree* tree = 0)
virtual Bool_t	Enter(Long64_t entry, TTree* tree, Long64_t subentry)
virtual void	TObject::Error(const char* method, const char* msgfmt) const
virtual void	TObject::Execute(const char* method, const char* params, Int_t* error = 0)
virtual void	TObject::Execute(TMethod* method, TObjArray* params, Int_t* error = 0)
virtual void	TObject::ExecuteEvent(Int_t event, Int_t px, Int_t py)
virtual void	TObject::Fatal(const char* method, const char* msgfmt) const
virtual void	TNamed::FillBuffer(char*& buffer)
virtual TObject*	TObject::FindObject(const char* name) const
virtual TObject*	TObject::FindObject(const TObject* obj) const
virtual TEntryList*	TEntryList::GetCurrentList() const
virtual TDirectory*	TEntryList::GetDirectory() const
virtual Option_t*	TObject::GetDrawOption() const
static Long_t	TObject::GetDtorOnly()
virtual Long64_t	TEntryList::GetEntriesToProcess() const
virtual Long64_t	TEntryList::GetEntry(Int_t index)
virtual Long64_t	TEntryList::GetEntryAndTree(Int_t index, Int_t& treenum)
virtual TEntryList*	TEntryList::GetEntryList(const char* treename, const char* filename, Option_t* opt = "")
virtual const char*	TEntryList::GetFileName() const
virtual const char*	TObject::GetIconName() const
virtual TList*	TEntryList::GetLists() const
virtual Long64_t	TEntryList::GetN() const
virtual const char*	TNamed::GetName() const
virtual char*	TObject::GetObjectInfo(Int_t px, Int_t py) const
static Bool_t	TObject::GetObjectStat()
virtual Option_t*	TObject::GetOption() const
virtual Bool_t	TEntryList::GetReapplyCut() const
virtual TEntryListArray*	GetSubListForEntry(Long64_t entry, TTree* tree = 0)
virtual TList*	GetSubLists() const
virtual const char*	TNamed::GetTitle() const
virtual const char*	TEntryList::GetTreeName() const
virtual Int_t	TEntryList::GetTreeNumber() const
virtual UInt_t	TObject::GetUniqueID() const
virtual Bool_t	TObject::HandleTimer(TTimer* timer)
virtual ULong_t	TNamed::Hash() const
virtual void	TObject::Info(const char* method, const char* msgfmt) const
virtual Bool_t	TObject::InheritsFrom(const char* classname) const
virtual Bool_t	TObject::InheritsFrom(const TClass* cl) const
virtual void	TObject::Inspect() constMENU
void	TObject::InvertBit(UInt_t f)
virtual TClass*	IsA() const
virtual Bool_t	TObject::IsEqual(const TObject* obj) const
virtual Bool_t	TObject::IsFolder() const
Bool_t	TObject::IsOnHeap() const
virtual Bool_t	TNamed::IsSortable() const
Bool_t	TObject::IsZombie() const
virtual void	TNamed::ls(Option_t* option = "") const
void	TObject::MayNotUse(const char* method) const
virtual Int_t	TEntryList::Merge(TCollection* list)
virtual Long64_t	TEntryList::Next()
virtual Bool_t	TObject::Notify()
void	TObject::Obsolete(const char* method, const char* asOfVers, const char* removedFromVers) const
void	TObject::operator delete(void* ptr)
void	TObject::operator delete(void* ptr, void* vp)
void	TObject::operator delete[](void* ptr)
void	TObject::operator delete[](void* ptr, void* vp)
void*	TObject::operator new(size_t sz)
void*	TObject::operator new(size_t sz, void* vp)
void*	TObject::operator new[](size_t sz)
void*	TObject::operator new[](size_t sz, void* vp)
virtual void	TEntryList::OptimizeStorage()
virtual void	TObject::Paint(Option_t* option = "")
virtual void	TObject::Pop()
virtual void	Print(const Option_t* option = "") const
virtual Int_t	TObject::Read(const char* name)
virtual void	TObject::RecursiveRemove(TObject* obj)
static Int_t	TEntryList::Relocate(const char* fn, const char* newroot, const char* oldroot = 0, const char* enlnm = 0)
virtual Int_t	TEntryList::RelocatePaths(const char* newloc, const char* oldloc = 0)
virtual Bool_t	Remove(Long64_t entry, TTree* tree = 0)
virtual Bool_t	Remove(Long64_t entry, TTree* tree, Long64_t subentry)
virtual void	Reset()
void	TObject::ResetBit(UInt_t f)
virtual void	TObject::SaveAs(const char* filename = "", Option_t* option = "") constMENU
virtual void	TObject::SavePrimitive(ostream& out, Option_t* option = "")
static Int_t	TEntryList::Scan(const char* fn, TList* roots)
virtual Int_t	TEntryList::ScanPaths(TList* roots, Bool_t notify = kTRUE)
void	TObject::SetBit(UInt_t f)
void	TObject::SetBit(UInt_t f, Bool_t set)
virtual void	TEntryList::SetDirectory(TDirectory* dir)
virtual void	TObject::SetDrawOption(Option_t* option = "")MENU
static void	TObject::SetDtorOnly(void* obj)
virtual void	TEntryList::SetEntriesToProcess(Long64_t nen)
virtual void	TEntryList::SetFileName(const char* filename)
virtual void	TNamed::SetName(const char* name)MENU
virtual void	TNamed::SetNameTitle(const char* name, const char* title)
static void	TObject::SetObjectStat(Bool_t stat)
virtual void	TEntryList::SetReapplyCut(Bool_t apply = kFALSE)TOGGLE GETTER
virtual void	TEntryList::SetShift(Bool_t shift)
virtual void	TNamed::SetTitle(const char* title = "")MENU
virtual void	SetTree(const TTree* tree)
virtual void	SetTree(const char* treename, const char* filename)
virtual void	TEntryList::SetTreeName(const char* treename)
virtual void	TEntryList::SetTreeNumber(Int_t index)
virtual void	TObject::SetUniqueID(UInt_t uid)
virtual void	ShowMembers(TMemberInspector& insp) const
virtual Int_t	TNamed::Sizeof() const
virtual void	Streamer(TBuffer&)
void	StreamerNVirtual(TBuffer& ClassDef_StreamerNVirtual_b)
virtual void	Subtract(const TEntryList* elist)
virtual void	TObject::SysError(const char* method, const char* msgfmt) const
	TEntryListArray()
	TEntryListArray(const TTree* tree)
	TEntryListArray(const TEntryListArray& elist)
	TEntryListArray(const TEntryList& elist)
	TEntryListArray(const char* name, const char* title)
	TEntryListArray(const char* name, const char* title, const TTree* tree)
	TEntryListArray(const char* name, const char* title, const char* treename, const char* filename)
Bool_t	TObject::TestBit(UInt_t f) const
Int_t	TObject::TestBits(UInt_t f) const
virtual void	TObject::UseCurrentStyle()
virtual void	TObject::Warning(const char* method, const char* msgfmt) const
virtual Int_t	TObject::Write(const char* name = 0, Int_t option = 0, Int_t bufsize = 0)
virtual Int_t	TObject::Write(const char* name = 0, Int_t option = 0, Int_t bufsize = 0) const

protected:

virtual void	AddEntriesAndSubLists(const TEntryList* elist)
virtual void	ConvertToTEntryListArray(TEntryList* e)
virtual void	TObject::DoError(int level, const char* location, const char* fmt, va_list va) const
void	TEntryList::GetFileName(const char* filename, TString& fn, Bool_t* = 0)
void	Init()
void	TObject::MakeZombie()
virtual Bool_t	RemoveSubList(TEntryListArray* e, TTree* tree = 0)
virtual Bool_t	RemoveSubListForEntry(Long64_t entry, TTree* tree = 0)
virtual TEntryListArray*	SetEntry(Long64_t entry, TTree* tree = 0)

private:

TEntryListArray&

operator=(const TEntryListArray&)

Data Members

public:

static TObject::(anonymous)	TObject::kBitMask
static TEntryList::(anonymous)	TEntryList::kBlockSize
static TObject::EStatusBits	TObject::kCanDelete
static TObject::EStatusBits	TObject::kCannotPick
static TObject::EStatusBits	TObject::kHasUUID
static TObject::EStatusBits	TObject::kInvalidObject
static TObject::(anonymous)	TObject::kIsOnHeap
static TObject::EStatusBits	TObject::kIsReferenced
static TObject::EStatusBits	TObject::kMustCleanup
static TObject::EStatusBits	TObject::kNoContextMenu
static TObject::(anonymous)	TObject::kNotDeleted
static TObject::EStatusBits	TObject::kObjInCanvas
static TObject::(anonymous)	TObject::kOverwrite
static TObject::(anonymous)	TObject::kSingleKey
static TObject::(anonymous)	TObject::kWriteDelete
static TObject::(anonymous)	TObject::kZombie

protected:

TObjArray*	TEntryList::fBlocks	blocks with indices of passing events (TEntryListBlocks)
TEntryList*	TEntryList::fCurrent	! currently filled entry list
TDirectory*	TEntryList::fDirectory	! Pointer to directory holding this tree
Long64_t	TEntryList::fEntriesToProcess	used on proof to set the number of entries to process in a packet
Long64_t	fEntry	the entry number, when the list is used for subentries
TString	TEntryList::fFileName	name of the file, where the tree is
Long64_t	TEntryList::fLastIndexQueried	! used to optimize GetEntry() function from a loop
Long64_t	TEntryList::fLastIndexReturned	! used to optimize GetEntry() function from a loop
TEntryListArray*	fLastSubListQueried	! last sublist checked by GetSubListForEntry
TList*	TEntryList::fLists	a list of underlying entry lists for each tree of a chain
Long64_t	TEntryList::fN	number of entries in the list
Int_t	TEntryList::fNBlocks	number of TEntryListBlocks
TString	TNamed::fName	object identifier
Bool_t	TEntryList::fReapply	If true, TTree::Draw will 'reapply' the original cut
Bool_t	TEntryList::fShift	! true when some sub-lists don't correspond to trees
ULong_t	TEntryList::fStringHash	! Hash value of a string of treename and filename
TIter*	fSubListIter	! to iterate over fSubLists and keep last one checked
TList*	fSubLists	a list of underlying entry lists for each event of a TEntryList
TString	TNamed::fTitle	object title
TString	TEntryList::fTreeName	name of the tree
Int_t	TEntryList::fTreeNumber	! the index of the tree in the chain (used when the entry

Class Charts

Inheritance Inherited Members Includes Libraries

Function documentation

void Init()

 Initialize data members, called by Reset

TEntryListArray()

default c-tor

TEntryListArray(const char* name, const char* title)

c-tor with name and title

TEntryListArray(const char* name, const char* title, const TTree* tree)

constructor with name and title, which also sets the tree

TEntryListArray(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

TEntryListArray(const TTree* tree)

c-tor, which sets the tree

TEntryListArray(const TEntryListArray& elist)

copy c-tor

TEntryListArray(const TEntryList& elist)

c-tor, from TEntryList

~TEntryListArray()

 d-tor

void Add(const TEntryList* elist)

Add 2 entry lists

void AddEntriesAndSubLists(const TEntryList* elist)

 The method that really adds two entry lists with sublists
 If lists are splitted (fLists != 0), look for the ones whose trees match and call the method for those lists.
 Add first the sublists, and then use TEntryList::Add to deal with the entries

Int_t Contains(Long64_t entry, TTree* tree, Long64_t subentry)

When tree = 0, returns from the current list
When tree != 0, finds the list corresponding to this tree
When tree is a chain, the entry is assumed to be global index and the local
entry is recomputed from the treeoffset information of the chain

void ConvertToTEntryListArray(TEntryList* e)

 Create a TEntryListArray based on the given TEntryList
 Called by SetTree when the given list is added to fLists
 Replace it by a TEntryListArray and delete the given list

Bool_t Enter(Long64_t entry, TTree* tree, Long64_t subentry)

Add entry #entry (, #subentry) to the list
When tree = 0, adds to the current list
When tree != 0, finds the list corresponding to this tree (or add a new one)
When tree is a chain, the entry is assumed to be global index and the local
entry is recomputed from the treeoffset information of the chain

TEntryListArray* GetSubListForEntry(Long64_t entry, TTree* tree = 0)

 Return the list holding the subentries for the given entry or 0

void Print(const Option_t* option = "") const

Print this list
option = "" - default - print the name of the tree and file
option = "all" - print all the entry numbers
option = "subentries" - print all the entry numbers and associated subentries

Bool_t Remove(Long64_t entry, TTree* tree, Long64_t subentry)

Remove entry #entry (, #subentry)  from the list
When tree = 0, removes from the current list
When tree != 0, finds the list, corresponding to this tree
When tree is a chain, the entry is assumed to be global index and the local
entry is recomputed from the treeoffset information of the chain
If subentry != -1, only the given subentry is removed

Bool_t RemoveSubList(TEntryListArray* e, TTree* tree = 0)

 Remove the given sublist and return true if succeeded

Bool_t RemoveSubListForEntry(Long64_t entry, TTree* tree = 0)

 Remove the sublists for the given entry --> not being used...

void Reset()

 Reset all entries and remove all sublists

TEntryListArray* SetEntry(Long64_t entry, TTree* tree = 0)

Create a sublist for the given entry and returns it --> should be called after calling GetSubListForEntry

void Subtract(const TEntryList* elist)

Remove all the entries (and subentries) of this entry list that are contained in elist
If for a given entry present in both lists, one has subentries and the other does not, the whole entry is removed

void SetTree(const char* treename, const char* filename)

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

TEntryListArray& operator=(const TEntryListArray& )

Int_t Contains(Long64_t entry, TTree* tree, Long64_t subentry)

Bool_t Enter(Long64_t entry, TTree* tree, Long64_t subentry)

Bool_t Remove(Long64_t entry, TTree* tree, Long64_t subentry)

void SetTree(const char* treename, const char* filename)

TList* GetSubLists() const