Add threshold for primary particles participating to a digit

[u/mrichter/AliRoot.git] / MUON / AliMUONTrack.cxx

/**************************************************************************
 * Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
 *                                                                        *
 * Author: The ALICE Off-line Project.                                    *
 * Contributors are mentioned in the code where appropriate.              *
 *                                                                        *
 * Permission to use, copy, modify and distribute this software and its   *
 * documentation strictly for non-commercial purposes is hereby granted   *
 * without fee, provided that the above copyright notice appears in all   *
 * copies and that both the copyright notice and this permission notice   *
 * appear in the supporting documentation. The authors make no claims     *
 * about the suitability of this software for any purpose. It is          *
 * provided "as is" without express or implied warranty.                  *
 **************************************************************************/

/*
$Log$
Revision 1.3  2000/06/25 13:23:28  hristov
stdlib.h needed for non-Linux compilation

Revision 1.2  2000/06/15 07:58:48  morsch
Code from MUON-dev joined

Revision 1.1.2.3  2000/06/12 10:11:34  morsch
Dummy copy constructor and assignment operator added

Revision 1.1.2.2  2000/06/09 12:58:05  gosset
Removed comment beginnings in Log sections of .cxx files
Suppressed most violations of coding rules

Revision 1.1.2.1  2000/06/07 14:44:53  gosset
Addition of files for track reconstruction in C++
*/

//__________________________________________________________________________
//
// Reconstructed track in ALICE dimuon spectrometer
//__________________________________________________________________________

#include "AliMUONTrack.h"

#include <iostream.h>

#include <TClonesArray.h>
#include <TMinuit.h>
#include <TMath.h>
#include <TMatrix.h>

#include "AliMUONEventReconstructor.h" 
#include "AliMUONHitForRec.h" 
#include "AliMUONSegment.h" 
#include "AliMUONTrackHit.h"

#include <stdlib.h>

// variables to be known from minimization functions
static AliMUONTrack *trackBeingFitted;
static AliMUONTrackParam *trackParamBeingFitted;

// Functions to be minimized with Minuit
void TrackChi2(Int_t &NParam, Double_t *Gradient, Double_t &Chi2, Double_t *Param, Int_t Flag);
void TrackChi2MCS(Int_t &NParam, Double_t *Gradient, Double_t &Chi2, Double_t *Param, Int_t Flag);

Double_t MultipleScatteringAngle2(AliMUONTrackHit *TrackHit);

ClassImp(AliMUONTrack) // Class implementation in ROOT context

  //__________________________________________________________________________
AliMUONTrack::AliMUONTrack(AliMUONSegment* BegSegment, AliMUONSegment* EndSegment, AliMUONEventReconstructor* EventReconstructor)
{
  // Constructor from two Segment's
  fEventReconstructor = EventReconstructor; // link back to EventReconstructor
  // memory allocation for the TClonesArray of reconstructed TrackHit's
  fTrackHitsPtr = new  TClonesArray("AliMUONTrackHit", 10);
  fNTrackHits = 0;
  AddSegment(BegSegment); // add hits from BegSegment
  AddSegment(EndSegment); // add hits from EndSegment
  fTrackHitsPtr->Sort(); // sort TrackHits according to increasing Z
  SetTrackParamAtVertex(); // set track parameters at vertex
  fFitMCS = 0;
  return;
}

  //__________________________________________________________________________
AliMUONTrack::AliMUONTrack(AliMUONSegment* Segment, AliMUONHitForRec* HitForRec, AliMUONEventReconstructor* EventReconstructor)
{
  // Constructor from one Segment and one HitForRec
  fEventReconstructor = EventReconstructor; // link back to EventReconstructor
  // memory allocation for the TClonesArray of reconstructed TrackHit's
  fTrackHitsPtr = new  TClonesArray("AliMUONTrackHit", 10);
  fNTrackHits = 0;
  AddSegment(Segment); // add hits from Segment
  AddHitForRec(HitForRec); // add HitForRec
  fTrackHitsPtr->Sort(); // sort TrackHits according to increasing Z
  SetTrackParamAtVertex(); // set track parameters at vertex
  fFitMCS = 0;
  return;
}

