ROOT logo
#ifndef ALIMUONTRACKEXTRAP_H
#define ALIMUONTRACKEXTRAP_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 AliMUONTrackExtrap
/// \brief Track parameters in ALICE dimuon spectrometer
///
//////////////////////////////////////////////////////////////
/// Tools for track extrapolation in ALICE dimuon spectrometer
//////////////////////////////////////////////////////////////

#include <TObject.h>
#include <TMatrixD.h>

class AliMagF;
class AliMUONTrackParam;

class AliMUONTrackExtrap : public TObject 
{
 public:
	/// Constructor
  AliMUONTrackExtrap() : TObject(){};
	/// Destructor
  virtual ~AliMUONTrackExtrap(){};
  
  static void SetField();
  
  /// return kTRUE if the field is switched ON
  static Bool_t IsFieldON() {return fgFieldON;}
  
  static Double_t GetImpactParamFromBendingMomentum(Double_t bendingMomentum);
  static Double_t GetBendingMomentumFromImpactParam(Double_t impactParam);
  
  // Linearly extrapolate track parameters
  static void LinearExtrapToZ(AliMUONTrackParam* trackParam, Double_t zEnd);
  
  // Linearly extrapolate track parameters and covariances
  static void LinearExtrapToZCov(AliMUONTrackParam* trackParam, Double_t zEnd, Bool_t updatePropagator = kFALSE);
  
  // Extrapolate track parameters in magnetic field
  static Bool_t ExtrapToZ(AliMUONTrackParam *trackParam, Double_t zEnd);
  
  // Extrapolate track parameters and covariances in magnetic field
  static Bool_t ExtrapToZCov(AliMUONTrackParam* trackParam, Double_t zEnd, Bool_t updatePropagator = kFALSE);
  
  // Extrapolate track parameters to vertex, corrected for multiple scattering and energy loss effects
  // Add branson correction resolution and energy loss fluctuation to parameter covariances
  static void ExtrapToVertex(AliMUONTrackParam* trackParam,
                             Double_t xVtx, Double_t yVtx, Double_t zVtx,
                             Double_t errXVtx, Double_t errYVtx);
  
  // Extrapolate track parameters to vertex, corrected for multiple scattering effects only
  // Add branson correction resolution to parameter covariances
  static void ExtrapToVertexWithoutELoss(AliMUONTrackParam* trackParam,
					 Double_t xVtx, Double_t yVtx, Double_t zVtx,
					 Double_t errXVtx, Double_t errYVtx);
  
  // Extrapolate track parameters to vertex, corrected for energy loss effects only
  // Add dispersion due to multiple scattering and energy loss fluctuation to parameter covariances
  static void ExtrapToVertexWithoutBranson(AliMUONTrackParam* trackParam, Double_t zVtx);
  
  // Extrapolate track parameters to vertex without multiple scattering and energy loss corrections
  // Add dispersion due to multiple scattering to parameter covariances
  static void ExtrapToVertexUncorrected(AliMUONTrackParam* trackParam, Double_t zVtx);
  
  static Double_t TotalMomentumEnergyLoss(AliMUONTrackParam* trackParam, Double_t xVtx, Double_t yVtx, Double_t zVtx);
  
  static Double_t GetMCSAngle2(const AliMUONTrackParam& param, Double_t dZ, Double_t x0);
  static void     AddMCSEffect(AliMUONTrackParam *param, Double_t dZ, Double_t x0);
  
  static Bool_t ExtrapOneStepRungekutta(Double_t charge, Double_t step, const Double_t* vect, Double_t* vout);
  
  
 private:
  static const Double_t fgkSimpleBPosition;     //!< position of the dipole
  static const Double_t fgkSimpleBLength;       //!< length of the dipole
  static       Double_t fgSimpleBValue;         //!< magnetic field value at the centre
  static       Bool_t   fgFieldON;              //!< kTRUE if the field is switched ON
  static const Bool_t   fgkUseHelix;		//!< Tell whether to use Helix or not (default is Runge-Kutta)
  static const Int_t    fgkMaxStepNumber;	//!< Maximum number of steps for track extrapolation
  static const Double_t fgkHelixStepLength;	//!< Step lenght for track extrapolation (used in Helix)
  static const Double_t fgkRungeKuttaMaxResidue;//!< Maximal distance (in Z) to destination to stop the track extrapolation (used in Runge-Kutta)
  
