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

/*$Id$*/
// Revision of includes 07/05/2004

/// \ingroup rec
/// \class AliMUONTrack
/// \brief Reconstructed track in ALICE dimuon spectrometer
///
////////////////////////////////////////////////////
/// Reconstructed track in ALICE dimuon spectrometer
////////////////////////////////////////////////////

#include <TObjArray.h>
#include <TMatrixD.h>

class AliMUONVCluster;
class AliMUONObjectPair;
class AliMUONTrackParam;

class AliMUONTrack : public TObject 
{
 public:
  AliMUONTrack(); // Default constructor
  AliMUONTrack(AliMUONObjectPair *segment, Double_t bendingVertexDispersion); // Constructor from a segment
  virtual ~AliMUONTrack(); // Destructor
  AliMUONTrack (const AliMUONTrack& track); // copy constructor
  AliMUONTrack& operator=(const AliMUONTrack& track); // assignment operator

  void Reset();
  
  TObjArray*    GetTrackParamAtCluster() const;
  void          AddTrackParamAtCluster(const AliMUONTrackParam &trackParam, AliMUONVCluster &cluster, Bool_t copy = kFALSE); 
  void          RemoveTrackParamAtCluster(AliMUONTrackParam *trackParam);
  Bool_t        UpdateTrackParamAtCluster();
  Bool_t        UpdateCovTrackParamAtCluster();
  
  Bool_t IsValid(UInt_t requestedStationMask, Bool_t request2ChInSameSt45 = kFALSE);
  
  void TagRemovableClusters(UInt_t requestedStationMask);
  
  /// return the number of clusters attached to the track
  Int_t GetNClusters() const {return fTrackParamAtCluster ? fTrackParamAtCluster->GetEntriesFast() : 0;}

  /// return kTrue if the vertex must be used to constrain the fit, kFalse if not
  Bool_t FitWithVertex() const {return fFitWithVertex;}
  /// set the flag telling whether the vertex must be used to constrain the fit or not
  void   FitWithVertex(Bool_t fitWithVertex) { fFitWithVertex = fitWithVertex; }
  /// return the vertex resolution square used during the tracking procedure
  void   GetVertexErrXY2(Double_t &nonBendingErr2, Double_t &bendingErr2) const
         { nonBendingErr2 = fVertexErrXY2[0]; bendingErr2 = fVertexErrXY2[1]; }
  /// set the vertex resolution square used during the tracking procedure
  void   SetVertexErrXY2(Double_t nonBendingErr2, Double_t bendingErr2)
	 { fVertexErrXY2[0] = nonBendingErr2; fVertexErrXY2[1] = bendingErr2; }

  /// return kTrue if the multiple scattering must be accounted for in the fit, kFalse if not
  Bool_t FitWithMCS() const {return fFitWithMCS;}
  /// set the flag telling whether the multiple scattering must be accounted for in the fit or not
  void   FitWithMCS(Bool_t fitWithMCS) {fFitWithMCS = fitWithMCS;}
  
  Bool_t   ComputeClusterWeights(TMatrixD* mcsCovariances = 0);
  Bool_t   ComputeLocalChi2(Bool_t accountForMCS);
  Double_t ComputeGlobalChi2(Bool_t accountForMCS);

  /// return the minimum value of the function minimized by the fit
  Double_t GetGlobalChi2() const {return fGlobalChi2;}
  /// set the minimum value of the function minimized by the fit
  void     SetGlobalChi2(Double_t chi2) { fGlobalChi2 = chi2;}
  
  /// return kTRUE if the track has been improved
  Bool_t IsImproved() const {return fImproved;}
  /// set the flag telling whether the track has been improved or not
  void   SetImproved(Bool_t improved) { fImproved = improved;}
  
  /// return 1,2,3 if track matches with trigger track, 0 if not
  Int_t    GetMatchTrigger(void) const {return fMatchTrigger;}
  /// returns the local trigger number corresponding to the trigger track (obsolete)
  Int_t    GetLoTrgNum(void) const {return LoCircuit();}
  /// set the flag telling whether track matches with trigger track or not
  void	   SetMatchTrigger(Int_t matchTrigger) {fMatchTrigger = matchTrigger;}
  /// return the chi2 of trigger/track matching 
  Double_t GetChi2MatchTrigger(void) const {return fChi2MatchTrigger;}
  /// set the chi2 of trigger/track matching 
  void     SetChi2MatchTrigger(Double_t chi2MatchTrigger) {fChi2MatchTrigger = chi2MatchTrigger;}