AliMUONTrack::AliMUONTrack (const AliMUONTrack& MUONTrack)
{
// Dummy copy constructor
}

AliMUONTrack & AliMUONTrack::operator=(const AliMUONTrack& MUONTrack)
{
// Dummy assignment operator
    return *this;
}

  //__________________________________________________________________________
void AliMUONTrack::SetFitMCS(Int_t FitMCS)
{
  // Set track fit option with or without multiple Coulomb scattering
  // from "FitMCS" argument: 0 without, 1 with
  fFitMCS = FitMCS;
  // better implementation with enum(with, without) ????
  return;
}

// Inline functions for Get and Set: inline removed because it does not work !!!!
AliMUONTrackParam* AliMUONTrack::GetTrackParamAtVertex(void) {
  // Get pointer to fTrackParamAtVertex
  return &fTrackParamAtVertex;}
AliMUONTrackParam* AliMUONTrack::GetTrackParamAtFirstHit(void) {
  // Get pointer to TrackParamAtFirstHit
  return ((AliMUONTrackHit*) (fTrackHitsPtr->First()))->GetTrackParam();}
TClonesArray* AliMUONTrack::GetTrackHitsPtr(void) {
  // Get fTrackHitsPtr
  return fTrackHitsPtr;}
Int_t AliMUONTrack::GetNTrackHits(void) {
  // Get fNTrackHits
  return fNTrackHits;}

  //__________________________________________________________________________
void AliMUONTrack::RecursiveDump(void)
{
  // Recursive dump of AliMUONTrack, i.e. with dump of TrackHit's and HitForRec's
  AliMUONTrackHit *trackHit;
  AliMUONHitForRec *hitForRec;
  cout << "Recursive dump of Track: " << this << endl;
  // Track
  this->Dump();
  for (Int_t trackHitIndex = 0; trackHitIndex < fNTrackHits; trackHitIndex++) {
    trackHit = (AliMUONTrackHit*) ((*fTrackHitsPtr)[trackHitIndex]);
    // TrackHit
    cout << "TrackHit: " << trackHit << " (index: " << trackHitIndex << ")" << endl;
    trackHit->Dump();
    hitForRec = trackHit->GetHitForRecPtr();
    // HitForRec
    cout << "HitForRec: " << hitForRec << endl;
    hitForRec->Dump();
  }
  return;
}

  //__________________________________________________________________________
