Additional data for track quality control (M.Ivanov)
[u/mrichter/AliRoot.git] / STEER / AliESDtrack.h
1 #ifndef ALIESDTRACK_H
2 #define ALIESDTRACK_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 //                          Class AliESDtrack
10 //   This is the class to deal with during the physics analysis of data
11 //      
12 //         Origin: Iouri Belikov, CERN, Jouri.Belikov@cern.ch 
13 //-------------------------------------------------------------------------
14 /*****************************************************************************
15  *  Use GetExternalParameters() and GetExternalCovariance() to access the    *
16  *      track information regardless of its internal representation.         *
17  * This formation is now fixed in the following way:                         *
18  *      external param0:   local Y-coordinate of a track (cm)                *
19  *      external param1:   local Z-coordinate of a track (cm)                *
20  *      external param2:   local sine of the track momentum azimuthal angle  *
21  *      external param3:   tangent of the track momentum dip angle           *
22  *      external param4:   1/pt (1/(GeV/c))                                  *
23  *****************************************************************************/
24
25 #include <TBits.h>
26 #include "AliExternalTrackParam.h"
27 #include "AliPID.h"
28 #include <TVector3.h>
29
30 class AliESDVertex;
31 class AliKalmanTrack;
32 class AliTrackPointArray;
33
34 const Int_t kNPlane = 6;
35
36 class AliESDtrack : public AliExternalTrackParam {
37 public:
38   AliESDtrack();
39   AliESDtrack(const AliESDtrack& track);
40   virtual ~AliESDtrack();
41   void MakeMiniESDtrack();
42   void SetID(Int_t id) { fID =id;}
43   Int_t GetID(){ return fID;}
44   void SetStatus(ULong_t flags) {fFlags|=flags;}
45   void ResetStatus(ULong_t flags) {fFlags&=~flags;}
46   Bool_t UpdateTrackParams(const AliKalmanTrack *t, ULong_t flags);
47   void SetIntegratedLength(Double_t l) {fTrackLength=l;}
48   void SetIntegratedTimes(const Double_t *times);
49   void SetESDpid(const Double_t *p);
50   void GetESDpid(Double_t *p) const;
51   
52   ULong_t GetStatus() const {return fFlags;}
53   Int_t GetLabel() const {return fLabel;}
54   void SetLabel(Int_t label) {fLabel = label;}
55
56   void GetExternalParameters(Double_t &x, Double_t p[5]) const;
57   void GetExternalCovariance(Double_t cov[15]) const;
58
59   Double_t GetIntegratedLength() const {return fTrackLength;}
60   void GetIntegratedTimes(Double_t *times) const;
61   Double_t GetMass() const;
62   TVector3 P3() const {Double_t p[3]; GetPxPyPz(p); return TVector3(p[0],p[1],p[2]);} //running track momentum
63   TVector3 X3() const {Double_t x[3]; GetXYZ(x); return TVector3(x[0],x[1],x[2]);}    //running track position 
64
65
66   Bool_t GetConstrainedPxPyPz(Double_t *p) const {
67     if (!fCp) return kFALSE;
68     return fCp->GetPxPyPz(p);
69   }
70   Bool_t GetConstrainedXYZ(Double_t *r) const {
71     if (!fCp) return kFALSE;
72     return fCp->GetXYZ(r);
73   }
74   Bool_t GetConstrainedExternalParameters
75               (Double_t &alpha, Double_t &x, Double_t p[5]) const;
76   Bool_t GetConstrainedExternalCovariance(Double_t cov[15]) const;
77   Double_t GetConstrainedChi2() const {return fCchi2;}
78
79
80   Bool_t GetInnerPxPyPz(Double_t *p) const {
81     if (!fIp) return kFALSE;
82     return fIp->GetPxPyPz(p);
83   }
84   Bool_t GetInnerXYZ(Double_t *r) const {
85     if (!fIp) return kFALSE;
86     return fIp->GetXYZ(r);
87   }
88   Bool_t GetInnerExternalParameters
89         (Double_t &alpha, Double_t &x, Double_t p[5]) const;
90   Bool_t GetInnerExternalCovariance(Double_t cov[15]) const;
91  
92
93   Bool_t GetOuterPxPyPz(Double_t *p) const {
94     if (!fOp) return kFALSE;
95     return fOp->GetPxPyPz(p);
96   }
97   Bool_t GetOuterXYZ(Double_t *r) const {
98     if (!fOp) return kFALSE;
99     return fOp->GetXYZ(r);
100   }
101   Bool_t GetOuterExternalParameters
102         (Double_t &alpha, Double_t &x, Double_t p[5]) const;
103   Bool_t GetOuterExternalCovariance(Double_t cov[15]) const;
104
105
106   Int_t GetNcls(Int_t idet) const;
107   Int_t GetClusters(Int_t idet, UInt_t *idx) const;
108  
109   void SetITSpid(const Double_t *p);
110   void SetITSChi2MIP(const Float_t *chi2mip);
111   void SetITStrack(AliKalmanTrack * track){fITStrack=track;}
112   void GetITSpid(Double_t *p) const;
113   Float_t GetITSsignal() const {return fITSsignal;}
114   Float_t GetITSchi2() const {return fITSchi2;}
115   Int_t GetITSclusters(UInt_t *idx) const;
116   Int_t GetITSLabel() const {return fITSLabel;}
117   Float_t GetITSFakeRatio() const {return fITSFakeRatio;}
118   AliKalmanTrack * GetITStrack(){return fITStrack;}
119
120   void SetTPCpid(const Double_t *p);
121   void GetTPCpid(Double_t *p) const;
122   void SetTPCPoints(Float_t points[4]){for (Int_t i=0;i<4;i++) fTPCPoints[i]=points[i];}
123   void SetTPCPointsF(UChar_t  findable){fTPCnclsF = findable;}
124   Float_t GetTPCPoints(Int_t i){return fTPCPoints[i];}
125   void SetKinkIndexes(Int_t points[3]) {for (Int_t i=0;i<3;i++) fKinkIndexes[i] = points[i];}
126   void SetV0Indexes(Int_t points[3]) {for (Int_t i=0;i<3;i++) fV0Indexes[i] = points[i];}
127   void SetTPCsignal(Float_t signal, Float_t sigma, UChar_t npoints){ fTPCsignal = signal; fTPCsignalS = sigma; fTPCsignalN = npoints;}
128   Float_t GetTPCsignal() const {return fTPCsignal;}
129   Float_t GetTPCchi2() const {return fTPCchi2;}
130   Int_t GetTPCclusters(Int_t *idx) const;
131   Float_t GetTPCdensity(Int_t row0, Int_t row1) const;
132   Int_t GetTPCLabel() const {return fTPCLabel;}
133   Int_t GetKinkIndex(Int_t i) const { return fKinkIndexes[i];}
134   Int_t GetV0Index(Int_t i) const { return fV0Indexes[i];}
135   const TBits& GetTPCClusterMap() const {return fTPCClusterMap;}
136   
137   void SetTRDpid(const Double_t *p);
138   void     SetTRDQuality(Float_t quality){fTRDQuality=quality;}
139   Float_t  GetTRDQuality()const {return fTRDQuality;}
140   void     SetTRDBudget(Float_t budget){fTRDBudget=budget;}
141   Float_t  GetTRDBudget()const {return fTRDBudget;}
142   void SetTRDtrack(AliKalmanTrack * track){fTRDtrack=track;}
143   void SetTRDsignals(Float_t dedx, Int_t i) {fTRDsignals[i]=dedx;}
144   void SetTRDTimBin(Int_t timbin, Int_t i) {fTRDTimBin[i]=timbin;}
145   void GetTRDpid(Double_t *p) const;
146   Float_t GetTRDsignal() const {return fTRDsignal;}
147   Float_t GetTRDsignals(Int_t i) const {return fTRDsignals[i];}
148   Int_t GetTRDTimBin(Int_t i) const {return fTRDTimBin[i];}
149   Float_t GetTRDchi2() const {return fTRDchi2;}
150   Int_t GetTRDclusters(UInt_t *idx) const;
151   Int_t GetTRDncls() const {return fTRDncls;}
152   void    SetTRDpid(Int_t iSpecies, Float_t p);
153   Float_t GetTRDpid(Int_t iSpecies) const;
154   Int_t GetTRDLabel() const {return fTRDLabel;}
155
156
157   AliKalmanTrack * GetTRDtrack(){return fTRDtrack;}
158
159   void SetTOFsignal(Double_t tof) {fTOFsignal=tof;}
160   Float_t GetTOFsignal() const {return fTOFsignal;}
161   Float_t GetTOFchi2() const {return fTOFchi2;}
162   void    SetTOFpid(const Double_t *p);
163   void    SetTOFLabel(const Int_t *p);
164   void    GetTOFpid(Double_t *p) const;
165   void    GetTOFLabel(Int_t *p) const;
166   void    GetTOFInfo(Float_t *info) const;
167   void    SetTOFInfo(Float_t *info);
168   UInt_t  GetTOFcluster() const {return fTOFindex;}
169   void  SetTOFcluster(UInt_t index) {fTOFindex=index;}
170   
171   void    SetRICHsignal(Double_t beta) {fRICHsignal=beta;}
172   Float_t GetRICHsignal() const {return fRICHsignal;}
173   void    SetRICHpid(const Double_t *p);
174   void    GetRICHpid(Double_t *p) const;
175   void    SetRICHchi2(Double_t chi2) {fRICHchi2=chi2;}
176   Float_t GetRICHchi2() const {return fRICHchi2;}
177   void    SetRICHcluster(UInt_t index) {fRICHindex=index;}
178   UInt_t  GetRICHcluster() const {return fRICHindex;}
179   void    SetRICHnclusters(Int_t n) {fRICHncls=n;}
180   Int_t   GetRICHnclusters() const {return fRICHncls;}
181   void    SetRICHthetaPhi(Double_t theta, Double_t phi) {
182     fRICHtheta=theta; fRICHphi=phi;
183   }
184   void    GetRICHthetaPhi(Double_t &theta, Double_t &phi) const {
185     theta=fRICHtheta; phi=fRICHphi;
186   }
187   void    SetRICHdxdy(Double_t dx, Double_t dy) {
188     fRICHdx=dx; fRICHdy=dy;
189   }
190   void    GetRICHdxdy(Double_t &dx, Double_t &dy) const {
191     dx=fRICHdx; dy=fRICHdy;
192   }
193   
194   void SetPHOSposition(const Double_t *pos)  {
195     fPHOSpos[0] = pos[0]; fPHOSpos[1]=pos[1]; fPHOSpos[2]=pos[2];
196   }
197   void SetPHOSsignal(Double_t ene) {fPHOSsignal = ene; }
198   void SetPHOSpid(const Double_t *p);
199   void GetPHOSposition(Double_t *pos) const {
200     pos[0]=fPHOSpos[0]; pos[1]=fPHOSpos[1]; pos[2]=fPHOSpos[2];
201   }
202   Float_t GetPHOSsignal() const {return fPHOSsignal;}
203   void GetPHOSpid(Double_t *p) const;  
204
205   void SetEMCALposition(const Double_t *pos)  {
206     fEMCALpos[0] = pos[0]; fEMCALpos[1]=pos[1]; fEMCALpos[2]=pos[2];
207   }
208   void SetEMCALsignal(Double_t ene) {fEMCALsignal = ene; }
209   void SetEMCALpid(const Double_t *p);
210   void GetEMCALposition(Double_t *pos) const {
211     pos[0]=fEMCALpos[0]; pos[1]=fEMCALpos[1]; pos[2]=fEMCALpos[2];
212   }
213   Float_t GetEMCALsignal() const {return fEMCALsignal;}
214   void GetEMCALpid(Double_t *p) const;  
215
216   Bool_t IsOn(Int_t mask) const {return (fFlags&mask)>0;}
217   Bool_t IsRICH()  const {return fFlags&kRICHpid;}
218   Bool_t IsPHOS()  const {return fFlags&kPHOSpid;}
219   Bool_t IsEMCAL() const {return fFlags&kEMCALpid;}
220
221   void   SetTrackPointArray(AliTrackPointArray *points) { fPoints = points; }
222   AliTrackPointArray *GetTrackPointArray() const { return fPoints; }
223
224   Bool_t 
225     RelateToVertex(const AliESDVertex *vtx, Double_t b, Double_t maxd);
226   void GetImpactParameters(Float_t &xy,Float_t &z) const {xy=fD; z=fZ;}
227   void GetImpactParameters(Float_t p[2], Float_t cov[3]) const {
228     p[0]=fD; p[1]=fZ; cov[0]=fCdd; cov[1]=fCdz; cov[2]=fCzz;
229   }
230   virtual void Print(Option_t * opt) const ; 
231
232   enum {
233     kITSin=0x0001,kITSout=0x0002,kITSrefit=0x0004,kITSpid=0x0008,
234     kTPCin=0x0010,kTPCout=0x0020,kTPCrefit=0x0040,kTPCpid=0x0080,
235     kTRDin=0x0100,kTRDout=0x0200,kTRDrefit=0x0400,kTRDpid=0x0800,
236     kTOFin=0x1000,kTOFout=0x2000,kTOFrefit=0x4000,kTOFpid=0x8000,
237     kPHOSpid=0x10000, kRICHpid=0x20000, kEMCALpid=0x40000,
238     kTRDbackup=0x80000,
239     kTRDStop=0x20000000,
240     kESDpid=0x40000000,
241     kTIME=0x80000000
242   }; 
243 protected:
244   
245   //AliESDtrack & operator=(const AliESDtrack & );
246
247   ULong_t   fFlags;         // Reconstruction status flags 
248   Int_t     fLabel;         // Track label
249   Int_t     fID;            // Unique ID of the track
250   Float_t   fTrackLength;   // Track length
251   Float_t   fD;             // Impact parameter in XY plane
252   Float_t   fZ;             // Impact parameter in Z
253   Float_t   fCdd,fCdz,fCzz; // Covariance matrix of the impact parameters 
254   Float_t   fTrackTime[AliPID::kSPECIES]; // TOFs estimated by the tracking
255   Float_t   fR[AliPID::kSPECIES]; // combined "detector response probability"
256
257   Int_t   fStopVertex;  // Index of the stop vertex
258
259 //Track parameters constrained to the primary vertex
260   AliExternalTrackParam *fCp; 
261   Double_t fCchi2; //chi2 at the primary vertex
262
263 //Track parameters at the inner wall of the TPC
264   AliExternalTrackParam *fIp;
265
266 //Track parameters at the inner wall of the TRD 
267   AliExternalTrackParam *fOp;
268
269   // ITS related track information
270   Float_t fITSchi2;        // chi2 in the ITS
271   Float_t fITSchi2MIP[12];     // chi2s in the ITS
272   Int_t   fITSncls;        // number of clusters assigned in the ITS
273   UInt_t  fITSindex[6];    //! indices of the assigned ITS clusters
274   Float_t fITSsignal;      // detector's PID signal
275   Float_t fITSr[AliPID::kSPECIES]; // "detector response probabilities" (for the PID)
276   Int_t   fITSLabel;       // label according TPC
277   Float_t fITSFakeRatio;   // ration of fake tracks
278   AliKalmanTrack * fITStrack; //! OWNER: pointer to the ITS track -- currently for debug purpose
279   
280   // TPC related track information
281   Float_t fTPCchi2;        // chi2 in the TPC
282   Int_t   fTPCncls;        // number of clusters assigned in the TPC
283   UShort_t fTPCnclsF;      // number of findable clusters in the TPC
284   Int_t  fTPCindex[180];  //! indices of the assigned TPC clusters
285   TBits   fTPCClusterMap;  // Map of clusters, one bit per padrow; 1 if has a cluster on given padrow
286   Float_t fTPCsignal;      // detector's PID signal
287   UShort_t fTPCsignalN;      // number of points used for dEdx
288   Float_t  fTPCsignalS;    // RMS of dEdx measurement
289   Float_t fTPCr[AliPID::kSPECIES]; // "detector response probabilities" (for the PID)
290   Int_t   fTPCLabel;       // label according TPC
291   Float_t fTPCPoints[4];   // TPC points -first, max. dens, last and max density
292   Int_t   fKinkIndexes[3]; // array of indexes of posible kink candidates 
293   Int_t   fV0Indexes[3]; // array of indexes of posible kink candidates 
294
295   // TRD related track information
296   Float_t fTRDchi2;        // chi2 in the TRD
297   Int_t   fTRDncls;        // number of clusters assigned in the TRD
298   Int_t   fTRDncls0;       // number of clusters assigned in the TRD before first material cross
299   UInt_t  fTRDindex[180];   //! indices of the assigned TRD clusters
300   Float_t fTRDsignal;      // detector's PID signal
301   Float_t fTRDsignals[kNPlane];  // TRD signals from all six planes
302   Int_t fTRDTimBin[kNPlane];     // Time bin of Max cluster from all six planes
303   Float_t fTRDr[AliPID::kSPECIES]; // "detector response probabilities" (for the PID)
304   Int_t   fTRDLabel;       // label according TRD
305   Float_t fTRDQuality;     //trd quality factor for TOF
306   Float_t fTRDBudget;     //trd material budget
307   AliKalmanTrack * fTRDtrack; //! OWNER: pointer to the TRD track -- currently for debug purpose
308
309   // TOF related track information
310   Float_t fTOFchi2;        // chi2 in the TOF
311   UInt_t  fTOFindex;       // index of the assigned TOF cluster
312   Float_t fTOFsignal;      // detector's PID signal
313   Float_t fTOFr[AliPID::kSPECIES]; // "detector response probabilities" (for the PID)
314   Int_t   fTOFLabel[3];       // TOF label 
315   Float_t fTOFInfo[10];       //! TOF informations
316
317   // PHOS related track information 
318   Float_t fPHOSpos[3]; // position localised by PHOS in global coordinate system
319   Float_t fPHOSsignal; // energy measured by PHOS
320   Float_t fPHOSr[AliPID::kSPECIESN]; // PID information from PHOS
321
322   // EMCAL related track information 
323   Float_t fEMCALpos[3]; //position localised by EMCAL in global coordinate system
324   Float_t fEMCALsignal; // energy measured by EMCAL
325   Float_t fEMCALr[AliPID::kSPECIESN]; // PID information from EMCAL
326
327   // HMPID related track information
328   Float_t fRICHchi2;       // chi2 in the RICH
329   Int_t   fRICHncls;       // number of photon clusters
330   UInt_t  fRICHindex;      // index of the assigned MIP cluster
331   Float_t fRICHsignal;     // RICH PID signal
332   Float_t fRICHr[AliPID::kSPECIES];// "detector response probabilities" (for the PID)
333   Float_t fRICHtheta;      // theta of the track extrapolated to the RICH
334   Float_t fRICHphi;        // phi of the track extrapolated to the RICH
335   Float_t fRICHdx;         // x of the track impact minus x of the MIP
336   Float_t fRICHdy;         // y of the track impact minus y of the MIP
337
338   AliTrackPointArray *fPoints; // Array which contains the track space points in the global frame
339
340   ClassDef(AliESDtrack,22)  //ESDtrack 
341 };
342
343 #endif 
344