  Int_t ClustersInCommon(AliMUONTrack* track, Int_t stMin = 0, Int_t stMax = 4) const;

  Int_t    GetNDF() const;
  Double_t GetNormalizedChi2() const;

  Int_t  FindCompatibleClusters(const AliMUONTrack &track, Double_t sigma2Cut, Bool_t compatibleCluster[10]) const;
  Bool_t Match(AliMUONTrack &track, Double_t sigma2Cut, Int_t &nMatchClusters) const;
  
  /// return pointer to track parameters at vertex (can be 0x0)
  AliMUONTrackParam* GetTrackParamAtVertex() const {return fTrackParamAtVertex;}
  void               SetTrackParamAtVertex(const AliMUONTrackParam* trackParam);

  /// set word telling which trigger chambers where hit by track
  UShort_t GetHitsPatternInTrigCh() const {return fHitsPatternInTrigCh;}
  /// set word telling which trigger chambers where hit by track
  void     SetHitsPatternInTrigCh(UShort_t hitsPatternInTrigCh) {fHitsPatternInTrigCh = hitsPatternInTrigCh;}
  /// set word telling which trigger chambers where hit by track (from tracker track extrapolation)
  UInt_t GetHitsPatternInTrigChTrk() const {return fHitsPatternInTrigChTrk;}
  /// set word telling which trigger chambers where hit by track (from tracker track extrapolation)
  void     SetHitsPatternInTrigChTrk(UInt_t hitsPatternInTrigChTrk) {fHitsPatternInTrigChTrk = hitsPatternInTrigChTrk;}

  /// set local trigger information for the matched trigger track
  void  SetLocalTrigger(Int_t loCirc, Int_t loStripX, Int_t loStripY, Int_t loDev, Int_t loLpt, Int_t loHpt, UChar_t respWithoutChamber=0);
  /// return local trigger information for the matched trigger track
  Int_t GetLocalTrigger(void) const { return fLocalTrigger;        }
  /// number of triggering circuit
  Int_t LoCircuit(void) const { return fLocalTrigger & 0xFF;       }
  /// x-strip local trigger 
  Int_t LoStripX(void) const  { return fLocalTrigger >>  8 & 0x1F; }
  /// y-strip local trigger 
  Int_t LoStripY(void) const  { return fLocalTrigger >> 13 & 0x0F; }
  /// deviation local trigger 
  Int_t LoDev(void)    const  { return fLocalTrigger >> 17 & 0x1F; }
  /// low pt decision local trigger 
  Int_t LoLpt(void)    const  { return fLocalTrigger >> 22 & 0x03; }
  /// high pt decision local trigger 
  Int_t LoHpt(void)    const  { return fLocalTrigger >> 24 & 0x03; }
  /// Word stating if trigger would be fired without one chamber
  Int_t GetTriggerWithoutChamber(void) const { return fLocalTrigger >> 26 & 0xF; }
  /// Check if trigger would be fired without chamber (ich [0,3])
  Bool_t TriggerFiredWithoutChamber(Int_t ich) const { return GetTriggerWithoutChamber() >> (3 - ich) & 0x1; }

  void  FindMCLabel();
  /// set the corresponding MC track number
  void  SetMCLabel(Int_t label) {fTrackID = label;}
  /// return the corresponding MC track number
  Int_t GetMCLabel() const {return fTrackID;}
  
  void RecursiveDump(void) const; // Recursive dump (with associated clusters)

  virtual void Print(Option_t* opt="") const;

  virtual void Clear(Option_t* opt="");
  
  /// return the maximum chi2 above which the track can be considered as abnormal (due to extrapolation failure, ...)
  static Double_t MaxChi2() {return fgkMaxChi2;}
  
  /// set the flag which is kTRUE if that track shares cluster(s) with another
  void   Connected(Bool_t flag = kTRUE) {fConnected = flag;}
  /// return the flag which is kTRUE if that track shares cluster(s) with another
  Bool_t IsConnected() const {return fConnected;}


 private:
  
  static const Double_t fgkMaxChi2; ///< maximum chi2 above which the track can be considered as abnormal
  
  mutable TObjArray* fTrackParamAtCluster; ///< Track parameters at cluster
  
  Bool_t   fFitWithVertex;   //!< kTRUE if using the vertex to constrain the fit, kFALSE if not
  Double_t fVertexErrXY2[2]; //!< Vertex resolution square used during the tracking procedure if required
  
