PHOS/AliPHOSClusterizerv1.h

   1 #ifndef ALIPHOSCLUSTERIZERV1_H
   2 #define ALIPHOSCLUSTERIZERV1_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 //  Implementation version 1 of the clusterization algorithm
  10 //  Performs clusterization (collects neighbouring active cells) and
  11 //  unfolding of the clusters with several local maxima.
  12 //  results are stored in TreeR#, branches PHOSEmcRP (EMC recPoints),
  13 //  PHOSCpvRP (CPV RecPoints) and AliPHOSClusterizer
  14 //
  15 //*-- Author: Dmitri Peressounko (SUBATECH)
  16
  17 // --- ROOT system ---
  18 #include "TArrayS.h"
  19 // --- Standard library ---
  20
  21 // --- AliRoot header files ---
  22
  23 #include "AliPHOSClusterizer.h"
  24 class AliPHOSEmcRecPoint ;
  25 class AliPHOSDigit ;
  26 class AliPHOSDigitizer ;
  27 class AliPHOSGeometry ;
  28 class AliPHOSCalibrationData ;
  29
  30 class AliPHOSClusterizerv1 : public AliPHOSClusterizer {
  31
  32 public:
  33
  34   AliPHOSClusterizerv1() ;
  35   AliPHOSClusterizerv1(const char * headerFile, const char * name = "Default", const Bool_t toSplit=kFALSE);
  36   AliPHOSClusterizerv1(const AliPHOSClusterizerv1 & clusterizer) {
  37     // copy ctor: no implementation yet
  38     Fatal("cpy ctor", "not implemented") ;
  39   }
  40   virtual ~AliPHOSClusterizerv1()  ;
  41
  42   virtual Int_t   AreNeighbours(AliPHOSDigit * d1, AliPHOSDigit * d2)const ;
  43                                // Checks if digits are in neighbour cells
  44
  45   virtual Float_t Calibrate(Int_t amp, Int_t absId)const ;  // Tranforms Amp to energy
  46
  47   virtual void    GetNumberOfClustersFound(int * numb )const{  numb[0] = fNumberOfEmcClusters ;
  48                                                                numb[1] = fNumberOfCpvClusters ; }
  49
  50   virtual Float_t GetEmcClusteringThreshold()const{ return fEmcClusteringThreshold;}
  51   virtual Float_t GetEmcLocalMaxCut()const        { return fEmcLocMaxCut;}
  52   virtual Float_t GetEmcLogWeight()const          { return fW0;}
  53   virtual Float_t GetEmcTimeGate() const          { return fEmcTimeGate ; }
  54   virtual Float_t GetCpvClusteringThreshold()const{ return fCpvClusteringThreshold;  }
  55   virtual Float_t GetCpvLocalMaxCut()const        { return fCpvLocMaxCut;}
  56   virtual Float_t GetCpvLogWeight()const          { return fW0CPV;}
  57   virtual Float_t GetPurifyThreshold()const       {return fPurifyThreshold; }
  58   virtual const char *  GetRecPointsBranch() const{ return GetName() ;}
  59   virtual const Int_t GetRecPointsInRun() const   {return fRecPointsInRun ;}
  60
  61   void    Exec(Option_t *option);                // Does the job
  62
  63   virtual void Print(Option_t * option)const ;
  64
  65   virtual void SetEmcClusteringThreshold(Float_t cluth)  { fEmcClusteringThreshold = cluth ; }
  66   virtual void SetEmcLocalMaxCut(Float_t cut)            { fEmcLocMaxCut = cut ; }
  67   virtual void SetEmcLogWeight(Float_t w)                { fW0 = w ; }
  68   virtual void SetEmcTimeGate(Float_t gate)              { fEmcTimeGate = gate ;}
  69   virtual void SetCpvClusteringThreshold(Float_t cluth)  { fCpvClusteringThreshold = cluth ; }
  70   virtual void SetCpvLocalMaxCut(Float_t cut)            { fCpvLocMaxCut = cut ; }
  71   virtual void SetCpvLogWeight(Float_t w)                { fW0CPV = w ; }
  72   virtual void SetUnfolding(Bool_t toUnfold = kTRUE )    { fToUnfold = toUnfold ;}
  73   virtual void SetPirifyThreshold(Float_t threshold)     {fPurifyThreshold = threshold ;}
  74   void SetCalibrVersion(const char* version = "v1",Int_t run=1)  //Provides specification of calibrationData
  75     {fCalibrVersion = version ; fCalibrRun = run ;}
  76   void SetPatterns(TArrayS * pats){if(fPatterns) delete fPatterns ;
  77                                   fPatterns = new TArrayS(*pats) ;}
  78   static Double_t ShowerShape(Double_t r) ; // Shape of EM shower used in unfolding;
  79                                             //class member function (not object member function)
  80   static void UnfoldingChiSquare(Int_t & nPar, Double_t * Grad, Double_t & fret, Double_t * x, Int_t iflag)  ;
  81                                             // Chi^2 of the fit. Should be static to be passes to MINUIT
  82   AliPHOSClusterizerv1 & operator = (const AliPHOSClusterizerv1 & rvalue)  {
  83     // assignement operator requested by coding convention but not needed
  84     Fatal("operator =", "not implemented") ; return *this ;
  85   }
  86
  87   virtual const char * Version() const { return "clu-v1" ; }
  88
  89 protected:
  90
  91   void           WriteRecPoints(Int_t event) ;
  92   virtual void   MakeClusters( ) ;
  93   virtual Bool_t IsInEmc (AliPHOSDigit * digit)const ;     // Tells if id digit is in EMC
  94   virtual Bool_t IsInCpv (AliPHOSDigit * digit)const ;     // Tells if id digit is in CPV
  95
  96
  97 private:
  98
  99   const   TString BranchName() const ;
 100   void    GetCalibrationParameters(void) ;
 101
 102   Bool_t  FindFit(AliPHOSEmcRecPoint * emcRP, AliPHOSDigit ** MaxAt, Float_t * maxAtEnergy,
 103                   Int_t NPar, Float_t * FitParametres) const; //Used in UnfoldClusters, calls TMinuit
 104   void    Init() ;
 105   void    InitParameters() ;
 106
 107   virtual void   MakeUnfolding() ;
 108   void           UnfoldCluster(AliPHOSEmcRecPoint * iniEmc,Int_t Nmax,
 109                        AliPHOSDigit ** maxAt,Float_t * maxAtEnergy ) ; //Unfolds cluster using TMinuit package
 110   void           PrintRecPoints(Option_t * option) ;
 111
 112 private:
 113
 114   Bool_t  fDefaultInit;              //! Says if the task was created by defaut ctor (only parameters are initialized)
 115
 116   Int_t   fEmcCrystals ;             // number of EMC cristalls in PHOS
 117
 118   Bool_t  fToUnfold ;                // To perform unfolding
 119
 120   Int_t   fNumberOfEmcClusters ;     // number of EMC clusters found
 121   Int_t   fNumberOfCpvClusters ;     // number of CPV clusters found
 122
 123   //Calibration parameters
 124   AliPHOSCalibrationData * fPedestals ; //!
 125   AliPHOSCalibrationData * fGains ;    //!
 126   TArrayS                * fPatterns ;// Array of trigger patterns of events to handle
 127   TString fCalibrVersion ;          // Version of calibration Data
 128   Int_t   fCalibrRun ;              // Specification of Calibration data
 129   Float_t fADCchanelEmc ;           // width of one ADC channel in GeV
 130   Float_t fADCpedestalEmc ;         // value of the EMC ADC pedestal
 131   Float_t fADCchanelCpv ;           // width of one ADC channel in CPV 'popugais'
 132   Float_t fADCpedestalCpv ;         // value of the CPV ADC pedestal
 133
 134   Float_t fPurifyThreshold ;         // threshold for cell energies after unfolding
 135   Float_t fEmcClusteringThreshold ;  // minimum energy to include a EMC digit in a cluster
 136   Float_t fCpvClusteringThreshold ;  // minimum energy to include a CPV digit in a cluster
 137   Float_t fEmcLocMaxCut ;            // minimum energy difference to distinguish local maxima in a cluster
 138   Float_t fW0 ;                      // logarithmic weight for the cluster center of gravity calculation
 139   Float_t fCpvLocMaxCut ;            // minimum energy difference to distinguish local maxima in a CPV cluster
 140   Float_t fW0CPV ;                   // logarithmic weight for the CPV cluster center of gravity calculation
 141   Int_t fRecPointsInRun ;            //! Total number of recpoints in one run
 142   Float_t fEmcTimeGate ;             // Maximum time difference between the digits in ont EMC cluster
 143
 144   ClassDef(AliPHOSClusterizerv1,2)   // Clusterizer implementation version 1
 145
 146 };
 147
 148 #endif // AliPHOSCLUSTERIZERV1_H