TOF readout efficiency measurements added to TOF reconstruction (both data and MC...
[u/mrichter/AliRoot.git] / TOF / AliTOFcalib.h
1 #ifndef ALITOFCALIB_H
2 #define ALITOFCALIB_H
3
4 /* Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
5  * See cxx source for full Copyright notice                               */
6
7 //////////////////////////////////////////////////////////////////
8 //  class for TOF calibration:: simulation of uncalibrated data //
9 //////////////////////////////////////////////////////////////////
10
11 #define CHENTRIESSMALL       300   // number of entries per TOF channel per run
12                                    // (to be divided by 3 to get the 
13                                    // real number of entries), smallarray 
14 #define MAXCHENTRIESSMALL  10000   // max number of entries per TOF channel 
15                                    // (to be divided by 3 to get the 
16                                    // real number of entries), smallarray 
17                                    
18 #define NIDXSMALL              3   // number of values stored 
19                                    // after Comb PID per ESD track
20 #define DELTAIDXTOT            0   // index for ToT in bigarray
21 #define DELTAIDXTIME           1   // index for TOF time in big/smallarray
22 #define DELTAIDXPID            2   // index for Exp Time after Comb PID 
23                                    // in smallarray
24 #define MEANENTRIES           15   // Mean number of entries per channel 
25                                    // to perform calibration
26
27 #include "TTask.h"
28
29 class TArrayF;
30 class TF1;
31 class TH1F;
32 class TObjArray;
33 class TTree;
34 class TChain;
35 class TMap;
36
37 //class AliESD;
38
39 class AliTOFCal;
40 class AliTOFRecoParam;
41 class AliTOFChannelOnlineStatusArray;
42 class AliTOFChannelOnlineArray;
43 class AliTOFDeltaBCOffset;
44 class AliTOFCTPLatency;
45 class AliTOFT0Fill;
46 class AliTOFRunParams;
47 class AliTOFResponseParams;
48 class AliESDEvent;
49
50 class AliTOFcalib:public TTask{
51 public:
52   AliTOFcalib();          // ctor
53   AliTOFcalib(const AliTOFcalib & calib); // copy constructor
54   AliTOFcalib& operator=(const AliTOFcalib & calib); // assignment operator
55   virtual ~AliTOFcalib() ; // dtor
56   void CreateCalArrays();
57   void CreateCalObjects();
58   TObjArray * GetTOFCalArrayOnline() const {return fTOFCalOnline;}
59   AliTOFChannelOnlineArray * GetTOFOnlineDelay() const {return fCal;}
60   AliTOFChannelOnlineStatusArray * GetTOFOnlineStatus() const {return fStatus;}
61   TObjArray * GetTOFCalArrayOnlinePulser() const {return fTOFCalOnlinePulser;}
62   TObjArray * GetTOFCalArrayOnlineNoise() const {return fTOFCalOnlineNoise;}
63   TObjArray * GetTOFCalArrayOnlineHW() const {return fTOFCalOnlineHW;}
64   TObjArray * GetTOFCalArrayOffline() const {return fTOFCalOffline;}
65   TMap * GetConfigMap() const {return fConfigMap;}
66   TH1F * GetTOFSimToT() const {return fTOFSimToT;}
67   TTree * GetTOFCalibTree() const {return fTree;}
68   TChain * GetTOFCalibChain() const {return fChain;}
69   const char * GetOfflineValidity() const {return fkValidity;}
70   void SetOfflineValidity(const char* validity) {fkValidity = validity;}
71   Int_t NChannels()const{return fNChannels;}
72
73   void CreateDeltaBCOffset();
74   void CreateCTPLatency();
75   void CreateT0Fill();
76   void CreateRunParams();
77   AliTOFDeltaBCOffset *GetDeltaBCOffset() const {return fDeltaBCOffset;};
78   AliTOFCTPLatency *GetCTPLatency() const {return fCTPLatency;};
79   AliTOFT0Fill *GetT0Fill() const {return fT0Fill;};
80   AliTOFRunParams *GetRunParams() const {return fRunParams;};
81   AliTOFResponseParams *GetResponseParams() const {return fResponseParams;};
82
83   // Methods to retrieve/write parameters from/on CDB
84   // writing
85
86   void WriteSimHistoOnCDB(const Char_t *sel, Int_t minrun, Int_t maxrun, TH1F *histo);
87   void WriteConfigMapOnCDB(const Char_t *sel, Int_t minrun, Int_t maxrun);
88   void WriteConfigMapOnCDB(const Char_t *sel);
89   // new calib objs
90   void WriteParOnlineDelayOnCDB(const Char_t *sel, Int_t minrun, Int_t maxrun);
91   void WriteParOnlineStatusOnCDB(const Char_t *sel, Int_t minrun, Int_t maxrun);
92   void WriteParOnlineDelayOnCDB(const Char_t *sel);
93   void WriteParOnlineStatusOnCDB(const Char_t *sel);
94   // old calib objs
95   void WriteParOnlineOnCDB(const Char_t *sel, Int_t minrun, Int_t maxrun);
96   void WriteParOnlinePulserOnCDB(const Char_t *sel, Int_t minrun, Int_t maxrun);
97   void WriteParOnlineNoiseOnCDB(const Char_t *sel, Int_t minrun, Int_t maxrun);
98   void WriteParOnlineHWOnCDB(const Char_t *sel, Int_t minrun, Int_t maxrun);
99   void WriteParOfflineOnCDB(const Char_t *sel, const Char_t *validity, Int_t minrun, Int_t maxrun);
100   void WriteParOnlineOnCDB(const Char_t *sel);
101   void WriteParOnlinePulserOnCDB(const Char_t *sel);  // old, before unification of status info
102   void WriteParOnlineNoiseOnCDB(const Char_t *sel);   // old, before unification of status info
103   void WriteParOnlineHWOnCDB(const Char_t *sel);      // old, before unification of status info
104   void WriteParOfflineOnCDB(const Char_t *sel, const Char_t *validity);
105
106   void WriteDeltaBCOffsetOnCDB(const Char_t *sel, Int_t minrun, Int_t maxrun);
107   void WriteCTPLatencyOnCDB(const Char_t *sel, Int_t minrun, Int_t maxrun);
108   void WriteT0FillOnCDB(const Char_t *sel, Int_t minrun, Int_t maxrun);
109   void WriteRunParamsOnCDB(const Char_t *sel, Int_t minrun, Int_t maxrun);
110   void WriteReadoutEfficiencyOnCDB(const Char_t *sel, Int_t minrun, Int_t maxrun);
111
112   // reading
113   Bool_t ReadSimHistoFromCDB(const Char_t *sel, Int_t nrun);
114   Bool_t ReadConfigMapFromCDB(const Char_t *sel, Int_t nrun);
115   // new objs
116   Bool_t ReadParOnlineDelayFromCDB(const Char_t *sel, Int_t nrun);
117   Bool_t ReadParOnlineStatusFromCDB(const Char_t *sel, Int_t nrun);
118   // old objs
119   Bool_t ReadParOnlineFromCDB(const Char_t *sel, Int_t nrun);
120   Bool_t ReadParOnlinePulserFromCDB(const Char_t *sel, Int_t nrun);  // old, before unification of status info
121   Bool_t ReadParOnlineNoiseFromCDB(const Char_t *sel, Int_t nrun);   // old, before unification of status info
122   Bool_t ReadParOnlineHWFromCDB(const Char_t *sel, Int_t nrun);      // old, before unification of status info
123   Bool_t ReadParOfflineFromCDB(const Char_t *sel, Int_t nrun);
124   void WriteRecParOnCDB(const Char_t *sel, Int_t minrun, Int_t maxrun, AliTOFRecoParam *param);
125   void WriteRecParOnCDB(const Char_t *sel, Int_t minrun, Int_t maxrun, TObjArray *arr);
126   AliTOFRecoParam * ReadRecParFromCDB(const Char_t *sel, Int_t nrun, Int_t eventType=0);
127   void CreateTreeFromCDB(Int_t minrun, Int_t maxrun);
128   void CreateTreeFromFile(Int_t minrun, Int_t maxrun);
129   void CreateTreeFromGrid(Int_t minrun, Int_t maxrun);
130   void CreateChainFromGrid(Int_t minrun, Int_t maxrun);
131   Int_t Calibrate(Option_t *optionSave="", Option_t *optionFit="RQ");
132   Int_t Calibrate(Int_t nch,Int_t *ich, Option_t *optionSave="", Option_t *optionFit="RQ");
133   Int_t Calibrate(Int_t ichmin, Int_t ichmax, Option_t *optionSave="", Option_t *optionFit="RQ");
134   Int_t Calibrate(Int_t ich, Option_t *optionSave="", Option_t *optionFit="RQ");
135   Int_t CalibrateFromProfile(Int_t ich, Option_t *optionSave="", Option_t *optionFit="RQ");
136   TH1F* Profile(Int_t i);
137   Int_t FindBins (TH1F* h, Double_t *bins) const;
138   void SetNruns(Int_t nruns) {fNruns=nruns;}
139   Int_t GetNruns() const {return fNruns;}
140   void SetFirstRun(Int_t firstRun) {fFirstRun=firstRun;}
141   Int_t GetFirstRun() const {return fFirstRun;}
142   void SetLastRun(Int_t lastRun) {fLastRun=lastRun;}
143   Int_t GetLastRun() const {return fLastRun;}
144
145   Bool_t ReadDeltaBCOffsetFromCDB(const Char_t *sel, Int_t nrun);
146   Bool_t ReadCTPLatencyFromCDB(const Char_t *sel, Int_t nrun);
147   Bool_t ReadT0FillFromCDB(const Char_t *sel, Int_t nrun);
148   Bool_t ReadRunParamsFromCDB(const Char_t *sel, Int_t nrun);
149   Bool_t ReadReadoutEfficiencyFromCDB(const Char_t *sel, Int_t nrun);
150
151   Bool_t Init(Int_t run = -1); // init
152   Double_t GetTimeCorrection(Int_t index, Double_t tot, Int_t deltaBC, Int_t l0l1, UInt_t timestamp); // get time correction
153   void CalibrateESD(AliESDEvent *event); // calibrate ESD
154   void CalibrateTExp(AliESDEvent *event) const; // calibrate TExp
155   void SetRemoveMeanT0(Bool_t value) {fRemoveMeanT0 = value;}; // setter
156   void SetCalibrateTOFsignal(Bool_t value) {fCalibrateTOFsignal = value;}; // setter
157   void SetCorrectTExp(Bool_t value) {fCorrectTExp = value;}; // setter
158   Bool_t IsChannelEnabled(Int_t index, Bool_t checkEfficiency = kTRUE); // is channel enabled
159   Bool_t IsChannelEfficient(Int_t index); // is channel efficient
160
161 private:
162   Int_t fNChannels; // number of TOF channels
163
164   // old calibration objects
165   TObjArray *fTOFCalOnline;       // array of AliTOFChannels storing calib parameters
166   TObjArray *fTOFCalOnlinePulser; // array of AliTOFChannels storing calib status from pulser   // old, before unification of status info
167   TObjArray *fTOFCalOnlineNoise;  // array of AliTOFChannels storing calib status from noise    // old, before unification of status info
168   TObjArray *fTOFCalOnlineHW;  // array of AliTOFChannels storing calib status from hardware    // old, before unification of status info
169   TObjArray *fTOFCalOffline;       // array of AliTOFChannels storing calib parameters
170
171   // new calibration objects
172   AliTOFChannelOnlineArray *fCal; // object with delay array for TOF channels
173   AliTOFChannelOnlineStatusArray *fStatus; // object with status array for TOF channels
174
175   TH1F *fTOFSimToT;        // histo with realistic ToT signal from TB Data
176   const char *fkValidity;  // validity for offline calibration object
177   TTree *fTree;            // tree for TOF calibration
178   TChain *fChain;          // chain for TOF calibration
179   Int_t fNruns;            // number of runs to be processed
180   Int_t fFirstRun;            // first run for calibration obj validity
181   Int_t fLastRun;            // last run for calib obj validity
182   TMap* fConfigMap;          // map holding configuration obj
183
184   AliTOFDeltaBCOffset *fDeltaBCOffset; // deltaBC offset
185   AliTOFCTPLatency *fCTPLatency; // CTP latency
186   AliTOFT0Fill *fT0Fill; // T0 fill
187   AliTOFRunParams *fRunParams; // run params
188   AliTOFResponseParams *fResponseParams; // run params
189   TH1F *fReadoutEfficiency; // readout efficiency
190   
191   Bool_t fInitFlag; // init flag
192   Bool_t fRemoveMeanT0; // remove mean T0
193   Bool_t fCalibrateTOFsignal; // calibrate TOF signal
194   Bool_t fCorrectTExp; // correct expected time
195
196   ClassDef(AliTOFcalib,10);
197 };
198
199 #endif // AliTOFcalib_H
200