TRD/AliTRDfeeParam.h

   1 #ifndef ALITRDFEEPARAM_H
   2 #define ALITRDFEEPARAM_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
   8 ////////////////////////////////////////////////////////////////////////////
   9 //                                                                        //
  10 //  TRD front end electronics parameters class                            //
  11 //  Contains all FEE (MCM, TRAP, PASA) related                            //
  12 //  parameters, constants, and mapping.                                   //
  13 //                                                                        //
  14 //  Author:                                                               //
  15 //    Ken Oyama (oyama@physi.uni-heidelberg.de)                           //
  16 //                                                                        //
  17 ////////////////////////////////////////////////////////////////////////////
  18
  19 #include <TObject.h>
  20
  21 class TRootIoCtor;
  22
  23 class AliTRDCommonParam;
  24 class AliTRDpadPlane;
  25 class AliTRDgeometry;
  26
  27 //_____________________________________________________________________________
  28 class AliTRDfeeParam : public TObject
  29 {
  30
  31  public:
  32
  33   AliTRDfeeParam(TRootIoCtor *);
  34   AliTRDfeeParam(const AliTRDfeeParam &p);
  35   virtual           ~AliTRDfeeParam();
  36   AliTRDfeeParam    &operator=(const AliTRDfeeParam &p);
  37   virtual void       Copy(TObject &p) const;
  38
  39   static AliTRDfeeParam *Instance();  // Singleton
  40   static void            Terminate();
  41
  42   // Translation from MCM to Pad and vice versa
  43   virtual Int_t    GetPadRowFromMCM(Int_t irob, Int_t imcm) const;
  44   virtual Int_t    GetPadColFromADC(Int_t irob, Int_t imcm, Int_t iadc) const;
  45   virtual Int_t    GetMCMfromPad(Int_t irow, Int_t icol) const;
  46   virtual Int_t    GetROBfromPad(Int_t irow, Int_t icol) const;
  47   virtual Int_t    GetRobSide(Int_t irob) const;
  48   virtual Int_t    GetColSide(Int_t icol) const;
  49
  50   static  Float_t  GetSamplingFrequency() { return (Float_t)fgkLHCfrequency / 4000000.0; }
  51   static  Int_t    GetNmcmRob()           { return fgkNmcmRob;      }
  52   static  Int_t    GetNmcmRobInRow()      { return fgkNmcmRobInRow; }
  53   static  Int_t    GetNmcmRobInCol()      { return fgkNmcmRobInCol; }
  54   static  Int_t    GetNrobC0()            { return fgkNrobC0;       }
  55   static  Int_t    GetNrobC1()            { return fgkNrobC1;       }
  56   static  Int_t    GetNadcMcm()           { return fgkNadcMcm;      }
  57   // static  Int_t    GetNtimebin()       { return fgkNtimebin;     }
  58   static  Int_t    GetNcol()              { return fgkNcol;         }
  59   static  Int_t    GetNcolMcm()           { return fgkNcolMcm;      }
  60   static  Int_t    GetNrowC0()            { return fgkNrowC0;       }
  61   static  Int_t    GetNrowC1()            { return fgkNrowC1;       }
  62
  63   // static  Int_t    GetADCpedestal()    { return fgkADCpedestal;  }
  64   // static  Int_t    GetADCnoise()       { return fgkADCnoise;     }
  65   static  Int_t    GetADCDAC()            { return fgkADCDAC;       }
  66
  67   static  Bool_t   IsPFon()               { return fgkPFon;         }
  68   static  Bool_t   IsGFon()               { return fgkGFon;         }
  69   static  Bool_t   IsTFon()               { return fgkTFon;         }
  70
  71   static  Int_t    GetPFtimeConstant()    { return fgkPFtimeConstant;   }
  72   static  Int_t    GetPFeffectPedestal()  { return fgkPFeffectPedestal; }
  73
  74   //        Float_t  GetClusThr()           { return fClusThr; };
  75   //        Float_t  GetPadThr() const { return fPadThr; };
  76   //        Int_t    GetTailCancelation() const { return fTCOn; };
  77   //        Int_t    GetNexponential() const { return fTCnexp; };
  78   //virtual void     GetFilterParam(Float_t &r1, Float_t &r2, Float_t &c1, Float_t &c2, Float_t &ped) const;
  79   //        Int_t    GetFilterType() const { return fFilterType; };
  80
  81   static  Int_t    GetTFtype()            { return fgkTFtype;       }
  82   static  Int_t    GetTFnExp()            { return fgkTFnExp;       }
  83           Float_t  GetTFr1()        const { return fTFr1;           }
  84           Float_t  GetTFr2()        const { return fTFr2;           }
  85           Float_t  GetTFc1()        const { return fTFc1;           }
  86           Float_t  GetTFc2()        const { return fTFc2;           }
  87
  88   static  Float_t  GetTFattPar()          { return ((Float_t) fgkTFattPar1) / ((Float_t) fgkTFattPar2); }
  89           Float_t  GetTFf0()        const { return 1.0 + fgkTFon*(-1.0+GetTFattPar()); }   // 1 if TC off
  90
  91           void     SetEBsglIndThr(Int_t val);
  92           Int_t    GetEBsglIndThr() const { return fEBsglIndThr;    }
  93
  94           void     SetEBsumIndThr(Int_t val);
  95           Int_t    GetEBsumIndThr() const { return fEBsumIndThr;    }
  96
  97           void     SetEBindLUT(Int_t val);
  98           Int_t    GetEBindLUT()    const { return fEBindLUT;       }
  99
 100           void     SetEBignoreNeighbour(Int_t val);
 101           Int_t    GetEBignoreNeighbour() const             { return fEBignoreNeighbour; }
 102
 103   // Concerning raw data format
 104           Int_t    GetRAWversion() const                    { return fRAWversion;        }
 105           void     SetRAWversion( Int_t rawver );
 106           Bool_t   GetRAWstoreRaw() const                   { return fRAWstoreRaw;       }
 107           void     SetRAWstoreRaw( Bool_t storeraw )        { fRAWstoreRaw = storeraw;   }
 108
 109  protected:
 110
 111   static AliTRDfeeParam *fgInstance;         // Singleton instance
 112   static Bool_t          fgTerminated;       // Defines if this class has already been terminated
 113
 114   AliTRDCommonParam     *fCP;                // TRD common parameters class
 115
 116   // Remark: ISO C++ allows initialization of static const values only for integer.
 117
 118   // Basic Geometrical numbers
 119   static const Int_t    fgkLHCfrequency      = 40079000 ; // [Hz] LHC clock (should be moved to STEER?)
 120   static const Int_t    fgkNmcmRob           = 16;        // Number of MCMs per ROB         (old fgkMCMmax)
 121   static const Int_t    fgkNmcmRobInRow      = 4;         // Number of MCMs per ROB in row dir. (old fgkMCMrow)
 122   static const Int_t    fgkNmcmRobInCol      = 4;         // Number of MCMs per ROB in col dir. (old fgkMCMrow)
 123   static const Int_t    fgkNrobC0            = 6;         // Number of ROBs per C0 chamber  (old fgkROBmaxC0)
 124   static const Int_t    fgkNrobC1            = 8;         // Number of ROBs per C1 chamber  (old fgkROBmaxC1)
 125   static const Int_t    fgkNadcMcm           = 21;        // Number of ADC channels per MCM (old fgkADCmax)
 126   // static const Int_t    fgkNtimebin       = 24;        // Number of Time bins should come from calibDB
 127   static const Int_t    fgkNcol              = 144;       // Number of pads per padplane row(old fgkColmax)
 128   static const Int_t    fgkNcolMcm           = 18;        // Number of pads per MCM         (old fgkPadmax)
 129   static const Int_t    fgkNrowC0            = 12;        // Number of Rows per C0 chamber  (old fgkRowmaxC0)
 130   static const Int_t    fgkNrowC1            = 16;        // Number of Rows per C1 chamber  (old fgkRowmaxC1)
 131
 132   // ADC intrinsic parameters
 133   static const Int_t    fgkADCDAC            = 0;         // 5 bit ADC gain parameter
 134
 135   // TRAP filter global setup
 136   static const Bool_t   fgkPFon              = kTRUE;     // Pedestal Filter enable/disable flag.
 137   static const Bool_t   fgkGFon              = kFALSE;    // Gain correction Filter enable/disable flag
 138   static const Bool_t   fgkTFon              = kTRUE;     // Tail cancelation Filter enable/disable flag (old name fTCOn)
 139
 140   // PF setup
 141   static const Int_t    fgkPFtimeConstant    =  0;        // 0 for fastest, 3 for slowest (no effect, probably)
 142   static const Int_t    fgkPFeffectPedestal  = 10;        // [in ADC units] the desired baseline (Additive)
 143
 144   // GF setup
 145   static const Int_t    fgkGFnoise           =  0;        // Noise level increased by gain filter x 100 [in ADC] (to be measured)
 146
 147   // TF setup
 148   static const Int_t    fgkTFtype            = 1;         // TC type (0=analog, 1=digital, 2=MI) (old name fFilterType)
 149
 150   // OLD TF setup (calculated from above)  (valid only for fgkTFsimType = 0 or 1)
 151   static const Int_t    fgkTFnExp          = 1;           // Number of exponential for simType 0 and 1
 152
 153   // following need Instance because initialized in constructor
 154                Float_t  fTFr1;                            // Time constant [us] long (old name fR1)
 155                Float_t  fTFr2;                            // Time constant [us] short(old name fR2)
 156                Float_t  fTFc1;                            // Weight long  (old name fC1)
 157                Float_t  fTFc2;                            // Weight short (old name fC2)
 158
 159   // here is for TRAP simulation (not yet used)
 160   static const Int_t    fgkTFdecayWeightL     = 270;      // 0 to 1024 corresponds to 0 to 0.5
 161   static const Int_t    fgkTFdecayParL        = 348;      // 0 to 511 corresponds to 0.75 to 1
 162   static const Int_t    fgkTFdecayParS        = 449;      // 0 to 511 correponds to 0.25 to 0.5
 163   static const Int_t    fgkTFattPar1          = 45;       // attenuationParameter = fgkTFattenuationParameter1/fgkTFattenuationParameter2
 164   static const Int_t    fgkTFattPar2          = 14;       //                      = -alphaL/ln(lambdaL)-(1-alphaL)/ln(lambdaS)
 165
 166   // ZS parameters
 167                Int_t    fEBsglIndThr;                     // EBIS in ADC units
 168                Int_t    fEBsumIndThr;                     // EBIT in ADC units
 169                Int_t    fEBindLUT;                        // EBIL lookup table
 170                Int_t    fEBignoreNeighbour;               // EBIN 0:include neighbor
 171
 172   // Charge accumulators
 173   static const Int_t    fgkPREPqAcc0Start     =  0;       // Preprocessor Charge Accumulator 0 Start
 174   static const Int_t    fgkPREPqAcc0End       = 10;       // Preprocessor Charge Accumulator 0 End
 175   static const Int_t    fgkPREPqAcc1Start     = 11;       // Preprocessor Charge Accumulator 1 Start
 176   static const Int_t    fgkPREPqAcc1End       = 20;       // Preprocessor Charge Accumulator 1 End
 177   static const Int_t    fgkMinClusterCharge   = 20;       // Hit detection [in ADC units]
 178
 179   // OLD TRAP processing parameters calculated from above
 180   //static const Float_t  fClusThr;                       // Cluster threshold
 181   //static const Float_t  fPadThr;                        // Pad threshold
 182
 183   // For raw production
 184                Int_t    fRAWversion;                      // Raw data production version
 185   static const Int_t    fgkMaxRAWversion      = 3;        // Maximum raw version number supported
 186                Bool_t   fRAWstoreRaw;                     // Store unfiltered data for raw data stream
 187
 188  private:
 189
 190   AliTRDfeeParam();
 191
 192   ClassDef(AliTRDfeeParam,2)                              // The TRD front end electronics parameter
 193
 194 };
 195 #endif