Updated SDigitizer; Added AliTOFanalyzeSDigits.C macro
[u/mrichter/AliRoot.git] / TOF / AliTOFSDigitizer.h
1 #ifndef ALITOFSDigitizer_H
2 #define ALITOFSDigitizer_H
3 /* Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
4  * See cxx source for full Copyright notice                               */
5
6
7 //_________________________________________________________________________
8 //  Task Class for making SDigits in TOF      
9 //                  
10 //-- Authors: F. Pierella, A. De Caro
11
12
13 #include "TTask.h"
14 #include "TString.h"
15 #include "AliTOF.h"
16 #include "AliDetector.h"
17
18 class TF1;
19
20 class AliTOFSDigitizer: public TTask {
21
22 public:
23   AliTOFSDigitizer() ;          // ctor
24   AliTOFSDigitizer(char* HeaderFile, Int_t evNumber1=0, Int_t nEvents=1) ; // par ctor
25
26   virtual ~AliTOFSDigitizer() ; // dtor
27
28   virtual void  Exec(Option_t *verboseOption, Option_t *allEvents="noAll"); 
29   void SetSDigitsFile(char * file ) {;}
30   
31   void InitParameters();
32   virtual void PrintParameters() const ;
33   virtual void  SimulateDetectorResponse(Float_t z0, Float_t x0, Float_t geantTime, Int_t& nActivatedPads, Int_t& nFiredPads, Bool_t* isFired, Int_t* nPlace, Float_t* qInduced, Float_t* tofTime, Float_t& averageTime);
34   virtual void Print(Option_t* opt) const ;
35   void  SetFirstEvent(Int_t event1)      {fEvent1=event1;}
36   void  SetSecondEvent(Int_t event2)     {fEvent2=event2;}
37   Int_t GetFirstEvent()  const {return fEvent1;}
38   Int_t GetSecondEvent() const {return fEvent2;}
39   Int_t GetNEvents() const {return (fEvent2-fEvent1);}
40   void  SelectSectorAndPlate(Int_t sector, Int_t plate);
41
42   // setters and getters for detector simulation
43   // it summarizes all it is known about TOF strip 
44   void  SetPadefficiency(Float_t padefficiency)      {fpadefficiency=padefficiency;}
45   void  SetEdgeEffect(Int_t   edgeEffect)            {fEdgeEffect=edgeEffect;}
46   void  SetEdgeTails(Int_t   edgeTails)              {fEdgeTails=edgeTails;}
47   void  SetHparameter(Float_t hparameter)            {fHparameter=hparameter;}
48   void  SetH2parameter(Float_t h2parameter)          {fH2parameter=h2parameter;}
49   void  SetKparameter(Float_t kparameter)            {fKparameter=kparameter;}
50   void  SetK2parameter(Float_t k2parameter)          {fK2parameter=k2parameter;}
51   void  SetEffCenter(Float_t effCenter)              {fEffCenter=effCenter;}
52   void  SetEffBoundary(Float_t effBoundary)          {fEffBoundary=effBoundary;}
53   void  SetEff2Boundary(Float_t eff2Boundary)        {fEff2Boundary=eff2Boundary;}
54   void  SetEff3Boundary(Float_t eff3Boundary)        {fEff3Boundary=eff3Boundary;}
55   void  SetResCenter (Float_t resCenter)             {fResCenter=resCenter;}
56   void  SetResBoundary(Float_t resBoundary)          {fResBoundary=resBoundary;}
57   void  SetResSlope(Float_t resSlope)                {fResSlope=resSlope;}
58   void  SetTimeWalkCenter(Float_t timeWalkCenter)    {fTimeWalkCenter=timeWalkCenter;}
59   void  SetTimeWalkBoundary(Float_t timeWalkBoundary){fTimeWalkBoundary=timeWalkBoundary;}
60   void  SetTimeWalkSlope(Float_t timeWalkSlope)      {fTimeWalkSlope=timeWalkSlope;}
61
62   void  SetTimeDelayFlag(Int_t timeDelayFlag)        {fTimeDelayFlag=timeDelayFlag;}
63   void  SetPulseHeightSlope(Float_t pulseHeightSlope){fPulseHeightSlope=pulseHeightSlope;}
64   void  SetTimeDelaySlope(Float_t timeDelaySlope)    {fTimeDelaySlope=timeDelaySlope;}
65   void  SetMinimumCharge(Float_t minimumCharge)      {fMinimumCharge=minimumCharge;}
66   void  SetChargeSmearing(Float_t chargeSmearing)    {fChargeSmearing=chargeSmearing;}
67   void  SetLogChargeSmearing(Float_t logChargeSmearing){fLogChargeSmearing=logChargeSmearing;}
68   void  SetTimeSmearing(Float_t timeSmearing)        {fTimeSmearing=timeSmearing;}
69   void  SetAverageTimeFlag(Int_t averageTimeFlag)    {fAverageTimeFlag=averageTimeFlag;}
70   void  SetTdcBin(Float_t tdcBin)                    {fTdcBin=tdcBin;}
71   void  SetAdcBin(Float_t adcBin)                    {fAdcBin=adcBin;}
72   void  SetAdcMean(Float_t adcMean)                  {fAdcMean=adcMean;}
73   void  SetAdcRms(Float_t adcRms)                    {fAdcRms=adcRms;}
74
75   Float_t  GetPadefficiency()    const {return fpadefficiency;}
76   Int_t    GetEdgeEffect()       const {return fEdgeEffect;}
77   Int_t    GetEdgeTails()        const {return fEdgeTails;}
78   Float_t  GetHparameter()       const {return fHparameter;}
79   Float_t  GetH2parameter()      const {return fH2parameter;}
80   Float_t  GetKparameter()       const {return fKparameter;}
81   Float_t  GetK2parameter()      const {return fK2parameter;}
82   Float_t  GetEffCenter()        const {return fEffCenter;}
83   Float_t  GetEffBoundary()      const {return fEffBoundary;}
84   Float_t  GetEff2Boundary()     const {return fEff2Boundary;}
85   Float_t  GetEff3Boundary()     const {return fEff3Boundary;}
86   Float_t  GetResCenter ()       const {return fResCenter;}
87   Float_t  GetResBoundary()      const {return fResBoundary;}
88   Float_t  GetResSlope()         const {return fResSlope;}
89   Float_t  GetTimeWalkCenter()   const {return fTimeWalkCenter;}
90   Float_t  GetTimeWalkBoundary() const {return fTimeWalkBoundary;}
91   Float_t  GetTimeWalkSlope()    const {return fTimeWalkSlope;}
92   Int_t    GetTimeDelayFlag()    const {return fTimeDelayFlag;}
93   Float_t  GetPulseHeightSlope() const {return fPulseHeightSlope;}
94   Float_t  GetTimeDelaySlope()   const {return fTimeDelaySlope;}
95   Float_t  GetMinimumCharge()    const {return fMinimumCharge;}
96   Float_t  GetChargeSmearing()   const {return fChargeSmearing;}
97   Float_t  GetLogChargeSmearing()const {return fLogChargeSmearing;}
98   Float_t  GetTimeSmearing()     const {return fTimeSmearing;}
99   Int_t    GetAverageTimeFlag()  const {return fAverageTimeFlag;}
100   Float_t  GetTdcBin()           const {return fTdcBin;}
101   Float_t  GetAdcBin()           const {return fAdcBin;}
102   Float_t  GetAdcMean()          const {return fAdcMean;}
103   Float_t  GetAdcRms()           const {return fAdcRms;}
104   
105
106 private:
107   Int_t   fEvent1;          // lower bound for events to sdigitize
108   Int_t   fEvent2;          // upper bound for events to sdigitize
109   TF1     *ftail;           // pointer to formula for time with tail
110   TString fHeadersFile;     // input file
111   Int_t fSelectedSector;    // sector number for sdigitization
112   Int_t fSelectedPlate ;    // plate  number for sdigitization
113
114   // detector response simulation
115   // Intrisic MRPC time resolution and pad (edge effect) parameters
116   Float_t fTimeResolution;  // time resolution of the MRPC (ns)
117   Float_t fpadefficiency;   // intrinsic pad efficiency, used if fEdgeEffect==0
118   Int_t   fEdgeEffect;      // edge effects option
119   Int_t   fEdgeTails;       // edge tails option
120   Float_t fHparameter;      // sensitive edge (to produce hits on the
121   // neighbouring pads) =0.7, new = 0.4 cm
122   Float_t fH2parameter;     // parameter to fit the efficiency
123   Float_t fKparameter;      // sensitive edge (going ahead towards the
124   // center no delay effects are suffered) =1.0, new = 0.5 cm
125   Float_t fK2parameter;     // parameter to fit the efficiency
126   // Pad Efficiency and Resolution parameters
127   Float_t fEffCenter;       // efficiency in the central region of the pad
128   Float_t fEffBoundary;     // efficiency at the boundary of the pad
129   Float_t fEff2Boundary;    // efficiency value at H2parameter
130   Float_t fEff3Boundary;    // efficiency value at K2parameter
131   Float_t fResCenter;       // resolution (ps) in the central region of the pad
132   Float_t fResBoundary;     // resolution (ps)  at the boundary of the pad
133   Float_t fResSlope;        // slope (ps/K) for neighbouring pad
134   // Time Walk parameters
135   Float_t fTimeWalkCenter;  // time walk (ps) in the central region of the pad
136   Float_t fTimeWalkBoundary;// time walk (ps) at the boundary of the pad
137   Float_t fTimeWalkSlope;   // slope (ps/K) for neighbouring pad
138   Int_t   fTimeDelayFlag;   // flag for delay due to the PulseHeightEffect
139   Float_t fPulseHeightSlope;// It determines the charge amount induced
140   // due to edge effect, using the formula
141   // qInduced=exp(-PulseHeightSlope*x)
142   Float_t fTimeDelaySlope;  // It determines the time delay. This is the slope
143   // in the T1-T2 vs log(q1/q2) plot
144   // ADC-TDC correlation parameters
145   Float_t fMinimumCharge;   // Minimum charge amount which could be induced
146   Float_t fChargeSmearing;  // Smearing in charge in (q1/q2) vs x plot
147   Float_t fLogChargeSmearing;// Smearing in log of charge ratio
148   Float_t fTimeSmearing;    // Smearing in time in time vs log(q1/q2) plot
149   Int_t   fAverageTimeFlag; // flag (see the setter for details)
150   Float_t fTdcBin;      // time-window for the TDC bins [ps]
151   Float_t fAdcBin;      // charge-window for the ADC bins [pC]
152   Float_t fAdcMean;     // mean value for the ADC spectrum [bins]
153   Float_t fAdcRms;      // rms value for the ADC spectrum [bins]
154
155  protected:
156
157
158   ClassDef(AliTOFSDigitizer,2)  // creates TOF SDigits
159
160 };
161
162 #endif // AliTOFSDigitizer_H