class TEntryListArray: public TEntryList
TEntryListArray: a list of entries and subentries in a TTree or TChain
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");
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:
| 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) | |
| 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 |
| static void | TObject::operator delete(void* ptr) |
| static void | TObject::operator delete(void* ptr, void* vp) |
| static void | TObject::operator delete[](void* ptr) |
| static 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(Option_t* option = "") const |
| virtual Int_t | TObject::Read(const char* name) |
| virtual void | TObject::RecursiveRemove(TObject* obj) |
| 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 = "") |
| 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 |
| 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) |
| virtual Int_t | TNamed::Sizeof() const |
| virtual void | Streamer(TBuffer& b) |
| void | StreamerNVirtual(TBuffer& b) |
| virtual void | Subtract(const TEntryList* elist) |
| virtual void | TObject::SysError(const char* method, const char* msgfmt) const |
| 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 | 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:
| enum TEntryList::[unnamed] { | kBlockSize | |
| }; | ||
| enum TObject::EStatusBits { | kCanDelete | |
| kMustCleanup | ||
| kObjInCanvas | ||
| kIsReferenced | ||
| kHasUUID | ||
| kCannotPick | ||
| kNoContextMenu | ||
| kInvalidObject | ||
| }; | ||
| enum TObject::[unnamed] { | kIsOnHeap | |
| kNotDeleted | ||
| kZombie | ||
| kBitMask | ||
| kSingleKey | ||
| kOverwrite | ||
| kWriteDelete | ||
| }; |
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
Function documentation
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
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(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)
Bool_t RemoveSubListForEntry(Long64_t entry, TTree* tree = 0)
Remove the sublists for the given entry --> not being used...
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& )
void SetTree(const char* treename, const char* filename)
TList* GetSubLists() const