]> git.uio.no Git - u/mrichter/AliRoot.git/blobdiff - MUON/AliMUONRecoParam.cxx
Correcting a message
[u/mrichter/AliRoot.git] / MUON / AliMUONRecoParam.cxx
index 2a520757fb34ce6f1aec8be409dc0c81e270ee89..b238512507dd58ad0b8a03e67c405e690f2fe4c1 100644 (file)
@@ -13,6 +13,7 @@
 * provided "as is" without express or implied warranty.                  *
 **************************************************************************/
 
+// $Id$
 
 //-----------------------------------------------------------------------------
 /// \class AliMUONRecoParam
@@ -25,7 +26,9 @@
 
 
 #include "AliMUONRecoParam.h"
+#include "AliMUONPadStatusMaker.h"
 
+#include "AliRecoParam.h"
 #include "AliLog.h"
 
 #include <Riostream.h>
@@ -38,7 +41,6 @@ AliMUONRecoParam::AliMUONRecoParam()
 : AliDetectorRecoParam(),
   fClusteringMode("MLEM"),
   fTrackingMode("KALMAN"),
-  fMostProbBendingMomentum(0.),
   fMinBendingMomentum(0.),
   fMaxBendingMomentum(0.),
   fMaxNonBendingSlope(0.),
@@ -64,13 +66,28 @@ AliMUONRecoParam::AliMUONRecoParam()
   fUseSmoother(kFALSE),
   fSaveFullClusterInESD(kTRUE),
   fCalibrationMode("NOGAIN"),
-  fBypassSt45(kFALSE)
-{
+  fBypassSt45(0),
+  fPadGoodnessMask(0),
+  fChargeSigmaCut(4.0),
+  fRemoveConnectedTracksInSt12(kFALSE),
+  fMaxTriggerTracks(0),
+  fMaxTrackCandidates(0),
+  fSelectTrackOnSlope(kFALSE),
+  fMissingPadFractionLimit(0),
+  fFractionOfBuspatchOutsideOccupancyLimit(0),
+  fAverageNoisePadCharge(0.22875),
+  fClusterChargeCut(2.0)
+{  
   /// Constructor
-  SetNameTitle("MUON","MUON");
   
-  // use the default parameters for low flux environment
-  SetLowFluxParam();
+  SetNameTitle("Dummy","Dummy");
+  for (Int_t iCh = 0; iCh < 10; iCh++) {
+    fUseChamber[iCh] = kTRUE;
+    fDefaultNonBendingReso[iCh] = 0.;
+    fDefaultBendingReso[iCh] = 0.;
+  }
+  for (Int_t iSt = 0; iSt < 5; iSt++) fRequestStation[iSt] = kTRUE;
+  SetDefaultLimits();
 }
 
 //_____________________________________________________________________________
@@ -79,6 +96,18 @@ AliMUONRecoParam::~AliMUONRecoParam()
   /// Destructor
 }
 
+//_____________________________________________________________________________
+void
+AliMUONRecoParam::BypassSt45(Bool_t st4, Bool_t st5)
+{
+       /// Set the bypass status
+       
+       if ( st4 && st5 ) fBypassSt45 = 45;
+       else if ( st4 ) fBypassSt45 = 4;
+       else if ( st5 ) fBypassSt45 = 5;
+       else fBypassSt45 = 0;
+}
+
 //_____________________________________________________________________________
 Option_t*
 AliMUONRecoParam::GetCalibrationMode() const
@@ -87,6 +116,7 @@ AliMUONRecoParam::GetCalibrationMode() const
   /// NOGAIN : only do pedestal subtraction
   /// GAIN : do pedestal subtraction, and apply gain correction, but with a
   ///        single capacitance value for all channels
+  /// INJECTIONGAIN : as GAIN, but with gain values taken as EMELEC factory values
   /// GAINCONSTANTCAPA : as GAIN, but with a channel-dependent capacitance value
   
   return fCalibrationMode.Data();
@@ -125,26 +155,40 @@ AliMUONRecoParam *AliMUONRecoParam::GetCosmicParam()
   return param;
 }
 