void AliMUONTrack::Fit(AliMUONTrackParam *TrackParam, Int_t NParam)
{
  // Fit the current track ("this"),
  // starting with track parameters pointed to by "TrackParam",
  // and with 3 or 5 parameters ("NParam"):
  // 3 if one keeps X and Y fixed in "TrackParam",
  // 5 if one lets them vary.
  if ((NParam != 3) && (NParam != 5)) {
    cout << "ERROR in AliMUONTrack::Fit, NParam = " << NParam;
    cout << " , i.e. neither 3 nor 5 ====> EXIT" << endl;
    exit(0); // right instruction for exit ????
  }
  Int_t error = 0;
  Double_t arg[1], benC, errorParam, invBenP, lower, nonBenC, upper, x, y;
  TString parName;
  TMinuit *minuit = new TMinuit(5);
  trackBeingFitted = this; // for the track to be known from the function to minimize
  trackParamBeingFitted = TrackParam; // for the track parameters to be known from the function to minimize; possible to use only Minuit parameters ????
  // try to use TVirtualFitter to get this feature automatically !!!!
  minuit->mninit(5, 10, 7); // sysrd, syswr, syssa: useful ????
  // how to go faster ???? choice of Minuit parameters like EDM ????
  // choice of function to be minimized according to fFitMCS
  if (fFitMCS == 0) minuit->SetFCN(TrackChi2);
  else minuit->SetFCN(TrackChi2MCS);
  minuit->SetPrintLevel(1); // More printing !!!!
  // set first 3 parameters
  // could be tried with no limits for the search (min=max=0) ????
  minuit->mnparm(0, "InvBenP",
		 TrackParam->GetInverseBendingMomentum(),
		 0.003, -0.4, 0.4, error);
  minuit->mnparm(1, "BenS",
		 TrackParam->GetBendingSlope(),
		 0.001, -0.5, 0.5, error);
  minuit->mnparm(2, "NonBenS",
		 TrackParam->GetNonBendingSlope(),
		 0.001, -0.5, 0.5, error);
  if (NParam == 5) {
    // set last 2 parameters (no limits for the search: min=max=0)
    minuit->mnparm(3, "X",
		   TrackParam->GetNonBendingCoor(),
		   0.03, 0.0, 0.0, error);
    minuit->mnparm(4, "Y",
		   TrackParam->GetBendingCoor(),
		   0.10, 0.0, 0.0, error);
  }
  // search without gradient calculation in the function
  minuit->mnexcm("SET NOGRADIENT", arg, 0, error);
  // minimization
  minuit->mnexcm("MINIMIZE", arg, 0, error);
  // exit from Minuit
  minuit->mnexcm("EXIT", arg, 0, error); // necessary ????
  // print results
  minuit->mnpout(0, parName, invBenP, errorParam, lower, upper, error);
  minuit->mnpout(1, parName, benC, errorParam, lower, upper, error);
  minuit->mnpout(2, parName, nonBenC, errorParam, lower, upper, error);
  if (NParam == 5) {
    minuit->mnpout(3, parName, x, errorParam, lower, upper, error);
    minuit->mnpout(4, parName, y, errorParam, lower, upper, error);
  }
  // result of the fit into track parameters
  TrackParam->SetInverseBendingMomentum(invBenP);
  TrackParam->SetBendingSlope(benC);
  TrackParam->SetNonBendingSlope(nonBenC);
  if (NParam == 5) {
    TrackParam->SetNonBendingCoor(x);
    TrackParam->SetBendingCoor(y);
  }
  trackBeingFitted = NULL;
  delete minuit;
}

  //__________________________________________________________________________
void AliMUONTrack::AddSegment(AliMUONSegment* Segment)
{
  // Add Segment
  AddHitForRec(Segment->GetHitForRec1()); // 1st hit
  AddHitForRec(Segment->GetHitForRec2()); // 2nd hit
}

  //__________________________________________________________________________
void AliMUONTrack::AddHitForRec(AliMUONHitForRec* HitForRec)
{
  // Add HitForRec
  new ((*fTrackHitsPtr)[fNTrackHits]) AliMUONTrackHit(HitForRec);
  fNTrackHits++;
}

  //__________________________________________________________________________
void AliMUONTrack::SetTrackParamAtHit(Int_t indexHit, AliMUONTrackParam *TrackParam)
{
  // Set track parameters at TrackHit with index "indexHit"
  // from the track parameters pointed to by "TrackParam".
  AliMUONTrackHit* trackHit = (AliMUONTrackHit*) ((*fTrackHitsPtr)[indexHit]);
  trackHit->SetTrackParam(TrackParam);
}

  //__________________________________________________________________________