  // Functions

  /// Not implemented
  AliMUONTrackExtrap(const AliMUONTrackExtrap& trackExtrap);
  /// Not implemented
  AliMUONTrackExtrap& operator=(const AliMUONTrackExtrap& trackExtrap);

  static Bool_t ExtrapToZHelix(AliMUONTrackParam *trackParam, Double_t Z);
  static Bool_t ExtrapToZRungekutta(AliMUONTrackParam *trackParam, Double_t Z);
  
  static void ConvertTrackParamForExtrap(AliMUONTrackParam* trackParam, Double_t forwardBackward, Double_t *v3);
  static void RecoverTrackParam(Double_t *v3, Double_t Charge, AliMUONTrackParam* trackParam);
  
  static void ExtrapToVertex(AliMUONTrackParam* trackParam,
                             Double_t xVtx, Double_t yVtx, Double_t zVtx,
                             Double_t errXVtx, Double_t errYVtx,
                             Bool_t correctForMCS, Bool_t correctForEnergyLoss);
  
  static void AddMCSEffectInAbsorber(AliMUONTrackParam* trackParam, Double_t signedPathLength, Double_t f0, Double_t f1, Double_t f2);
  static void CorrectMCSEffectInAbsorber(AliMUONTrackParam* param,
                                         Double_t xVtx, Double_t yVtx, Double_t zVtx,
                                         Double_t errXVtx, Double_t errYVtx,
                                         Double_t absZBeg, Double_t pathLength, Double_t f0, Double_t f1, Double_t f2);
  static void CorrectELossEffectInAbsorber(AliMUONTrackParam* param, Double_t eLoss, Double_t sigmaELoss2);
  static Bool_t GetAbsorberCorrectionParam(Double_t trackXYZIn[3], Double_t trackXYZOut[3], Double_t pTotal,
                                           Double_t &pathLength, Double_t &f0, Double_t &f1, Double_t &f2,
                                           Double_t &meanRho, Double_t &totalELoss, Double_t &sigmaELoss2);
  
  static Double_t BetheBloch(Double_t pTotal, Double_t pathLength, Double_t rho, Double_t atomicZ, Double_t atomicZoverA);
  static Double_t EnergyLossFluctuation(Double_t pTotal, Double_t pathLength, Double_t rho, Double_t atomicZoverA);
  
  static void Cov2CovP(const TMatrixD &param, TMatrixD &cov);
  static void CovP2Cov(const TMatrixD &param, TMatrixD &cov);
  
  static void ExtrapOneStepHelix(Double_t charge, Double_t step, const Double_t *vect, Double_t *vout);
  static void ExtrapOneStepHelix3(Double_t field, Double_t step, const Double_t *vect, Double_t *vout);
  
  ClassDef(AliMUONTrackExtrap, 0) // Tools for track extrapolation in ALICE dimuon spectrometer
};
	
