MUON/AliMUONRecoParam.cxx

   1 /**************************************************************************
   2 * Copyright(c) 1998-2007, ALICE Experiment at CERN, All rights reserved. *
   3 *                                                                        *
   4 * Author: The ALICE Off-line Project.                                    *
   5 * Contributors are mentioned in the code where appropriate.              *
   6 *                                                                        *
   7 * Permission to use, copy, modify and distribute this software and its   *
   8 * documentation strictly for non-commercial purposes is hereby granted   *
   9 * without fee, provided that the above copyright notice appears in all   *
  10 * copies and that both the copyright notice and this permission notice   *
  11 * appear in the supporting documentation. The authors make no claims     *
  12 * about the suitability of this software for any purpose. It is          *
  13 * provided "as is" without express or implied warranty.                  *
  14 **************************************************************************/
  15
  16 // $Id$
  17
  18 //-----------------------------------------------------------------------------
  19 /// \class AliMUONRecoParam
  20 ///
  21 /// Class with MUON reconstruction parameters
  22 ///
  23 ///  \author Philippe Pillot
  24 //-----------------------------------------------------------------------------
  25
  26
  27
  28 #include "AliMUONRecoParam.h"
  29 #include "AliMUONPadStatusMaker.h"
  30
  31 #include "AliRecoParam.h"
  32 #include "AliLog.h"
  33
  34 #include <Riostream.h>
  35
  36 ClassImp(AliMUONRecoParam)
  37
  38
  39 //_____________________________________________________________________________
  40 AliMUONRecoParam::AliMUONRecoParam()
  41 : AliDetectorRecoParam(),
  42   fClusteringMode("MLEM"),
  43   fTrackingMode("KALMAN"),
  44   fMinBendingMomentum(0.),
  45   fMaxBendingMomentum(0.),
  46   fMaxNonBendingSlope(0.),
  47   fMaxBendingSlope(0.),
  48   fNonBendingVertexDispersion(0.),
  49   fBendingVertexDispersion(0.),
  50   fMaxNonBendingDistanceToTrack(0.),
  51   fMaxBendingDistanceToTrack(0.),
  52   fSigmaCutForTracking(0.),
  53   fSigmaCutForImprovement(0.),
  54   fSigmaCutForTrigger(0.),
  55   fStripCutForTrigger(0.),
  56   fMaxStripAreaForTrigger(0.),
  57   fMaxNormChi2MatchTrigger(0.),
  58   fPercentOfFullClusterInESD(10.),
  59   fCombinedClusterTrackReco(kFALSE),
  60   fTrackAllTracks(kFALSE),
  61   fRecoverTracks(kFALSE),
  62   fMakeTrackCandidatesFast(kFALSE),
  63   fMakeMoreTrackCandidates(kFALSE),
  64   fComplementTracks(kFALSE),
  65   fImproveTracks(kFALSE),
  66   fUseSmoother(kFALSE),
  67   fSaveFullClusterInESD(kTRUE),
  68   fCalibrationMode("NOGAIN"),
  69   fBypassSt45(0),
  70   fPadGoodnessMask(0),
  71   fChargeSigmaCut(4.0)
  72 {
  73   /// Constructor
  74
  75   SetNameTitle("Dummy","Dummy");
  76   SetDefaultLimits();
  77 }
  78
  79 //_____________________________________________________________________________
  80 AliMUONRecoParam::~AliMUONRecoParam()
  81 {
  82   /// Destructor
  83 }
  84
  85 //_____________________________________________________________________________
  86 void
  87 AliMUONRecoParam::BypassSt45(Bool_t st4, Bool_t st5)
  88 {
  89         /// Set the bypass status
  90
  91         if ( st4 && st5 ) fBypassSt45 = 45;
  92         else if ( st4 ) fBypassSt45 = 4;
  93         else if ( st5 ) fBypassSt45 = 5;
  94         else fBypassSt45 = 0;
  95 }
  96
  97 //_____________________________________________________________________________
  98 Option_t*
  99 AliMUONRecoParam::GetCalibrationMode() const
 100 {
 101   /// Return the calibration mode. Can be :
 102   /// NOGAIN : only do pedestal subtraction
 103   /// GAIN : do pedestal subtraction, and apply gain correction, but with a
 104   ///        single capacitance value for all channels
 105   /// GAINCONSTANTCAPA : as GAIN, but with a channel-dependent capacitance value
 106
 107   return fCalibrationMode.Data();
 108 }
 109
 110 //_____________________________________________________________________________
 111 AliMUONRecoParam *AliMUONRecoParam::GetLowFluxParam()
 112 {
 113   /// Return default reconstruction parameters for low flux environment
 114
 115   AliMUONRecoParam *param = new AliMUONRecoParam();
 116   param->SetLowFluxParam();
 117
 118   return param;
 119 }
 120
 121 //_____________________________________________________________________________
 122 AliMUONRecoParam *AliMUONRecoParam::GetHighFluxParam()
 123 {
 124   /// Return default reconstruction parameters for high flux environment
 125
 126   AliMUONRecoParam *param = new AliMUONRecoParam();
 127   param->SetHighFluxParam();
 128
 129   return param;
 130 }
 131
 132 //_____________________________________________________________________________
 133 AliMUONRecoParam *AliMUONRecoParam::GetCosmicParam()
 134 {
 135   /// Return default reconstruction parameters for high flux environment
 136
 137   AliMUONRecoParam *param = new AliMUONRecoParam();
 138   param->SetCosmicParam();
 139
 140   return param;
 141 }
 142
 143 //_____________________________________________________________________________
 144 void AliMUONRecoParam::SetLowFluxParam()
 145 {
 146   /// Set reconstruction parameters for low flux environment
 147
 148   SetNameTitle("Low Flux","Low Flux");
 149   SetEventSpecie(AliRecoParam::kLowMult);
 150   fMinBendingMomentum = 1.;
 151   fMaxBendingMomentum = 3000.;
 152   fMaxNonBendingSlope = 0.3;
 153   fMaxBendingSlope = 0.4;
 154   fNonBendingVertexDispersion = 10.;
 155   fBendingVertexDispersion = 10.;
 156   fMaxNonBendingDistanceToTrack = 1.;
 157   fMaxBendingDistanceToTrack = 1.;
 158   fSigmaCutForTracking = 6.;
 159   fSigmaCutForImprovement = 5.;
 160   fSigmaCutForTrigger = 8.;
 161   fStripCutForTrigger = 1.;
 162   fMaxStripAreaForTrigger = 3.;
 163   fMaxNormChi2MatchTrigger = 16.;
 164   fCombinedClusterTrackReco = kFALSE;
 165   fTrackAllTracks = kTRUE;
 166   fRecoverTracks = kTRUE;
 167   fMakeTrackCandidatesFast = kFALSE;
 168   fMakeMoreTrackCandidates = kFALSE;
 169   fComplementTracks = kTRUE;
 170   fImproveTracks = kTRUE;
 171   fUseSmoother = kTRUE;
 172   for (Int_t iCh = 0; iCh < 10; iCh++) fUseChamber[iCh] = kTRUE;
 173   for (Int_t iSt = 0; iSt < 5; iSt++) fRequestStation[iSt] = kTRUE;
 174   fBypassSt45 = 0;
 175
 176 }
 177
 178 //_____________________________________________________________________________
 179 void AliMUONRecoParam::SetHighFluxParam()
 180 {
 181   /// Set reconstruction parameters for high flux environment
 182
 183   SetNameTitle("High Flux","High Flux");
 184   SetEventSpecie(AliRecoParam::kHighMult);
 185   fMinBendingMomentum = 1.;
 186   fMaxBendingMomentum = 3000.;
 187   fMaxNonBendingSlope = 0.3;
 188   fMaxBendingSlope = 0.4;
 189   fNonBendingVertexDispersion = 10.;
 190   fBendingVertexDispersion = 10.;
 191   fMaxNonBendingDistanceToTrack = 1.;
 192   fMaxBendingDistanceToTrack = 1.;
 193   fSigmaCutForTracking = 6.;
 194   fSigmaCutForImprovement = 5.;
 195   fSigmaCutForTrigger = 8.;
 196   fStripCutForTrigger = 1.;
 197   fMaxStripAreaForTrigger = 3.;
 198   fMaxNormChi2MatchTrigger = 16.;
 199   fCombinedClusterTrackReco = kFALSE;
 200   fTrackAllTracks = kTRUE;
 201   fRecoverTracks = kTRUE;
 202   fMakeTrackCandidatesFast = kFALSE;
 203   fMakeMoreTrackCandidates = kFALSE;
 204   fComplementTracks = kTRUE;
 205   fImproveTracks = kTRUE;
 206   fUseSmoother = kTRUE;
 207   for (Int_t iCh = 0; iCh < 10; iCh++) fUseChamber[iCh] = kTRUE;
 208   for (Int_t iSt = 0; iSt < 5; iSt++) fRequestStation[iSt] = kTRUE;
 209   fBypassSt45 = 0;
 210
 211 }
 212
 213 //_____________________________________________________________________________
 214 UInt_t
 215 AliMUONRecoParam::RequestedStationMask() const
 216 {
 217   /// Get the mask of the requested station, i.e. an integer where
 218   /// bit n is set to one if the station n was requested
 219
 220   UInt_t m(0);
 221
 222   for ( Int_t i = 0; i < 5; ++i )
 223   {
 224     if ( RequestStation(i) ) m |= ( 1 << i );
 225   }
 226   return m;
 227 }
 228
 229 //_____________________________________________________________________________
 230 void AliMUONRecoParam::SetCosmicParam()
 231 {
 232   /// Set reconstruction parameters for high flux environment
 233
 234   SetNameTitle("Cosmic","Cosmic");
 235   SetEventSpecie(AliRecoParam::kCosmic);
 236   fMinBendingMomentum = 1.;
 237   fMaxBendingMomentum = 10000000.;
 238   fMaxNonBendingSlope = 0.3;
 239   fMaxBendingSlope = 0.4;
 240   fNonBendingVertexDispersion = 10.;
 241   fBendingVertexDispersion = 10.;
 242   fMaxNonBendingDistanceToTrack = 10.;
 243   fMaxBendingDistanceToTrack = 10.;
 244   fSigmaCutForTracking = 20.;
 245   fSigmaCutForImprovement = 20.;
 246   fSigmaCutForTrigger = 8.;
 247   fMaxNormChi2MatchTrigger = 16.;
 248   fPercentOfFullClusterInESD = 100.;
 249   fCombinedClusterTrackReco = kFALSE;
 250   fTrackAllTracks = kTRUE;
 251   fRecoverTracks = kTRUE;
 252   fMakeTrackCandidatesFast = kFALSE;
 253   fMakeMoreTrackCandidates = kFALSE;
 254   fComplementTracks = kTRUE;
 255   fImproveTracks = kTRUE;
 256   fUseSmoother = kTRUE;
 257   fSaveFullClusterInESD = kTRUE;
 258   for (Int_t iCh = 0; iCh < 10; iCh++) fUseChamber[iCh] = kTRUE;
 259   for (Int_t iSt = 0; iSt < 5; iSt++) fRequestStation[iSt] = kTRUE;
 260   fBypassSt45 = 0;
 261
 262 }
 263
 264 //_____________________________________________________________________________
 265 void AliMUONRecoParam::Print(Option_t *option) const
 266 {
 267   /// print reconstruction parameters
 268   /// if option = FULL then print also unused parameters
 269
 270   cout<<endl<<"\t------Reconstruction parameters ("<<GetName()<<")------"<<endl;
 271
 272   if (IsDefault()) cout<<"\t\t*** Parameters used by default ***"<<endl;
 273
 274   cout<<Form("Calibration mode = %s",fCalibrationMode.Data())<<endl;
 275   cout<<Form("Clustering mode = %s",fClusteringMode.Data())<<endl;
 276   cout<<Form("Tracking mode = %s",fTrackingMode.Data())<<endl;
 277
 278         TString bypass;
 279
 280         if ( BypassSt45() )
 281         {
 282                 bypass = "stations 4 and 5";
 283         }
 284         else if ( BypassSt4() )
 285         {
 286                 bypass = "station 4";
 287         }
 288         else if ( BypassSt5() )
 289         {
 290                 bypass = "station 5";
 291         }
 292
 293   if (bypass.Length()) cout << "Will bypass " << bypass.Data() << " (replacing real clusters by generated ones from trigger tracks)" << endl;
 294
 295   if (fCombinedClusterTrackReco) cout<<"Combined cluster/track reconstruction: ON"<<endl;
 296   else cout<<"Combined cluster/track reconstruction: OFF"<<endl;
 297
 298   if (fSaveFullClusterInESD) cout<<Form("Save all cluster info in ESD for %5.2f %% of events",fPercentOfFullClusterInESD)<<endl;
 299   else cout<<"Save partial cluster info in ESD"<<endl;
 300
 301   cout<<Form("Bending momentum range = [%5.2f,%5.2f]",fMinBendingMomentum,fMaxBendingMomentum)<<endl;
 302
 303   cout<<Form("Maximum non bending slope = %5.2f",fMaxNonBendingSlope)<<endl;
 304
 305   cout<<Form("Maximum bending slope (used only if B=0) = %5.2f",fMaxBendingSlope)<<endl;
 306
 307   if (strstr(fTrackingMode,"ORIGINAL"))
 308     cout<<Form("Vertex dispertion = (%5.2f,%5.2f)",fNonBendingVertexDispersion,fBendingVertexDispersion)<<endl;
 309   else if (strstr(option,"FULL"))
 310     cout<<Form("Vertex dispertion (used for original tracking only) = (%5.2f,%5.2f)",fNonBendingVertexDispersion,fBendingVertexDispersion)<<endl;
 311
 312   cout<<Form("Maximum distance to track = (%5.2f,%5.2f)",fMaxNonBendingDistanceToTrack,fMaxBendingDistanceToTrack)<<endl;
 313
 314   cout<<Form("Sigma cut for tracking = %5.2f",fSigmaCutForTracking)<<endl;
 315
 316   cout<<Form("Sigma cut for trigger hit pattern = %5.2f",fSigmaCutForTrigger)<<endl;
 317
 318   cout<<Form("Cut in strips for trigger chamber efficiency = %5.2f",fStripCutForTrigger)<<endl;
 319
 320   cout<<Form("Max search area in strips for trigger chamber efficiency = %5.2f",fMaxStripAreaForTrigger)<<endl;
 321
 322   if (fTrackAllTracks) cout<<"Track all the possible candidates"<<endl;
 323   else cout<<"Track only the best candidates"<<endl;
 324
 325   if (strstr(option,"FULL")) {
 326     cout<<"Make track candidates assuming linear propagation between stations 4 and 5: ";
 327     if (fMakeTrackCandidatesFast) cout<<"ON"<<endl;
 328     else cout<<"OFF"<<endl;
 329   } else if (fMakeTrackCandidatesFast)
 330     cout<<"Make track candidates assuming linear propagation between stations 4 and 5"<<endl;
 331
 332   if (strstr(option,"FULL")) {
 333     cout<<"Make track candidates starting from 1 cluster in each of the stations 4 and 5: ";
 334     if (fMakeMoreTrackCandidates) cout<<"ON"<<endl;
 335     else cout<<"OFF"<<endl;
 336   } else if (fMakeMoreTrackCandidates)
 337     cout<<"Make track candidates starting from 1 cluster in each of the stations 4 and 5"<<endl;
 338
 339   if (strstr(option,"FULL")) {
 340     cout<<"Try to recover tracks getting lost during tracking: ";
 341     if (fRecoverTracks) cout<<"ON"<<endl;
 342     else cout<<"OFF"<<endl;
 343   } else if (fRecoverTracks)
 344     cout<<"Try to recover tracks getting lost during tracking"<<endl;
 345
 346   if (strstr(option,"FULL")) {
 347     cout<<"Try to complete the reconstructed tracks by adding missing clusters: ";
 348     if (fComplementTracks) cout<<"ON"<<endl;
 349     else cout<<"OFF"<<endl;
 350   } else if (fComplementTracks)
 351     cout<<"Try to complete the reconstructed tracks by adding missing clusters"<<endl;
 352
 353   if (strstr(option,"FULL")) {
 354     cout<<"Try to improve the reconstructed tracks by removing bad clusters: ";
 355     if (fImproveTracks) cout<<Form("ON (sigma cut = %5.2f)",fSigmaCutForImprovement)<<endl;
 356     else cout<<"OFF"<<endl;
 357   } else if (fImproveTracks)
 358     cout<<Form("Try to improve the reconstructed tracks by removing bad clusters (sigma cut = %5.2f)",fSigmaCutForImprovement)<<endl;
 359
 360   if (strstr(option,"FULL")) {
 361     cout<<"Use smoother to compute final track parameters, etc, at each cluster (used for Kalman tracking only): ";
 362     if (fUseSmoother) cout<<"ON"<<endl;
 363     else cout<<"OFF"<<endl;
 364   } else if (fUseSmoother)
 365     cout<<"Use smoother to compute final track parameters, etc, at each cluster"<<endl;
 366
 367   cout<<Form("Maximum normalized chi2 of tracking/trigger track matching = %5.2f",fMaxNormChi2MatchTrigger)<<endl;
 368
 369   Bool_t discardedCh = kFALSE;
 370   Int_t ch = 0;
 371   do {
 372     if (!UseChamber(ch)) {
 373       if (!discardedCh) {
 374         cout<<"Discarded chambers(1..): "<<ch+1;
 375         discardedCh = kTRUE;
 376       }
 377       else cout<<" "<<ch+1;
 378     }
 379   } while (++ch < 10);
 380   if (discardedCh) cout<<endl;
 381
 382   Bool_t discardedSt = kFALSE;
 383   Int_t st = 0;
 384   do {
 385     if (!RequestStation(st)) {
 386       if (!discardedSt) {
 387         cout<<"Not requested stations(1..): "<<st+1;
 388         discardedSt = kTRUE;
 389       }
 390       else cout<<" "<<st+1;
 391     }
 392   } while (++st < 5);
 393   if (discardedSt) cout<<endl;
 394
 395         cout << Form("Pad goodness policy mask is 0x%x",PadGoodnessMask()) << endl;
 396         cout << "Which means we reject pads having the condition = " <<
 397         AliMUONPadStatusMaker::AsCondition(PadGoodnessMask()).Data() << endl;
 398
 399         cout << "The pad limits we are using are :" << endl;
 400
 401         cout << Form("%5.0f <= HVSt12 <= %5.0f Volts",HVSt12LowLimit(),HVSt12HighLimit()) << endl;
 402         cout << Form("%5.0f <= HVSt345 <= %5.0f Volts",HVSt345LowLimit(),HVSt345HighLimit()) << endl;
 403         cout << Form("%7.2f <= Pedestal mean <= %7.2f",PedMeanLowLimit(),PedMeanHighLimit()) << endl;
 404         cout << Form("%7.2f <= Pedestal sigma <= %7.2f",PedSigmaLowLimit(),PedSigmaHighLimit()) << endl;
 405         cout << Form("%e <= Gain linear term <= %e",GainA1LowLimit(),GainA1HighLimit()) << endl;
 406         cout << Form("%e <= Gain quadratic term <= %e",GainA2LowLimit(),GainA2HighLimit()) << endl;
 407         cout << Form("%5.0f <= Gain threshold term <= %5.0f",GainThresLowLimit(),GainThresHighLimit()) << endl;
 408
 409   cout << Form("And we cut on charge >= %7.2f x ( pedestal sigma ) ",ChargeSigmaCut()) << endl;
 410
 411   cout<<"\t----------------------------------------------"<<endl<<endl;
 412
 413 }
 414
 415 //_____________________________________________________________________________
 416 void
 417 AliMUONRecoParam::SetDefaultLimits()
 418 {
 419         /// Set the default limits and pad goodness policy
 420
 421         fHVSt12Limits[0]=1500;
 422         fHVSt12Limits[1]=2000;
 423
 424         fHVSt345Limits[0]=1500;
 425         fHVSt345Limits[1]=2000;
 426
 427         fPedMeanLimits[0] = 50;
 428         fPedMeanLimits[1] = 1024;
 429
 430         fPedSigmaLimits[0] = 0.1;
 431         fPedSigmaLimits[1] = 100;
 432
 433         fGainA1Limits[0] = 0.1;
 434         fGainA1Limits[1] = 10;
 435
 436         fGainA2Limits[0] = -1E30;
 437         fGainA2Limits[1] = 1E30;
 438
 439         fGainThresLimits[0] = 0;
 440         fGainThresLimits[1] = 4095;
 441
 442         fPadGoodnessMask = 0x8080;
 443
 444   fChargeSigmaCut = 4.0;
 445 }
 446