void AliMUONTrack::SetTrackParamAtVertex()
{
  // Set track parameters at vertex.
  // TrackHit's are assumed to be only in stations(1..) 4 and 5,
  // and sorted according to increasing Z..
  // Parameters are calculated from information in HitForRec's
  // of first and last TrackHit's.
  AliMUONTrackParam *trackParam =
    &fTrackParamAtVertex; // pointer to track parameters
  // Pointer to HitForRec of first TrackHit
  AliMUONHitForRec *firstHit =
    ((AliMUONTrackHit*) (fTrackHitsPtr->First()))->GetHitForRecPtr();
  // Pointer to HitForRec of last TrackHit
  AliMUONHitForRec *lastHit =
    ((AliMUONTrackHit*) (fTrackHitsPtr->Last()))->GetHitForRecPtr();
  // Z difference between first and last hits
  Double_t deltaZ = firstHit->GetZ() - lastHit->GetZ();
  // bending slope in stations(1..) 4 and 5
  Double_t bendingSlope =
    (firstHit->GetBendingCoor() - lastHit->GetBendingCoor()) / deltaZ;
  trackParam->SetBendingSlope(bendingSlope);
  // impact parameter
  Double_t impactParam =
    firstHit->GetBendingCoor() - bendingSlope * firstHit->GetZ(); // same if from firstHit and  lastHit ????
  // signed bending momentum
  Double_t signedBendingMomentum =
    fEventReconstructor->GetBendingMomentumFromImpactParam(impactParam);
  trackParam->SetInverseBendingMomentum(1.0 / signedBendingMomentum);
  // bending slope at vertex
  trackParam->
    SetBendingSlope(bendingSlope +
		    impactParam / fEventReconstructor->GetSimpleBPosition());
  // non bending slope
  Double_t nonBendingSlope =
    (firstHit->GetNonBendingCoor() - lastHit->GetNonBendingCoor()) / deltaZ;
  trackParam->SetNonBendingSlope(nonBendingSlope);
  // vertex coordinates at (0,0,0)
  trackParam->SetZ(0.0);
  trackParam->SetBendingCoor(0.0);
  trackParam->SetNonBendingCoor(0.0);
}

  //__________________________________________________________________________
void TrackChi2(Int_t &NParam, Double_t *Gradient, Double_t &Chi2, Double_t *Param, Int_t Flag)
{
  // Return the "Chi2" to be minimized with Minuit for track fitting,
  // with "NParam" parameters
  // and their current values in array pointed to by "Param".
  // Assumes that the track hits are sorted according to increasing Z.
  // Track parameters at each TrackHit are updated accordingly.
  // Multiple Coulomb scattering is not taken into account
  AliMUONTrackHit* hit;
  AliMUONTrackParam param1;
  Int_t hitNumber;
  Double_t zHit;
  Chi2 = 0.0; // initialize Chi2
  // copy of track parameters to be fitted
  param1 = *trackParamBeingFitted;
  // Minuit parameters to be fitted into this copy
  param1.SetInverseBendingMomentum(Param[0]);
  param1.SetBendingSlope(Param[1]);
  param1.SetNonBendingSlope(Param[2]);
  if (NParam == 5) {
    param1.SetNonBendingCoor(Param[3]);
    param1.SetBendingCoor(Param[4]);
  }
  // Follow track through all planes of track hits
  for (hitNumber = 0; hitNumber < trackBeingFitted->GetNTrackHits(); hitNumber++) {
    hit = (AliMUONTrackHit*) (*(trackBeingFitted->GetTrackHitsPtr()))[hitNumber];
    zHit = hit->GetHitForRecPtr()->GetZ();
    // do something special if 2 hits with same Z ????
    // security against infinite loop ????
    (&param1)->ExtrapToZ(zHit); // extrapolation
    hit->SetTrackParam(&param1);
    // Increment Chi2
    // done hit per hit, with hit resolution,
    // and not with point and angle like in "reco_muon.F" !!!!
    // Needs to add multiple scattering contribution ????
    Double_t dX =
      hit->GetHitForRecPtr()->GetNonBendingCoor() - (&param1)->GetNonBendingCoor();
    Double_t dY =
      hit->GetHitForRecPtr()->GetBendingCoor() - (&param1)->GetBendingCoor();
    Chi2 =
      Chi2 +
      dX * dX / hit->GetHitForRecPtr()->GetNonBendingReso2() +
      dY * dY / hit->GetHitForRecPtr()->GetBendingReso2();
  }
}

  //__________________________________________________________________________