+//_____________________________________________________________________________
+AliMUONRecoParam *AliMUONRecoParam::GetCalibrationParam() 
+{
+  /// Return default (dummy) reconstruction parameters for calibration environment
+  
+  AliMUONRecoParam *param = new AliMUONRecoParam();
+  param->SetCalibrationParam();
+  
+  return param;
+}
+
+
 //_____________________________________________________________________________
 void AliMUONRecoParam::SetLowFluxParam() 
 {
   /// Set reconstruction parameters for low flux environment
   
-  fMostProbBendingMomentum = 2.;
-  fMinBendingMomentum = 1.;
-  fMaxBendingMomentum = 3000.;
+  SetNameTitle("Low Flux","Low Flux");
+  SetEventSpecie(AliRecoParam::kLowMult);
+  fMinBendingMomentum = 0.8;
+  fMaxBendingMomentum = 1.e10;
   fMaxNonBendingSlope = 0.3;
   fMaxBendingSlope = 0.4;
-  fNonBendingVertexDispersion = 10.;
-  fBendingVertexDispersion = 10.;
+  fSelectTrackOnSlope = kFALSE;
+  fNonBendingVertexDispersion = 70.;
+  fBendingVertexDispersion = 70.;
   fMaxNonBendingDistanceToTrack = 1.;
   fMaxBendingDistanceToTrack = 1.;
   fSigmaCutForTracking = 6.;
   fSigmaCutForImprovement = 5.;
-  fSigmaCutForTrigger = 8.;
+  fSigmaCutForTrigger = 4.;
   fStripCutForTrigger = 1.;
   fMaxStripAreaForTrigger = 3.;
-  fMaxNormChi2MatchTrigger = 16.;
+  fMaxNormChi2MatchTrigger = fSigmaCutForTrigger * fSigmaCutForTrigger;
   fCombinedClusterTrackReco = kFALSE;
   fTrackAllTracks = kTRUE;
   fRecoverTracks = kTRUE;
@@ -152,11 +196,17 @@ void AliMUONRecoParam::SetLowFluxParam()
   fMakeMoreTrackCandidates = kFALSE;
   fComplementTracks = kTRUE;
   fImproveTracks = kTRUE;
+  fRemoveConnectedTracksInSt12 = kFALSE;
   fUseSmoother = kTRUE;
-  for (Int_t iCh = 0; iCh < 10; iCh++) fUseChamber[iCh] = kTRUE;
+  for (Int_t iCh = 0; iCh < 10; iCh++) {
+    fUseChamber[iCh] = kTRUE;
+    fDefaultNonBendingReso[iCh] = 0.144;
+    fDefaultBendingReso[iCh] = 0.01;
+  }
   for (Int_t iSt = 0; iSt < 5; iSt++) fRequestStation[iSt] = kTRUE;
-  fBypassSt45 = kFALSE;
-  
+  fBypassSt45 = 0;
+  fMaxTriggerTracks = 100;
+  fMaxTrackCandidates = 10000;  
 }
 
 //_____________________________________________________________________________
