3 /* Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
4 * See cxx source for full Copyright notice */
8 //-------------------------------------------------------------------------
10 // This is the class to deal with during the physics analysis of data
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)) *
24 * The Get*Label() getters return the label of the associated MC particle. *
25 * The absolute value of this label is the index of the particle within the *
26 * MC stack. If the label is negative, this track was assigned a certain *
27 * number of clusters that did not in fact belong to this track. *
28 *****************************************************************************/
31 #include "AliExternalTrackParam.h"
32 #include "AliVTrack.h"
34 #include "AliESDfriendTrack.h"
39 class AliTrackPointArray;
42 class AliESDtrack : public AliExternalTrackParam {
45 kITSin=0x0001,kITSout=0x0002,kITSrefit=0x0004,kITSpid=0x0008,
46 kTPCin=0x0010,kTPCout=0x0020,kTPCrefit=0x0040,kTPCpid=0x0080,
47 kTRDin=0x0100,kTRDout=0x0200,kTRDrefit=0x0400,kTRDpid=0x0800,
48 kTOFin=0x1000,kTOFout=0x2000,kTOFrefit=0x4000,kTOFpid=0x8000,
49 kHMPIDout=0x10000,kHMPIDpid=0x20000,
55 kGlobalMerge=0x08000000
62 AliESDtrack(const AliESDtrack& track);
63 AliESDtrack(const AliVTrack* track);
64 AliESDtrack(TParticle * part);
65 virtual ~AliESDtrack();
66 virtual void Copy(TObject &obj) const;
67 const AliESDfriendTrack *GetFriendTrack() const {return fFriendTrack;}
68 void SetFriendTrack(const AliESDfriendTrack *t) {
69 delete fFriendTrack; fFriendTrack=new AliESDfriendTrack(*t);
71 void ReleaseESDfriendTrack() { delete fFriendTrack; fFriendTrack=0; }
72 void AddCalibObject(TObject * object); // add calib object to the list
73 TObject * GetCalibObject(Int_t index); // return calib objct at given position
74 void MakeMiniESDtrack();
75 void SetID(Int_t id) { fID =id;}
76 Int_t GetID() const { return fID;}
77 void SetVertexID(Char_t id) { fVertexID=id;}
78 Char_t GetVertexID() const { return fVertexID;}
79 void SetStatus(ULong_t flags) {fFlags|=flags;}
80 void ResetStatus(ULong_t flags) {fFlags&=~flags;}
81 Bool_t UpdateTrackParams(const AliKalmanTrack *t, ULong_t flags);
82 void SetIntegratedLength(Double_t l) {fTrackLength=l;}
83 void SetIntegratedTimes(const Double_t *times);
84 void SetESDpid(const Double_t *p);
85 void GetESDpid(Double_t *p) const;
86 virtual const Double_t *PID() const { return fR; }
88 Bool_t IsOn(Int_t mask) const {return (fFlags&mask)>0;}
89 ULong_t GetStatus() const {return fFlags;}
90 Int_t GetLabel() const {return fLabel;}
91 void SetLabel(Int_t label) {fLabel = label;}
93 void GetExternalParameters(Double_t &x, Double_t p[5]) const;
94 void GetExternalCovariance(Double_t cov[15]) const;
96 Double_t GetIntegratedLength() const {return fTrackLength;}
97 void GetIntegratedTimes(Double_t *times) const;
98 Double_t GetMass() const;
99 Double_t M() const { return GetMass(); }
103 Bool_t GetConstrainedPxPyPz(Double_t *p) const {
104 if (!fCp) return kFALSE;
105 return fCp->GetPxPyPz(p);
107 Bool_t GetConstrainedXYZ(Double_t *r) const {
108 if (!fCp) return kFALSE;
109 return fCp->GetXYZ(r);
111 const AliExternalTrackParam *GetConstrainedParam() const {return fCp;}
112 Bool_t GetConstrainedExternalParameters
113 (Double_t &alpha, Double_t &x, Double_t p[5]) const;
114 Bool_t GetConstrainedExternalCovariance(Double_t cov[15]) const;
115 Double_t GetConstrainedChi2() const {return fCchi2;}
119 void SetGlobalChi2(Double_t chi2) {fGlobalChi2 = chi2;}
120 Double_t GetGlobalChi2() const {return fGlobalChi2;}
122 Bool_t GetInnerPxPyPz(Double_t *p) const {
123 if (!fIp) return kFALSE;
124 return fIp->GetPxPyPz(p);
126 const AliExternalTrackParam * GetInnerParam() const { return fIp;}
127 const AliExternalTrackParam * GetTPCInnerParam() const {return fTPCInner;}
128 Bool_t FillTPCOnlyTrack(AliESDtrack &track);
129 Bool_t GetInnerXYZ(Double_t *r) const {
130 if (!fIp) return kFALSE;
131 return fIp->GetXYZ(r);
133 Bool_t GetInnerExternalParameters
134 (Double_t &alpha, Double_t &x, Double_t p[5]) const;
135 Bool_t GetInnerExternalCovariance(Double_t cov[15]) const;
137 void SetOuterParam(const AliExternalTrackParam *p, ULong_t flags);
139 void SetOuterHmpParam(const AliExternalTrackParam *p, ULong_t flags);
141 const AliExternalTrackParam * GetOuterParam() const { return fOp;}
143 const AliExternalTrackParam * GetOuterHmpParam() const { return fHMPIDp;}
145 Bool_t GetOuterPxPyPz(Double_t *p) const {
146 if (!fOp) return kFALSE;
147 return fOp->GetPxPyPz(p);
149 Bool_t GetOuterHmpPxPyPz(Double_t *p) const {
150 if (!fHMPIDp) return kFALSE;
151 return fHMPIDp->GetPxPyPz(p);
154 Bool_t GetOuterXYZ(Double_t *r) const {
155 if (!fOp) return kFALSE;
156 return fOp->GetXYZ(r);
158 Bool_t GetOuterHmpXYZ(Double_t *r) const {
159 if (!fHMPIDp) return kFALSE;
160 return fHMPIDp->GetXYZ(r);
163 Bool_t GetOuterExternalParameters
164 (Double_t &alpha, Double_t &x, Double_t p[5]) const;
165 Bool_t GetOuterExternalCovariance(Double_t cov[15]) const;
167 Bool_t GetOuterHmpExternalParameters
168 (Double_t &alpha, Double_t &x, Double_t p[5]) const;
169 Bool_t GetOuterHmpExternalCovariance(Double_t cov[15]) const;
172 Int_t GetNcls(Int_t idet) const;
173 Int_t GetClusters(Int_t idet, Int_t *idx) const;
175 void SetITSpid(const Double_t *p);
176 void GetITSpid(Double_t *p) const;
178 Double_t GetITSsignal() const {return fITSsignal;}
179 void SetITSdEdxSamples(const Double_t s[4]);
180 void GetITSdEdxSamples(Double_t *s) const;
182 Double_t GetITSchi2() const {return fITSchi2;}
183 Char_t GetITSclusters(Int_t *idx) const;
184 UChar_t GetITSClusterMap() const {return fITSClusterMap;}
185 void SetITSModuleIndex(Int_t ilayer,Int_t idx) {fITSModule[ilayer]=idx;}
186 Int_t GetITSModuleIndex(Int_t ilayer) const {return fITSModule[ilayer];}
187 Bool_t GetITSModuleIndexInfo(Int_t ilayer,Int_t &idet,Int_t &status,
188 Float_t &xloc,Float_t &zloc) const;
189 Int_t GetITSLabel() const {return fITSLabel;}
190 void SetITStrack(AliKalmanTrack * track){
191 fFriendTrack->SetITStrack(track);
193 AliKalmanTrack *GetITStrack(){
194 return fFriendTrack->GetITStrack();
196 Bool_t HasPointOnITSLayer(Int_t i) const {return TESTBIT(fITSClusterMap,i);}
198 void SetTPCpid(const Double_t *p);
199 void GetTPCpid(Double_t *p) const;
200 void SetTPCPoints(Float_t points[4]){
201 for (Int_t i=0;i<4;i++) fTPCPoints[i]=points[i];
203 void SetTPCPointsF(UChar_t findable){fTPCnclsF = findable;}
204 UShort_t GetTPCNcls() const { return fTPCncls;}
205 UShort_t GetTPCNclsF() const { return fTPCnclsF;}
206 Double_t GetTPCPoints(Int_t i) const {return fTPCPoints[i];}
207 void SetKinkIndexes(Int_t points[3]) {
208 for (Int_t i=0;i<3;i++) fKinkIndexes[i] = points[i];
210 void SetV0Indexes(Int_t points[3]) {
211 for (Int_t i=0;i<3;i++) fV0Indexes[i] = points[i];
213 void SetTPCsignal(Float_t signal, Float_t sigma, UChar_t npoints){
214 fTPCsignal = signal; fTPCsignalS = sigma; fTPCsignalN = npoints;
216 Double_t GetTPCsignal() const {return fTPCsignal;}
217 Double_t GetTPCsignalSigma() const {return fTPCsignalS;}
218 UShort_t GetTPCsignalN() const {return fTPCsignalN;}
219 Double_t GetTPCchi2() const {return fTPCchi2;}
220 UShort_t GetTPCclusters(Int_t *idx) const;
221 Double_t GetTPCdensity(Int_t row0, Int_t row1) const;
222 Int_t GetTPCLabel() const {return fTPCLabel;}
223 Int_t GetKinkIndex(Int_t i) const { return fKinkIndexes[i];}
224 Int_t GetV0Index(Int_t i) const { return fV0Indexes[i];}
225 const TBits& GetTPCClusterMap() const {return fTPCClusterMap;}
226 const TBits& GetTPCSharedMap() const {return fTPCSharedMap;}
227 void SetTPCClusterMap(const TBits amap) {fTPCClusterMap = amap;}
228 void SetTPCSharedMap(const TBits amap) {fTPCSharedMap = amap;}
230 void SetTRDpid(const Double_t *p);
233 void SetTRDntracklets(UChar_t q){fTRDntracklets = q;}
234 UChar_t GetTRDntracklets() const {return (fTRDntracklets>>3)&7;}
235 UChar_t GetTRDntrackletsPID() const {return fTRDntracklets&7;}
236 // TEMPORARY alias asked by the HFE group to allow
237 // reading of the v4-16-Release data with TRUNK related software (A.Bercuci@Apr 30th 09)
238 UChar_t GetTRDpidQuality() const {return GetTRDntrackletsPID();}
241 void SetNumberOfTRDslices(Int_t n);
242 Int_t GetNumberOfTRDslices() const;
243 void SetTRDslice(Double_t q, Int_t plane, Int_t slice);
244 void SetTRDmomentum(Double_t p, Int_t plane, Double_t *sp=0x0);
245 Double_t GetTRDslice(Int_t plane, Int_t slice=-1) const;
246 Double_t GetTRDmomentum(Int_t plane, Double_t *sp=0x0) const;
248 void SetTRDQuality(Float_t quality){fTRDQuality=quality;}
249 Double_t GetTRDQuality()const {return fTRDQuality;}
250 void SetTRDBudget(Float_t budget){fTRDBudget=budget;}
251 Double_t GetTRDBudget()const {return fTRDBudget;}
253 void SetTRDTimBin(Int_t timbin, Int_t i) {fTRDTimBin[i]=timbin;}
254 void GetTRDpid(Double_t *p) const;
255 Double_t GetTRDsignal() const {return fTRDsignal;}
257 Char_t GetTRDTimBin(Int_t i) const {return fTRDTimBin[i];}
258 Double_t GetTRDchi2() const {return fTRDchi2;}
259 UChar_t GetTRDclusters(Int_t *idx) const;
260 UChar_t GetTRDncls() const {return fTRDncls;}
261 UChar_t GetTRDncls0() const {return fTRDncls0;}
262 UChar_t GetTRDtracklets(Int_t *idx) const;
263 void SetTRDpid(Int_t iSpecies, Float_t p);
264 Double_t GetTRDpid(Int_t iSpecies) const;
265 Int_t GetTRDLabel() const {return fTRDLabel;}
267 void SetTRDtrack(AliKalmanTrack * track){
268 fFriendTrack->SetTRDtrack(track);
270 AliKalmanTrack *GetTRDtrack(){
271 return fFriendTrack->GetTRDtrack();
274 void SetTOFsignal(Double_t tof) {fTOFsignal=tof;}
275 Double_t GetTOFsignal() const {return fTOFsignal;}
276 void SetTOFsignalToT(Double_t ToT) {fTOFsignalToT=ToT;}
277 Double_t GetTOFsignalToT() const {return fTOFsignalToT;}
278 void SetTOFsignalRaw(Double_t tof) {fTOFsignalRaw=tof;}
279 Double_t GetTOFsignalRaw() const {return fTOFsignalRaw;}
280 void SetTOFsignalDz(Double_t dz) {fTOFsignalDz=dz;}
281 Double_t GetTOFsignalDz() const {return fTOFsignalDz;}
282 Double_t GetTOFchi2() const {return fTOFchi2;}
283 void SetTOFpid(const Double_t *p);
284 void SetTOFLabel(const Int_t *p);
285 void GetTOFpid(Double_t *p) const;
286 void GetTOFLabel(Int_t *p) const;
287 void GetTOFInfo(Float_t *info) const;
288 void SetTOFInfo(Float_t *info);
289 Int_t GetTOFCalChannel() const {return fTOFCalChannel;}
290 Int_t GetTOFcluster() const {return fTOFindex;}
291 void SetTOFcluster(Int_t index) {fTOFindex=index;}
292 void SetTOFCalChannel(Int_t index) {fTOFCalChannel=index;}
294 // HMPID methodes +++++++++++++++++++++++++++++++++ (kir)
295 void SetHMPIDsignal(Double_t theta) {fHMPIDsignal=theta;}
296 Double_t GetHMPIDsignal() const {return fHMPIDsignal;}
297 void SetHMPIDpid(const Double_t *p);
298 void GetHMPIDpid(Double_t *p) const;
299 void SetHMPIDchi2(Double_t chi2) {fHMPIDchi2=chi2;}
300 Double_t GetHMPIDchi2() const {return fHMPIDchi2;}
301 void SetHMPIDcluIdx(Int_t ch,Int_t idx) {fHMPIDcluIdx=ch*1000000+idx;}
302 Int_t GetHMPIDcluIdx() const {return fHMPIDcluIdx;}
303 void SetHMPIDtrk(Float_t x, Float_t y, Float_t th, Float_t ph) {
304 fHMPIDtrkX=x; fHMPIDtrkY=y; fHMPIDtrkTheta=th; fHMPIDtrkPhi=ph;
306 void GetHMPIDtrk(Float_t &x, Float_t &y, Float_t &th, Float_t &ph) const {
307 x=fHMPIDtrkX; y=fHMPIDtrkY; th=fHMPIDtrkTheta; ph=fHMPIDtrkPhi;
309 void SetHMPIDmip(Float_t x, Float_t y, Int_t q, Int_t nph=0) {
310 fHMPIDmipX=x; fHMPIDmipY=y; fHMPIDqn=1000000*nph+q;
312 void GetHMPIDmip(Float_t &x,Float_t &y,Int_t &q,Int_t &nph) const {
313 x=fHMPIDmipX; y=fHMPIDmipY; q=fHMPIDqn%1000000; nph=fHMPIDqn/1000000;
315 Bool_t IsHMPID() const {return fFlags&kHMPIDpid;}
318 Int_t GetEMCALcluster() {return fEMCALindex;}
319 void SetEMCALcluster(Int_t index) {fEMCALindex=index;}
320 Bool_t IsEMCAL() const {return fFlags&kEMCALmatch;}
322 void SetTrackPointArray(AliTrackPointArray *points) {
323 fFriendTrack->SetTrackPointArray(points);
325 const AliTrackPointArray *GetTrackPointArray() const {
326 return fFriendTrack->GetTrackPointArray();
328 Bool_t RelateToVertexTPC(const AliESDVertex *vtx, Double_t b, Double_t maxd,
329 AliExternalTrackParam *cParam=0);
331 RelateToVertexTPCBxByBz(const AliESDVertex *vtx, Double_t b[3],Double_t maxd,
332 AliExternalTrackParam *cParam=0);
333 void GetImpactParametersTPC(Float_t &xy,Float_t &z) const {xy=fdTPC; z=fzTPC;}
334 void GetImpactParametersTPC(Float_t p[2], Float_t cov[3]) const {
335 p[0]=fdTPC; p[1]=fzTPC; cov[0]=fCddTPC; cov[1]=fCdzTPC; cov[2]=fCzzTPC;
337 Double_t GetConstrainedChi2TPC() const {return fCchi2TPC;}
339 Bool_t RelateToVertex(const AliESDVertex *vtx, Double_t b, Double_t maxd,
340 AliExternalTrackParam *cParam=0);
342 RelateToVertexBxByBz(const AliESDVertex *vtx, Double_t b[3], Double_t maxd,
343 AliExternalTrackParam *cParam=0);
344 void GetImpactParameters(Float_t &xy,Float_t &z) const {xy=fD; z=fZ;}
345 void GetImpactParameters(Float_t p[2], Float_t cov[3]) const {
346 p[0]=fD; p[1]=fZ; cov[0]=fCdd; cov[1]=fCdz; cov[2]=fCzz;
348 virtual void Print(Option_t * opt) const ;
350 // visualization (M. Ivanov)
352 void FillPolymarker(TPolyMarker3D *pol, Float_t magf, Float_t minR, Float_t maxR, Float_t stepR);
356 AliExternalTrackParam *fCp; // Track parameters constrained to the primary vertex
357 AliExternalTrackParam *fIp; // Track parameters estimated at the inner wall of TPC
358 AliExternalTrackParam *fTPCInner; // Track parameters estimated at the inner wall of TPC using the TPC stand-alone
359 AliExternalTrackParam *fOp; // Track parameters estimated at the point of maximal radial coordinate reached during the tracking
360 AliExternalTrackParam *fHMPIDp; // Track parameters at HMPID
361 AliESDfriendTrack *fFriendTrack; //! All the complementary information
363 TBits fTPCClusterMap; // Map of clusters, one bit per padrow; 1 if has a cluster on given padrow
364 TBits fTPCSharedMap; // Map of clusters, one bit per padrow; 1 if has a shared cluster on given padrow
368 ULong_t fFlags; // Reconstruction status flags
369 Int_t fID; // Unique ID of the track
370 Int_t fLabel; // Track label
371 Int_t fITSLabel; // label according ITS
372 Int_t fITSModule[12]; // modules crossed by the track in the ITS
373 Int_t fTPCLabel; // label according TPC
374 Int_t fTRDLabel; // label according TRD
375 Int_t fTOFLabel[3]; // TOF label
376 Int_t fTOFCalChannel; // Channel Index of the TOF Signal
377 Int_t fTOFindex; // index of the assigned TOF cluster
378 Int_t fHMPIDqn; // 1000000*number of photon clusters + QDC
379 Int_t fHMPIDcluIdx; // 1000000*chamber id + cluster idx of the assigned MIP cluster
380 Int_t fEMCALindex; // index of associated EMCAL cluster (AliESDCaloCluster)
383 Int_t fKinkIndexes[3]; // array of indexes of posible kink candidates
384 Int_t fV0Indexes[3]; // array of indexes of posible kink candidates
386 Double32_t fR[AliPID::kSPECIES]; //[0.,0.,8] combined "detector response probability"
387 Double32_t fITSr[AliPID::kSPECIES]; //[0.,0.,8] "detector response probabilities" (for the PID)
388 Double32_t fTPCr[AliPID::kSPECIES]; //[0.,0.,8] "detector response probabilities" (for the PID)
389 Double32_t fTRDr[AliPID::kSPECIES]; //[0.,0.,8] "detector response probabilities" (for the PID)
390 Double32_t fTOFr[AliPID::kSPECIES]; //[0.,0.,8] "detector response probabilities" (for the PID)
391 Double32_t fHMPIDr[AliPID::kSPECIES];//[0.,0.,8] "detector response probabilities" (for the PID)
393 Double32_t fHMPIDtrkTheta;//[-2*pi,2*pi,16] theta of the track extrapolated to the HMPID, LORS
394 // how much of this is needed?
395 Double32_t fHMPIDtrkPhi; //[-2*pi,2*pi,16] phi of the track extrapolated to the HMPID, LORS
396 Double32_t fHMPIDsignal; // HMPID PID signal (Theta ckov, rad)
398 Double32_t fTrackTime[AliPID::kSPECIES]; // TOFs estimated by the tracking
399 Double32_t fTrackLength; // Track length
401 Double32_t fdTPC; // TPC-only impact parameter in XY plane
402 Double32_t fzTPC; // TPC-only impact parameter in Z
403 Double32_t fCddTPC,fCdzTPC,fCzzTPC; // Covariance matrix of the TPC-only impact parameters
404 Double32_t fCchi2TPC; // [0.,0.,8] TPC-only chi2 at the primary vertex
406 Double32_t fD; // Impact parameter in XY plane
407 Double32_t fZ; // Impact parameter in Z
408 Double32_t fCdd,fCdz,fCzz; // Covariance matrix of the impact parameters
409 Double32_t fCchi2; // [0.,0.,8] chi2 at the primary vertex
411 Double32_t fITSchi2; // [0.,0.,8] chi2 in the ITS
412 Double32_t fTPCchi2; // [0.,0.,8] chi2 in the TPC
413 Double32_t fTRDchi2; // [0.,0.,8] chi2 in the TRD
414 Double32_t fTOFchi2; // [0.,0.,8] chi2 in the TOF
415 Double32_t fHMPIDchi2; // [0.,0.,8] chi2 in the HMPID
417 Double32_t fGlobalChi2; // [0.,0.,8] chi2 of the global track
419 Double32_t fITSsignal; // [0.,0.,10] detector's PID signal
420 Double32_t fITSdEdxSamples[4]; // [0.,0.,10] ITS dE/dx samples
422 Double32_t fTPCsignal; // [0.,0.,10] detector's PID signal
423 Double32_t fTPCsignalS; // [0.,0.,10] RMS of dEdx measurement
424 Double32_t fTPCPoints[4]; // [0.,0.,10] TPC points -first, max. dens, last and max density
426 Double32_t fTRDsignal; // detector's PID signal
427 Double32_t fTRDQuality; // trd quality factor for TOF
428 Double32_t fTRDBudget; // trd material budget
430 Double32_t fTOFsignal; // detector's PID signal
431 Double32_t fTOFsignalToT; // detector's ToT signal
432 Double32_t fTOFsignalRaw; // detector's uncorrected time signal
433 Double32_t fTOFsignalDz; // local z of track's impact on the TOF pad
434 Double32_t fTOFInfo[10]; //! TOF informations
436 Double32_t fHMPIDtrkX; // x of the track impact, LORS
437 Double32_t fHMPIDtrkY; // y of the track impact, LORS
438 Double32_t fHMPIDmipX; // x of the MIP in LORS
439 Double32_t fHMPIDmipY; // y of the MIP in LORS
442 UShort_t fTPCncls; // number of clusters assigned in the TPC
443 UShort_t fTPCnclsF; // number of findable clusters in the TPC
444 UShort_t fTPCsignalN; // number of points used for dEdx
446 Char_t fITSncls; // number of clusters assigned in the ITS
447 UChar_t fITSClusterMap; // map of clusters, one bit per a layer
448 UChar_t fTRDncls; // number of clusters assigned in the TRD
449 UChar_t fTRDncls0; // number of clusters assigned in the TRD before first material cross
450 UChar_t fTRDntracklets; // number of TRD tracklets used for tracking/PID
452 Int_t fTRDnSlices; // number of slices used for PID in the TRD
453 Double32_t *fTRDslices; //[fTRDnSlices]
455 Char_t fTRDTimBin[kTRDnPlanes]; // Time bin of Max cluster from all six planes
456 Char_t fVertexID; // ID of the primary vertex this track belongs to
460 AliESDtrack & operator=(const AliESDtrack & );
461 ClassDef(AliESDtrack,52) //ESDtrack