[u/mrichter/AliRoot.git] / ANALYSIS / AliAnalysisManager.h

#ifndef ALIANALYSISMANAGER_H
#define ALIANALYSISMANAGER_H
/* Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
 * See cxx source for full Copyright notice                               */

/* $Id$ */
// Author: Andrei Gheata, 31/05/2006

//==============================================================================
//   AliAnalysysManager - Manager analysis class. Allows creation of several
// analysis tasks and data containers storing their input/output. Allows 
// connecting/chaining tasks via shared data containers. Serializes the current
// event for all tasks depending only on initial input data.
//==============================================================================

#ifndef ROOT_TNamed
#include <TNamed.h>
#endif

class TClass;
class TTree;
class TFile;
class TStopwatch;
class AliAnalysisSelector;
class AliAnalysisDataContainer;
class AliAnalysisTask;
class AliVEventHandler;
class AliVEventPool;
class AliAnalysisGrid;


class AliAnalysisManager : public TNamed {

public:

enum EAliAnalysisContType {
   kExchangeContainer  = 0,   // use to exchange data between tasks
   kInputContainer     = 1,   // use for the task private input data
   kOutputContainer    = 2,   // use for the task private output data
   kParamContainer     = 3    // use for storing task private parameters/cuts per analysis session
};   

enum EAliAnalysisExecMode {
   kLocalAnalysis    = 0,
   kProofAnalysis    = 1,
   kGridAnalysis     = 2,
   kMixingAnalysis   = 3
};

enum EAliAnalysisFlags {
   kEventLoop        = BIT(14),
   kDisableBranches  = BIT(15),
   kUseDataSet       = BIT(16),
   kSaveCanvases     = BIT(17),
   kExternalLoop     = BIT(18),
   kSkipTerminate    = BIT(19)
};   

   AliAnalysisManager(const char *name = "mgr", const char *title="");
   virtual            ~AliAnalysisManager();

   AliAnalysisManager(const AliAnalysisManager& other);
   AliAnalysisManager& operator=(const AliAnalysisManager& other);
   
   // Event loop control
   virtual Int_t       GetEntry(Long64_t entry, Int_t getall = 0);
   virtual Bool_t      Init(TTree *tree);   
   virtual Bool_t      Notify();
   virtual Bool_t      ProcessCut(Long64_t entry) {return Process(entry);}
   virtual Bool_t      Process(Long64_t entry);
   TFile              *OpenProofFile(AliAnalysisDataContainer *cont, const char *option);
   static TFile       *OpenFile(AliAnalysisDataContainer *cont, const char *option, Bool_t ignoreProof=kFALSE);
   void                PackOutput(TList *target);
   void                RegisterExtraFile(const char *fname);
   Long64_t            StartAnalysis(const char *type="local", TTree *tree=0, Long64_t nentries=1234567890, Long64_t firstentry=0);
   Long64_t            StartAnalysis(const char *type, const char *dataset, Long64_t nentries=1234567890, Long64_t firstentry=0);
   virtual void        SlaveBegin(TTree *tree);
   virtual void        Terminate();
   void                UnpackOutput(TList *source);