@@ -164,21 +214,23 @@ void AliMUONRecoParam::SetHighFluxParam()
 {
   /// Set reconstruction parameters for high flux environment
   
-  fMostProbBendingMomentum = 2.;
-  fMinBendingMomentum = 1.;
-  fMaxBendingMomentum = 3000.;
+  SetNameTitle("High Flux","High Flux");
+  SetEventSpecie(AliRecoParam::kHighMult);
+  fMinBendingMomentum = 0.8;
+  fMaxBendingMomentum = 1.e10;
   fMaxNonBendingSlope = 0.3;
   fMaxBendingSlope = 0.4;
-  fNonBendingVertexDispersion = 10.;
-  fBendingVertexDispersion = 10.;
+  fSelectTrackOnSlope = kFALSE;
+  fNonBendingVertexDispersion = 70.;
+  fBendingVertexDispersion = 70.;
   fMaxNonBendingDistanceToTrack = 1.;
   fMaxBendingDistanceToTrack = 1.;
   fSigmaCutForTracking = 6.;
   fSigmaCutForImprovement = 5.;
-  fSigmaCutForTrigger = 8.;
+  fSigmaCutForTrigger = 4.;
   fStripCutForTrigger = 1.;
   fMaxStripAreaForTrigger = 3.;
-  fMaxNormChi2MatchTrigger = 16.;
+  fMaxNormChi2MatchTrigger = fSigmaCutForTrigger * fSigmaCutForTrigger;
   fCombinedClusterTrackReco = kFALSE;
   fTrackAllTracks = kTRUE;
   fRecoverTracks = kTRUE;
@@ -186,11 +238,17 @@ void AliMUONRecoParam::SetHighFluxParam()
   fMakeMoreTrackCandidates = kFALSE;
   fComplementTracks = kTRUE;
   fImproveTracks = kTRUE;
+  fRemoveConnectedTracksInSt12 = kFALSE;
   fUseSmoother = kTRUE;
-  for (Int_t iCh = 0; iCh < 10; iCh++) fUseChamber[iCh] = kTRUE;
+  for (Int_t iCh = 0; iCh < 10; iCh++) {
+    fUseChamber[iCh] = kTRUE;
+    fDefaultNonBendingReso[iCh] = 0.144;
+    fDefaultBendingReso[iCh] = 0.01;
+  }
   for (Int_t iSt = 0; iSt < 5; iSt++) fRequestStation[iSt] = kTRUE;
-  fBypassSt45 = kFALSE;
-  
+  fBypassSt45 = 0;
+  fMaxTriggerTracks = 100;
+  fMaxTrackCandidates = 10000;
 }
 
 //_____________________________________________________________________________
@@ -198,19 +256,23 @@ void AliMUONRecoParam::SetCosmicParam()
 {
   /// Set reconstruction parameters for high flux environment
   
-  fMostProbBendingMomentum = 2.;
-  fMinBendingMomentum = 1.;
-  fMaxBendingMomentum = 10000000.;
+  SetNameTitle("Cosmic","Cosmic");
+  SetEventSpecie(AliRecoParam::kCosmic);
+  fMinBendingMomentum = 0.8;
+  fMaxBendingMomentum = 1.e10;
   fMaxNonBendingSlope = 0.3;
   fMaxBendingSlope = 0.4;
-  fNonBendingVertexDispersion = 10.;
-  fBendingVertexDispersion = 10.;
-  fMaxNonBendingDistanceToTrack = 10.;
-  fMaxBendingDistanceToTrack = 10.;
-  fSigmaCutForTracking = 20.;
-  fSigmaCutForImprovement = 20.;
-  fSigmaCutForTrigger = 8.;
-  fMaxNormChi2MatchTrigger = 16.;
+  fSelectTrackOnSlope = kTRUE;
+  fNonBendingVertexDispersion = 170.;
+  fBendingVertexDispersion = 170.;
+  fMaxNonBendingDistanceToTrack = 1.;
+  fMaxBendingDistanceToTrack = 1.;
+  fSigmaCutForTracking = 7.;
+  fSigmaCutForImprovement = 6.;
+  fSigmaCutForTrigger = 4.;
+  fStripCutForTrigger = 1.5;
+  fMaxStripAreaForTrigger = 3.;
+  fMaxNormChi2MatchTrigger = fSigmaCutForTrigger * fSigmaCutForTrigger;
   fPercentOfFullClusterInESD = 100.;
   fCombinedClusterTrackReco = kFALSE;
   fTrackAllTracks = kTRUE;
@@ -219,12 +281,62 @@ void AliMUONRecoParam::SetCosmicParam()
   fMakeMoreTrackCandidates = kFALSE;
   fComplementTracks = kTRUE;
   fImproveTracks = kTRUE;
+  fRemoveConnectedTracksInSt12 = kTRUE;
   fUseSmoother = kTRUE;
   fSaveFullClusterInESD = kTRUE;
-  for (Int_t iCh = 0; iCh < 10; iCh++) fUseChamber[iCh] = kTRUE;
-  for (Int_t iSt = 0; iSt < 5; iSt++) fRequestStation[iSt] = kTRUE;
-  fBypassSt45 = kFALSE;
+  for (Int_t iCh = 0; iCh < 10; iCh++) {
+    fUseChamber[iCh] = kTRUE;
+    fDefaultNonBendingReso[iCh] = 0.4;
+    fDefaultBendingReso[iCh] = 0.4;
+  }
+  fRequestStation[0] = kTRUE;
+  fRequestStation[1] = kTRUE;
+  fRequestStation[2] = kTRUE;
+  fRequestStation[3] = kTRUE;
+  fRequestStation[4] = kTRUE;
+  fBypassSt45 = 0;
+  fPadGoodnessMask = 0x400BE80; // Ped Mean is Zero | Ped Mean Too Low | Ped Mean Too High | Ped Sigma Too Low | Ped Sigma Too High | Ped is missing | HV is missing | manu occupancy too high
+  fMaxTriggerTracks = 100;
+  fMaxTrackCandidates = 10000;
+  
+  SetPedMeanLimits(20, 700);
+  SetManuOccupancyLimits(-1.,0.01); // reject manu above occ=1%
+
+  SetBuspatchOccupancyLimits(-1,0.01);  
+  SetMissingPadFractionLimit(0.1); // 10 %   
+  SetFractionOfBuspatchOutsideOccupancyLimit(0.05); // 5 %   
+}
+
+
+//_____________________________________________________________________________
+void AliMUONRecoParam::SetCalibrationParam() 
+{
+  /// Set (dummy) reconstruction parameters for calibration environment
+  
+  SetNameTitle("Calibration","Calibration");
+  SetEventSpecie(AliRecoParam::kCalib);
+
+  fPedMeanLimits[0] = 5000;
+  fPedMeanLimits[1] = 0;
+
+  fPadGoodnessMask = 0x8C00; // Pedestal is missing | is too low | too high
+
+}
+
+//_____________________________________________________________________________
+UInt_t
+AliMUONRecoParam::RequestedStationMask() const
+{
+  /// Get the mask of the requested station, i.e. an integer where 
+  /// bit n is set to one if the station n was requested
+  
+  UInt_t m(0);
   
+  for ( Int_t i = 0; i < 5; ++i ) 
+  {
+    if ( RequestStation(i) ) m |= ( 1 << i );
+  }
+  return m;
 }
 
 //_____________________________________________________________________________
