[u/mrichter/AliRoot.git] / TRD / AliTRDtrackV1.h

#ifndef ALITRDTRACKV1_H
#define ALITRDTRACKV1_H
/* Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
 * See cxx source for full Copyright notice                               */

/* $Id$ */

///////////////////////////////////////////////////////////////////////////////
//                                                                           //
//  Represents a reconstructed TRD track                                     //
//                                                                           //
///////////////////////////////////////////////////////////////////////////////

#ifndef ALIKALMANTRACK_H
#include "AliKalmanTrack.h"
#endif

#ifndef ALITRDSEEDV1_H
#include "AliTRDseedV1.h"
#endif

class AliESDtrack;
class AliTRDcluster;
class AliTRDReconstructor;
class AliTRDtrackV1 : public AliKalmanTrack
{
  friend class AliHLTTRDTrack; // allow HLT special access
public:
  enum ETRDtrackSize { 
    kNdet      = AliTRDgeometry::kNdet
   ,kNstacks   = AliTRDgeometry::kNstack*AliTRDgeometry::kNsector
   ,kNplane    = AliTRDgeometry::kNlayer
   ,kNcham     = AliTRDgeometry::kNstack
   ,kNsect     = AliTRDgeometry::kNsector
   ,kNslice    =   3
   ,kNMLPslice =   8 
   ,kMAXCLUSTERSPERTRACK = 210
  };
  
  // bits from 0-13 are reserved by ROOT (see TObject.h)
  enum ETRDtrackStatus {
    kOwner     = BIT(14)
   ,kStopped   = BIT(15) 
   ,kKink      = BIT(16) 
   ,kPrimary   = BIT(17) 
  };

  // propagation/update error codes (up to 4 bits)
  enum ETRDtrackError {
    kProlongation = 1
   ,kPropagation
   ,kAdjustSector
   ,kSnp
   ,kTrackletInit
   ,kUpdate
   ,kUnknown      = 0xff
  };

  // data/clusters/tracklet error codes (up to 4 bits/layer)
  enum ETRDlayerError {
    kGeometry = 1
   ,kBoundary
   ,kNoClusters
   ,kNoAttach
   ,kNoClustersTracklet
   ,kNoFit
   ,kChi2
  };

  AliTRDtrackV1();
  AliTRDtrackV1(AliTRDseedV1 * const trklts, const Double_t p[5], const Double_t cov[15], Double_t x, Double_t alpha);
  AliTRDtrackV1(const AliESDtrack &ref);
  AliTRDtrackV1(const AliTRDtrackV1 &ref);
  virtual ~AliTRDtrackV1();
  AliTRDtrackV1 &operator=(const AliTRDtrackV1 &ref);
  virtual void   Copy(TObject &ref) const;
 
  Bool_t         CookPID();
  Bool_t         CookLabel(Float_t wrong);
  AliTRDtrackV1* GetBackupTrack() const {return fBackupTrack;}
  Double_t       GetBudget(Int_t i) const { return fBudget[i];}
  AliTRDcluster* GetCluster(Int_t id);
  Int_t          GetClusterIndex(Int_t id) const;
  Float_t        GetEdep() const {return fDE;}
  Int_t          GetESDid() const {return fESDid;}
  inline Float_t GetMomentum(Int_t plane=-1) const;
  inline Int_t   GetNCross();
  inline Int_t   GetNumberOfTracklets() const;
  Double_t       GetPIDsignal() const   { return 0.;}
  Double_t       GetPID(Int_t is) const { return (is >=0 && is < AliPID::kSPECIES) ? fPID[is] : -1.;}
  UChar_t        GetNumberOfTrackletsPID() const;
  Double_t       GetPredictedChi2(const AliTRDseedV1 *tracklet, Double_t *cov) const;
  Double_t       GetPredictedChi2(const AliCluster* /*c*/) const                   { return 0.0; }
  Int_t          GetProlongation(Double_t xk, Double_t &y, Double_t &z) const;
  inline UChar_t GetStatusTRD(Int_t ly=-1) const;
  Int_t          GetSector() const;
  AliTRDseedV1*  GetTracklet(Int_t plane) const {return plane >=0 && plane <kNplane ? fTracklet[plane] : NULL;}
  Int_t          GetTrackletIndex(Int_t plane) const          { return (plane>=0 && plane<kNplane) ? fTrackletIndex[plane] : -1;}
  AliExternalTrackParam*
                 GetTrackIn() const  { return fTrackLow;} 
  AliExternalTrackParam*
                 GetTrackOut() const  { return fTrackHigh;} 
  const Int_t* GetTrackletIndexes() const { return &fTrackletIndex[0];}
  