#endif
 AliMUONTrackExtrap.h:1
 AliMUONTrackExtrap.h:2
 AliMUONTrackExtrap.h:3
 AliMUONTrackExtrap.h:4
 AliMUONTrackExtrap.h:5
 AliMUONTrackExtrap.h:6
 AliMUONTrackExtrap.h:7
 AliMUONTrackExtrap.h:8
 AliMUONTrackExtrap.h:9
 AliMUONTrackExtrap.h:10
 AliMUONTrackExtrap.h:11
 AliMUONTrackExtrap.h:12
 AliMUONTrackExtrap.h:13
 AliMUONTrackExtrap.h:14
 AliMUONTrackExtrap.h:15
 AliMUONTrackExtrap.h:16
 AliMUONTrackExtrap.h:17
 AliMUONTrackExtrap.h:18
 AliMUONTrackExtrap.h:19
 AliMUONTrackExtrap.h:20
 AliMUONTrackExtrap.h:21
 AliMUONTrackExtrap.h:22
 AliMUONTrackExtrap.h:23
 AliMUONTrackExtrap.h:24
 AliMUONTrackExtrap.h:25
 AliMUONTrackExtrap.h:26
 AliMUONTrackExtrap.h:27
 AliMUONTrackExtrap.h:28
 AliMUONTrackExtrap.h:29
 AliMUONTrackExtrap.h:30
 AliMUONTrackExtrap.h:31
 AliMUONTrackExtrap.h:32
 AliMUONTrackExtrap.h:33
 AliMUONTrackExtrap.h:34
 AliMUONTrackExtrap.h:35
 AliMUONTrackExtrap.h:36
 AliMUONTrackExtrap.h:37
 AliMUONTrackExtrap.h:38
 AliMUONTrackExtrap.h:39
 AliMUONTrackExtrap.h:40
 AliMUONTrackExtrap.h:41
 AliMUONTrackExtrap.h:42
 AliMUONTrackExtrap.h:43
 AliMUONTrackExtrap.h:44
 AliMUONTrackExtrap.h:45
 AliMUONTrackExtrap.h:46
 AliMUONTrackExtrap.h:47
 AliMUONTrackExtrap.h:48
 AliMUONTrackExtrap.h:49
 AliMUONTrackExtrap.h:50
 AliMUONTrackExtrap.h:51
 AliMUONTrackExtrap.h:52
 AliMUONTrackExtrap.h:53
 AliMUONTrackExtrap.h:54
 AliMUONTrackExtrap.h:55
 AliMUONTrackExtrap.h:56
 AliMUONTrackExtrap.h:57
 AliMUONTrackExtrap.h:58
 AliMUONTrackExtrap.h:59
 AliMUONTrackExtrap.h:60
 AliMUONTrackExtrap.h:61
 AliMUONTrackExtrap.h:62
 AliMUONTrackExtrap.h:63
 AliMUONTrackExtrap.h:64
 AliMUONTrackExtrap.h:65
 AliMUONTrackExtrap.h:66
 AliMUONTrackExtrap.h:67
 AliMUONTrackExtrap.h:68
 AliMUONTrackExtrap.h:69
 AliMUONTrackExtrap.h:70
 AliMUONTrackExtrap.h:71
 AliMUONTrackExtrap.h:72
 AliMUONTrackExtrap.h:73
 AliMUONTrackExtrap.h:74
 AliMUONTrackExtrap.h:75
 AliMUONTrackExtrap.h:76
 AliMUONTrackExtrap.h:77
 AliMUONTrackExtrap.h:78
 AliMUONTrackExtrap.h:79
 AliMUONTrackExtrap.h:80
 AliMUONTrackExtrap.h:81
 AliMUONTrackExtrap.h:82
 AliMUONTrackExtrap.h:83
 AliMUONTrackExtrap.h:84
 AliMUONTrackExtrap.h:85
 AliMUONTrackExtrap.h:86
 AliMUONTrackExtrap.h:87
 AliMUONTrackExtrap.h:88
 AliMUONTrackExtrap.h:89
 AliMUONTrackExtrap.h:90
 AliMUONTrackExtrap.h:91
 AliMUONTrackExtrap.h:92
 AliMUONTrackExtrap.h:93
 AliMUONTrackExtrap.h:94
 AliMUONTrackExtrap.h:95
 AliMUONTrackExtrap.h:96
 AliMUONTrackExtrap.h:97
 AliMUONTrackExtrap.h:98
 AliMUONTrackExtrap.h:99
 AliMUONTrackExtrap.h:100
 AliMUONTrackExtrap.h:101
 AliMUONTrackExtrap.h:102
 AliMUONTrackExtrap.h:103
 AliMUONTrackExtrap.h:104
 AliMUONTrackExtrap.h:105
 AliMUONTrackExtrap.h:106
 AliMUONTrackExtrap.h:107
 AliMUONTrackExtrap.h:108
 AliMUONTrackExtrap.h:109
 AliMUONTrackExtrap.h:110
 AliMUONTrackExtrap.h:111
 AliMUONTrackExtrap.h:112
 AliMUONTrackExtrap.h:113
 AliMUONTrackExtrap.h:114
 AliMUONTrackExtrap.h:115
 AliMUONTrackExtrap.h:116
 AliMUONTrackExtrap.h:117
 AliMUONTrackExtrap.h:118
 AliMUONTrackExtrap.h:119
 AliMUONTrackExtrap.h:120
 AliMUONTrackExtrap.h:121
 AliMUONTrackExtrap.h:122
 AliMUONTrackExtrap.h:123
 AliMUONTrackExtrap.h:124
 AliMUONTrackExtrap.h:125
 AliMUONTrackExtrap.h:126
 AliMUONTrackExtrap.h:127
 AliMUONTrackExtrap.h:128
 AliMUONTrackExtrap.h:129