@@ -233,32 +345,45 @@ void AliMUONRecoParam::Print(Option_t *option) const
   /// print reconstruction parameters
   /// if option = FULL then print also unused parameters
   
-  cout<<endl<<"\t------Reconstruction parameters------"<<endl;
+  cout<<endl<<"\t------MUON Reconstruction parameters ("<<GetName()<<")------"<<endl;
+  
+  if (IsDefault()) cout<<"\t\t*** Parameters used by default ***"<<endl;
   
   cout<<Form("Calibration mode = %s",fCalibrationMode.Data())<<endl;
   cout<<Form("Clustering mode = %s",fClusteringMode.Data())<<endl;
   cout<<Form("Tracking mode = %s",fTrackingMode.Data())<<endl;
 
-  if (BypassSt45()) cout << "Will bypass St45 (replacing their clusters by generated ones from trigger tracks)" << endl;
+       TString bypass;
+       
+       if ( BypassSt45() )
+       {
+               bypass = "stations 4 and 5";
+       }
+       else if ( BypassSt4() ) 
+       {
+               bypass = "station 4";
+       }
+       else if ( BypassSt5() ) 
+       {
+               bypass = "station 5";
+       }
+       
+  if (bypass.Length()) cout << "Will bypass " << bypass.Data() << " (replacing real clusters by generated ones from trigger tracks)" << endl;
   
   if (fCombinedClusterTrackReco) cout<<"Combined cluster/track reconstruction: ON"<<endl;
   else cout<<"Combined cluster/track reconstruction: OFF"<<endl;
   
   if (fSaveFullClusterInESD) cout<<Form("Save all cluster info in ESD for %5.2f %% of events",fPercentOfFullClusterInESD)<<endl;
   else cout<<"Save partial cluster info in ESD"<<endl;
