cdca0d0d5b79f6fb1efadc72ab8a8e963808d57d
[u/mrichter/AliRoot.git] / EMCAL / AliEMCALRawUtils.h
1 #ifndef ALIEMCALRAWUTILS_H
2 #define ALIEMCALRAWUTILS_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 /* History of cvs commits:
8  *
9  * $Log$
10  * Revision 1.3  2007/10/31 17:15:24  mvl
11  * Fixed bug in raw data unpacking; Added pedestal to signal fit; Added logic to deal with high/low gain
12  *
13  * Revision 1.2  2007/09/03 20:55:35  jklay
14  * EMCAL e-by-e reconstruction methods from Cvetan
15  *
16  * Revision 1.1  2007/03/17 19:56:38  mvl
17  * Moved signal shape routines from AliEMCAL to separate class AliEMCALRawUtils to streamline raw data reconstruction code.
18  *
19  *
20  */
21 //_________________________________________________________________________
22 //  Utility Class for handling Raw data
23 //  Does all transitions from Digits to Raw and vice versa, 
24 //  for simu and reconstruction
25 //
26 //  Note: the current version is still simplified. Only 
27 //    one raw signal per digit is generated; either high-gain or low-gain
28 //    Need to add concurrent high and low-gain info in the future
29 //    No pedestal is added to the raw signal.
30 //
31 //*-- Author: Marco van Leeuwen (LBL)
32 //
33 #include "TObject.h" // for ROOT types
34 #include <TString.h>
35 #include "AliCaloRawStream.h"
36
37 class TGraph;
38 class TF1;
39 class AliRawReader;
40 class AliEMCALGeometry;
41
42 class AliEMCALRawUtils : public TObject {
43  public:
44   AliEMCALRawUtils();
45   virtual ~AliEMCALRawUtils();
46
47   AliEMCALRawUtils(const AliEMCALRawUtils& rawUtils);  //copy ctor
48   AliEMCALRawUtils& operator =(const AliEMCALRawUtils& rawUtils);
49
50   void Digits2Raw();
51   void Raw2Digits(AliRawReader *reader,TClonesArray *digitsArr);
52
53   void AddDigit(TClonesArray *digitsArr, Int_t id, Int_t lowGain, Int_t amp, Float_t time);
54
55   // Signal shape parameters
56   Double_t GetRawFormatHighLowGainFactor() const { return fHighLowGainFactor ;}
57   Int_t GetRawFormatOrder()                const { return fOrder ; }   
58   Double_t GetRawFormatTau()               const { return fTau ; }    
59   Int_t GetNoiseThreshold()                const { return fNoiseThreshold; }
60   Int_t GetNPedSamples()                   const { return fNPedSamples; }
61
62   void SetRawFormatHighLowGainFactor(Double_t val) {fHighLowGainFactor=val;}
63   void SetRawFormatOrder(Int_t val)                {fOrder=val; }   
64   void SetRawFormatTau(Double_t val)               {fTau=val; }    
65   void SetNoiseThreshold(Int_t val)                {fNoiseThreshold=val; }
66   void SetNPedSamples(Int_t val)                   {fNPedSamples=val; }
67   
68   static Int_t GetRawFormatTimeBins() { return fgkTimeBins ; }    
69   static Double_t GetRawFormatTimeMax() { return fgkTimeBins*fgTimeBinWidth; }   
70   static Double_t GetRawFormatTimeBinWidth() { return fgTimeBinWidth; }   
71   Double_t GetRawFormatTimeTrigger() const { return fgTimeTrigger ; }
72   Int_t GetRawFormatThreshold() const { return fgThreshold ; }       
73   Int_t GetRawFormatDDLPerSuperModule() const { return fgDDLPerSuperModule ; } 
74
75   virtual Option_t* GetOption() const { return fOption.Data(); }
76   void SetOption(Option_t* opt) { fOption = opt; }
77
78   // Signal shape functions
79   void FitRaw(TGraph * gSig, TF1* signalF, Float_t & amp, Float_t & time);
80   static Double_t RawResponseFunction(Double_t *x, Double_t *par); 
81   Bool_t   RawSampledResponse(Double_t dtime, Double_t damp, Int_t * adcH, Int_t * adcL) const;  
82
83
84  private:
85   Double_t fHighLowGainFactor ;         // high to low gain factor for the raw RO signal
86   Int_t fOrder ;                        // order of the gamma function for the RO signal
87   Double_t fTau ;                       // tau parameter of gamma function for the RO signal
88   Int_t fNoiseThreshold;                // threshold to consider signal or noise
89   Int_t fNPedSamples;                   // number of samples to use in pedestal calculation
90
91   static const Int_t fgkOverflowCut = 950;  // cut to discriminate overflowed channels
92   static const Int_t fgkTimeBins = 256 ; // number of sampling bins of the raw RO signal  
93   static const Int_t fgkRawSignalOverflow = 0x3FF; // maximum signal (10 bits)
94
95   static Double_t fgTimeTrigger ;       // time of the trigger for the RO signal 
96   static Double_t fgTimeBinWidth;       // maximum sampled time of the raw RO signal                             
97   static Int_t fgThreshold;             // threshold
98   static Int_t fgDDLPerSuperModule;     // number of DDL per SuperModule
99
100   AliEMCALGeometry* fGeom;         //geometry
101   AliAltroMapping*  fMapping[2];   //only two for now
102
103   TString fOption;                      //! option passed from Reconstructor
104
105   ClassDef(AliEMCALRawUtils,2)          // utilities for raw signal fitting
106 };
107
108 #endif