1 #ifndef AliMUONRecoParam_H
2 #define AliMUONRecoParam_H
3 /* Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
4 * See cxx source for full Copyright notice */
9 /// \class AliMUONRecoParam
10 /// \brief Class with MUON reconstruction parameters
12 // Author: Philippe Pillot
14 #include "AliDetectorRecoParam.h"
18 class AliMUONRecoParam : public AliDetectorRecoParam
22 virtual ~AliMUONRecoParam();
24 static AliMUONRecoParam *GetLowFluxParam();
25 static AliMUONRecoParam *GetHighFluxParam();
26 static AliMUONRecoParam *GetCosmicParam();
28 /// set the calibration mode (see GetCalibrationMode() for possible modes)
29 void SetCalibrationMode(Option_t* mode) { fCalibrationMode = mode; fCalibrationMode.ToUpper();}
31 Option_t* GetCalibrationMode() const;
33 /// set the clustering (pre-clustering) mode
34 void SetClusteringMode(Option_t* mode) {fClusteringMode = mode; fClusteringMode.ToUpper();}
35 /// get the clustering (pre-clustering) mode
36 Option_t* GetClusteringMode() const {return fClusteringMode.Data();}
38 /// set the tracking mode
39 void SetTrackingMode(Option_t* mode) {fTrackingMode = mode; fTrackingMode.ToUpper();}
40 /// get the tracking mode
41 Option_t* GetTrackingMode() const {return fTrackingMode.Data();}
43 /// switch on/off the combined cluster/track reconstruction
44 void CombineClusterTrackReco(Bool_t flag) {fCombinedClusterTrackReco = flag;}
45 /// return kTRUE/kFALSE if the combined cluster/track reconstruction is on/off
46 Bool_t CombineClusterTrackReco() const {return fCombinedClusterTrackReco;}
48 /// save all cluster info (including pads) in ESD, for the given percentage of events
49 void SaveFullClusterInESD(Bool_t flag, Double_t percentOfEvent = 100.) {fSaveFullClusterInESD = flag;
50 fPercentOfFullClusterInESD = (fSaveFullClusterInESD) ? percentOfEvent : 0.;}
51 /// return kTRUE/kFALSE depending on whether we save all cluster info in ESD or not
52 Bool_t SaveFullClusterInESD() const {return fSaveFullClusterInESD;}
53 /// return the percentage of events for which all cluster info are stored in ESD
54 Double_t GetPercentOfFullClusterInESD() const {return fPercentOfFullClusterInESD;}
56 /// set the minimum value (GeV/c) of momentum in bending plane
57 void SetMinBendingMomentum(Double_t val) {fMinBendingMomentum = val;}
58 /// return the minimum value (GeV/c) of momentum in bending plane
59 Double_t GetMinBendingMomentum() const {return fMinBendingMomentum;}
60 /// set the maximum value (GeV/c) of momentum in bending plane
61 void SetMaxBendingMomentum(Double_t val) {fMaxBendingMomentum = val;}
62 /// return the maximum value (GeV/c) of momentum in bending plane
63 Double_t GetMaxBendingMomentum() const {return fMaxBendingMomentum;}
64 /// set the maximum value of the non bending slope
65 void SetMaxNonBendingSlope(Double_t val) {fMaxNonBendingSlope = val;}
66 /// return the maximum value of the non bending slope
67 Double_t GetMaxNonBendingSlope() const {return fMaxNonBendingSlope;}
68 /// set the maximum value of the bending slope
69 void SetMaxBendingSlope(Double_t val) {fMaxBendingSlope = val;}
70 /// return the maximum value of the bending slope
71 Double_t GetMaxBendingSlope() const {return fMaxBendingSlope;}
73 /// set the vertex dispersion (cm) in non bending plane (used for original tracking only)
74 void SetNonBendingVertexDispersion(Double_t val) {fNonBendingVertexDispersion = val;}
75 /// return the vertex dispersion (cm) in non bending plane (used for original tracking only)
76 Double_t GetNonBendingVertexDispersion() const {return fNonBendingVertexDispersion;}
77 /// set the vertex dispersion (cm) in bending plane (used for original tracking only)
78 void SetBendingVertexDispersion(Double_t val) {fBendingVertexDispersion = val;}
79 /// return the vertex dispersion (cm) in bending plane (used for original tracking only)
80 Double_t GetBendingVertexDispersion() const {return fBendingVertexDispersion;}
82 /// set the maximum distance to the track to search for compatible cluster(s) in non bending direction
83 void SetMaxNonBendingDistanceToTrack(Double_t val) {fMaxNonBendingDistanceToTrack = val;}
84 /// return the maximum distance to the track to search for compatible cluster(s) in non bending direction
85 Double_t GetMaxNonBendingDistanceToTrack() const {return fMaxNonBendingDistanceToTrack;}
86 /// set the maximum distance to the track to search for compatible cluster(s) in bending direction
87 void SetMaxBendingDistanceToTrack(Double_t val) {fMaxBendingDistanceToTrack = val;}
88 /// return the maximum distance to the track to search for compatible cluster(s) in bending direction
89 Double_t GetMaxBendingDistanceToTrack() const {return fMaxBendingDistanceToTrack;}
91 /// set the cut in sigma to apply on cluster (local chi2) and track (global chi2) during tracking
92 void SetSigmaCutForTracking(Double_t val) {fSigmaCutForTracking = val;}
93 /// return the cut in sigma to apply on cluster (local chi2) and track (global chi2) during tracking
94 Double_t GetSigmaCutForTracking() const {return fSigmaCutForTracking;}
96 /// switch on/off the track improvement and keep the default cut in sigma to apply on cluster (local chi2)
97 void ImproveTracks(Bool_t flag) {fImproveTracks = flag;}
98 /// switch on/off the track improvement and set the cut in sigma to apply on cluster (local chi2)
99 void ImproveTracks(Bool_t flag, Double_t sigmaCut) {fImproveTracks = flag; fSigmaCutForImprovement = sigmaCut;}
100 /// return kTRUE/kFALSE if the track improvement is switch on/off
101 Bool_t ImproveTracks() const {return fImproveTracks;}
102 /// return the cut in sigma to apply on cluster (local chi2) during track improvement
103 Double_t GetSigmaCutForImprovement() const {return fSigmaCutForImprovement;}
105 /// set the cut in sigma to apply on track during trigger hit pattern search
106 void SetSigmaCutForTrigger(Double_t val) {fSigmaCutForTrigger = val;}
107 /// return the cut in sigma to apply on track during trigger hit pattern search
108 Double_t GetSigmaCutForTrigger() const {return fSigmaCutForTrigger;}
109 /// set the cut in strips to apply on trigger track during trigger chamber efficiency
110 void SetStripCutForTrigger(Double_t val) {fStripCutForTrigger = val;}
111 /// return the cut in strips to apply on trigger track during trigger chamber efficiency
112 Double_t GetStripCutForTrigger() const {return fStripCutForTrigger;}
113 /// set the maximum search area in strips to apply on trigger track during trigger chamber efficiency
114 void SetMaxStripAreaForTrigger(Double_t val) {fMaxStripAreaForTrigger = val;}
115 /// return the maximum search area in strips to apply on trigger track during trigger chamber efficiency
116 Double_t GetMaxStripAreaForTrigger() const {return fMaxStripAreaForTrigger;}
118 /// set the maximum normalized chi2 of tracking/trigger track matching
119 void SetMaxNormChi2MatchTrigger(Double_t val) {fMaxNormChi2MatchTrigger = val;}
120 /// return the maximum normalized chi2 of tracking/trigger track matching
121 Double_t GetMaxNormChi2MatchTrigger() const {return fMaxNormChi2MatchTrigger;}
123 /// switch on/off the tracking of all the possible candidates (track only the best one if switched off)
124 void TrackAllTracks(Bool_t flag) {fTrackAllTracks = flag;}
125 /// return kTRUE/kFALSE if the tracking of all the possible candidates is switched on/off
126 Bool_t TrackAllTracks() const {return fTrackAllTracks;}
128 /// switch on/off the recovering of tracks being lost during reconstruction
129 void RecoverTracks(Bool_t flag) {fRecoverTracks = flag;}
130 /// return kTRUE/kFALSE if the recovering of tracks being lost during reconstruction is switched on/off
131 Bool_t RecoverTracks() const {return fRecoverTracks;}
133 /// switch on/off the fast building of track candidates (assuming linear propagation between stations 4 and 5)
134 void MakeTrackCandidatesFast(Bool_t flag) {fMakeTrackCandidatesFast = flag;}
135 /// return kTRUE/kFALSE if the fast building of track candidates is switched on/off
136 Bool_t MakeTrackCandidatesFast() const {return fMakeTrackCandidatesFast;}
138 /// switch on/off the building of track candidates starting from 1 cluster in each of the stations 4 and 5
139 void MakeMoreTrackCandidates(Bool_t flag) {fMakeMoreTrackCandidates = flag;}
140 /// return kTRUE/kFALSE if the building of extra track candidates is switched on/off
141 Bool_t MakeMoreTrackCandidates() const {return fMakeMoreTrackCandidates;}
143 /// switch on/off the completion of reconstructed track
144 void ComplementTracks(Bool_t flag) {fComplementTracks = flag;}
145 /// return kTRUE/kFALSE if completion of the reconstructed track is switched on/off
146 Bool_t ComplementTracks() const {return fComplementTracks;}
148 /// switch on/off the use of the smoother
149 void UseSmoother(Bool_t flag) {fUseSmoother = flag;}
150 /// return kTRUE/kFALSE if the use of the smoother is switched on/off
151 Bool_t UseSmoother() const {return fUseSmoother;}
153 /// switch on/off a chamber in the reconstruction
154 void UseChamber(Int_t iCh, Bool_t flag) {if (iCh >= 0 && iCh < 10) fUseChamber[iCh] = flag;}
155 /// return kTRUE/kFALSE whether the chamber must be used or not
156 Bool_t UseChamber(Int_t iCh) const {return (iCh >= 0 && iCh < 10) ? fUseChamber[iCh] : kFALSE;}
158 /// request or not at least one cluster in the station to validate the track
159 void RequestStation(Int_t iSt, Bool_t flag) {if (iSt >= 0 && iSt < 5) fRequestStation[iSt] = flag;}
160 /// return kTRUE/kFALSE whether at least one cluster is requested in the station to validate the track
161 Bool_t RequestStation(Int_t iSt) const {return (iSt >= 0 && iSt < 5) ? fRequestStation[iSt] : kFALSE;}
162 /// return an integer where first 5 bits are set to 1 if the corresponding station is requested
163 UInt_t RequestedStationMask() const;
165 /// set the bypassSt45 value
166 void BypassSt45(Bool_t st4, Bool_t st5);
168 /// return kTRUE if we should replace clusters in St 4 and 5 by generated clusters from trigger tracks
169 Bool_t BypassSt45() const { return fBypassSt45==45; }
171 /// return kTRUE if we should replace clusters in St 4 by generated clusters from trigger tracks
172 Bool_t BypassSt4() const { return BypassSt45() || fBypassSt45==4 ; }
174 /// return kTRUE if we should replace clusters in St 5 by generated clusters from trigger tracks
175 Bool_t BypassSt5() const { return BypassSt45() || fBypassSt45==5 ; }
177 /// Set Low and High threshold for St12 HV
178 void SetHVSt12Limits(float low, float high) { fHVSt12Limits[0]=low; fHVSt12Limits[1]=high; }
179 /// Retrieve low limit for St12's HV
180 Float_t HVSt12LowLimit() const { return fHVSt12Limits[0]; }
181 /// Retrieve high limit for St12's HV
182 Float_t HVSt12HighLimit() const { return fHVSt12Limits[1]; }
184 /// Set Low and High threshold for St345 HV
185 void SetHVSt345Limits(float low, float high) { fHVSt345Limits[0]=low; fHVSt345Limits[1]=high; }
186 /// Retrieve low limit for St345's HV
187 Float_t HVSt345LowLimit() const { return fHVSt345Limits[0]; }
188 /// Retrieve high limit for St345's HV
189 Float_t HVSt345HighLimit() const { return fHVSt345Limits[1]; }
191 /// Set Low and High threshold for pedestal mean
192 void SetPedMeanLimits(float low, float high) { fPedMeanLimits[0]=low; fPedMeanLimits[1]=high; }
193 /// Retrieve low limit of ped mean
194 Float_t PedMeanLowLimit() const { return fPedMeanLimits[0]; }
195 /// Retrieve high limit of ped mean
196 Float_t PedMeanHighLimit() const { return fPedMeanLimits[1]; }
198 /// Set Low and High threshold for pedestal sigma
199 void SetPedSigmaLimits(float low, float high) { fPedSigmaLimits[0]=low; fPedSigmaLimits[1]=high; }
200 /// Retrieve low limit of ped sigma
201 Float_t PedSigmaLowLimit() const { return fPedSigmaLimits[0]; }
202 /// Retrieve high limit of ped sigma
203 Float_t PedSigmaHighLimit() const { return fPedSigmaLimits[1]; }
205 /// Set Low and High threshold for gain a0 term
206 void SetGainA1Limits(float low, float high) { fGainA1Limits[0]=low; fGainA1Limits[1]=high; }
207 /// Retrieve low limit of a1 (linear term) gain parameter
208 Float_t GainA1LowLimit() const { return fGainA1Limits[0]; }
209 /// Retrieve high limit of a1 (linear term) gain parameter
210 Float_t GainA1HighLimit() const { return fGainA1Limits[1]; }
212 /// Set Low and High threshold for gain a1 term
213 void SetGainA2Limits(float low, float high) { fGainA2Limits[0]=low; fGainA2Limits[1]=high; }
214 /// Retrieve low limit of a2 (quadratic term) gain parameter
215 Float_t GainA2LowLimit() const { return fGainA2Limits[0]; }
216 /// Retrieve high limit of a2 (quadratic term) gain parameter
217 Float_t GainA2HighLimit() const { return fGainA2Limits[1]; }
219 /// Set Low and High threshold for gain threshold term
220 void SetGainThresLimits(float low, float high) { fGainThresLimits[0]=low; fGainThresLimits[1]=high; }
221 /// Retrieve low limit on threshold gain parameter
222 Float_t GainThresLowLimit() const { return fGainThresLimits[0]; }
223 /// Retrieve high limit on threshold gain parameter
224 Float_t GainThresHighLimit() const { return fGainThresLimits[1]; }
226 /// Set the goodness mask (see AliMUONPadStatusMapMaker)
227 void SetPadGoodnessMask(UInt_t mask) { fPadGoodnessMask=mask; }
228 /// Get the goodness mask
229 UInt_t PadGoodnessMask() const { return fPadGoodnessMask; }
231 /// Number of sigma cut we must apply when cutting on adc-ped
232 Double_t ChargeSigmaCut() const { return fChargeSigmaCut; }
234 /// Number of sigma cut we must apply when cutting on adc-ped
235 void ChargeSigmaCut(Double_t value) { fChargeSigmaCut=value; }
237 /// Set the default non bending resolution of chamber iCh
238 void SetDefaultNonBendingReso(Int_t iCh, Double_t val) {if (iCh >= 0 && iCh < 10) fDefaultNonBendingReso[iCh] = val;}
239 /// Get the default non bending resolution of chamber iCh
240 Double_t GetDefaultNonBendingReso(Int_t iCh) const {return (iCh >= 0 && iCh < 10) ? fDefaultNonBendingReso[iCh] : FLT_MAX;}
241 /// Set the default bending resolution of chamber iCh
242 void SetDefaultBendingReso(Int_t iCh, Double_t val) {if (iCh >= 0 && iCh < 10) fDefaultBendingReso[iCh] = val;}
243 /// Get the default bending resolution of chamber iCh
244 Double_t GetDefaultBendingReso(Int_t iCh) const {return (iCh >= 0 && iCh < 10) ? fDefaultBendingReso[iCh] : FLT_MAX;}
246 virtual void Print(Option_t *option = "") const;
251 void SetDefaultLimits();
256 /// clustering mode: NOCLUSTERING, PRECLUSTER, PRECLUSTERV2, PRECLUSTERV3, COG, <pre>
257 /// SIMPLEFIT, SIMPLEFITV3, MLEM:DRAW, MLEM, MLEMV2, MLEMV3 </pre>
258 TString fClusteringMode; ///< \brief name of the clustering (+ pre-clustering) mode
260 /// tracking mode: ORIGINAL, KALMAN
261 TString fTrackingMode; ///< \brief name of the tracking mode
263 Double32_t fMinBendingMomentum; ///< minimum value (GeV/c) of momentum in bending plane
264 Double32_t fMaxBendingMomentum; ///< maximum value (GeV/c) of momentum in bending plane
265 Double32_t fMaxNonBendingSlope; ///< maximum value of the non bending slope
266 Double32_t fMaxBendingSlope; ///< maximum value of the bending slope (used only if B = 0)
268 Double32_t fNonBendingVertexDispersion; ///< vertex dispersion (cm) in non bending plane (used for original tracking only)
269 Double32_t fBendingVertexDispersion; ///< vertex dispersion (cm) in bending plane (used for original tracking only)
271 Double32_t fMaxNonBendingDistanceToTrack; ///< maximum distance to the track to search for compatible cluster(s) in non bending direction
272 Double32_t fMaxBendingDistanceToTrack; ///< maximum distance to the track to search for compatible cluster(s) in bending direction
274 Double32_t fSigmaCutForTracking; ///< cut in sigma to apply on cluster (local chi2) and track (global chi2) during tracking
276 Double32_t fSigmaCutForImprovement; ///< cut in sigma to apply on cluster (local chi2) during track improvement
278 Double32_t fSigmaCutForTrigger; ///< cut in sigma to apply on track during trigger hit pattern search
280 Double32_t fStripCutForTrigger; ///< cut in strips to apply on trigger track during trigger chamber efficiency
282 Double32_t fMaxStripAreaForTrigger; ///< max. search area in strips to apply on trigger track during trigger chamber efficiency
284 Double32_t fMaxNormChi2MatchTrigger; ///< maximum normalized chi2 of tracking/trigger track matching
286 Double32_t fPercentOfFullClusterInESD; ///< percentage of events for which all cluster info are stored in ESD
288 Bool_t fCombinedClusterTrackReco; ///< switch on/off the combined cluster/track reconstruction
290 Bool_t fTrackAllTracks; ///< kTRUE to track all the possible candidates; kFALSE to track only the best ones
292 Bool_t fRecoverTracks; ///< kTRUE to try to recover the tracks getting lost during reconstruction
294 Bool_t fMakeTrackCandidatesFast; ///< kTRUE to make candidate tracks assuming linear propagation between stations 4 and 5
296 Bool_t fMakeMoreTrackCandidates; ///< kTRUE to make candidate tracks starting from 1 cluster in each of the stations 4 and 5
298 Bool_t fComplementTracks; ///< kTRUE to try to complete the reconstructed tracks by adding missing clusters
300 Bool_t fImproveTracks; ///< kTRUE to try to improve the reconstructed tracks by removing bad clusters
302 Bool_t fUseSmoother; ///< kTRUE to use the smoother to compute track parameters/covariances and local chi2 at each cluster (used for Kalman tracking only)
304 Bool_t fSaveFullClusterInESD; ///< kTRUE to save all cluster info (including pads) in ESD
306 /// calibration mode: GAIN, NOGAIN, GAINCONSTANTCAPA
307 TString fCalibrationMode; ///<\brief calibration mode
309 Int_t fBypassSt45; ///< non-zero to use trigger tracks to generate "fake" clusters in St 4 and 5. Can be 0, 4, 5 or 45 only
311 Bool_t fUseChamber[10]; ///< kTRUE to use the chamber i in the tracking algorithm
313 Bool_t fRequestStation[5]; ///< kTRUE to request at least one cluster in station i to validate the track
315 Double32_t fGainA1Limits[2]; ///< Low and High threshold for gain a0 parameter
316 Double32_t fGainA2Limits[2]; ///< Low and High threshold for gain a1 parameter
317 Double32_t fGainThresLimits[2]; ///< Low and High threshold for gain threshold parameter
318 Double32_t fHVSt12Limits[2]; ///< Low and High threshold for St12 HV
319 Double32_t fHVSt345Limits[2]; ///< Low and High threshold for St345 HV
320 Double32_t fPedMeanLimits[2]; ///< Low and High threshold for pedestal mean
321 Double32_t fPedSigmaLimits[2]; ///< Low and High threshold for pedestal sigma
323 UInt_t fPadGoodnessMask; ///< goodness mask (see AliMUONPadStatusMaker)
325 Double32_t fChargeSigmaCut; ///< number of sigma to cut on adc-ped
327 Double32_t fDefaultNonBendingReso[10]; ///< default chamber resolution in the non-bending direction
328 Double32_t fDefaultBendingReso[10]; ///< default chamber resolution in the bending direction
331 void SetLowFluxParam();
332 void SetHighFluxParam();
333 void SetCosmicParam();
336 ClassDef(AliMUONRecoParam,10) // MUON reco parameters