Major update of the physics selection and trigger analysis class
[u/mrichter/AliRoot.git] / ANALYSIS / AliPhysicsSelection.h
CommitLineData
61899827 1/* $Id: AliPhysicsSelection.h 35782 2009-10-22 11:54:31Z jgrosseo $ */
2
3#ifndef ALIPHYSICSSELECTION_H
4#define ALIPHYSICSSELECTION_H
5
6/* Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
7 * See cxx source for full Copyright notice */
8
9//-------------------------------------------------------------------------
10// Implementation of Class AliPhysicsSelection
11//
12// This class selects collision candidates from data runs, applying selection cuts on triggers
13// and background rejection based on the content of the ESD
14//
15// Origin: Jan Fiete Grosse-Oetringhaus, CERN
73cc8654 16// Michele Floris, CERN
61899827 17//-------------------------------------------------------------------------
18
296dd262 19#include <AliAnalysisCuts.h>
61899827 20#include <TList.h>
91bea6e7 21#include "TObjString.h"
141265a2 22#include "AliVEvent.h"
7c55ebd9 23#include "AliAnalysisManager.h"
61899827 24
8dec6e35 25//#define VERBOSE_STAT
73cc8654 26
61899827 27class AliESDEvent;
17ba346c 28class TH2F;
73cc8654 29class TH1F;
61899827 30class TCollection;
31class AliTriggerAnalysis;
85c71ba7 32class AliAnalysisTaskSE;
7c55ebd9 33class AliOADBPhysicsSelection ;
34class AliOADBFillingScheme ;
35class TPRegexp;
141265a2 36
296dd262 37class AliPhysicsSelection : public AliAnalysisCuts
61899827 38{
9b0cb3c3 39public:
85c71ba7 40
5f337f3d 41public:
869f9767 42 enum {kStatTriggerClass=1,kStatHWTrig,kStatV0ABG,kStatV0CBG,kStatMB1,kStatMB1Prime,kStatFMD,kStatFO1,kStatFO2,kStatFO2L1,kStatV0A,kStatV0C,kStatZDCA,kStatZDCC,kStatZDCAC,kStatZDCTime,kStatV0,kStatOffline,kStatBG,kStatAccepted};
85c71ba7 43
44#ifdef VERBOSE_STAT
8dec6e35 45 enum {kStatRowAllB=0, kStatRowAllAC, kStatRowAllE, kStatRowBG,kStatRowAcc,kStatRowBGFrac,kStatRowAccFrac,kStatRowErrGoodFrac,kStatRowGoodFrac,kStatRowErrGood,kStatRowGood}; // offset wrt fBGStatOffset
85c71ba7 46#else
8dec6e35 47 enum {kStatRowAllB=0, kStatRowAllAC, kStatRowAllE, kStatRowBG, kStatRowAcc,kStatRowGood}; // offset wrt fBGStatOffset
85c71ba7 48#endif
49
50 enum {kStatIdxAll=0,kStatIdxBin0=1};
05e1da5d 51 enum ETriggerLogic { kCINT1 = 0, kCMBS2A, kCMBS2C, kCMBAC, kCMBACS2, kHighMultL1 };
85c71ba7 52
ff097e3f 53 typedef Bool_t (*Bin0Callback_t)(const AliESDEvent *);
85c71ba7 54
55 AliPhysicsSelection();
56 virtual ~AliPhysicsSelection();
61899827 57
85c71ba7 58 // AliAnalysisCuts interface
0c6c629b 59 virtual UInt_t GetSelectionMask(const TObject* obj) { return IsCollisionCandidate((const AliESDEvent*) obj); }
85c71ba7 60 virtual Bool_t IsSelected(TList*) { return kFALSE; }
0c6c629b 61 virtual Bool_t IsSelected(TObject*) {return kFALSE;}
296dd262 62
518b6d59 63 Int_t GetCurrentRun() const {return fCurrentRun;}
0c6c629b 64 UInt_t IsCollisionCandidate(const AliESDEvent* aEsd);
1107e2ce 65 Bool_t Initialize(const AliESDEvent* aEsd);
7c55ebd9 66 Bool_t Initialize(Int_t runNumber);
decf6fd4 67
85c71ba7 68 void SetAnalyzeMC(Bool_t flag = kTRUE) { fMC = flag; }
69 void SetSkipTriggerClassSelection(Bool_t flag = kTRUE) { fSkipTriggerClassSelection = flag; }
70 void SetSkipV0(Bool_t flag=kTRUE) { fSkipV0 = flag;}
8dec6e35 71 void SetSkipZDCTime(Bool_t flag=kTRUE) { fSkipZDCTime = flag;}
91bea6e7 72
85c71ba7 73 void AddBackgroundIdentification(AliAnalysisCuts* background) { fBackgroundIdentification = background; }
296dd262 74
7c55ebd9 75 virtual void Print(const Option_t* option = "") const;
85c71ba7 76 virtual Long64_t Merge(TCollection* list);
8dec6e35 77 void SaveHistograms(const char* folder = 0);
61899827 78
85c71ba7 79 const TList* GetCollisionTriggerClasses() const { return &fCollTrigClasses; }
80 const TList* GetBGTriggerClasses() const { return &fBGTrigClasses; }
7c55ebd9 81 void AddCollisionTriggerClass(const char* className);
82 void AddBGTriggerClass(const char* className) ;
83 void SetCustomOADBObjects(AliOADBPhysicsSelection * oadbPS, AliOADBFillingScheme * oadbFS) { fPSOADB = oadbPS; fFillOADB = oadbFS; fUsingCustomClasses = kTRUE;}
84 const AliOADBPhysicsSelection * GetOADBPhysicsSelection() const {return fPSOADB; }
85 const AliOADBFillingScheme * GetOADBFillingScheme() const {return fFillOADB;}
86
87 const Int_t GetBGStatOffset() const { return fBGStatOffset; }
88
89
c3a12f21 90 AliTriggerAnalysis* GetTriggerAnalysis(Int_t i = 0) { return (fTriggerAnalysis.GetEntries() > 0) ? (AliTriggerAnalysis*) fTriggerAnalysis.At(i) : 0; }
61899827 91
85c71ba7 92 const TH2F* GetStatisticsHistogram(Int_t idx=kStatIdxAll) const { return fHistStatistics[idx]; }
93 const TH2F* GetBunchCrossingHistogram() const { return fHistBunchCrossing; }
7c55ebd9 94 virtual TObject *GetStatistics(const Option_t *option) const;
17ba346c 95
141265a2 96 void SetBIFactors(const AliESDEvent * aESD);
85c71ba7 97
98 void SetUseBXNumbers(Bool_t flag = kTRUE) {fUseBXNumbers = flag;}
141265a2 99 void SetComputeBG (UInt_t flag = AliVEvent::kMB) {fComputeBG = flag; if(flag) fUseBXNumbers = flag;}
85fc0208 100 void SetUseMuonTriggers(Bool_t) { Printf("ERROR: Use of AliPhysicsSelection::SetUseMuonTriggers is deprecated. Use AliVEvent::kMUON selection instead."); }
85c71ba7 101 void SetBin0Callback( const char * cb) {fBin0CallBack = cb;}
ff097e3f 102 void SetBin0CallbackViaPointer( Bin0Callback_t cb) {fBin0CallBackPointer = cb;}// WARNING: THIS SHOULD NOT BE USED, WILL BE REMOVED SOON
73cc8654 103
7c55ebd9 104 static const char * GetOADBFileName() { static TString filename; filename.Form("%s/COMMON/PHYSICSSELECTION/data/physicsSelection.root", AliAnalysisManager::GetOADBPath()); return filename.Data();};
105
85c71ba7 106protected:
c2ba5a61 107 UInt_t CheckTriggerClass(const AliESDEvent* aEsd, const char* trigger, Int_t& triggerLogic) const;
7c55ebd9 108 Bool_t EvaluateTriggerLogic(const AliESDEvent* aEsd, AliTriggerAnalysis* triggerAnalysis, const char* triggerLogic, Bool_t offline);
85c71ba7 109 TH2F * BookHistStatistics(const char * tag) ;
141265a2 110 Int_t GetStatRow(const char * triggerBXClass, UInt_t offlineTriggerType, UInt_t ** rowIDs) const;
7c55ebd9 111 const char * GetTriggerString(TObjString * obj);
112
85c71ba7 113
85c71ba7 114 Int_t fCurrentRun; // run number for which the object is initialized
115 Bool_t fMC; // flag if MC is analyzed
116 TList fCollTrigClasses; // trigger class identifying collision candidates
117 TList fBGTrigClasses; // trigger classes identifying background events
296dd262 118
85c71ba7 119 TList fTriggerAnalysis; // list of offline trigger objects (several are needed to keep the control histograms separate per trigger class)
61899827 120
85c71ba7 121 AliAnalysisCuts* fBackgroundIdentification; // class that performs additional background identification
61899827 122
85c71ba7 123 TH2F* fHistStatistics[2]; // how many events are cut away why {all,bin 0}
7c55ebd9 124 // TH2F* fHistStatisticsTokens; // how many events are cut away why (new version, bins for all tokens. Only used tokens are filled)
85c71ba7 125 TH2F* fHistBunchCrossing; // histograms of accepted bunch crossing numbers
73cc8654 126 TH1F* fHistTriggerPattern; // Pattern of the individual detectors in the MB1 trigger. Can reveal inconsistencies/inefficiencies in the trigger
61899827 127
85c71ba7 128 Bool_t fSkipTriggerClassSelection; // flag that determines if the trigger classs selection is skipped
129 Bool_t fUsingCustomClasses; // flag that is set if costum trigger classes are defined
130 Bool_t fSkipV0; // ignore information from v0
8dec6e35 131 Bool_t fSkipZDCTime; // ignore ZDC timing cut (used in HI)
85c71ba7 132
133 Float_t fBIFactorA; // ratio of interacting over non interacting bunch intensities for beam 1
134 Float_t fBIFactorC; // ratio of interacting over non interacting bunch intensities for beam 2
141265a2 135 Float_t fBIFactorAC; // ratio of interacting over non interacting bunch intensities for beam 1&2:
136 // for some trigger classes we do not distinguish betweem 1 and 2
85c71ba7 137
85c71ba7 138
141265a2 139 UInt_t fComputeBG; // Switch on computation of background and filling of relevant stat table entries. If you enable this you can only process one run at a time (the relative bunch intensity used to compute this chages from run to run); This is a mask of the trigger types to be used in the selection, as defined in AliVEvent
140 Int_t fBGStatOffset; // Offset of the BG statistics computed at the end of the processing. It depends on how many trigger classes you have selected
73cc8654 141 Bool_t fUseBXNumbers; // Explicitely select "good" bunch crossing numbers (exclude pilot, afterpulses and fakes). If you anable this you can only process runs within the same filling scheme.
142 Bool_t fUseMuonTriggers; // if true, also use the muon triggers
143 TString fFillingScheme; // stores the filling scheme of the current run.
85c71ba7 144
145 TString fBin0CallBack; // callback used to determine if an event is in the bin0 (name of the task where the callback is implemented);
ff097e3f 146 Bin0Callback_t fBin0CallBackPointer; //! don't stream this. TO BE REMOVED SOON
91bea6e7 147
869f9767 148 Bool_t fIsPP; // True if processing pp run, false if heavy ion
149
7c55ebd9 150 AliOADBPhysicsSelection * fPSOADB; // Physics selection OADB object
151 AliOADBFillingScheme * fFillOADB; // Filling scheme OADB object
152
153 TPRegexp* fRegexp; //! regular expression for trigger tokens
154 TList* fCashedTokens; //! trigger token lookup list
155
156 ClassDef(AliPhysicsSelection, 13)
61899827 157
85c71ba7 158 private:
159 AliPhysicsSelection(const AliPhysicsSelection&);
160 AliPhysicsSelection& operator=(const AliPhysicsSelection&);
61899827 161};
162
163#endif