void TrackChi2MCS(Int_t &NParam, Double_t *Gradient, Double_t &Chi2, Double_t *Param, Int_t Flag)
{
  // Return the "Chi2" to be minimized with Minuit for track fitting,
  // with "NParam" parameters
  // and their current values in array pointed to by "Param".
  // Assumes that the track hits are sorted according to increasing Z.
  // Track parameters at each TrackHit are updated accordingly.
  // Multiple Coulomb scattering is taken into account with covariance matrix.
  AliMUONTrackParam param1;
  Chi2 = 0.0; // initialize Chi2
  // copy of track parameters to be fitted
  param1 = *trackParamBeingFitted;
  // Minuit parameters to be fitted into this copy
  param1.SetInverseBendingMomentum(Param[0]);
  param1.SetBendingSlope(Param[1]);
  param1.SetNonBendingSlope(Param[2]);
  if (NParam == 5) {
    param1.SetNonBendingCoor(Param[3]);
    param1.SetBendingCoor(Param[4]);
  }

  AliMUONTrackHit* hit, hit1, hit2, hit3;
  Bool_t GoodDeterminant;
  Int_t hitNumber, hitNumber1, hitNumber2, hitNumber3;
  Double_t zHit[10], paramBendingCoor[10], paramNonBendingCoor[10], ap[10];
  Double_t hitBendingCoor[10], hitNonBendingCoor[10];
  Double_t hitBendingReso2[10], hitNonBendingReso2[10];
  Int_t numberOfHit = TMath::Min(trackBeingFitted->GetNTrackHits(), 10);
  TMatrix *covBending = new TMatrix(numberOfHit, numberOfHit);
  TMatrix *covNonBending = new TMatrix(numberOfHit, numberOfHit);

  // Predicted coordinates and  multiple scattering angles are first calculated
  for (hitNumber = 0; hitNumber < numberOfHit; hitNumber++) {
    hit = (AliMUONTrackHit*) (*(trackBeingFitted->GetTrackHitsPtr()))[hitNumber];
    zHit[hitNumber] = hit->GetHitForRecPtr()->GetZ();
    // do something special if 2 hits with same Z ????
    // security against infinite loop ????
    (&param1)->ExtrapToZ(zHit[hitNumber]); // extrapolation
    hit->SetTrackParam(&param1);
    paramBendingCoor[hitNumber]= (&param1)->GetBendingCoor();
    paramNonBendingCoor[hitNumber]= (&param1)->GetNonBendingCoor();
    hitBendingCoor[hitNumber]= hit->GetHitForRecPtr()->GetBendingCoor();
    hitNonBendingCoor[hitNumber]= hit->GetHitForRecPtr()->GetNonBendingCoor();
    hitBendingReso2[hitNumber]= hit->GetHitForRecPtr()->GetBendingReso2();
    hitNonBendingReso2[hitNumber]= hit->GetHitForRecPtr()->GetNonBendingReso2();
    ap[hitNumber] = MultipleScatteringAngle2(hit); // multiple scatt. angle ^2  
  }

  // Calculates the covariance matrix
  for (hitNumber1 = 0; hitNumber1 < numberOfHit; hitNumber1++) {    
    for (hitNumber2 = hitNumber1; hitNumber2 < numberOfHit; hitNumber2++) {
      (*covBending)(hitNumber1, hitNumber2) = 0;
      (*covBending)(hitNumber2, hitNumber1) = 0;
      if (hitNumber1 == hitNumber2){ // diagonal elements
	(*covBending)(hitNumber2, hitNumber1) =
	  (*covBending)(hitNumber2, hitNumber1) + hitBendingReso2[hitNumber1];
      }
      // Multiple Scattering...  loop on upstream chambers ??
      for (hitNumber3 = 0; hitNumber3 < hitNumber1; hitNumber3++){ 	
	(*covBending)(hitNumber2, hitNumber1) =
	  (*covBending)(hitNumber2, hitNumber1) +
	  ((zHit[hitNumber1] - zHit[hitNumber3]) *
	   (zHit[hitNumber2] - zHit[hitNumber3]) * ap[hitNumber3]); 
      }  
      (*covNonBending)(hitNumber1, hitNumber2) = 0;
      (*covNonBending)(hitNumber2, hitNumber1) =
	(*covBending)(hitNumber2, hitNumber1);
      if (hitNumber1 == hitNumber2) {  // diagonal elements
	(*covNonBending)(hitNumber2, hitNumber1) =
	  (*covNonBending)(hitNumber2, hitNumber1) -
	  hitBendingReso2[hitNumber1] + hitNonBendingReso2[hitNumber1] ;
      }      
    }
  }

  // Inverts covariance matrix 
  GoodDeterminant = kTRUE;
  if (covBending->Determinant() != 0) {
    covBending->Invert();
  } else {
    GoodDeterminant = kFALSE;
    cout << "Warning in ChiMCS  Determinant Bending=0: " << endl;  
  }
  if (covNonBending->Determinant() != 0){
    covNonBending->Invert();
  } else {
    GoodDeterminant = kFALSE;
    cout << "Warning in ChiMCS  Determinant non Bending=0: " << endl;  
  }
  
  // Calculates Chi2
  if (GoodDeterminant) { // with Multiple Scattering if inversion correct
    for (hitNumber1=0; hitNumber1 < numberOfHit ; hitNumber1++){ 
      for (hitNumber2=0; hitNumber2 < numberOfHit; hitNumber2++){
	Chi2 = Chi2 +
	  ((*covBending)(hitNumber2, hitNumber1) * 
	   (hitBendingCoor[hitNumber1] - paramBendingCoor[hitNumber1]) *
	   (hitBendingCoor[hitNumber2] - paramBendingCoor[hitNumber2]));
	Chi2 = Chi2 +
	  ((*covNonBending)(hitNumber2, hitNumber1) *
	   (hitNonBendingCoor[hitNumber1] - paramNonBendingCoor[hitNumber1]) *
	   (hitNonBendingCoor[hitNumber2] - paramNonBendingCoor[hitNumber2]));
      }
    }
  } else {  // without Multiple Scattering if inversion impossible
    for (hitNumber1=0; hitNumber1 < numberOfHit ; hitNumber1++) { 
      Chi2 = Chi2 +
	((hitBendingCoor[hitNumber1] - paramBendingCoor[hitNumber1]) *
	 (hitBendingCoor[hitNumber1] - paramBendingCoor[hitNumber1]) /
	 hitBendingReso2[hitNumber1]);
      Chi2 = Chi2 +
	((hitNonBendingCoor[hitNumber1] - paramNonBendingCoor[hitNumber1]) *
	 (hitNonBendingCoor[hitNumber1] - paramNonBendingCoor[hitNumber1]) /
	 hitNonBendingReso2[hitNumber1]);      
    }
  }
  
  delete covBending;
  delete covNonBending;
}

