- Remove "connected tracks" (i.e. track sharing at least 1 cluster in station 3,
[u/mrichter/AliRoot.git] / MUON / AliMUONTrack.h
1 #ifndef ALIMUONTRACK_H
2 #define ALIMUONTRACK_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 // Revision of includes 07/05/2004
8
9 /// \ingroup rec
10 /// \class AliMUONTrack
11 /// \brief Reconstructed track in ALICE dimuon spectrometer
12 ///
13 ////////////////////////////////////////////////////
14 /// Reconstructed track in ALICE dimuon spectrometer
15 ////////////////////////////////////////////////////
16
17 #include "AliMUONTrackParam.h" // object belongs to the class
18 #include "AliMUONConstants.h"
19 #include <TClonesArray.h>
20
21 class AliMUONVCluster;
22 class AliMUONObjectPair;
23
24 class AliMUONTrack : public TObject 
25 {
26  public:
27   AliMUONTrack(); // Default constructor
28   AliMUONTrack(AliMUONObjectPair *segment, Double_t bendingVertexDispersion); // Constructor from a segment
29   virtual ~AliMUONTrack(); // Destructor
30   AliMUONTrack (const AliMUONTrack& track); // copy constructor
31   AliMUONTrack& operator=(const AliMUONTrack& track); // assignment operator
32
33   void Reset();
34   
35   TClonesArray* GetTrackParamAtCluster() const;
36   void          AddTrackParamAtCluster(const AliMUONTrackParam &trackParam, AliMUONVCluster &cluster, Bool_t copy = kFALSE); 
37   void          RemoveTrackParamAtCluster(AliMUONTrackParam *trackParam);
38   void          UpdateTrackParamAtCluster();
39   void          UpdateCovTrackParamAtCluster();
40   
41   Bool_t IsValid(UInt_t requestedStationMask);
42   
43   void TagRemovableClusters(UInt_t requestedStationMask);
44   
45   /// return the number of clusters attached to the track
46   Int_t GetNClusters() const {return fTrackParamAtCluster ? fTrackParamAtCluster->GetEntriesFast() : 0;}
47
48   /// return kTrue if the vertex must be used to constrain the fit, kFalse if not
49   Bool_t FitWithVertex() const {return fFitWithVertex;}
50   /// set the flag telling whether the vertex must be used to constrain the fit or not
51   void   FitWithVertex(Bool_t fitWithVertex) { fFitWithVertex = fitWithVertex; }
52   /// return the vertex resolution square used during the tracking procedure
53   void   GetVertexErrXY2(Double_t &nonBendingErr2, Double_t &bendingErr2) const
54          { nonBendingErr2 = fVertexErrXY2[0]; bendingErr2 = fVertexErrXY2[1]; }
55   /// set the vertex resolution square used during the tracking procedure
56   void   SetVertexErrXY2(Double_t nonBendingErr2, Double_t bendingErr2)
57          { fVertexErrXY2[0] = nonBendingErr2; fVertexErrXY2[1] = bendingErr2; }
58
59   /// return kTrue if the multiple scattering must be accounted for in the fit, kFalse if not
60   Bool_t FitWithMCS() const {return fFitWithMCS;}
61   /// set the flag telling whether the multiple scattering must be accounted for in the fit or not
62   void   FitWithMCS(Bool_t fitWithMCS) {fFitWithMCS = fitWithMCS;}
63   
64   Bool_t   ComputeClusterWeights(TMatrixD* mcsCovariances = 0);
65   Bool_t   ComputeLocalChi2(Bool_t accountForMCS);
66   Double_t ComputeGlobalChi2(Bool_t accountForMCS);
67
68   /// return the minimum value of the function minimized by the fit
69   Double_t GetGlobalChi2() const {return fGlobalChi2;}
70   /// set the minimum value of the function minimized by the fit
71   void     SetGlobalChi2(Double_t chi2) { fGlobalChi2 = chi2;}
72   
73   /// return kTRUE if the track has been improved
74   Bool_t IsImproved() const {return fImproved;}
75   /// set the flag telling whether the track has been improved or not
76   void   SetImproved(Bool_t improved) { fImproved = improved;}
77   
78   /// return 1,2,3 if track matches with trigger track, 0 if not
79   Int_t    GetMatchTrigger(void) const {return fMatchTrigger;}
80   /// returns the local trigger number corresponding to the trigger track 
81   Int_t    GetLoTrgNum(void) const {return floTrgNum;}
82   /// set the flag telling whether track matches with trigger track or not
83   void     SetMatchTrigger(Int_t matchTrigger) {fMatchTrigger = matchTrigger;}
84   /// set the local trigger number corresponding to the trigger track
85   void     SetLoTrgNum(Int_t loTrgNum) {floTrgNum = loTrgNum;}
86   /// return the chi2 of trigger/track matching 
87   Double_t GetChi2MatchTrigger(void) const {return fChi2MatchTrigger;}
88   /// set the chi2 of trigger/track matching 
89   void     SetChi2MatchTrigger(Double_t chi2MatchTrigger) {fChi2MatchTrigger = chi2MatchTrigger;}
90
91   Int_t ClustersInCommon(AliMUONTrack* track, Bool_t inSt345 = kFALSE) const;
92
93   Double_t GetNormalizedChi2() const;
94
95   Int_t CompatibleTrack(AliMUONTrack* track, Double_t sigma2Cut, Bool_t compatibleCluster[10]) const;
96   
97   /// return track number in TrackRefs
98   Int_t GetTrackID() const {return fTrackID;}
99   /// set track number in TrackRefs
100   void  SetTrackID(Int_t trackID) {fTrackID = trackID;}
101
102   /// return pointer to track parameters at vertex (can be 0x0)
103   AliMUONTrackParam* GetTrackParamAtVertex() {return fTrackParamAtVertex;}
104   void               SetTrackParamAtVertex(const AliMUONTrackParam* trackParam);
105
106   /// set word telling which trigger chambers where hit by track
107   UShort_t GetHitsPatternInTrigCh() const {return fHitsPatternInTrigCh;}
108   /// set word telling which trigger chambers where hit by track
109   void     SetHitsPatternInTrigCh(UShort_t hitsPatternInTrigCh) {fHitsPatternInTrigCh = hitsPatternInTrigCh;}
110
111   /// set local trigger information for the matched trigger track
112   void  SetLocalTrigger(Int_t loCirc, Int_t loStripX, Int_t loStripY, Int_t loDev, Int_t loLpt, Int_t loHpt);
113   /// return local trigger information for the matched trigger track
114   Int_t GetLocalTrigger(void) const { return fLocalTrigger;        }
115   /// number of triggering circuit
116   Int_t LoCircuit(void) const { return fLocalTrigger & 0xFF;       }
117   /// x-strip local trigger 
118   Int_t LoStripX(void) const  { return fLocalTrigger >>  8 & 0x1F; }
119   /// y-strip local trigger 
120   Int_t LoStripY(void) const  { return fLocalTrigger >> 13 & 0x0F; }
121   /// deviation local trigger 
122   Int_t LoDev(void)    const  { return fLocalTrigger >> 17 & 0x1F; }
123   /// low pt decision local trigger 
124   Int_t LoLpt(void)    const  { return fLocalTrigger >> 22 & 0x03; }
125   /// high pt decision local trigger 
126   Int_t LoHpt(void)    const  { return fLocalTrigger >> 24 & 0x03; }
127
128   void RecursiveDump(void) const; // Recursive dump (with associated clusters)
129
130   virtual void Print(Option_t* opt="") const;
131
132   virtual void Clear(Option_t* opt="");
133
134
135  private:
136  
137   mutable TClonesArray* fTrackParamAtCluster; ///< Track parameters at cluster
138   
139   Bool_t   fFitWithVertex;   //!< kTRUE if using the vertex to constrain the fit, kFALSE if not
140   Double_t fVertexErrXY2[2]; //!< Vertex resolution square used during the tracking procedure if required
141   
142   Bool_t fFitWithMCS; //!< kTRUE if accounting for multiple scattering in the fit, kFALSE if not
143   
144   TMatrixD* fClusterWeightsNonBending; //!< weights matrix, in non bending direction, of clusters attached to the track
145                                        //!< (accounting for multiple scattering and cluster resolution)
146   TMatrixD* fClusterWeightsBending;    //!< weights matrix, in bending direction, of clusters attached to the track
147                                        //!< (accounting for multiple scattering and cluster resolution)
148   
149   Double_t fGlobalChi2; ///< Global chi2 of the track
150   
151   Bool_t fImproved; //!< kTRUE if the track has been improved
152   
153   Int_t fMatchTrigger;  ///<  0 track does not match trigger
154                         ///<  1 track match but does not pass pt cut
155                         ///<  2 track match Low pt cut
156                         ///<  3 track match High pt cut
157   Int_t floTrgNum; ///< the number of the corresponding loTrg, -1 if no matching
158   Double_t fChi2MatchTrigger; ///< chi2 of trigger/track matching 
159   
160   Int_t fTrackID; ///< track ID = track number in TrackRefs
161   
162   AliMUONTrackParam* fTrackParamAtVertex; //!< Track parameters at vertex
163   
164   UShort_t fHitsPatternInTrigCh; ///< Word containing info on the hits left in trigger chambers
165
166   Int_t fLocalTrigger;    ///< packed local trigger information
167   
168   
169   // methods
170   Bool_t ComputeClusterWeights(TMatrixD& clusterWeightsNB, TMatrixD& clusterWeightsB,
171                                TMatrixD* mcsCovariances = 0, AliMUONVCluster* discardedCluster = 0) const;
172   void   ComputeMCSCovariances(TMatrixD& mcsCovariances) const;
173   
174   
175   ClassDef(AliMUONTrack, 8) // Reconstructed track in ALICE dimuon spectrometer
176 };
177         
178 #endif