  Bool_t         IsEqual(const TObject *inTrack) const;
  Bool_t         IsKink() const    { return TestBit(kKink);}
  Bool_t         IsOwner() const   { return TestBit(kOwner);};
  Bool_t         IsPrimary() const   { return TestBit(kPrimary);};
  Bool_t         IsStopped() const { return TestBit(kStopped);};
  Bool_t         IsElectron() const;
  inline static Bool_t IsTrackError(ETRDtrackError error, UInt_t status);
  inline static Bool_t IsLayerError(ETRDlayerError error, Int_t layer, UInt_t status);

  Int_t          MakeBackupTrack();
  void           Print(Option_t *o="") const;

  Bool_t         PropagateTo(Double_t xr, Double_t x0 = 8.72, Double_t rho = 5.86e-3);
  Int_t          PropagateToR(Double_t xr, Double_t step);
  Bool_t         Rotate(Double_t angle, Bool_t absolute = kFALSE);
  void           SetBudget(Int_t i, Double_t b) {if(i>=0 && i<3) fBudget[i] = b;}
  void           SetEdep(Double32_t inDE){fDE = inDE;};
  void           SetESDid(Int_t id) {fESDid = id;}
  void           SetKink(Bool_t k)        { SetBit(kKink, k);}
  void           SetPrimary(Bool_t k)     { SetBit(kPrimary, k);}
  void           SetNumberOfClusters();
  void           SetOwner();
  void           SetPID(Short_t is, Double_t inPID){if (is >=0 && is < AliPID::kSPECIES) fPID[is]=inPID;};
  void           SetPIDquality(UChar_t /*inPIDquality*/) const {/*fPIDquality = inPIDquality*/;};
  inline void    SetStatus(UChar_t stat, Int_t ly=-1);
  void           SetStopped(Bool_t stop) {SetBit(kStopped, stop);}
  void           SetTracklet(AliTRDseedV1 *const trklt,  Int_t index);
  void           SetTrackIn();
  void           SetTrackOut(const AliExternalTrackParam *op=NULL);
  inline void    SetReconstructor(const AliTRDReconstructor *rec);
  inline Float_t StatusForTOF();
  void           UnsetTracklet(Int_t plane);
  Bool_t         Update(const AliCluster *, Double_t, Int_t) { return kFALSE; };
  void           UpdateChi2(Float_t chi2);
  void           UpdateESDtrack(AliESDtrack *t);

private:
  UInt_t       fStatus;                //  Bit map for the status of propagation
  Int_t        fTrackletIndex[kNplane];//  Tracklets index in the tracker list
  Int_t        fESDid;                 //  ESD track id 
  Double32_t   fPID[AliPID::kSPECIES]; //  PID probabilities
  Double32_t   fBudget[3];             //  Integrated material budget
  Double32_t   fDE;                    //  Integrated delta energy
  const AliTRDReconstructor *fkReconstructor;//! reconstructor link 
  AliTRDtrackV1 *fBackupTrack;         //! Backup track
  AliTRDseedV1  *fTracklet[kNplane];   //  Tracklets array defining the track
  AliExternalTrackParam *fTrackLow;    // parameters of the track which enter TRD from below (TPC) 
  AliExternalTrackParam *fTrackHigh;   // parameters of the track which enter TRD from above (HMPID, PHOS) 

  ClassDef(AliTRDtrackV1, 7)          // TRD track - tracklet based
};

