TPC/AliTPCCorrection.h

   1 #ifndef ALI_TPC_CORRECTION_H
   2 #define ALI_TPC_CORRECTION_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 //                                                                            //
   9 // AliTPCCorrection class                                                     //
  10 //                                                                            //
  11 // This class provides a general framework to deal with space point           //
  12 // distortions. An correction class which inherits from here is for example   //
  13 // AliTPCExBBShape or AliTPCExBTwist                                          //
  14 //                                                                            //
  15 // General functions are (for example):                                       //
  16 //   CorrectPoint(x,roc) where x is the vector of inital positions in         //
  17 //   cartesian coordinates and roc represents the Read Out chamber number     //
  18 //   according to the offline naming convention. The vector x is overwritten  //
  19 //   with the corrected coordinates.                                          //
  20 //                                                                            //
  21 // An alternative usage would be CorrectPoint(x,roc,dx), which leaves the     //
  22 //   vector x untouched, put returns the distortions via the vector dx        //
  23 //                                                                            //
  24 // The class allows "effective Omega Tau" corrections to be shifted to the    //
  25 // single distortion classes.                                                 //
  26 //                                                                            //
  27 // Note: This class is normally used via the class AliTPCComposedCorrection   //
  28 //                                                                            //
  29 // date: 27/04/2010                                                           //
  30 // Authors: Magnus Mager, Stefan Rossegger, Jim Thomas                        //
  31 ////////////////////////////////////////////////////////////////////////////////
  32
  33
  34 #include <TNamed.h>
  35 class TH2F;
  36 class TTimeStamp;
  37 class TCollection;
  38 class TTreeSRedirector;
  39 class AliExternalTrackParam;
  40 class TTree;
  41
  42 class AliTPCCorrection : public TNamed {
  43 public:
  44   enum CompositionType {kParallel,kQueue};
  45
  46   AliTPCCorrection();
  47   AliTPCCorrection(const char *name,const char *title);
  48   virtual ~AliTPCCorrection();
  49
  50
  51   // functions to correct a space point
  52           void CorrectPoint (      Float_t x[],const Short_t roc);
  53           void CorrectPoint (const Float_t x[],const Short_t roc,Float_t xp[]);
  54   virtual void GetCorrection(const Float_t x[],const Short_t roc,Float_t dx[]);
  55
  56   // functions to distort a space point
  57           void DistortPoint (      Float_t x[],const Short_t roc);
  58           void DistortPoint (const Float_t x[],const Short_t roc,Float_t xp[]);
  59   virtual void GetDistortion(const Float_t x[],const Short_t roc,Float_t dx[]);
  60
  61   // initialization and update functions
  62   virtual void Init();
  63   virtual void Update(const TTimeStamp &timeStamp);
  64
  65   // convenience functions
  66   virtual void Print(Option_t* option="") const;
  67
  68   TH2F* CreateHistoDRinXY   (Float_t z=10.,Int_t nx=100,Int_t ny=100);
  69   TH2F* CreateHistoDRPhiinXY(Float_t z=10.,Int_t nx=100,Int_t nphi=100);
  70   TH2F* CreateHistoDRinZR   (Float_t phi=0.,Int_t nZ=100,Int_t nR=100);
  71   TH2F* CreateHistoDRPhiinZR(Float_t phi=0.,Int_t nZ=100,Int_t nR=100);
  72   TTree* CreateDistortionTree(Double_t step=5);
  73
  74   // normally called directly in the correction classes which inherit from this class
  75   virtual void SetOmegaTauT1T2(Float_t omegaTau,Float_t t1,Float_t t2);
  76   AliExternalTrackParam * FitDistortedTrack(const AliExternalTrackParam * trackIn, Double_t refX, Int_t dir,TTreeSRedirector *pcstream);
  77   void StoreInOCDB(Int_t startRun, Int_t endRun, const char *comment=0);
  78 protected:
  79   TH2F* CreateTH2F(const char *name,const char *title,
  80                    const char *xlabel,const char *ylabel,const char *zlabel,
  81                    Int_t nbinsx,Double_t xlow,Double_t xup,
  82                    Int_t nbinsy,Double_t ylow,Double_t yup);
  83
  84   static const Double_t fgkTPC_Z0;      // nominal gating grid position
  85   static const Double_t fgkIFCRadius;   // Mean Radius of the Inner Field Cage ( 82.43 min,  83.70 max) (cm)
  86   static const Double_t fgkOFCRadius;   // Mean Radius of the Outer Field Cage (252.55 min, 256.45 max) (cm)
  87   static const Double_t fgkZOffSet;     // Offset from CE: calculate all distortions closer to CE as if at this point
  88   static const Double_t fgkCathodeV;    // Cathode Voltage (volts)
  89   static const Double_t fgkGG;          // Gating Grid voltage (volts)
  90
  91   enum {kNR=   92};              // Number of R points in the table for interpolating distortion data
  92   enum {kNZ=  270};              // Number of Z points in the table for interpolating distortion data
  93   static const Double_t fgkRList[kNR];
  94   static const Double_t fgkZList[kNZ];
  95
  96   // Simple Interpolation functions: e.g. with tricubic interpolation (not yet in TH3)
  97   Int_t fJLow;
  98   Int_t fKLow;
  99   void Interpolate2DEdistortion( const Int_t order, const Double_t r, const Double_t z,
 100                                  const Double_t er[kNZ][kNR], Double_t &er_value );
 101   Double_t Interpolate( const Double_t xArray[], const Double_t yArray[],
 102                         const Int_t order, const Double_t x );
 103   void Search( const Int_t n, const Double_t xArray[], const Double_t x, Int_t &low );
 104
 105
 106
 107   ClassDef(AliTPCCorrection,1);
 108 };
 109
 110 #endif