Coverity fix for uninitialized variables and check for returned null value
[u/mrichter/AliRoot.git] / MUON / AliMUONTrack.h
CommitLineData
a9e2aefa 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$*/
30178c30 7// Revision of includes 07/05/2004
8
692de412 9/// \ingroup rec
10/// \class AliMUONTrack
11/// \brief Reconstructed track in ALICE dimuon spectrometer
12///
13////////////////////////////////////////////////////
14/// Reconstructed track in ALICE dimuon spectrometer
15////////////////////////////////////////////////////
3831f268 16
ce8cd162 17#include <TObjArray.h>
933daf4c 18#include <TMatrixD.h>
a9e2aefa 19
96ebe67e 20class AliMUONVCluster;
ea94c18b 21class AliMUONObjectPair;
933daf4c 22class AliMUONTrackParam;
a9e2aefa 23
30178c30 24class AliMUONTrack : public TObject
25{
a9e2aefa 26 public:
d837040f 27 AliMUONTrack(); // Default constructor
a0dc65b4 28 AliMUONTrack(AliMUONObjectPair *segment, Double_t bendingVertexDispersion); // Constructor from a segment
8429a5e4 29 virtual ~AliMUONTrack(); // Destructor
ea94c18b 30 AliMUONTrack (const AliMUONTrack& track); // copy constructor
31 AliMUONTrack& operator=(const AliMUONTrack& track); // assignment operator
a9e2aefa 32
b1fea02e 33 void Reset();
34
ce8cd162 35 TObjArray* GetTrackParamAtCluster() const;
96ebe67e 36 void AddTrackParamAtCluster(const AliMUONTrackParam &trackParam, AliMUONVCluster &cluster, Bool_t copy = kFALSE);
37 void RemoveTrackParamAtCluster(AliMUONTrackParam *trackParam);
4ea3f013 38 Bool_t UpdateTrackParamAtCluster();
39 Bool_t UpdateCovTrackParamAtCluster();
96ebe67e 40
f202486b 41 Bool_t IsValid(UInt_t requestedStationMask, Bool_t request2ChInSameSt45 = kFALSE);
7332f213 42
a0dc65b4 43 void TagRemovableClusters(UInt_t requestedStationMask);
7332f213 44
96ebe67e 45 /// return the number of clusters attached to the track
7332f213 46 Int_t GetNClusters() const {return fTrackParamAtCluster ? fTrackParamAtCluster->GetEntriesFast() : 0;}
96ebe67e 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;}
bdfb6eef 80 /// returns the local trigger number corresponding to the trigger track (obsolete)
81 Int_t GetLoTrgNum(void) const {return LoCircuit();}
96ebe67e 82 /// set the flag telling whether track matches with trigger track or not
83 void SetMatchTrigger(Int_t matchTrigger) {fMatchTrigger = matchTrigger;}
96ebe67e 84 /// return the chi2 of trigger/track matching
85 Double_t GetChi2MatchTrigger(void) const {return fChi2MatchTrigger;}
86 /// set the chi2 of trigger/track matching
87 void SetChi2MatchTrigger(Double_t chi2MatchTrigger) {fChi2MatchTrigger = chi2MatchTrigger;}
ea94c18b 88
5c15a68b 89 Int_t ClustersInCommon(AliMUONTrack* track, Int_t stMin = 0, Int_t stMax = 4) const;
ea94c18b 90
5a240757 91 Int_t GetNDF() const;
96ebe67e 92 Double_t GetNormalizedChi2() const;
ea94c18b 93
57e2ad1a 94 Int_t FindCompatibleClusters(const AliMUONTrack &track, Double_t sigma2Cut, Bool_t compatibleCluster[10]) const;
f202486b 95 Bool_t Match(AliMUONTrack &track, Double_t sigma2Cut, Int_t &nMatchClusters) const;
b8dc484b 96
61fed964 97 /// return pointer to track parameters at vertex (can be 0x0)
40a42243 98 AliMUONTrackParam* GetTrackParamAtVertex() const {return fTrackParamAtVertex;}
96ebe67e 99 void SetTrackParamAtVertex(const AliMUONTrackParam* trackParam);
100
101 /// set word telling which trigger chambers where hit by track
102 UShort_t GetHitsPatternInTrigCh() const {return fHitsPatternInTrigCh;}
103 /// set word telling which trigger chambers where hit by track
104 void SetHitsPatternInTrigCh(UShort_t hitsPatternInTrigCh) {fHitsPatternInTrigCh = hitsPatternInTrigCh;}
0a2dcc83 105 /// set word telling which trigger chambers where hit by track (from tracker track extrapolation)
106 UInt_t GetHitsPatternInTrigChTrk() const {return fHitsPatternInTrigChTrk;}
107 /// set word telling which trigger chambers where hit by track (from tracker track extrapolation)
108 void SetHitsPatternInTrigChTrk(UInt_t hitsPatternInTrigChTrk) {fHitsPatternInTrigChTrk = hitsPatternInTrigChTrk;}
7771752e 109
423b32ca 110 /// set local trigger information for the matched trigger track
00d46f24 111 void SetLocalTrigger(Int_t loCirc, Int_t loStripX, Int_t loStripY, Int_t loDev, Int_t loLpt, Int_t loHpt, UChar_t respWithoutChamber=0);
423b32ca 112 /// return local trigger information for the matched trigger track
61fed964 113 Int_t GetLocalTrigger(void) const { return fLocalTrigger; }
4a335550 114 /// number of triggering circuit
01413742 115 Int_t LoCircuit(void) const { return fLocalTrigger & 0xFF; }
4a335550 116 /// x-strip local trigger
423b32ca 117 Int_t LoStripX(void) const { return fLocalTrigger >> 8 & 0x1F; }
4a335550 118 /// y-strip local trigger
423b32ca 119 Int_t LoStripY(void) const { return fLocalTrigger >> 13 & 0x0F; }
4a335550 120 /// deviation local trigger
423b32ca 121 Int_t LoDev(void) const { return fLocalTrigger >> 17 & 0x1F; }
4a335550 122 /// low pt decision local trigger
423b32ca 123 Int_t LoLpt(void) const { return fLocalTrigger >> 22 & 0x03; }
4a335550 124 /// high pt decision local trigger
423b32ca 125 Int_t LoHpt(void) const { return fLocalTrigger >> 24 & 0x03; }
00d46f24 126 /// Word stating if trigger would be fired without one chamber
127 Int_t GetTriggerWithoutChamber(void) const { return fLocalTrigger >> 26 & 0xF; }
128 /// Check if trigger would be fired without chamber (ich [0,3])
129 Bool_t TriggerFiredWithoutChamber(Int_t ich) const { return GetTriggerWithoutChamber() >> (3 - ich) & 0x1; }
423b32ca 130
2e2d0c44 131 void FindMCLabel();
132 /// set the corresponding MC track number
133 void SetMCLabel(Int_t label) {fTrackID = label;}
134 /// return the corresponding MC track number
135 Int_t GetMCLabel() const {return fTrackID;}
136
96ebe67e 137 void RecursiveDump(void) const; // Recursive dump (with associated clusters)
6464217e 138
96ebe67e 139 virtual void Print(Option_t* opt="") const;
a9e2aefa 140
d2b1e7bb 141 virtual void Clear(Option_t* opt="");
4ea3f013 142
3e1866ad 143 /// return the maximum chi2 above which the track can be considered as abnormal (due to extrapolation failure, ...)
4ea3f013 144 static Double_t MaxChi2() {return fgkMaxChi2;}
5c15a68b 145
52ce8802 146 /// set the flag which is kTRUE if that track shares cluster(s) with another
5c15a68b 147 void Connected(Bool_t flag = kTRUE) {fConnected = flag;}
52ce8802 148 /// return the flag which is kTRUE if that track shares cluster(s) with another
5c15a68b 149 Bool_t IsConnected() const {return fConnected;}
956019b6 150
ea94c18b 151
a9e2aefa 152 private:
4ea3f013 153
154 static const Double_t fgkMaxChi2; ///< maximum chi2 above which the track can be considered as abnormal
155
ce8cd162 156 mutable TObjArray* fTrackParamAtCluster; ///< Track parameters at cluster
de2cd600 157
96ebe67e 158 Bool_t fFitWithVertex; //!< kTRUE if using the vertex to constrain the fit, kFALSE if not
159 Double_t fVertexErrXY2[2]; //!< Vertex resolution square used during the tracking procedure if required
208f139e 160
ea94c18b 161 Bool_t fFitWithMCS; //!< kTRUE if accounting for multiple scattering in the fit, kFALSE if not
162
96ebe67e 163 TMatrixD* fClusterWeightsNonBending; //!< weights matrix, in non bending direction, of clusters attached to the track
164 //!< (accounting for multiple scattering and cluster resolution)
165 TMatrixD* fClusterWeightsBending; //!< weights matrix, in bending direction, of clusters attached to the track
166 //!< (accounting for multiple scattering and cluster resolution)
ea94c18b 167
168 Double_t fGlobalChi2; ///< Global chi2 of the track
169
170 Bool_t fImproved; //!< kTRUE if the track has been improved
171
423b32ca 172 Int_t fMatchTrigger; ///< 0 track does not match trigger
173 ///< 1 track match but does not pass pt cut
174 ///< 2 track match Low pt cut
175 ///< 3 track match High pt cut
829425a5 176 Double_t fChi2MatchTrigger; ///< chi2 of trigger/track matching
de2cd600 177
2e2d0c44 178 Int_t fTrackID; ///< Point to the corresponding MC track
96ebe67e 179
180 AliMUONTrackParam* fTrackParamAtVertex; //!< Track parameters at vertex
181
7771752e 182 UShort_t fHitsPatternInTrigCh; ///< Word containing info on the hits left in trigger chambers
0a2dcc83 183 UInt_t fHitsPatternInTrigChTrk; ///< Word containing info on the hits left in trigger chambers (calculated from extrapolated tracker track)
423b32ca 184
185 Int_t fLocalTrigger; ///< packed local trigger information
de2cd600 186
5c15a68b 187 Bool_t fConnected; ///< kTRUE if that track shares cluster(s) with another
ea94c18b 188
189 // methods
96ebe67e 190 Bool_t ComputeClusterWeights(TMatrixD& clusterWeightsNB, TMatrixD& clusterWeightsB,
57e2ad1a 191 TMatrixD* mcsCovariances = 0, const AliMUONVCluster* discardedCluster = 0) const;
ea94c18b 192 void ComputeMCSCovariances(TMatrixD& mcsCovariances) const;
193
194
0a2dcc83 195 ClassDef(AliMUONTrack, 11) // Reconstructed track in ALICE dimuon spectrometer
de2cd600 196};
a9e2aefa 197
198#endif