1 #ifndef ALI_TPC_CORRECTION_H
2 #define ALI_TPC_CORRECTION_H
4 /* Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
5 * See cxx source for full Copyright notice */
8 ////////////////////////////////////////////////////////////////////////////////
9 // AliTPCCorrection class //
10 ////////////////////////////////////////////////////////////////////////////////
19 class TTreeSRedirector;
20 class AliExternalTrackParam;
26 class AliTPCCorrection : public TNamed {
28 enum CompositionType {kParallel,kQueue};
31 AliTPCCorrection(const char *name,const char *title);
32 virtual ~AliTPCCorrection();
35 // functions to correct a space point
36 void CorrectPoint ( Float_t x[],const Short_t roc);
37 void CorrectPointLocal(Float_t x[],const Short_t roc);
38 void CorrectPoint (const Float_t x[],const Short_t roc,Float_t xp[]);
39 virtual void GetCorrection(const Float_t x[],const Short_t roc,Float_t dx[]);
41 virtual void GetCorrectionDz(const Float_t x[],const Short_t roc,Float_t dx[], Float_t delta);
42 virtual void GetCorrectionIntegralDz(const Float_t x[],const Short_t roc,Float_t dx[], Float_t delta);
44 // functions to distort a space point
45 void DistortPoint ( Float_t x[],const Short_t roc);
46 void DistortPointLocal(Float_t x[],const Short_t roc);
47 void DistortPoint (const Float_t x[],const Short_t roc,Float_t xp[]);
48 virtual void GetDistortion(const Float_t x[],const Short_t roc,Float_t dx[]);
49 virtual void GetDistortionIntegralDz(const Float_t x[],const Short_t roc,Float_t dx[], Float_t delta);
51 // initialization and update functions
53 virtual void Update(const TTimeStamp &timeStamp);
55 // convenience functions
56 virtual void Print(Option_t* option="") const;
58 TH2F* CreateHistoDRinXY (Float_t z=10.,Int_t nx=100,Int_t ny=100);
59 TH2F* CreateHistoDRPhiinXY(Float_t z=10.,Int_t nx=100,Int_t nphi=100);
60 TH2F* CreateHistoDZinXY (Float_t z=10.,Int_t nx=100,Int_t ny=100);
62 TH2F* CreateHistoDRinZR (Float_t phi=0.,Int_t nZ=100,Int_t nR=100);
63 TH2F* CreateHistoDRPhiinZR(Float_t phi=0.,Int_t nZ=100,Int_t nR=100);
64 TH2F* CreateHistoDZinZR (Float_t phi=0.,Int_t nZ=100,Int_t nR=100);
67 TTree* CreateDistortionTree(Double_t step=5);
68 static void MakeDistortionMap(THnSparse * his0, TTreeSRedirector *pcstream, const char* hname, Int_t run, Float_t refX, Int_t type, Int_t integ=1);
69 static void MakeDistortionMapCosmic(THnSparse * his0, TTreeSRedirector *pcstream, const char* hname, Int_t run, Float_t refX, Int_t type);
70 static void MakeDistortionMapSector(THnSparse * his0, TTreeSRedirector *pcstream, const char* hname, Int_t run, Int_t type);
71 // normally called directly in the correction classes which inherit from this class
72 virtual void SetOmegaTauT1T2(Float_t omegaTau,Float_t t1,Float_t t2);
73 AliExternalTrackParam * FitDistortedTrack(AliExternalTrackParam & trackIn, Double_t refX, Int_t dir,TTreeSRedirector *pcstream);
74 void StoreInOCDB(Int_t startRun, Int_t endRun, const char *comment=0);
75 static void MakeTrackDistortionTree(TTree *tinput, Int_t dtype, Int_t ptype, const TObjArray * corrArray, Int_t step=1, Int_t offset=0, Bool_t debug=0);
76 static void MakeSectorDistortionTree(TTree *tinput, Int_t dtype, Int_t ptype, const TObjArray * corrArray, Int_t step=1, Int_t offset=0, Bool_t debug=0);
77 static void MakeLaserDistortionTreeOld(TTree* tree, TObjArray *corrArray, Int_t itype);
78 static void MakeLaserDistortionTree(TTree* tree, TObjArray *corrArray, Int_t itype);
80 void FastSimDistortedVertex(Double_t orgVertex[3], Int_t nTracks, AliESDVertex &aV, AliESDVertex &avOrg, AliESDVertex &cV, AliESDVertex &cvOrg, TTreeSRedirector * const pcstream, Double_t etaCuts);
82 static void AddVisualCorrection(AliTPCCorrection* corr, Int_t position);
83 static Double_t GetCorrSector(Double_t sector, Double_t r, Double_t kZ, Int_t axisType, Int_t corrType=0);
84 static Double_t GetCorrXYZ(Double_t gx, Double_t gy, Double_t gz, Int_t axisType, Int_t corrType=0);
86 static Double_t GetCorrXYZDz(Double_t gx, Double_t gy, Double_t gz, Int_t axisType, Int_t corrType=0,Double_t delta=5);
87 static Double_t GetCorrXYZIntegrateZ(Double_t gx, Double_t gy, Double_t gz, Int_t axisType, Int_t corrType=0, Double_t delta=5);
91 TH2F* CreateTH2F(const char *name,const char *title,
92 const char *xlabel,const char *ylabel,const char *zlabel,
93 Int_t nbinsx,Double_t xlow,Double_t xup,
94 Int_t nbinsy,Double_t ylow,Double_t yup);
96 static const Double_t fgkTPCZ0; // nominal gating grid position
97 static const Double_t fgkIFCRadius; // Mean Radius of the Inner Field Cage ( 82.43 min, 83.70 max) (cm)
98 static const Double_t fgkOFCRadius; // Mean Radius of the Outer Field Cage (252.55 min, 256.45 max) (cm)
99 static const Double_t fgkZOffSet; // Offset from CE: calculate all distortions closer to CE as if at this point
100 static const Double_t fgkCathodeV; // Cathode Voltage (volts)
101 static const Double_t fgkGG; // Gating Grid voltage (volts)
102 static const Double_t fgkdvdE; // [cm/V] drift velocity dependency on the E field (from Magboltz for NeCO2N2 at standard environment)
103 static const Double_t fgkEM; // charge/mass in [C/kg]
104 static const Double_t fgke0; // vacuum permittivity [A·s/(V·m)]
107 enum {kNR= 72 }; // Number of R points in the table for interpolating distortion data
108 enum {kNPhi= 18*10+1}; // Number of Phi points in the table for interpolating distortion data ( plus one extra for 360 == 0 )
109 enum {kNZ= 166}; // Number of Z points in the table for interpolating distortion data
111 Double_t fgkRList[kNR]; // points in the radial direction (for the lookup table)
112 Double_t fgkPhiList[kNPhi]; // points in the phi direction (for the lookup table)
113 Double_t fgkZList[kNZ]; // points in the z direction (for the lookup table)
115 // Simple Interpolation functions: e.g. with tricubic interpolation (not yet in TH3)
116 Int_t fILow, fJLow, fKLow; // variable to help in the interpolation
118 void Interpolate2DEdistortion( const Int_t order, const Double_t r, const Double_t z,
119 const Double_t er[kNZ][kNR], Double_t &erValue );
120 void Interpolate3DEdistortion( const Int_t order, const Double_t r, const Float_t phi, const Double_t z,
121 const Double_t er[kNZ][kNPhi][kNR], const Double_t ephi[kNZ][kNPhi][kNR],
122 const Double_t ez[kNZ][kNPhi][kNR],
123 Double_t &erValue, Double_t &ephiValue, Double_t &ezValue);
124 // TMatrixD versions (for e.g. Poisson relaxation)
125 Double_t Interpolate2DTable( const Int_t order, const Double_t x, const Double_t y,
126 const Int_t nx, const Int_t ny, const Double_t xv[], const Double_t yv[],
127 const TMatrixD &array );
128 Double_t Interpolate3DTable( const Int_t order, const Double_t x, const Double_t y, const Double_t z,
129 const Int_t nx, const Int_t ny, const Int_t nz,
130 const Double_t xv[], const Double_t yv[], const Double_t zv[],
131 TMatrixD **arrayofArrays );
132 Double_t Interpolate( const Double_t xArray[], const Double_t yArray[],
133 const Int_t order, const Double_t x );
134 void Search( const Int_t n, const Double_t xArray[], const Double_t x, Int_t &low );
136 // TMatrixF versions (smaller size, e.g. for final look up table)
137 Float_t Interpolate2DTable( const Int_t order, const Double_t x, const Double_t y,
138 const Int_t nx, const Int_t ny, const Double_t xv[], const Double_t yv[],
139 const TMatrixF &array );
140 Float_t Interpolate3DTable( const Int_t order, const Double_t x, const Double_t y, const Double_t z,
141 const Int_t nx, const Int_t ny, const Int_t nz,
142 const Double_t xv[], const Double_t yv[], const Double_t zv[],
143 TMatrixF **arrayofArrays );
144 Float_t Interpolate( const Double_t xArray[], const Float_t yArray[],
145 const Int_t order, const Double_t x );
147 virtual Int_t IsPowerOfTwo ( Int_t i ) const ;
151 // Algorithms to solve the laplace or poisson equation
152 void PoissonRelaxation2D(TMatrixD &arrayV, TMatrixD &chargeDensity,
153 TMatrixD &arrayErOverEz, TMatrixD &arrayDeltaEz,
154 const Int_t rows, const Int_t columns, const Int_t iterations,
155 const Bool_t rocDisplacement = kTRUE);
157 void PoissonRelaxation3D( TMatrixD **arrayofArrayV, TMatrixD **arrayofChargeDensities,
158 TMatrixD **arrayofEroverEz, TMatrixD **arrayofEPhioverEz, TMatrixD **arrayofEz,
159 const Int_t rows, const Int_t columns, const Int_t phislices,
160 const Float_t deltaphi, const Int_t iterations, const Int_t summetry,
161 const Bool_t rocDisplacement = kTRUE);
164 Double_t fT1; // tensor term of wt - T1
165 Double_t fT2; // tensor term of wt - T2
166 static TObjArray *fgVisualCorrection; // array of orrection for visualization
168 AliTPCCorrection(const AliTPCCorrection &); // not implemented
169 AliTPCCorrection &operator=(const AliTPCCorrection &); // not implemented
171 void InitLookUpfulcrums(); // to initialize the grid of the look up table
173 ClassDef(AliTPCCorrection,4);