ANALYSIS/AliAnalysisManager.h

   1 #ifndef ALIANALYSISMANAGER_H
   2 #define ALIANALYSISMANAGER_H
   3 /* Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
   4  * See cxx source for full Copyright notice                               */
   5
   6 /* $Id$ */
   7 // Author: Andrei Gheata, 31/05/2006
   8
   9 //==============================================================================
  10 //   AliAnalysysManager - Manager analysis class. Allows creation of several
  11 // analysis tasks and data containers storing their input/output. Allows
  12 // connecting/chaining tasks via shared data containers. Serializes the current
  13 // event for all tasks depending only on initial input data.
  14 //==============================================================================
  15
  16 #ifndef ROOT_TNamed
  17 #include <TNamed.h>
  18 #endif
  19
  20 class TClass;
  21 class TTree;
  22 class AliAnalysisDataContainer;
  23 class AliAnalysisTask;
  24 class AliVEventHandler;
  25
  26
  27 class AliAnalysisManager : public TNamed {
  28
  29 public:
  30
  31 enum EAliAnalysisContType {
  32    kExchangeContainer  = 0,
  33    kInputContainer   = 1,
  34    kOutputContainer  = 2
  35 };
  36
  37 enum EAliAnalysisExecMode {
  38    kLocalAnalysis    = 0,
  39    kProofAnalysis    = 1,
  40    kGridAnalysis     = 2
  41 };
  42
  43 enum EAliAnalysisFlags {
  44    kEventLoop        = BIT(14),
  45    kDisableBranches  = BIT(15)
  46 };
  47
  48    AliAnalysisManager();
  49    AliAnalysisManager(const char *name, const char *title="");
  50    virtual            ~AliAnalysisManager();
  51
  52    AliAnalysisManager(const AliAnalysisManager& other);
  53    AliAnalysisManager& operator=(const AliAnalysisManager& other);
  54
  55    void                StartAnalysis(const char *type="local", TTree *tree=0);
  56
  57    virtual void        Init(TTree *tree);
  58    virtual void        Begin(TTree *tree);
  59    virtual Bool_t      Notify();
  60    virtual void        SlaveBegin(TTree *tree);
  61    virtual Bool_t      ProcessCut(Long64_t entry) {return Process(entry);}
  62    virtual Bool_t      Process(Long64_t entry);
  63    virtual Int_t       GetEntry(Long64_t entry, Int_t getall = 0);
  64    void                PackOutput(TList *target);
  65    void                UnpackOutput(TList *source);
  66    virtual void        Terminate();
  67
  68    // Getters/Setters
  69    static AliAnalysisManager *GetAnalysisManager() {return fgAnalysisManager;}
  70    TObjArray          *GetContainers() const {return fContainers;}
  71    UInt_t              GetDebugLevel() const {return fDebug;}
  72    TObjArray          *GetInputs() const     {return fInputs;}
  73    TObjArray          *GetOutputs() const    {return fOutputs;}
  74    TObjArray          *GetTasks() const      {return fTasks;}
  75    TObjArray          *GetTopTasks() const   {return fTopTasks;}
  76    TTree              *GetTree() const       {return fTree;}
  77    TObjArray          *GetZombieTasks() const {return fZombies;}
  78    Long64_t            GetCurrentEntry() const {return fCurrentEntry;}
  79    EAliAnalysisExecMode
  80                        GetAnalysisType() const {return fMode;}
  81
  82    void                SetAnalysisType(EAliAnalysisExecMode mode) {fMode = mode;}
  83    void                SetCurrentEntry(Long64_t entry) {fCurrentEntry = entry;}
  84    void                SetDebugLevel(UInt_t level) {fDebug = level;}
  85    void                SetDisableBranches(Bool_t disable=kTRUE) {TObject::SetBit(kDisableBranches,disable);}
  86    void                SetOutputEventHandler(AliVEventHandler*  handler) {fOutputEventHandler  = handler;}
  87    void                SetMCtruthEventHandler(AliVEventHandler* handler) {fMCtruthEventHandler = handler;}
  88    AliVEventHandler*   GetOutputEventHandler()  {return fOutputEventHandler;}
  89    AliVEventHandler*   GetMCtruthEventHandler() {return fMCtruthEventHandler;}
  90
  91    // Container handling
  92    AliAnalysisDataContainer *CreateContainer(const char *name, TClass *datatype,
  93                        EAliAnalysisContType type     = kExchangeContainer,
  94                        const char          *filename = NULL);
  95
  96    // Including tasks and getting them
  97    void                 AddTask(AliAnalysisTask *task);
  98    AliAnalysisTask     *GetTask(const char *name) const;
  99
 100    // Connecting data containers to task inputs/outputs
 101    Bool_t               ConnectInput(AliAnalysisTask *task, Int_t islot,
 102                                      AliAnalysisDataContainer *cont);
 103    Bool_t               ConnectOutput(AliAnalysisTask *task, Int_t islot,
 104                                      AliAnalysisDataContainer *cont);
 105    // Garbage collection
 106    void                 CleanContainers();
 107
 108    // Analysis initialization and execution, status
 109    Bool_t               InitAnalysis();
 110    Bool_t               IsInitialized() const {return fInitOK;}
 111    Bool_t               IsEventLoop() const {return TObject::TestBit(kEventLoop);}
 112    void                 ResetAnalysis();
 113    void                 ExecAnalysis(Option_t *option="");
 114    void                 FinishAnalysis();
 115    void                 PrintStatus(Option_t *option="all") const;
 116
 117 protected:
 118    void                 ImportWrappers(TList *source);
 119    void                 SetEventLoop(Bool_t flag=kTRUE) {TObject::SetBit(kEventLoop,flag);}
 120
 121 private:
 122    TTree                  *fTree;                //! Input tree in case of TSelector model
 123    AliVEventHandler       *fOutputEventHandler;  //  Optional common output event handler
 124    AliVEventHandler       *fMCtruthEventHandler; //  Optional common MC Truth event handler
 125    Long64_t                fCurrentEntry;        //! Current processed entry in the tree
 126    EAliAnalysisExecMode    fMode;                // Execution mode
 127    Bool_t                  fInitOK;              // Initialisation done
 128    UInt_t                  fDebug;               // Debug level
 129    TObjArray              *fTasks;               // List of analysis tasks
 130    TObjArray              *fTopTasks;            // List of top tasks
 131    TObjArray              *fZombies;             // List of zombie tasks
 132    TObjArray              *fContainers;          // List of all containers
 133    TObjArray              *fInputs;              // List of containers with input data
 134    TObjArray              *fOutputs;             // List of containers with results
 135
 136    static AliAnalysisManager *fgAnalysisManager; //! static pointer to object instance
 137    ClassDef(AliAnalysisManager,1)  // Analysis manager class
 138 };
 139 #endif