//____________________________________________________
inline Float_t AliTRDtrackV1::GetMomentum(Int_t plane) const
{
// Return ESD momentum stored in the tracklet reconstructed in layer = "plane". 
// By default returns the ESD momentum in first tracklet attached to track
  if(plane==-1){
    for(Int_t i(0); i<kNplane; i++){
      if(fTracklet[i]) return fTracklet[i]->GetMomentum();
    }
  } else if( plane >=0 && plane < kNplane){
    if(fTracklet[plane]) return fTracklet[plane]->GetMomentum();
  }
  return -1.;
}

//____________________________________________________
inline Int_t AliTRDtrackV1::GetNCross()
{
  Int_t ncross = 0;
  for(Int_t ip=0; ip<kNplane; ip++){
    if(!fTracklet[ip]) continue;
    ncross += fTracklet[ip]->IsRowCross();
  }
  return ncross;
}

//____________________________________________________
inline Int_t AliTRDtrackV1::GetNumberOfTracklets() const
{
  Int_t n = 0;
  for(Int_t ip=0; ip<kNplane; ip++){
    if(!fTracklet[ip]) continue;
    n++;
  }
  return n;
}

//____________________________________________________
inline UChar_t AliTRDtrackV1::GetStatusTRD(Int_t ly) const
{
  if(ly>=-1 && ly<kNplane) return (fStatus>>((ly+1)*4))&0xf;
  return kUnknown;
}

//____________________________________________________
inline Bool_t AliTRDtrackV1::IsTrackError(ETRDtrackError error, UInt_t status)
{
  return (status&0xf)==UChar_t(error);
}

//____________________________________________________
inline Bool_t AliTRDtrackV1::IsLayerError(ETRDlayerError error, Int_t ly, UInt_t status)
{
  if(ly>=kNplane || ly<0) return kFALSE;
  return ((status>>((ly+1)*4))&0xf) == UChar_t(error);
}

//____________________________________________________
inline void AliTRDtrackV1::SetReconstructor(const AliTRDReconstructor *rec)
{
  for(Int_t ip=0; ip<kNplane; ip++){
    if(!fTracklet[ip]) continue;
    fTracklet[ip]->SetReconstructor(rec);
  }
  fkReconstructor = rec;
}

//____________________________________________________
inline void AliTRDtrackV1::SetStatus(UChar_t status, Int_t ly)
{
  if(ly<kNplane) fStatus|=((status&0xf)<<((ly+1)*4));
  return;
}


//____________________________________________________________________________
inline Float_t AliTRDtrackV1::StatusForTOF()
{
  // OBSOLETE
  // Defines the status of the TOF extrapolation
  //

  if(!fTracklet[5]) return 0.;

  // Definition of res ????
  Float_t res = /*(0.2 + 0.8 * (fN / (fNExpected + 5.0))) **/ (0.4 + 0.6 * fTracklet[5]->GetN() / 20.0);
  res *= (0.25 + 0.8 * 40.0 / (40.0 + fBudget[2]));
  return res;
}

#endif
Commit	Line	Data
d9950a5a	1	#ifndef ALITRDTRACKV1_H
	2	#define ALITRDTRACKV1_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
0906e73e	8	///////////////////////////////////////////////////////////////////////////////
	9	// //
	10	// Represents a reconstructed TRD track //
	11	// //
	12	///////////////////////////////////////////////////////////////////////////////