   // Getters/Setters
   static AliAnalysisManager *GetAnalysisManager() {return fgAnalysisManager;}
   EAliAnalysisExecMode 
                       GetAnalysisType() const    {return fMode;}
   void                GetAnalysisTypeString(TString &type) const;                    
   static const char  *GetCommonFileName()        {return fgCommonFileName.Data();}
   AliAnalysisDataContainer *
                       GetCommonInputContainer()  {return fCommonInput;}
   AliAnalysisDataContainer *
                       GetCommonOutputContainer() {return fCommonOutput;}
   TObjArray          *GetContainers() const      {return fContainers;}
   Long64_t            GetCurrentEntry() const    {return fCurrentEntry;}
   UInt_t              GetDebugLevel() const      {return fDebug;}
   TString             GetExtraFiles() const      {return fExtraFiles;}
   AliVEventPool*      GetEventPool()             {return fEventPool;}
   Bool_t              GetFileFromWrapper(const char *filename, TList *source);
   AliAnalysisGrid*    GetGridHandler()           {return fGridHandler;}
   TObjArray          *GetInputs() const          {return fInputs;}
   AliVEventHandler*   GetInputEventHandler()     {return fInputEventHandler;}
   AliVEventHandler*   GetMCtruthEventHandler()   {return fMCtruthEventHandler;}
   AliVEventHandler*   GetOutputEventHandler()    {return fOutputEventHandler;}
   TObjArray          *GetOutputs() const         {return fOutputs;}
   TObjArray          *GetTasks() const           {return fTasks;}
   TObjArray          *GetTopTasks() const        {return fTopTasks;}
   TTree              *GetTree() const            {return fTree;}
   TObjArray          *GetZombieTasks() const     {return fZombies;}
   Bool_t              IsUsingDataSet() const     {return TObject::TestBit(kUseDataSet);}
   void                SetAnalysisType(EAliAnalysisExecMode mode) {fMode = mode;}
   void                SetCurrentEntry(Long64_t entry)            {fCurrentEntry = entry;}
   void                SetCollectSysInfoEach(Int_t nevents=0)     {fNSysInfo = nevents;}
   static void         SetCommonFileName(const char *name)        {fgCommonFileName = name;}
   void                SetDebugLevel(UInt_t level)                {fDebug = level;}
   void                SetDisableBranches(Bool_t disable=kTRUE)   {TObject::SetBit(kDisableBranches,disable);}
   void                SetExternalLoop(Bool_t flag)               {TObject::SetBit(kExternalLoop,flag);}
   void                SetEventPool(AliVEventPool* epool)         {fEventPool = epool;}
   void                SetGridHandler(AliAnalysisGrid *handler)   {fGridHandler = handler;}
   void                SetInputEventHandler(AliVEventHandler*  handler);
   void                SetMCtruthEventHandler(AliVEventHandler* handler) {fMCtruthEventHandler = handler;}
   void                SetNSysInfo(Long64_t nevents)              {fNSysInfo = nevents;}
   void                SetOutputEventHandler(AliVEventHandler*  handler);
   void                SetSelector(AliAnalysisSelector *sel)      {fSelector = sel;}
   void                SetSaveCanvases(Bool_t flag=kTRUE)         {TObject::SetBit(kSaveCanvases,flag);}
   void                SetSkipTerminate(Bool_t flag)              {TObject::SetBit(kSkipTerminate,flag);}
   void                SetSpecialOutputLocation(const char *loc)  {fSpecialOutputLocation = loc;}

   // Container handling
   AliAnalysisDataContainer *CreateContainer(const char *name, TClass *datatype, 
                       EAliAnalysisContType type     = kExchangeContainer, 
                       const char          *filename = NULL);
   
   // Including tasks and getting them
   void                 AddTask(AliAnalysisTask *task);
   AliAnalysisTask     *GetTask(const char *name) const;
   
   // Connecting data containers to task inputs/outputs
   Bool_t               ConnectInput(AliAnalysisTask *task, Int_t islot,
                                     AliAnalysisDataContainer *cont);
   Bool_t               ConnectOutput(AliAnalysisTask *task, Int_t islot,
                                     AliAnalysisDataContainer *cont);
   // Garbage collection
   void                 CleanContainers();
   
   // Analysis initialization and execution, status
   Bool_t               InitAnalysis();
   Bool_t               IsInitialized() const {return fInitOK;}
   Bool_t               IsExternalLoop() const {return TObject::TestBit(kExternalLoop);}
   Bool_t               IsEventLoop() const {return TObject::TestBit(kEventLoop);}
   Bool_t               IsSkipTerminate() const {return TObject::TestBit(kSkipTerminate);}
   void                 ResetAnalysis();
   void                 ExecAnalysis(Option_t *option="");
   void                 FinishAnalysis();
   void                 PrintStatus(Option_t *option="all") const;
   void                 ProfileTask(const char *name, const char *option="VM") const;
   void                 ProfileTask(Int_t itop, const char *option="VM") const;
   static void          ProgressBar(const char *opname, Long64_t current, Long64_t size, TStopwatch *watch=0, Bool_t last=kFALSE, Bool_t refresh=kFALSE);
   Bool_t               ValidateOutputFiles() const;

protected:
   void                 ImportWrappers(TList *source);
   void                 SetEventLoop(Bool_t flag=kTRUE) {TObject::SetBit(kEventLoop,flag);}

private:
   TTree                  *fTree;                //! Input tree in case of TSelector model
   AliVEventHandler       *fInputEventHandler;   //  Optional common input  event handler
   AliVEventHandler       *fOutputEventHandler;  //  Optional common output event handler
   AliVEventHandler       *fMCtruthEventHandler; //  Optional common MC Truth event handler
   AliVEventPool          *fEventPool;           //  Event pool for mixing analysis
   Long64_t                fCurrentEntry;        //! Current processed entry in the tree
   Long64_t                fNSysInfo;            // Event frequency for collecting system information
   EAliAnalysisExecMode    fMode;                // Execution mode
   Bool_t                  fInitOK;              // Initialisation done
   UInt_t                  fDebug;               // Debug level
   TString                 fSpecialOutputLocation; // URL/path where the special outputs will be copied
   TObjArray              *fTasks;               // List of analysis tasks
   TObjArray              *fTopTasks;            // List of top tasks
   TObjArray              *fZombies;             // List of zombie tasks
   TObjArray              *fContainers;          // List of all containers
   TObjArray              *fInputs;              // List of containers with input data
   TObjArray              *fOutputs;             // List of containers with results
   TObjArray              *fParamCont;           //! List of containers with results
   AliAnalysisDataContainer *fCommonInput;       // Common input container
   AliAnalysisDataContainer *fCommonOutput;      // Common output container
   AliAnalysisSelector    *fSelector;            //! Current selector
   AliAnalysisGrid        *fGridHandler;         //! Grid handler plugin
   TString                 fExtraFiles;          // List of extra files to be merged