  Bool_t fFitWithMCS; //!< kTRUE if accounting for multiple scattering in the fit, kFALSE if not
  
  TMatrixD* fClusterWeightsNonBending; //!< weights matrix, in non bending direction, of clusters attached to the track
				       //!< (accounting for multiple scattering and cluster resolution)
  TMatrixD* fClusterWeightsBending;    //!< weights matrix, in bending direction, of clusters attached to the track
				       //!< (accounting for multiple scattering and cluster resolution)
  
  Double_t fGlobalChi2; ///< Global chi2 of the track
  
  Bool_t fImproved; //!< kTRUE if the track has been improved
  
  Int_t fMatchTrigger;  ///<  0 track does not match trigger
                        ///<  1 track match but does not pass pt cut
                        ///<  2 track match Low pt cut
                        ///<  3 track match High pt cut
  Double_t fChi2MatchTrigger; ///< chi2 of trigger/track matching 
  
  Int_t fTrackID; ///< Point to the corresponding MC track
  
  AliMUONTrackParam* fTrackParamAtVertex; //!< Track parameters at vertex
  
  UShort_t fHitsPatternInTrigCh; ///< Word containing info on the hits left in trigger chambers
  UInt_t fHitsPatternInTrigChTrk; ///< Word containing info on the hits left in trigger chambers (calculated from extrapolated tracker track)

  Int_t fLocalTrigger;    ///< packed local trigger information
  
  Bool_t fConnected; ///< kTRUE if that track shares cluster(s) with another
  
  // methods
  Bool_t ComputeClusterWeights(TMatrixD& clusterWeightsNB, TMatrixD& clusterWeightsB,
			       TMatrixD* mcsCovariances = 0, const AliMUONVCluster* discardedCluster = 0) const;
  void   ComputeMCSCovariances(TMatrixD& mcsCovariances) const;
  
  
  ClassDef(AliMUONTrack, 11) // Reconstructed track in ALICE dimuon spectrometer
};
	