d9950a5a	13
d8069611	14	#ifndef ALIKALMANTRACK_H
3b57a3f7	15	#include "AliKalmanTrack.h"
d8069611	16	#endif
3b57a3f7	17
d8069611	18	#ifndef ALITRDSEEDV1_H
3b57a3f7	19	#include "AliTRDseedV1.h"
d8069611	20	#endif
d9950a5a	21
3b57a3f7	22	class AliESDtrack;
d8069611	23	class AliTRDcluster;
181c7f7e	24	class AliTRDReconstructor;
3b57a3f7	25	class AliTRDtrackV1 : public AliKalmanTrack
d9950a5a	26	{
d8069611	27	friend class AliHLTTRDTrack; // allow HLT special access
3b57a3f7	28	public:
eb2b4f91	29	enum ETRDtrackSize {
e3cf3d02	30	kNdet = AliTRDgeometry::kNdet
	31	,kNstacks = AliTRDgeometry::kNstack*AliTRDgeometry::kNsector
	32	,kNplane = AliTRDgeometry::kNlayer
	33	,kNcham = AliTRDgeometry::kNstack
	34	,kNsect = AliTRDgeometry::kNsector
	35	,kNslice = 3
	36	,kNMLPslice = 8
	37	,kMAXCLUSTERSPERTRACK = 210
	38	};
3b57a3f7	39
2e2915e7	40	// bits from 0-13 are reserved by ROOT (see TObject.h)
eb2b4f91	41	enum ETRDtrackStatus {
	42	kOwner = BIT(14)
	43	,kStopped = BIT(15)
	44	,kKink = BIT(16)
2eb10c34	45	,kPrimary = BIT(17)
eb2b4f91	46	};
	47
	48	// propagation/update error codes (up to 4 bits)
	49	enum ETRDtrackError {
	50	kProlongation = 1
	51	,kPropagation
	52	,kAdjustSector
	53	,kSnp
	54	,kTrackletInit
	55	,kUpdate
af4e990c	56	,kUnknown = 0xff
eb2b4f91	57	};
	58
	59	// data/clusters/tracklet error codes (up to 4 bits/layer)
	60	enum ETRDlayerError {
	61	kGeometry = 1
	62	,kBoundary
	63	,kNoClusters
	64	,kNoAttach
	65	,kNoClustersTracklet
	66	,kNoFit
	67	,kChi2
e44586fb	68	};
0906e73e	69
3b57a3f7	70	AliTRDtrackV1();
e17f4785	71	AliTRDtrackV1(AliTRDseedV1 * const trklts, const Double_t p[5], const Double_t cov[15], Double_t x, Double_t alpha);
3b57a3f7	72	AliTRDtrackV1(const AliESDtrack &ref);
	73	AliTRDtrackV1(const AliTRDtrackV1 &ref);
	74	virtual ~AliTRDtrackV1();
e08a5492	75	AliTRDtrackV1 &operator=(const AliTRDtrackV1 &ref);
	76	virtual void Copy(TObject &ref) const;
	77
3b57a3f7	78	Bool_t CookPID();
	79	Bool_t CookLabel(Float_t wrong);
	80	AliTRDtrackV1* GetBackupTrack() const {return fBackupTrack;}
	81	Double_t GetBudget(Int_t i) const { return fBudget[i];}
0349cc67	82	AliTRDcluster* GetCluster(Int_t id);
3b57a3f7	83	Int_t GetClusterIndex(Int_t id) const;
3b57a3f7	84	Float_t GetEdep() const {return fDE;}
352cef8f	85	Int_t GetESDid() const {return fESDid;}
c4a4e64f	86	inline Float_t GetMomentum(Int_t plane=-1) const;
3b57a3f7	87	inline Int_t GetNCross();
82180ec1	88	inline Int_t GetNumberOfTracklets() const;
1128e139	89	Double_t GetPIDsignal() const { return 0.;}
3b57a3f7	90	Double_t GetPID(Int_t is) const { return (is >=0 && is < AliPID::kSPECIES) ? fPID[is] : -1.;}
eb2b4f91	91	UChar_t GetNumberOfTrackletsPID() const;
b72f4eaf	92	Double_t GetPredictedChi2(const AliTRDseedV1 tracklet, Double_t cov) const;
3b57a3f7	93	Double_t GetPredictedChi2(const AliCluster* /c/) const { return 0.0; }
f8a9723f	94	Int_t GetProlongation(Double_t xk, Double_t &y, Double_t &z) const;
eb2b4f91	95	inline UChar_t GetStatusTRD(Int_t ly=-1) const;
eb2b4f91	96	Int_t GetSector() const;
4d6aee34	97	AliTRDseedV1* GetTracklet(Int_t plane) const {return plane >=0 && plane <kNplane ? fTracklet[plane] : NULL;}
e3cf3d02	98	Int_t GetTrackletIndex(Int_t plane) const { return (plane>=0 && plane<kNplane) ? fTrackletIndex[plane] : -1;}
e3cf3d02	99	AliExternalTrackParam*
a310e49b	100	GetTrackIn() const { return fTrackLow;}
e3cf3d02	101	AliExternalTrackParam*
a310e49b	102	GetTrackOut() const { return fTrackHigh;}
17896e82	103	const Int_t* GetTrackletIndexes() const { return &fTrackletIndex[0];}
3b57a3f7	104
203967fc	105	Bool_t IsEqual(const TObject *inTrack) const;
f29f13a6	106	Bool_t IsKink() const { return TestBit(kKink);}
f29f13a6	107	Bool_t IsOwner() const { return TestBit(kOwner);};
2eb10c34	108	Bool_t IsPrimary() const { return TestBit(kPrimary);};
f29f13a6	109	Bool_t IsStopped() const { return TestBit(kStopped);};
22a4ab0c	110	Bool_t IsElectron() const;
eb2b4f91	111	inline static Bool_t IsTrackError(ETRDtrackError error, UInt_t status);
	112	inline static Bool_t IsLayerError(ETRDlayerError error, Int_t layer, UInt_t status);
	113
b453ef55	114	Int_t MakeBackupTrack();
203967fc	115	void Print(Option_t *o="") const;
203967fc	116
3b57a3f7	117	Bool_t PropagateTo(Double_t xr, Double_t x0 = 8.72, Double_t rho = 5.86e-3);
	118	Int_t PropagateToR(Double_t xr, Double_t step);
	119	Bool_t Rotate(Double_t angle, Bool_t absolute = kFALSE);
	120	void SetBudget(Int_t i, Double_t b) {if(i>=0 && i<3) fBudget[i] = b;}
bee2b41e	121	void SetEdep(Double32_t inDE){fDE = inDE;};
352cef8f	122	void SetESDid(Int_t id) {fESDid = id;}
f29f13a6	123	void SetKink(Bool_t k) { SetBit(kKink, k);}
2eb10c34	124	void SetPrimary(Bool_t k) { SetBit(kPrimary, k);}
3b57a3f7	125	void SetNumberOfClusters();
3b57a3f7	126	void SetOwner();
bee2b41e	127	void SetPID(Short_t is, Double_t inPID){if (is >=0 && is < AliPID::kSPECIES) fPID[is]=inPID;};
4d6aee34	128	void SetPIDquality(UChar_t /inPIDquality/) const {/fPIDquality = inPIDquality/;};
eb2b4f91	129	inline void SetStatus(UChar_t stat, Int_t ly=-1);
e44586fb	130	void SetStopped(Bool_t stop) {SetBit(kStopped, stop);}
4d6aee34	131	void SetTracklet(AliTRDseedV1 *const trklt, Int_t index);
a310e49b	132	void SetTrackIn();
a310e49b	133	void SetTrackOut(const AliExternalTrackParam *op=NULL);
181c7f7e	134	inline void SetReconstructor(const AliTRDReconstructor *rec);
3b57a3f7	135	inline Float_t StatusForTOF();
181d2c97	136	void UnsetTracklet(Int_t plane);
4d6aee34	137	Bool_t Update(const AliCluster *, Double_t, Int_t) { return kFALSE; };
ef867f55	138	void UpdateChi2(Float_t chi2);
3b57a3f7	139	void UpdateESDtrack(AliESDtrack *t);
3b57a3f7	140
3b57a3f7	141	private:
eb2b4f91	142	UInt_t fStatus; // Bit map for the status of propagation
17896e82	143	Int_t fTrackletIndex[kNplane];// Tracklets index in the tracker list
352cef8f	144	Int_t fESDid; // ESD track id
eb2b4f91	145	Double32_t fPID[AliPID::kSPECIES]; // PID probabilities
	146	Double32_t fBudget[3]; // Integrated material budget
	147	Double32_t fDE; // Integrated delta energy
4d6aee34	148	const AliTRDReconstructor *fkReconstructor;//! reconstructor link
eb2b4f91	149	AliTRDtrackV1 *fBackupTrack; //! Backup track
17896e82	150	AliTRDseedV1 *fTracklet[kNplane]; // Tracklets array defining the track
eb2b4f91	151	AliExternalTrackParam *fTrackLow; // parameters of the track which enter TRD from below (TPC)
17896e82	152	AliExternalTrackParam *fTrackHigh; // parameters of the track which enter TRD from above (HMPID, PHOS)
d9950a5a	153
352cef8f	154	ClassDef(AliTRDtrackV1, 7) // TRD track - tracklet based
d9950a5a	155	};
d9950a5a	156
3b57a3f7	157	//____________________________________________________
	158	inline Float_t AliTRDtrackV1::GetMomentum(Int_t plane) const
	159	{
c4a4e64f	160	// Return ESD momentum stored in the tracklet reconstructed in layer = "plane".
	161	// By default returns the ESD momentum in first tracklet attached to track
	162	if(plane==-1){
	163	for(Int_t i(0); i<kNplane; i++){
	164	if(fTracklet[i]) return fTracklet[i]->GetMomentum();
	165	}
	166	} else if( plane >=0 && plane < kNplane){
	167	if(fTracklet[plane]) return fTracklet[plane]->GetMomentum();
	168	}
	169	return -1.;
3b57a3f7	170	}
	171
	172	//____________________________________________________
	173	inline Int_t AliTRDtrackV1::GetNCross()
	174	{
	175	Int_t ncross = 0;
	176	for(Int_t ip=0; ip<kNplane; ip++){
	177	if(!fTracklet[ip]) continue;
	178	ncross += fTracklet[ip]->IsRowCross();
	179	}
	180	return ncross;
	181	}
	182