+    
+  cout<<"Selection of track candidates:"<<endl;
+  if (fSelectTrackOnSlope) cout<<Form("\t- Non-bending slope < %5.2f",fMaxNonBendingSlope)<<endl;
+  else cout<<"\t- Impact parameter < 3 * vertex dispersion in the non-bending direction"<<endl;
+  cout<<Form("\t- if B!=0: Bending momentum > %5.2f",fMinBendingMomentum)<<endl;
+  if (fSelectTrackOnSlope) cout<<Form("\t  if B==0: Bending slope < %5.2f",fMaxBendingSlope)<<endl;
+  else cout<<"\t  if B==0: Impact parameter < 3 * vertex dispersion in the bending direction"<<endl;
   
-  cout<<Form("Most probable bending momentum (used only if B=0) = %5.2f",fMostProbBendingMomentum)<<endl;
-  
-  cout<<Form("Bending momentum range = [%5.2f,%5.2f]",fMinBendingMomentum,fMaxBendingMomentum)<<endl;
-  
-  cout<<Form("Maximum non bending slope = %5.2f",fMaxNonBendingSlope)<<endl;
-  
-  cout<<Form("Maximum bending slope (used only if B=0) = %5.2f",fMaxBendingSlope)<<endl;
-  
-  if (strstr(fTrackingMode,"ORIGINAL"))
-    cout<<Form("Vertex dispertion = (%5.2f,%5.2f)",fNonBendingVertexDispersion,fBendingVertexDispersion)<<endl;
-  else if (strstr(option,"FULL"))
-    cout<<Form("Vertex dispertion (used for original tracking only) = (%5.2f,%5.2f)",fNonBendingVertexDispersion,fBendingVertexDispersion)<<endl;
+  cout<<Form("Vertex dispersion (used to estimate initial bending momentum resolution) = (%5.2f,%5.2f)",fNonBendingVertexDispersion,fBendingVertexDispersion)<<endl;
   
   cout<<Form("Maximum distance to track = (%5.2f,%5.2f)",fMaxNonBendingDistanceToTrack,fMaxBendingDistanceToTrack)<<endl;
   
@@ -308,6 +433,9 @@ void AliMUONRecoParam::Print(Option_t *option) const
   } else if (fImproveTracks)
     cout<<Form("Try to improve the reconstructed tracks by removing bad clusters (sigma cut = %5.2f)",fSigmaCutForImprovement)<<endl;
   
+  if (fRemoveConnectedTracksInSt12) cout<<"Remove tracks sharing one cluster or more in any station"<<endl;
+  else cout<<"Remove tracks sharing one cluster or more in stations 3, 4 and 5"<<endl;
+  
   if (strstr(option,"FULL")) {
     cout<<"Use smoother to compute final track parameters, etc, at each cluster (used for Kalman tracking only): ";
     if (fUseSmoother) cout<<"ON"<<endl;
@@ -343,7 +471,95 @@ void AliMUONRecoParam::Print(Option_t *option) const
   } while (++st < 5);
   if (discardedSt) cout<<endl;
   
