ROOT » TREE » TREE » TTreeCache

class TTreeCache: public TFileCacheRead


TTreeCache

A specialized TFileCacheRead object for a TTree
This class acts as a file cache, registering automatically the
baskets from the branches being processed (TTree::Draw or
TTree::Process and TSelectors) when in the learning phase.
The learning phase is by default 100 entries.
It can be changed via TTreeCache::SetLearnEntries.

This cache speeds-up considerably the performance, in particular
when the Tree is accessed remotely via a high latency network.

The default cache size (10 Mbytes) may be changed via the function
TTreeCache::SetCacheSize

Only the baskets for the requested entry range are put in the cache

For each Tree being processed a TTreeCache object is created.
This object is automatically deleted when the Tree is deleted or
when the file is deleted.

-Special case of a TChain
Once the training is done on the first Tree, the list of branches
in the cache is kept for the following files.

-Special case of a TEventlist
if the Tree or TChain has a TEventlist, only the buffers
referenced by the list are put in the cache.

  The learning period is started or restarted when:
     - TTree automatically creates a cache. This feature can be
       controlled with an env. variable or the TTreeCache.Size option.
     - TTree::SetCacheSize is called with a non-zero size and a cache
       did not previously exist
     - TTreeCache::StartLearningPhase is called.
     - TTree[Cache]::SetEntryRange is called
          * and the learning is not yet finished
          * and has not been set to manual
          * and the new minimun entry is different.

  The learning period is stopped (and prefetching is actually started) when:
     - TTree[Cache]::StopLearningPhase is called.
     - An entry outside the 'learning' range is requested
       The 'learning range is from fEntryMin (default to 0) to
       fEntryMin + fgLearnEntries (default to 100).
     - A 'cached' TChain switches over to a new file.

     WHY DO WE NEED the TreeCache when doing data analysis?


  When writing a TTree, the branch buffers are kept in memory.
  A typical branch buffersize (before compression) is typically 32 KBytes.
  After compression, the zipped buffer may be just a few Kbytes.
  The branch buffers cannot be much larger in case of Trees with several
  hundred or thousand branches.
  When writing, this does not generate a performance problem because branch
  buffers are always written sequentially and the OS is in general clever enough
  to flush the data to the output file when a few MBytes of data have to be written.
  When reading at the contrary, one may hit a performance problem when reading
  across a network (LAN or WAN) and the network latency is high.
  For example in a WAN with 10ms latency, reading 1000 buffers of 10 KBytes each
  with no cache will imply 10s penalty where a local read of the 10 MBytes would
  take about 1 second.
  The TreeCache will try to prefetch all the buffers for the selected branches
  such that instead of transfering 1000 buffers of 10 Kbytes, it will be able
  to transfer one single large buffer of 10 Mbytes in one single transaction.
  Not only the TreeCache minimizes the number of transfers, but in addition
  it can sort the blocks to be read in increasing order such that the file
  is read sequentially.
  Systems like xrootd, dCache or httpd take advantage of the TreeCache in
  reading ahead as much data as they can and return to the application
  the maximum data specified in the cache and have the next chunk of data ready
  when the next request comes.


     HOW TO USE the TreeCache


  A few use cases are discussed below. A cache may be created with automatic sizing
  when a TTree is used:

  Caches are created and automatically sized for TTrees when TTreeCache.Size or
  the environment variable ROOT_TTREECACHE_SIZE is set to a sizing factor.

  But there are many possible configurations where manual control may be wanted.
  In some applications you know a priori the list of branches to read. In other
  applications the analysis loop calls several layers of user functions where it
  is impossible to predict a priori which branches will be used. This
  is probably the most frequent case. In this case ROOT I/O will flag used
  branches automatically when a branch buffer is read during the learning phase.
  The TreeCache interface provides functions to instruct the cache about the used
  branches if they are known a priori. In the examples below, portions of analysis
  code are shown. The few statements involving the TreeCache are marked with //<<<


  1- with TTree::Draw

  the TreeCache is automatically used by TTree::Draw. The function knows
  which branches are used in the query and it puts automatically these branches
  in the cache. The entry range is also known automatically.


  2- with TTree::Process and TSelectors

  You must enable the cache and tell the system which branches to cache
  and also specify the entry range. It is important to specify the entry range
  in case you process only a subset of the events, otherwise you run the risk
  to store in the cache entries that you do not need.

      --example 2a