82180ec1	183	//____________________________________________________
	184	inline Int_t AliTRDtrackV1::GetNumberOfTracklets() const
	185	{
	186	Int_t n = 0;
	187	for(Int_t ip=0; ip<kNplane; ip++){
	188	if(!fTracklet[ip]) continue;
	189	n++;
	190	}
	191	return n;
	192	}
	193
eb2b4f91	194	//____________________________________________________
	195	inline UChar_t AliTRDtrackV1::GetStatusTRD(Int_t ly) const
	196	{
af4e990c	197	if(ly>=-1 && ly<kNplane) return (fStatus>>((ly+1)*4))&0xf;
af4e990c	198	return kUnknown;
eb2b4f91	199	}
	200
	201	//____________________________________________________
	202	inline Bool_t AliTRDtrackV1::IsTrackError(ETRDtrackError error, UInt_t status)
	203	{
	204	return (status&0xf)==UChar_t(error);
	205	}
	206
	207	//____________________________________________________
	208	inline Bool_t AliTRDtrackV1::IsLayerError(ETRDlayerError error, Int_t ly, UInt_t status)
	209	{
	210	if(ly>=kNplane \|\| ly<0) return kFALSE;
	211	return ((status>>((ly+1)*4))&0xf) == UChar_t(error);
	212	}