Double_t MultipleScatteringAngle2(AliMUONTrackHit *TrackHit)
{
  // Returns square of multiple Coulomb scattering angle
  // at TrackHit pointed to by "TrackHit"
  Double_t slopeBending, slopeNonBending, radiationLength, inverseBendingMomentum2, inverseTotalMomentum2;
  Double_t varMultipleScatteringAngle;
  AliMUONTrackParam *param = TrackHit->GetTrackParam();
  slopeBending = param->GetBendingSlope();
  slopeNonBending = param->GetNonBendingSlope();
  // thickness in radiation length for the current track,
  // taking local angle into account
  radiationLength =
    trackBeingFitted->GetEventReconstructor()->GetChamberThicknessInX0() *
    TMath::Sqrt(1.0 +
		slopeBending * slopeBending + slopeNonBending * slopeNonBending);
  inverseBendingMomentum2 = 
    param->GetInverseBendingMomentum() * param->GetInverseBendingMomentum();
  inverseTotalMomentum2 =
    inverseBendingMomentum2 * (1.0 + slopeBending*slopeBending) /
    (1.0 + slopeBending *slopeBending + slopeNonBending * slopeNonBending); 
  varMultipleScatteringAngle = 0.0136 * (1.0 + 0.038 * TMath::Log(radiationLength));
  varMultipleScatteringAngle = inverseTotalMomentum2 * radiationLength *
    varMultipleScatteringAngle * varMultipleScatteringAngle;
  return varMultipleScatteringAngle;
}