--
   TTree *T = (TTree*)f->Get("mytree");
   Long64_t nentries = T->GetEntries();
   Int_t cachesize = 10000000; //10 MBytes
   T->SetCacheSize(cachesize); //<<<
   T->AddBranchToCache("*",kTRUE);    //<<< add all branches to the cache
   T->Process('myselector.C+");
   //in the TSelector::Process function we read all branches
   T->GetEntry(i);
--      ... here you process your entry


      --example 2b
  in the Process function we read a subset of the branches.
  Only the branches used in the first entry will be put in the cache
--
   TTree *T = (TTree*)f->Get("mytree");
   //we want to process only the 200 first entries
   Long64_t nentries=200;
   int efirst= 0;
   int elast = efirst+nentries;
   Int_t cachesize = 10000000; //10 MBytes
   TTreeCache::SetLearnEntries(1);  //<<< we can take the decision after 1 entry
   T->SetCacheSize(cachesize);      //<<<
   T->SetCacheEntryRange(efirst,elast); //<<<
   T->Process('myselector.C+","",nentries,efirst);
   // in the TSelector::Process we read only 2 branches
   TBranch *b1 = T->GetBranch("branch1");
   b1->GetEntry(i);
   if (somecondition) return;
   TBranch *b2 = T->GetBranch("branch2");
   b2->GetEntry(i);
      ... here you process your entry
--

  3- with your own event loop

    --example 3a
      in your analysis loop, you always use 2 branches. You want to prefetch
      the branch buffers for these 2 branches only.
--
   TTree *T = (TTree*)f->Get("mytree");
   TBranch *b1 = T->GetBranch("branch1");
   TBranch *b2 = T->GetBranch("branch2");
   Long64_t nentries = T->GetEntries();
   Int_t cachesize = 10000000; //10 MBytes
   T->SetCacheSize(cachesize);     //<<<
   T->AddBranchToCache(b1,kTRUE);  //<<<add branch1 and branch2 to the cache
   T->AddBranchToCache(b2,kTRUE);  //<<<
   T->StopCacheLearningPhase();    //<<<
   for (Long64_t i=0;i<nentries;i++) {
      T->LoadTree(i); //<<< important call when calling TBranch::GetEntry after
      b1->GetEntry(i);
      if (some condition not met) continue;
      b2->GetEntry(i);
      if (some condition not met) continue;
      //here we read the full event only in some rare cases.
      //there is no point in caching the other branches as it might be
      //more economical to read only the branch buffers really used.
      T->GetEntry(i);
      .. process the rare but interesting cases.
      ... here you process your entry
   }
--
   --example 3b
      in your analysis loop, you always use 2 branches in the main loop.
      you also call some analysis functions where a few more branches will be read.
      but you do not know a priori which ones. There is no point in prefetching
      branches that will be used very rarely.
--
   TTree *T = (TTree*)f->Get("mytree");
   Long64_t nentries = T->GetEntries();
   Int_t cachesize = 10000000;   //10 MBytes
   T->SetCacheSize(cachesize);   //<<<
   T->SetCacheLearnEntries(5);   //<<< we can take the decision after 5 entries
   TBranch *b1 = T->GetBranch("branch1");
   TBranch *b2 = T->GetBranch("branch2");
   for (Long64_t i=0;i<nentries;i++) {
      T->LoadTree(i);
      b1->GetEntry(i);
      if (some condition not met) continue;
      b2->GetEntry(i);
      //at this point we may call a user function where a few more branches
      //will be read conditionally. These branches will be put in the cache
      //if they have been used in the first 10 entries
      if (some condition not met) continue;
      //here we read the full event only in some rare cases.
      //there is no point in caching the other branches as it might be
      //more economical to read only the branch buffers really used.
      T->GetEntry(i);
      .. process the rare but interesting cases.
      ... here you process your entry
   }
--


     SPECIAL CASES WHERE TreeCache should not be activated


   When reading only a small fraction of all entries such that not all branch
   buffers are read, it might be faster to run without a cache.


   HOW TO VERIFY That the TreeCache has been used and check its performance


  Once your analysis loop has terminated, you can access/print the number
  of effective system reads for a given file with a code like
  (where TFile* f is a pointer to your file)

   printf("Reading %lld bytes in %d transactions\n",f->GetBytesRead(),  f->GetReadCalls());


Function Members (Methods)

public:
virtual~TTreeCache()
voidTObject::AbstractMethod(const char* method) const
virtual Int_tAddBranch(TBranch* b, Bool_t subgbranches = kFALSE)
virtual Int_tAddBranch(const char* branch, Bool_t subbranches = kFALSE)
virtual voidTFileCacheRead::AddNoCacheBytesRead(Long64_t len)
virtual voidTFileCacheRead::AddNoCacheReadCalls(Int_t reads)
virtual voidTObject::AppendPad(Option_t* option = "")
virtual voidTObject::Browse(TBrowser* b)
static TClass*Class()
virtual const char*TObject::ClassName() const
virtual voidTObject::Clear(Option_t* = "")
virtual TObject*TObject::Clone(const char* newname = "") const
virtual voidTFileCacheRead::Close(Option_t* option = "")
virtual Int_tTObject::Compare(const TObject* obj) const
virtual voidTObject::Copy(TObject& object) const
virtual voidTObject::Delete(Option_t* option = "")MENU
virtual voidDisable()
virtual Int_tTObject::DistancetoPrimitive(Int_t px, Int_t py)
virtual voidTObject::Draw(Option_t* option = "")
virtual voidTObject::DrawClass() constMENU
virtual TObject*TObject::DrawClone(Option_t* option = "") constMENU
virtual Int_tDropBranch(TBranch* b, Bool_t subbranches = kFALSE)
virtual Int_tDropBranch(const char* branch, Bool_t subbranches = kFALSE)
virtual voidTObject::Dump() constMENU
virtual voidEnable()
virtual voidTObject::Error(const char* method, const char* msgfmt) const
virtual voidTObject::Execute(const char* method, const char* params, Int_t* error = 0)
virtual voidTObject::Execute(TMethod* method, TObjArray* params, Int_t* error = 0)
virtual voidTObject::ExecuteEvent(Int_t event, Int_t px, Int_t py)
virtual voidTObject::Fatal(const char* method, const char* msgfmt) const
virtual Bool_tFillBuffer()
virtual TObject*TObject::FindObject(const char* name) const
virtual TObject*TObject::FindObject(const TObject* obj) const
virtual Int_tTFileCacheRead::GetBufferSize() const
virtual Long64_tTFileCacheRead::GetBytesRead() const
virtual Long64_tTFileCacheRead::GetBytesReadExtra() const
const TObjArray*GetCachedBranches() const
TTreeCache::EPrefillTypeGetConfiguredPrefillType() const
virtual Option_t*TObject::GetDrawOption() const
static Long_tTObject::GetDtorOnly()
Double_tGetEfficiency() const
Double_tGetEfficiencyRel() const
virtual Int_tGetEntryMax() const
virtual Int_tGetEntryMin() const
TFile*TFileCacheRead::GetFile() const
virtual const char*TObject::GetIconName() const
static Int_tGetLearnEntries()
virtual TTreeCache::EPrefillTypeGetLearnPrefill() const
virtual const char*TObject::GetName() const
virtual Long64_tTFileCacheRead::GetNoCacheBytesRead() const
virtual Int_tTFileCacheRead::GetNoCacheReadCalls() const
Int_tTFileCacheRead::GetNseek() const
Int_tTFileCacheRead::GetNtot() const
virtual char*TObject::GetObjectInfo(Int_t px, Int_t py) const
static Bool_tTObject::GetObjectStat()
virtual Option_t*TObject::GetOption() const
Long64_tTFileCacheRead::GetPrefetchedBlocks() const
virtual TFilePrefetch*TFileCacheRead::GetPrefetchObj()
virtual Int_tTFileCacheRead::GetReadCalls() const
virtual const char*TObject::GetTitle() const
TTree*GetTree() const
virtual UInt_tTObject::GetUniqueID() const
virtual Int_tTFileCacheRead::GetUnzipBuffer(char**, Long64_t, Int_t, Bool_t*)
virtual Bool_tTObject::HandleTimer(TTimer* timer)
virtual ULong_tTObject::Hash() const
virtual voidTObject::Info(const char* method, const char* msgfmt) const
virtual Bool_tTObject::InheritsFrom(const char* classname) const
virtual Bool_tTObject::InheritsFrom(const TClass* cl) const
virtual voidTObject::Inspect() constMENU
voidTObject::InvertBit(UInt_t f)
virtual TClass*IsA() const
virtual Bool_tTFileCacheRead::IsAsyncReading() const
Bool_tIsAutoCreated() const
virtual Bool_tIsEnabled() const
virtual Bool_tTFileCacheRead::IsEnablePrefetching() const
virtual Bool_tTObject::IsEqual(const TObject* obj) const
virtual Bool_tTObject::IsFolder() const
virtual Bool_tIsLearning() const
Bool_tTObject::IsOnHeap() const
virtual Bool_tTObject::IsSortable() const
Bool_tTObject::IsZombie() const
virtual voidLearnPrefill()
virtual voidTObject::ls(Option_t* option = "") const
voidTObject::MayNotUse(const char* method) const
virtual Bool_tTObject::Notify()
voidTObject::Obsolete(const char* method, const char* asOfVers, const char* removedFromVers) const
voidTObject::operator delete(void* ptr)
voidTObject::operator delete(void* ptr, void* vp)
voidTObject::operator delete[](void* ptr)
voidTObject::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 voidTObject::Paint(Option_t* option = "")
virtual voidTObject::Pop()
virtual voidTFileCacheRead::Prefetch(Long64_t pos, Int_t len)
virtual voidPrint(Option_t* option = "") const
virtual Int_tTObject::Read(const char* name)
virtual Int_tReadBuffer(char* buf, Long64_t pos, Int_t len)
virtual Int_tTFileCacheRead::ReadBufferExt(char* buf, Long64_t pos, Int_t len, Int_t& loc)
virtual Int_tTFileCacheRead::ReadBufferExtNormal(char* buf, Long64_t pos, Int_t len, Int_t& loc)
virtual Int_tTFileCacheRead::ReadBufferExtPrefetch(char* buf, Long64_t pos, Int_t len, Int_t& loc)
virtual Int_tReadBufferNormal(char* buf, Long64_t pos, Int_t len)
virtual Int_tReadBufferPrefetch(char* buf, Long64_t pos, Int_t len)
virtual voidTObject::RecursiveRemove(TObject* obj)
voidTObject::ResetBit(UInt_t f)
virtual voidResetCache()
virtual voidTObject::SaveAs(const char* filename = "", Option_t* option = "") constMENU
virtual voidTObject::SavePrimitive(ostream& out, Option_t* option = "")
virtual voidTFileCacheRead::SecondPrefetch(Long64_t, Int_t)
virtual voidTFileCacheRead::SecondSort()
voidSetAutoCreated(Bool_t val)
voidTObject::SetBit(UInt_t f)
voidTObject::SetBit(UInt_t f, Bool_t set)
virtual Int_tSetBufferSize(Int_t buffersize)
virtual voidTObject::SetDrawOption(Option_t* option = "")MENU
static voidTObject::SetDtorOnly(void* obj)
virtual voidTFileCacheRead::SetEnablePrefetching(Bool_t setPrefetching = kFALSE)
virtual voidSetEntryRange(Long64_t emin, Long64_t emax)
virtual voidSetFile(TFile* file, TFile::ECacheAction action = TFile::kDisconnect)
static voidSetLearnEntries(Int_t n = 10)
virtual voidSetLearnPrefill(TTreeCache::EPrefillType type = kNoPrefill)
static voidTObject::SetObjectStat(Bool_t stat)
virtual voidTFileCacheRead::SetSkipZip(Bool_t = kTRUE)
virtual voidTObject::SetUniqueID(UInt_t uid)
virtual voidShowMembers(TMemberInspector& insp) const
virtual voidTFileCacheRead::Sort()
voidStartLearningPhase()
virtual voidStopLearningPhase()
virtual voidStreamer(TBuffer&)
voidStreamerNVirtual(TBuffer& ClassDef_StreamerNVirtual_b)
virtual voidTObject::SysError(const char* method, const char* msgfmt) const
Bool_tTObject::TestBit(UInt_t f) const
Int_tTObject::TestBits(UInt_t f) const
TTreeCache()
TTreeCache(TTree* tree, Int_t buffersize = 0)
virtual voidUpdateBranches(TTree* tree)
virtual voidTObject::UseCurrentStyle()
virtual voidTFileCacheRead::WaitFinishPrefetch()
virtual voidTObject::Warning(const char* method, const char* msgfmt) const
virtual Int_tTObject::Write(const char* name = 0, Int_t option = 0, Int_t bufsize = 0)
virtual Int_tTObject::Write(const char* name = 0, Int_t option = 0, Int_t bufsize = 0) const
protected:
virtual voidTObject::DoError(int level, const char* location, const char* fmt, va_list va) const
voidTObject::MakeZombie()
voidTFileCacheRead::SetEnablePrefetchingImpl(Bool_t setPrefetching = kFALSE)

Data Members

public:
static TTreeCache::EPrefillTypekAllBranches
static TObject::(anonymous)TObject::kBitMask
static TObject::EStatusBitsTObject::kCanDelete
static TObject::EStatusBitsTObject::kCannotPick
static TObject::EStatusBitsTObject::kHasUUID
static TObject::EStatusBitsTObject::kInvalidObject
static TObject::(anonymous)TObject::kIsOnHeap
static TObject::EStatusBitsTObject::kIsReferenced
static TObject::EStatusBitsTObject::kMustCleanup
static TObject::EStatusBitsTObject::kNoContextMenu
static TTreeCache::EPrefillTypekNoPrefill
static TObject::(anonymous)TObject::kNotDeleted
static TObject::EStatusBitsTObject::kObjInCanvas
static TObject::(anonymous)TObject::kOverwrite
static TObject::(anonymous)TObject::kSingleKey
static TObject::(anonymous)TObject::kWriteDelete
static TObject::(anonymous)TObject::kZombie
protected:
Bool_tTFileCacheRead::fAsyncReading
Bool_tfAutoCreated! true if cache was automatically created
Bool_tTFileCacheRead::fBIsSorted
Bool_tTFileCacheRead::fBIsTransferred
Int_t*TFileCacheRead::fBLen[fBNb]
Int_tTFileCacheRead::fBNb
Int_tTFileCacheRead::fBNseek
Int_tTFileCacheRead::fBNtot
Long64_t*TFileCacheRead::fBPos[fBNb]
Long64_t*TFileCacheRead::fBSeek[fBNseek]
Int_t*TFileCacheRead::fBSeekIndex[fBNseek]
Int_t*TFileCacheRead::fBSeekLen[fBNseek]
Int_t*TFileCacheRead::fBSeekPos[fBNseek]
Int_tTFileCacheRead::fBSeekSize
Long64_t*TFileCacheRead::fBSeekSort[fBNseek]
Int_t*TFileCacheRead::fBSeekSortLen[fBNseek]
TList*fBrNames! list of branch names in the cache
TObjArray*fBranches! List of branches to be stored in the cache
char*TFileCacheRead::fBuffer[fBufferSize] buffer of contiguous prefetched blocks
Int_tTFileCacheRead::fBufferLenCurrent buffer length (<= fBufferSize)
Int_tTFileCacheRead::fBufferSizeAllocated size of fBuffer (at a given time)
Int_tTFileCacheRead::fBufferSizeMinOriginal size of fBuffer
Long64_tTFileCacheRead::fBytesReadNumber of bytes read for this cache
Long64_tTFileCacheRead::fBytesReadExtraNumber of extra bytes (overhead) read by the readahead buffer
Bool_tTFileCacheRead::fEnablePrefetchingreading by prefetching asynchronously
Bool_tfEnabled! cache enabled for cached reading
Long64_tfEntryCurrent! current lowest entry number in the cache
Long64_tfEntryMax! last entry in the cache
Long64_tfEntryMin! first entry in the cache
Long64_tfEntryNext! next entry number where cache must be filled
TFile*TFileCacheRead::fFilePointer to file
Int_tfFillTimes! how many times we can fill the current buffer
Bool_tfFirstBuffer! true if first buffer is used for prefetching
Long64_tfFirstEntry! save the value of the first entry
Bool_tfFirstTime! save the fact that we processes the first entry
Bool_tfIsLearning! true if cache is in learning mode
Bool_tfIsManual! true if cache is StopLearningPhase was used
Bool_tTFileCacheRead::fIsSortedTrue if fSeek array is sorted
Bool_tTFileCacheRead::fIsTransferredTrue when fBuffer contains something valid
Int_t*TFileCacheRead::fLen[fNb] Length of long buffers
Int_tfNReadMissNumber of blocks read and not found in the chache
Int_tfNReadOkNumber of blocks read and found in the cache
Int_tfNReadPrefNumber of blocks that were prefetched
Int_tTFileCacheRead::fNbNumber of long buffers
Int_tfNbranches! Number of branches in the cache
Long64_tTFileCacheRead::fNoCacheBytesReadNumber of bytes read by basket to fill cached tree
Int_tTFileCacheRead::fNoCacheReadCallsNumber of read calls by basket to fill cached tree
Int_tTFileCacheRead::fNseekNumber of blocks to be prefetched
Int_tTFileCacheRead::fNtotTotal size of prefetched blocks
Bool_tfOneTime! used in the learning phase
Long64_t*TFileCacheRead::fPos[fNb] start of long buffers
TFilePrefetch*TFileCacheRead::fPrefetch! Object that does the asynchronous reading in another thread
Long64_tTFileCacheRead::fPrefetchedBlocksNumber of blocks prefetched.
TTreeCache::EPrefillTypefPrefillTypeWhether a prefilling is enabled (and if applicable which type)
Int_tTFileCacheRead::fReadCallsNumber of read calls for this cache
Bool_tfReadDirectionSet! read direction established
Bool_tfReverseRead! reading in reverse mode
Long64_t*TFileCacheRead::fSeek[fNseek] Position on file of buffers to be prefetched
Int_t*TFileCacheRead::fSeekIndex[fNseek] sorted index table of fSeek
Int_t*TFileCacheRead::fSeekLen[fNseek] Length of buffers to be prefetched
Int_t*TFileCacheRead::fSeekPos[fNseek] Position of sorted blocks in fBuffer
Int_tTFileCacheRead::fSeekSizeAllocated size of fSeek
Long64_t*TFileCacheRead::fSeekSort[fNseek] Position on file of buffers to be prefetched (sorted)
Int_t*TFileCacheRead::fSeekSortLen[fNseek] Length of buffers to be prefetched (sorted)
TTree*fTree! pointer to the current Tree
static Int_tfgLearnEntriesnumber of entries used for learning mode

Class Charts

Inheritance Chart:
TObject
TFileCacheRead
TTreeCache
TTreeCacheUnzip

Function documentation

TTreeCache()
 Default Constructor.
TTreeCache(TTree* tree, Int_t buffersize = 0)
 Constructor.
~TTreeCache()
 destructor. (in general called by the TFile destructor)
Int_t AddBranch(TBranch* b, Bool_t subgbranches = kFALSE)
add a branch to the list of branches to be stored in the cache
this function is called by TBranch::GetBasket
 Returns  0 branch added or already included
         -1 on error
Int_t AddBranch(const char* branch, Bool_t subbranches = kFALSE)
 Add a branch to the list of branches to be stored in the cache
 this is to be used by user (thats why we pass the name of the branch).
 It works in exactly the same way as TTree::SetBranchStatus so you
 probably want to look over ther for details about the use of bname
 with regular expressions.
 The branches are taken with respect to the Owner of this TTreeCache
 (i.e. the original Tree)
 NB: if bname="*" all branches are put in the cache and the learning phase stopped
 Returns  0 branch added or already included
         -1 on error
Int_t DropBranch(TBranch* b, Bool_t subbranches = kFALSE)
 Remove a branch to the list of branches to be stored in the cache
 this function is called by TBranch::GetBasket.
 Returns  0 branch dropped or not in cache
         -1 on error
Int_t DropBranch(const char* branch, Bool_t subbranches = kFALSE)
 Remove a branch to the list of branches to be stored in the cache
 this is to be used by user (thats why we pass the name of the branch).
 It works in exactly the same way as TTree::SetBranchStatus so you
 probably want to look over ther for details about the use of bname
 with regular expresions.
 The branches are taken with respect to the Owner of this TTreeCache
 (i.e. the original Tree)
 NB: if bname="*" all branches are put in the cache and the learning phase stopped
 Returns  0 branch dropped or not in cache
         -1 on error
Bool_t FillBuffer()
 Fill the cache buffer with the branches in the cache.
Double_t GetEfficiency() const
 Give the total efficiency of the cache... defined as the ratio
 of blocks found in the cache vs. the number of blocks prefetched
 ( it could be more than 1 if we read the same block from the cache more
   than once )
 Note: This should eb used at the end of the processing or we will
       get uncomplete stats
Double_t GetEfficiencyRel() const
 This will indicate a sort of relative efficiency... a ratio of the
 reads found in the cache to the number of reads so far
Int_t GetLearnEntries()
static function returning the number of entries used to train the cache
see SetLearnEntries
void Print(Option_t* option = "") const
 Print cache statistics, like
   ******TreeCache statistics for file: cms2.root ******
   Number of branches in the cache ...: 1093
   Cache Efficiency ..................: 0.997372
   Cache Efficiency Rel...............: 1.000000
   Learn entries......................: 100
   Reading............................: 72761843 bytes in 7 transactions
   Readahead..........................: 256000 bytes with overhead = 0 bytes
   Average transaction................: 10394.549000 Kbytes
   Number of blocks in current cache..: 210, total size: 6280352

 if option = "a" the list of blocks in the cache is printed
 see also class TTreePerfStats.
 if option contains 'cachedbranches', the list of branches being
 cached is printed.
Int_t ReadBufferNormal(char* buf, Long64_t pos, Int_t len)
Int_t ReadBufferPrefetch(char* buf, Long64_t pos, Int_t len)
Int_t ReadBuffer(char* buf, Long64_t pos, Int_t len)
 Read buffer at position pos if the request is in the list of
 prefetched blocks read from fBuffer.
 Otherwise try to fill the cache from the list of selected branches,
 and recheck if pos is now in the list.
 Returns
    -1 in case of read failure,
     0 in case not in cache,
     1 in case read from cache.
 This function overloads TFileCacheRead::ReadBuffer.
void ResetCache()
 This will simply clear the cache
Int_t SetBufferSize(Int_t buffersize)
 Change the underlying buffer size of the cache.
 If the change of size means some cache content is lost, or if the buffer
 is now larger, setup for a cache refill the next time there is a read
 Returns  0 if the buffer content is still available
          1 if some or all of the buffer content has been made unavailable
         -1 on error
void SetEntryRange(Long64_t emin, Long64_t emax)
 Set the minimum and maximum entry number to be processed
 this information helps to optimize the number of baskets to read
 when prefetching the branch buffers.
void SetFile(TFile* file, TFile::ECacheAction action = TFile::kDisconnect)
 Overload to make sure that the object specific
void SetLearnEntries(Int_t n = 10)
 Static function to set the number of entries to be used in learning mode
 The default value for n is 10. n must be >= 1
void SetLearnPrefill(TTreeCache::EPrefillType type = kNoPrefill)
 Set whether the learning period is started with a prefilling of the
 cache and which type of prefilling is used.
 The two value currently supported are:
   TTreeCache::kNoPrefill    disable the prefilling
   TTreeCache::kAllBranches  fill the cache with baskets from all branches.
 The default prefilling behavior can be controlled by setting
 TTreeCache.Prefill or the environment variable ROOT_TTREECACHE_PREFILL.
void StartLearningPhase()
 The name should be enough to explain the method.
 The only additional comments is that the cache is cleaned before
 the new learning phase.
void StopLearningPhase()
 This is the counterpart of StartLearningPhase() and can be used to stop
 the learning phase. It's useful when the user knows exactly what branches
 they are going to use.
 For the moment it's just a call to FillBuffer() since that method
 will create the buffer lists from the specified branches.
void UpdateBranches(TTree* tree)
 Update pointer to current Tree and recompute pointers to the branches in the cache.
void LearnPrefill()
 Perform an initial prefetch, attempting to read as much of the learning
 phase baskets for all branches at once
TTreeCache(const TTreeCache& )
TTreeCache& operator=(const TTreeCache& )
void Disable()
void Enable()
const TObjArray * GetCachedBranches() const
{ return fBranches; }
EPrefillType GetConfiguredPrefillType() const
Int_t GetEntryMin() const
{return fEntryMin;}
Int_t GetEntryMax() const
{return fEntryMax;}
EPrefillType GetLearnPrefill() const
{return fPrefillType;}
TTree * GetTree() const
{return fTree;}
Bool_t IsAutoCreated() const
{return fAutoCreated;}
Bool_t IsEnabled() const
{return fEnabled;}
Bool_t IsLearning() const
{return fIsLearning;}
void SetAutoCreated(Bool_t val)
{fAutoCreated = val;}