181c7f7e	213
	214	//____________________________________________________
	215	inline void AliTRDtrackV1::SetReconstructor(const AliTRDReconstructor *rec)
	216	{
	217	for(Int_t ip=0; ip<kNplane; ip++){
	218	if(!fTracklet[ip]) continue;
	219	fTracklet[ip]->SetReconstructor(rec);
	220	}
4d6aee34	221	fkReconstructor = rec;
181c7f7e	222	}
181c7f7e	223
eb2b4f91	224	//____________________________________________________
	225	inline void AliTRDtrackV1::SetStatus(UChar_t status, Int_t ly)
	226	{
	227	if(ly<kNplane) fStatus\|=((status&0xf)<<((ly+1)*4));
	228	return;
	229	}
	230
181c7f7e	231
3b57a3f7	232	//____________________________________________________________________________
	233	inline Float_t AliTRDtrackV1::StatusForTOF()
	234	{
eb2b4f91	235	// OBSOLETE
3b57a3f7	236	// Defines the status of the TOF extrapolation
	237	//
	238
	239	if(!fTracklet[5]) return 0.;
	240
	241	// Definition of res ????
	242	Float_t res = /(0.2 + 0.8 (fN / (fNExpected + 5.0))) */ (0.4 + 0.6 fTracklet[5]->GetN() / 20.0);
	243	res = (0.25 + 0.8 40.0 / (40.0 + fBudget[2]));
	244	return res;
	245	}
d9950a5a	246
	247	#endif
	248
	249
6e49cfdb	250