   static TString          fgCommonFileName;     //! Common output file name (not streamed)
   static AliAnalysisManager *fgAnalysisManager; //! static pointer to object instance
   ClassDef(AliAnalysisManager,6)  // Analysis manager class
};   
#endif
Commit	Line	Data
d3106602	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
c52c2132	16	#ifndef ROOT_TNamed
c52c2132	17	#include <TNamed.h>
d3106602	18	#endif
	19
	20	class TClass;
c52c2132	21	class TTree;
8d7d3b59	22	class TFile;
cd11251e	23	class TStopwatch;
8d7d3b59	24	class AliAnalysisSelector;
d3106602	25	class AliAnalysisDataContainer;
d3106602	26	class AliAnalysisTask;
d2f1d9ef	27	class AliVEventHandler;
c2922515	28	class AliVEventPool;
c57f56b7	29	class AliAnalysisGrid;
8c9485b2	30
d3106602	31
c52c2132	32	class AliAnalysisManager : public TNamed {
d3106602	33
	34	public:
	35
	36	enum EAliAnalysisContType {
6cd44ee0	37	kExchangeContainer = 0, // use to exchange data between tasks
	38	kInputContainer = 1, // use for the task private input data
	39	kOutputContainer = 2, // use for the task private output data
	40	kParamContainer = 3 // use for storing task private parameters/cuts per analysis session
d3106602	41	};
c52c2132	42
	43	enum EAliAnalysisExecMode {
	44	kLocalAnalysis = 0,
	45	kProofAnalysis = 1,
aee5ee44	46	kGridAnalysis = 2,
aee5ee44	47	kMixingAnalysis = 3
c52c2132	48	};
c52c2132	49
efd53803	50	enum EAliAnalysisFlags {
b1310ef5	51	kEventLoop = BIT(14),
d86ed856	52	kDisableBranches = BIT(15),
a0e2e8b1	53	kUseDataSet = BIT(16),
06a59280	54	kSaveCanvases = BIT(17),
90a4b3ee	55	kExternalLoop = BIT(18),
90a4b3ee	56	kSkipTerminate = BIT(19)
efd53803	57	};
efd53803	58
6e14aaa2	59	AliAnalysisManager(const char name = "mgr", const char title="");
d3106602	60	virtual ~AliAnalysisManager();
c52c2132	61
	62	AliAnalysisManager(const AliAnalysisManager& other);
	63	AliAnalysisManager& operator=(const AliAnalysisManager& other);
d3106602	64
06a59280	65	// Event loop control
06a59280	66	virtual Int_t GetEntry(Long64_t entry, Int_t getall = 0);
2d626244	67	virtual Bool_t Init(TTree *tree);
327eaf46	68	virtual Bool_t Notify();
327eaf46	69	virtual Bool_t ProcessCut(Long64_t entry) {return Process(entry);}
d3106602	70	virtual Bool_t Process(Long64_t entry);
84fcd93f	71	TFile OpenProofFile(AliAnalysisDataContainer cont, const char *option);
84fcd93f	72	static TFile OpenFile(AliAnalysisDataContainer cont, const char *option, Bool_t ignoreProof=kFALSE);
c52c2132	73	void PackOutput(TList *target);
06a59280	74	void RegisterExtraFile(const char *fname);
1f87e9fb	75	Long64_t StartAnalysis(const char type="local", TTree tree=0, Long64_t nentries=1234567890, Long64_t firstentry=0);
1f87e9fb	76	Long64_t StartAnalysis(const char type, const char dataset, Long64_t nentries=1234567890, Long64_t firstentry=0);
06a59280	77	virtual void SlaveBegin(TTree *tree);
d3106602	78	virtual void Terminate();
06a59280	79	void UnpackOutput(TList *source);
d3106602	80
c52c2132	81	// Getters/Setters
c52c2132	82	static AliAnalysisManager *GetAnalysisManager() {return fgAnalysisManager;}
c52c2132	83	EAliAnalysisExecMode
06a59280	84	GetAnalysisType() const {return fMode;}
d29168d6	85	void GetAnalysisTypeString(TString &type) const;
06a59280	86	static const char *GetCommonFileName() {return fgCommonFileName.Data();}
	87	AliAnalysisDataContainer *
	88	GetCommonInputContainer() {return fCommonInput;}
	89	AliAnalysisDataContainer *
	90	GetCommonOutputContainer() {return fCommonOutput;}
	91	TObjArray *GetContainers() const {return fContainers;}
	92	Long64_t GetCurrentEntry() const {return fCurrentEntry;}
	93	UInt_t GetDebugLevel() const {return fDebug;}
	94	TString GetExtraFiles() const {return fExtraFiles;}
	95	AliVEventPool* GetEventPool() {return fEventPool;}
	96	Bool_t GetFileFromWrapper(const char filename, TList source);
	97	AliAnalysisGrid* GetGridHandler() {return fGridHandler;}
	98	TObjArray *GetInputs() const {return fInputs;}
	99	AliVEventHandler* GetInputEventHandler() {return fInputEventHandler;}
	100	AliVEventHandler* GetMCtruthEventHandler() {return fMCtruthEventHandler;}
	101	AliVEventHandler* GetOutputEventHandler() {return fOutputEventHandler;}
	102	TObjArray *GetOutputs() const {return fOutputs;}
	103	TObjArray *GetTasks() const {return fTasks;}
	104	TObjArray *GetTopTasks() const {return fTopTasks;}
	105	TTree *GetTree() const {return fTree;}
	106	TObjArray *GetZombieTasks() const {return fZombies;}
06a59280	107	Bool_t IsUsingDataSet() const {return TObject::TestBit(kUseDataSet);}
c52c2132	108	void SetAnalysisType(EAliAnalysisExecMode mode) {fMode = mode;}
06a59280	109	void SetCurrentEntry(Long64_t entry) {fCurrentEntry = entry;}
	110	void SetCollectSysInfoEach(Int_t nevents=0) {fNSysInfo = nevents;}
	111	static void SetCommonFileName(const char *name) {fgCommonFileName = name;}
	112	void SetDebugLevel(UInt_t level) {fDebug = level;}
	113	void SetDisableBranches(Bool_t disable=kTRUE) {TObject::SetBit(kDisableBranches,disable);}
	114	void SetExternalLoop(Bool_t flag) {TObject::SetBit(kExternalLoop,flag);}
	115	void SetEventPool(AliVEventPool* epool) {fEventPool = epool;}
	116	void SetGridHandler(AliAnalysisGrid *handler) {fGridHandler = handler;}
60a04972	117	void SetInputEventHandler(AliVEventHandler* handler);
d2f1d9ef	118	void SetMCtruthEventHandler(AliVEventHandler* handler) {fMCtruthEventHandler = handler;}
06a59280	119	void SetNSysInfo(Long64_t nevents) {fNSysInfo = nevents;}
	120	void SetOutputEventHandler(AliVEventHandler* handler);
	121	void SetSelector(AliAnalysisSelector *sel) {fSelector = sel;}
	122	void SetSaveCanvases(Bool_t flag=kTRUE) {TObject::SetBit(kSaveCanvases,flag);}
90a4b3ee	123	void SetSkipTerminate(Bool_t flag) {TObject::SetBit(kSkipTerminate,flag);}
06a59280	124	void SetSpecialOutputLocation(const char *loc) {fSpecialOutputLocation = loc;}
d3106602	125
	126	// Container handling
	127	AliAnalysisDataContainer CreateContainer(const char name, TClass *datatype,
c52c2132	128	EAliAnalysisContType type = kExchangeContainer,
c52c2132	129	const char *filename = NULL);
d3106602	130
	131	// Including tasks and getting them
	132	void AddTask(AliAnalysisTask *task);
	133	AliAnalysisTask GetTask(const char name) const;
	134
	135	// Connecting data containers to task inputs/outputs
	136	Bool_t ConnectInput(AliAnalysisTask *task, Int_t islot,
	137	AliAnalysisDataContainer *cont);
	138	Bool_t ConnectOutput(AliAnalysisTask *task, Int_t islot,
	139	AliAnalysisDataContainer *cont);
	140	// Garbage collection
	141	void CleanContainers();
	142
	143	// Analysis initialization and execution, status
	144	Bool_t InitAnalysis();
	145	Bool_t IsInitialized() const {return fInitOK;}
90a4b3ee	146	Bool_t IsExternalLoop() const {return TObject::TestBit(kExternalLoop);}
efd53803	147	Bool_t IsEventLoop() const {return TObject::TestBit(kEventLoop);}
90a4b3ee	148	Bool_t IsSkipTerminate() const {return TObject::TestBit(kSkipTerminate);}
d3106602	149	void ResetAnalysis();
	150	void ExecAnalysis(Option_t *option="");
	151	void FinishAnalysis();
	152	void PrintStatus(Option_t *option="all") const;
096b5a2e	153	void ProfileTask(const char name, const char option="VM") const;
096b5a2e	154	void ProfileTask(Int_t itop, const char *option="VM") const;
cd11251e	155	static void ProgressBar(const char opname, Long64_t current, Long64_t size, TStopwatch watch=0, Bool_t last=kFALSE, Bool_t refresh=kFALSE);
923e2ca5	156	Bool_t ValidateOutputFiles() const;
d3106602	157
d3106602	158	protected:
981f2614	159	void ImportWrappers(TList *source);
efd53803	160	void SetEventLoop(Bool_t flag=kTRUE) {TObject::SetBit(kEventLoop,flag);}
d3106602	161
5daf9fd2	162	private:
6bb2b24f	163	TTree *fTree; //! Input tree in case of TSelector model
54cff064	164	AliVEventHandler *fInputEventHandler; // Optional common input event handler
d2f1d9ef	165	AliVEventHandler *fOutputEventHandler; // Optional common output event handler
d2f1d9ef	166	AliVEventHandler *fMCtruthEventHandler; // Optional common MC Truth event handler
c2922515	167	AliVEventPool *fEventPool; // Event pool for mixing analysis
6bb2b24f	168	Long64_t fCurrentEntry; //! Current processed entry in the tree
8c0ab8e8	169	Long64_t fNSysInfo; // Event frequency for collecting system information
6bb2b24f	170	EAliAnalysisExecMode fMode; // Execution mode
	171	Bool_t fInitOK; // Initialisation done
	172	UInt_t fDebug; // Debug level
13ef3bb0	173	TString fSpecialOutputLocation; // URL/path where the special outputs will be copied
6bb2b24f	174	TObjArray *fTasks; // List of analysis tasks
	175	TObjArray *fTopTasks; // List of top tasks
	176	TObjArray *fZombies; // List of zombie tasks
	177	TObjArray *fContainers; // List of all containers
	178	TObjArray *fInputs; // List of containers with input data
	179	TObjArray *fOutputs; // List of containers with results
6cd44ee0	180	TObjArray *fParamCont; //! List of containers with results
60a04972	181	AliAnalysisDataContainer *fCommonInput; // Common input container
60a04972	182	AliAnalysisDataContainer *fCommonOutput; // Common output container
8d7d3b59	183	AliAnalysisSelector *fSelector; //! Current selector
c57f56b7	184	AliAnalysisGrid *fGridHandler; //! Grid handler plugin
c9e39043	185	TString fExtraFiles; // List of extra files to be merged
5daf9fd2	186
84fcd93f	187	static TString fgCommonFileName; //! Common output file name (not streamed)
c52c2132	188	static AliAnalysisManager *fgAnalysisManager; //! static pointer to object instance
6cd44ee0	189	ClassDef(AliAnalysisManager,6) // Analysis manager class
d3106602	190	};
d3106602	191	#endif