-  cout<<"\t-------------------------------------"<<endl<<endl;
+  cout << Form("Pad goodness policy mask is 0x%x",PadGoodnessMask()) << endl;
+  cout << "Which means we reject pads having the condition = " <<
+  AliMUONPadStatusMaker::AsCondition(PadGoodnessMask()).Data() << endl;
+  
+  cout << "The pad limits we are using are :" << endl;
+  
+  cout << Form("%5.0f <= HVSt12 <= %5.0f Volts",HVSt12LowLimit(),HVSt12HighLimit()) << endl;
+  cout << Form("%5.0f <= HVSt345 <= %5.0f Volts",HVSt345LowLimit(),HVSt345HighLimit()) << endl;
+  cout << Form("%7.2f <= Pedestal mean <= %7.2f",PedMeanLowLimit(),PedMeanHighLimit()) << endl;
+  cout << Form("%7.2f <= Pedestal sigma <= %7.2f",PedSigmaLowLimit(),PedSigmaHighLimit()) << endl;
+  cout << Form("%e <= Gain linear term <= %e",GainA1LowLimit(),GainA1HighLimit()) << endl;
+  cout << Form("%e <= Gain quadratic term <= %e",GainA2LowLimit(),GainA2HighLimit()) << endl;
+  cout << Form("%5.0f <= Gain threshold term <= %5.0f",GainThresLowLimit(),GainThresHighLimit()) << endl;
+    
+  cout << Form("And we cut on charge >= %7.2f x ( pedestal sigma ) ",ChargeSigmaCut()) << endl;
+  
+  cout << "Occupancy limits are :" << endl;
+  
+  cout << Form("%e <= Manu occupancy < %7.2f",ManuOccupancyLowLimit(),ManuOccupancyHighLimit()) << endl;
+  cout << Form("%e <= Buspatch occupancy < %7.2f",BuspatchOccupancyLowLimit(),BuspatchOccupancyHighLimit()) << endl;
+  cout << Form("%e <= DE occupancy < %7.2f",DEOccupancyLowLimit(),DEOccupancyHighLimit()) << endl;
+  
+  cout << "'QAChecker' limits" << endl;  
+  cout << Form("MissingPadFractionLimit = %5.2f %%",MissingPadFractionLimit()*100.0) << endl;  
+  cout << Form("FractionOfBuspatchOutsideOccupancyLimit = %5.2f %%",FractionOfBuspatchOutsideOccupancyLimit()*100.0) << endl;
+  
+  cout << "chamber non bending resolution = |";
+  for (Int_t iCh = 0; iCh < 10; iCh++) cout << Form(" %6.3f |",fDefaultNonBendingReso[iCh]);
+  cout << endl;
+  cout << "chamber bending resolution = |";
+  for (Int_t iCh = 0; iCh < 10; iCh++) cout << Form(" %6.3f |",fDefaultBendingReso[iCh]);
+  cout << endl;
+  cout<<Form("maximum number of trigger tracks above which the tracking is cancelled = %d",fMaxTriggerTracks)<<endl;
+  cout<<Form("maximum number of track candidates above which the tracking is abandonned = %d",fMaxTrackCandidates)<<endl;
+
+  cout << Form("The average noise pad charge is assumed to be %7.2f fC",AverageNoisePadCharge()) << endl;
+  cout << Form("and clusters below %5.2f times this noise charge (i.e. %7.2f fC) are discarded",
+               ClusterChargeCut(),ClusterChargeCut()*AverageNoisePadCharge()) << endl;
+  cout << Form("Note that LowestPadCharge is then %7.2f fC",LowestPadCharge()) << endl;
+  
+  cout<<"\t-----------------------------------------------------"<<endl<<endl;
+  
+}
+
+//_____________________________________________________________________________
+void
+AliMUONRecoParam::SetDefaultLimits()
+{
+       /// Set the default limits and pad goodness policy
+
+       fHVSt12Limits[0]=1500;
+       fHVSt12Limits[1]=2000;
+
+       fHVSt345Limits[0]=1500;
+       fHVSt345Limits[1]=2000;
+
+       fPedMeanLimits[0] = 20;
+       fPedMeanLimits[1] = 1024;
+       
+       fPedSigmaLimits[0] = 0.6;
+       fPedSigmaLimits[1] = 100;
+
+       fGainA1Limits[0] = 0.1;
+       fGainA1Limits[1] = 10;
+
+       fGainA2Limits[0] = -1E30;
+       fGainA2Limits[1] = 1E30;
+       
+       fGainThresLimits[0] = 0;
+       fGainThresLimits[1] = 4095;
+       
+       fPadGoodnessMask = 0x8080; // Ped is missing | HV is missing
+
+  fManuOccupancyLimits[0] = -1.0; 
+  fManuOccupancyLimits[1] = 1.0;
+
+  fBuspatchOccupancyLimits[0] = 1E-6; 
+  fBuspatchOccupancyLimits[1] = 1.0;
+
+  fDEOccupancyLimits[0] = -1.0; 
+  fDEOccupancyLimits[1] = 1.0;
+
+  fMissingPadFractionLimit = 0.1; // 10 % 
+  fFractionOfBuspatchOutsideOccupancyLimit = 0.05; // 5 % 
+
+  ChargeSigmaCut(4.0); // pad with charge < 4.0 x sigma will be removed (where sigma is the actual noise of that very pad, i.e. not the average)
   
+  AverageNoisePadCharge(0.22875); // 0.22875 coulombs ~ 1.5 ADC channels
+
+  ClusterChargeCut(2.0); // will cut cluster below 2.0 x LowestPadCharge()
 }