#endif
 AliMUONTrack.h:1
 AliMUONTrack.h:2
 AliMUONTrack.h:3
 AliMUONTrack.h:4
 AliMUONTrack.h:5
 AliMUONTrack.h:6
 AliMUONTrack.h:7
 AliMUONTrack.h:8
 AliMUONTrack.h:9
 AliMUONTrack.h:10
 AliMUONTrack.h:11
 AliMUONTrack.h:12
 AliMUONTrack.h:13
 AliMUONTrack.h:14
 AliMUONTrack.h:15
 AliMUONTrack.h:16
 AliMUONTrack.h:17
 AliMUONTrack.h:18
 AliMUONTrack.h:19
 AliMUONTrack.h:20
 AliMUONTrack.h:21
 AliMUONTrack.h:22
 AliMUONTrack.h:23
 AliMUONTrack.h:24
 AliMUONTrack.h:25
 AliMUONTrack.h:26
 AliMUONTrack.h:27
 AliMUONTrack.h:28
 AliMUONTrack.h:29
 AliMUONTrack.h:30
 AliMUONTrack.h:31
 AliMUONTrack.h:32
 AliMUONTrack.h:33
 AliMUONTrack.h:34
 AliMUONTrack.h:35
 AliMUONTrack.h:36
 AliMUONTrack.h:37
 AliMUONTrack.h:38
 AliMUONTrack.h:39
 AliMUONTrack.h:40
 AliMUONTrack.h:41
 AliMUONTrack.h:42
 AliMUONTrack.h:43
 AliMUONTrack.h:44
 AliMUONTrack.h:45
 AliMUONTrack.h:46
 AliMUONTrack.h:47
 AliMUONTrack.h:48
 AliMUONTrack.h:49
 AliMUONTrack.h:50
 AliMUONTrack.h:51
 AliMUONTrack.h:52
 AliMUONTrack.h:53
 AliMUONTrack.h:54
 AliMUONTrack.h:55
 AliMUONTrack.h:56
 AliMUONTrack.h:57
 AliMUONTrack.h:58
 AliMUONTrack.h:59
 AliMUONTrack.h:60
 AliMUONTrack.h:61
 AliMUONTrack.h:62
 AliMUONTrack.h:63
 AliMUONTrack.h:64
 AliMUONTrack.h:65
 AliMUONTrack.h:66
 AliMUONTrack.h:67
 AliMUONTrack.h:68
 AliMUONTrack.h:69
 AliMUONTrack.h:70
 AliMUONTrack.h:71
 AliMUONTrack.h:72
 AliMUONTrack.h:73
 AliMUONTrack.h:74
 AliMUONTrack.h:75
 AliMUONTrack.h:76
 AliMUONTrack.h:77
 AliMUONTrack.h:78
 AliMUONTrack.h:79
 AliMUONTrack.h:80
 AliMUONTrack.h:81
 AliMUONTrack.h:82
 AliMUONTrack.h:83
 AliMUONTrack.h:84
 AliMUONTrack.h:85
 AliMUONTrack.h:86
 AliMUONTrack.h:87
 AliMUONTrack.h:88
 AliMUONTrack.h:89
 AliMUONTrack.h:90
 AliMUONTrack.h:91
 AliMUONTrack.h:92
 AliMUONTrack.h:93
 AliMUONTrack.h:94
 AliMUONTrack.h:95
 AliMUONTrack.h:96
 AliMUONTrack.h:97
 AliMUONTrack.h:98
 AliMUONTrack.h:99
 AliMUONTrack.h:100
 AliMUONTrack.h:101
 AliMUONTrack.h:102
 AliMUONTrack.h:103
 AliMUONTrack.h:104
 AliMUONTrack.h:105
 AliMUONTrack.h:106
 AliMUONTrack.h:107
 AliMUONTrack.h:108
 AliMUONTrack.h:109
 AliMUONTrack.h:110
 AliMUONTrack.h:111
 AliMUONTrack.h:112
 AliMUONTrack.h:113
 AliMUONTrack.h:114
 AliMUONTrack.h:115
 AliMUONTrack.h:116
 AliMUONTrack.h:117
 AliMUONTrack.h:118
 AliMUONTrack.h:119
 AliMUONTrack.h:120
 AliMUONTrack.h:121
 AliMUONTrack.h:122
 AliMUONTrack.h:123
 AliMUONTrack.h:124
 AliMUONTrack.h:125
 AliMUONTrack.h:126
 AliMUONTrack.h:127
 AliMUONTrack.h:128
 AliMUONTrack.h:129
 AliMUONTrack.h:130
 AliMUONTrack.h:131
 AliMUONTrack.h:132
 AliMUONTrack.h:133
 AliMUONTrack.h:134
 AliMUONTrack.h:135
 AliMUONTrack.h:136
 AliMUONTrack.h:137
 AliMUONTrack.h:138
 AliMUONTrack.h:139
 AliMUONTrack.h:140
 AliMUONTrack.h:141
 AliMUONTrack.h:142
 AliMUONTrack.h:143
 AliMUONTrack.h:144
 AliMUONTrack.h:145
 AliMUONTrack.h:146
 AliMUONTrack.h:147
 AliMUONTrack.h:148
 AliMUONTrack.h:149
 AliMUONTrack.h:150
 AliMUONTrack.h:151
 AliMUONTrack.h:152
 AliMUONTrack.h:153
 AliMUONTrack.h:154
 AliMUONTrack.h:155
 AliMUONTrack.h:156
 AliMUONTrack.h:157
 AliMUONTrack.h:158
 AliMUONTrack.h:159
 AliMUONTrack.h:160
 AliMUONTrack.h:161
 AliMUONTrack.h:162
 AliMUONTrack.h:163
 AliMUONTrack.h:164
 AliMUONTrack.h:165
 AliMUONTrack.h:166
 AliMUONTrack.h:167
 AliMUONTrack.h:168
 AliMUONTrack.h:169
 AliMUONTrack.h:170
 AliMUONTrack.h:171
 AliMUONTrack.h:172
 AliMUONTrack.h:173
 AliMUONTrack.h:174
 AliMUONTrack.h:175
 AliMUONTrack.h:176
 AliMUONTrack.h:177
 AliMUONTrack.h:178
 AliMUONTrack.h:179
 AliMUONTrack.h:180
 AliMUONTrack.h:181
 AliMUONTrack.h:182
 AliMUONTrack.h:183
 AliMUONTrack.h:184
 AliMUONTrack.h:185
 AliMUONTrack.h:186
 AliMUONTrack.h:187
 AliMUONTrack.h:188
 AliMUONTrack.h:189
 AliMUONTrack.h:190
 AliMUONTrack.h:191
 AliMUONTrack.h:192
 AliMUONTrack.h:193
 AliMUONTrack.h:194
 AliMUONTrack.h:195
 AliMUONTrack.h:196
 AliMUONTrack.h:197
 AliMUONTrack.h:198