1 /**************************************************************************
2 * Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
4 * Author: The ALICE Off-line Project. *
5 * Contributors are mentioned in the code where appropriate. *
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 **************************************************************************/
16 // Cut container class for the ALICE HFE group
17 // Serves also as interface to the correction Framework
18 // Provides a set of standard cuts
27 #ifndef ALIHFEEXTRACUTS_H
28 #include "AliHFEextraCuts.h"
40 class AliHFEcuts : public TNamed{
44 kStepRecKineITSTPC = 1,
50 kNcutStepsRecTrack = 7
57 kStepHFEcutsSecvtx = 0,
58 kNcutStepsSecvtxTrack = 1
62 kStepMCGeneratedZOutNoPileUpCentralityFine = 1,
63 kStepMCGeneratedEventCut = 2,
64 kStepMCInAcceptance = 3,
68 kEventStepGenerated = 0,
69 kEventStepRecNoCut = 1,
70 kEventStepRecNoPileUp = 2,
71 kEventStepRecCentralityOk = 3,
73 kEventStepReconstructed = 5,
78 AliHFEcuts(const Char_t *name, const Char_t *title);
79 AliHFEcuts(const AliHFEcuts &c);
80 AliHFEcuts &operator=(const AliHFEcuts &c);
81 void Copy(TObject &o) const;
82 Long64_t Merge(const TCollection *list);
85 void Initialize(AliCFManager *cfm);
88 Bool_t CheckParticleCuts(UInt_t step, TObject *o);
89 Bool_t CheckEventCuts(const char*namestep, TObject *o);
90 void SetRecEvent(const AliVEvent *ev);
91 void SetMCEvent(const AliVEvent *ev);
93 TList *GetQAhistograms() const { return fHistQA; }
95 void SetQAOn() {SetBit(kDebugMode, kTRUE); };
96 void UnsetQA() {SetBit(kDebugMode, kFALSE); };
97 Bool_t IsQAOn() const { return TestBit(kDebugMode); };
98 void SetAOD() { SetBit(kAOD, kTRUE); }
99 void SetESD() { SetBit(kAOD, kFALSE); }
100 Bool_t IsAOD() const { return TestBit(kAOD); }
101 Bool_t IsESD() const { return !TestBit(kAOD); }
104 static const Char_t *MCCutName(UInt_t step){
105 if(step >= kNcutStepsMCTrack) return fgkUndefined;
106 return fgkMCCutName[step];
108 static const Char_t *RecoCutName(UInt_t step){
109 if(step >= kNcutStepsRecTrack) return fgkUndefined;
110 return fgkRecoCutName[step];
112 static const Char_t *DECutName(UInt_t step){
113 if(step >= kNcutStepsDETrack) return fgkUndefined;
114 return fgkDECutName[step];
116 static const Char_t *SecvtxCutName(UInt_t step){
117 if(step >= kNcutStepsSecvtxTrack) return fgkUndefined;
118 return fgkSecvtxCutName[step];
120 static const Char_t *EventCutName(UInt_t step){
121 if(step >= kNcutStepsEvent) return fgkUndefined;
122 return fgkEventCutName[step];
126 Bool_t IsRequireITSpixel() const { return TESTBIT(fRequirements, kITSPixel); };
127 Bool_t IsRequireITSdrift() const { return TESTBIT(fRequirements, kITSDrift); };
128 Bool_t IsRequireMaxImpactParam() const { return TESTBIT(fRequirements, kMaxImpactParam); };
129 Bool_t IsRequirePrimary() const { return TESTBIT(fRequirements, kPrimary); };
130 Bool_t IsRequireProdVertex() const { return TESTBIT(fRequirements, kProductionVertex); };
131 Bool_t IsRequireSigmaToVertex() const { return TESTBIT(fRequirements, kSigmaToVertex); };
132 Bool_t IsRequireDCAToVertex() const {return TESTBIT(fRequirements, kDCAToVertex); };
133 Bool_t IsRequireKineMCCuts() const {return TESTBIT(fRequirements, kKineMCCuts); };
134 Double_t GetVertexRange() const {return fVertexRangeZ; };
135 Int_t GetMinTrackletsTRD() const { return fMinTrackletsTRD; }
136 Bool_t GetUseMixedVertex() const { return fUseMixedVertex;};
139 inline void SetCutITSpixel(UChar_t cut);
140 inline void SetCutITSdrift(UChar_t cut);
141 void SetCheckITSLayerStatus(Bool_t checkITSLayerStatus) { fCheckITSLayerStatus = checkITSLayerStatus; }
142 void SetMinNClustersTPC(UChar_t minClustersTPC) { fMinClustersTPC = minClustersTPC; }
143 void SetMinNClustersTPCPID(UChar_t minClustersTPC) { fMinClustersTPCPID = minClustersTPC; }
144 void SetMinNClustersITS(UChar_t minClustersITS) { fMinClustersITS = minClustersITS; }
145 void SetMinNTrackletsTRD(UChar_t minNtrackletsTRD, Bool_t exact = kFALSE) { fMinTrackletsTRD = minNtrackletsTRD; fTRDtrackletsExact = exact; }
146 void SetMaxChi2perTrackletTRD(Float_t maxchi2trackletTRD) { fMaxChi2TRD = maxchi2trackletTRD; }
147 void SetMaxChi2perClusterITS(Double_t chi2) { fMaxChi2clusterITS = chi2; };
148 void SetMaxChi2perClusterTPC(Double_t chi2) { fMaxChi2clusterTPC = chi2; };
149 inline void SetMaxImpactParam(Double_t radial, Double_t z);
150 inline void SetIPcutParam(Float_t p0, Float_t p1, Float_t p2, Float_t p3, Bool_t isIPcharge, Bool_t isipsigma, Bool_t isopp);
151 void SetMinRatioTPCclusters(Double_t minRatioTPC) { fMinClusterRatioTPC = minRatioTPC; };
152 void SetPtRange(Double_t ptmin, Double_t ptmax){fPtRange[0] = ptmin; fPtRange[1] = ptmax;};
153 void SetTOFsignaldxz(Double_t tofsignaldx, Double_t tofsignaldz){fTOFsignaldx = tofsignaldx; fTOFsignaldz = tofsignaldz;};
154 void SetAODFilterBit(Int_t bit) { fAODFilterBit = bit; };
155 inline void SetProductionVertex(Double_t xmin, Double_t xmax, Double_t ymin, Double_t ymax);
156 inline void SetSigmaToVertex(Double_t sig);
157 inline void SetSigmaToVertexXY(Double_t sig);
158 inline void SetSigmaToVertexZ(Double_t sig);
159 void SetTPCmodes(UChar_t clusterDef, UChar_t ratioDef) {
160 fTPCclusterDef= clusterDef;
161 fTPCratioDef = ratioDef;
163 void SetEtaRange(Double_t etaRange){fEtaRange[0] = -etaRange; fEtaRange[1] = etaRange;};
164 void SetEtaRange(Double_t etamin, Double_t etamax){fEtaRange[0] = etamin; fEtaRange[1] = etamax;};
165 void SetVertexRange(Double_t zrange){fVertexRangeZ = zrange;};
166 void SetTOFPIDStep(Bool_t tofPidStep) {fTOFPIDStep = tofPidStep;};
167 void SetTOFMISMATCHStep(Bool_t tofMismatchStep) {fTOFMISMATCHStep = tofMismatchStep;};
168 void SetTPCPIDCleanUpStep(Bool_t tpcPIDCleanUpStep) {fTPCPIDCLEANUPStep = tpcPIDCleanUpStep;};
169 void SetITSpatternCut() { fITSpatternCut = kTRUE; }
170 inline void SetUseMixedVertex(Bool_t useMixedVertex);
171 inline void SetUseSPDVertex(Bool_t useSPDVertex);
172 void SetUseCorrelationVertex() { fUseCorrelationVertex = kTRUE;};
173 void SetSPDVtxResolutionCut() {fSPDVtxResolution = kTRUE;}
174 void SetpApileupCut() { fPApileupCut = kTRUE; }
175 void SetFractionOfSharedTPCClusters(Double_t fractionOfSharedTPCClusters) {fFractionOfSharedTPCClusters = fractionOfSharedTPCClusters;};
176 void SetMaxImpactParameterRpar(Bool_t maxImpactParameterRpar) { fMaxImpactParameterRpar = maxImpactParameterRpar; };
178 inline void CreateStandardCuts();
181 void SetAdditionalStatusRequirement(Long_t requirement) {fAdditionalStatusRequirement = requirement;}
182 void SetRequireDCAToVertex() { SETBIT(fRequirements, kDCAToVertex); CLRBIT(fRequirements, kSigmaToVertex); };
183 void SetRequireIsPrimary() { SETBIT(fRequirements, kPrimary); };
184 void SetRequireITSPixel() { SETBIT(fRequirements, kITSPixel); }
185 void SetRequireITSDrift() { SETBIT(fRequirements, kITSDrift); }
186 void UnsetRequireITSPixel() { CLRBIT(fRequirements, kITSPixel); }
187 void SetRequireProdVertex() { SETBIT(fRequirements, kProductionVertex); };
188 void SetRequireSigmaToVertex() { SETBIT(fRequirements, kSigmaToVertex); CLRBIT(fRequirements, kDCAToVertex); };
189 void UnsetVertexRequirement() { CLRBIT(fRequirements, kDCAToVertex); CLRBIT(fRequirements, kSigmaToVertex); }
190 void SetRequireKineMCCuts() { SETBIT(fRequirements, kKineMCCuts); };
192 void SetDebugLevel(Int_t level) { fDebugLevel = level; };
193 Int_t GetDebugLevel() const { return fDebugLevel; };
197 kDebugMode = BIT(14),
202 kProductionVertex = 1,
210 void SetParticleGenCutList();
211 void SetAcceptanceCutList();
212 void SetRecKineITSTPCCutList();
213 void SetRecPrimaryCutList();
214 void SetHFElectronITSCuts();
215 void SetHFElectronTOFCuts();
216 void SetHFElectronTPCCuts();
217 void SetHFElectronTRDCuts();
218 void SetHFElectronDcaCuts();
219 void SetEventCutList(Int_t istep);
221 static const Char_t* fgkMCCutName[kNcutStepsMCTrack]; // Cut step names for MC single Track cuts
222 static const Char_t* fgkRecoCutName[kNcutStepsRecTrack]; // Cut step names for Rec single Track cuts
223 static const Char_t* fgkDECutName[kNcutStepsDETrack]; // Cut step names for impact parameter cuts
224 static const Char_t* fgkSecvtxCutName[kNcutStepsSecvtxTrack]; // Cut step names for secondary vertexing cuts
225 static const Char_t* fgkEventCutName[kNcutStepsEvent]; // Cut step names for Event cuts
226 static const Char_t* fgkUndefined; // Name for undefined (overflow)
228 ULong64_t fRequirements; // Bitmap for requirements
229 UChar_t fTPCclusterDef; // TPC cluster definition
230 UChar_t fTPCratioDef; // TPC cluster ratio Definition
231 Double_t fEtaRange[2]; // Eta range
232 Double_t fDCAtoVtx[2]; // DCA to Vertex
233 Double_t fProdVtx[4]; // Production Vertex
234 Double_t fPtRange[2]; // pt range
235 UChar_t fMinClustersTPC; // Min.Number of TPC clusters
236 UChar_t fMinClustersTPCPID; // Min.Number of TPC clusters
237 UChar_t fMinClustersITS; // Min.Number of TPC clusters
238 UChar_t fMinTrackletsTRD; // Min. Number of TRD tracklets
239 Float_t fMaxChi2TRD; // Max. Chi2 per TRD tracklet
240 UChar_t fCutITSPixel; // Cut on ITS pixel
241 Bool_t fCheckITSLayerStatus; // Check ITS layer status
242 UChar_t fCutITSDrift; // Cut on ITS drift
243 Double_t fMaxChi2clusterITS; // Max Chi2 per ITS cluster
244 Double_t fMaxChi2clusterTPC; // Max Chi2 per TPC cluster
245 Double_t fMinClusterRatioTPC; // Min. Ratio findable / found TPC clusters
246 Double_t fSigmaToVtx[3]; // Sigma To Vertex
247 Double_t fVertexRangeZ; // Vertex Range reconstructed
248 Bool_t fTRDtrackletsExact; // Require exact number of tracklets
249 Bool_t fTOFPIDStep; // TOF matching step efficiency
250 Bool_t fTOFMISMATCHStep; // TOF mismatch step
251 Bool_t fTPCPIDCLEANUPStep; // TPC PIC cleanup step
252 Bool_t fITSpatternCut; // Cut on ITS pattern
253 Bool_t fUseMixedVertex; // Use primary vertex from track if there otherwise SPD vertex
254 Bool_t fUseSPDVertex; // Use primary SPD vertex
255 Bool_t fUseCorrelationVertex; // Use the correlation of the vertex in z
256 Bool_t fSPDVtxResolution; // Check resolution of the SPD vertex
257 Bool_t fPApileupCut; // Apply pA pileup cut
258 Float_t fIPCutParams[4]; // Parameters of impact parameter cut parametrization
259 Bool_t fIsIPSigmacut; // if IP cut or IP sigma cut
260 Bool_t fIsIPcharge; // if cut on IP * charge (cut using only positive side of distribution, to eliminate conversions)
261 Bool_t fIsIPOpp; // if IP*charge cut on side of the photon peak
262 Double_t fFractionOfSharedTPCClusters; // Fraction of shared TPC clusters
263 Bool_t fMaxImpactParameterRpar; // Max impact parameter
264 Long_t fAdditionalStatusRequirement; // Additional status bit requirement
265 Double_t fTOFsignaldx; // TOF signal Dx
266 Double_t fTOFsignaldz; // TOF signal Dz
267 Int_t fAODFilterBit; // AOD Filter Bit Number
269 TList *fHistQA; //! QA Histograms
270 TObjArray *fCutList; //! List of cut objects(Correction Framework Manager)
272 Int_t fDebugLevel; // Debug Level
274 ClassDef(AliHFEcuts, 5) // Container for HFE cuts
277 //__________________________________________________________________
278 void AliHFEcuts::SetProductionVertex(Double_t xmin, Double_t xmax, Double_t ymin, Double_t ymax){
279 // Set the production vertex constraint
280 SetRequireProdVertex();
287 //__________________________________________________________________
288 void AliHFEcuts::SetSigmaToVertex(Double_t sig){
289 SetRequireSigmaToVertex();
290 fSigmaToVtx[0] = sig;
293 //__________________________________________________________________
294 void AliHFEcuts::SetSigmaToVertexXY(Double_t sig){
295 SetRequireSigmaToVertex();
296 fSigmaToVtx[1] = sig;
299 //__________________________________________________________________
300 void AliHFEcuts::SetSigmaToVertexZ(Double_t sig){
301 SetRequireSigmaToVertex();
302 fSigmaToVtx[2] = sig;
305 //__________________________________________________________________
306 void AliHFEcuts::SetMaxImpactParam(Double_t radial, Double_t z){
307 SetRequireDCAToVertex();
308 fDCAtoVtx[0] = radial;
312 //__________________________________________________________________
313 void AliHFEcuts::SetIPcutParam(Float_t p0, Float_t p1, Float_t p2, Float_t p3, Bool_t isipsigma, Bool_t isIPcharge, Bool_t isopp){
314 // Set parameters for impact parameter cut parametrization
315 fIPCutParams[0] = p0;
316 fIPCutParams[1] = p1;
317 fIPCutParams[2] = p2;
318 fIPCutParams[3] = p3;
319 fIsIPSigmacut = isipsigma;
320 fIsIPcharge = isIPcharge;
324 //__________________________________________________________________
325 void AliHFEcuts::SetCutITSpixel(UChar_t cut){
326 SetRequireITSPixel();
330 //__________________________________________________________________
331 void AliHFEcuts::SetCutITSdrift(UChar_t cut){
332 SetRequireITSDrift();
335 //__________________________________________________________________
336 void AliHFEcuts::SetUseMixedVertex(Bool_t useMixedVertex){
338 // Choice of a vertex
340 fUseMixedVertex = useMixedVertex;
341 if(useMixedVertex) fUseSPDVertex = kFALSE;
343 //__________________________________________________________________
344 void AliHFEcuts::SetUseSPDVertex(Bool_t useSPDVertex){
346 // Choice of a vertex
348 fUseSPDVertex = useSPDVertex;
349 if(useSPDVertex) fUseMixedVertex = kFALSE;
352 //__________________________________________________________________
353 void AliHFEcuts::CreateStandardCuts(){
355 // Standard Cuts defined by the HFE Group
357 SetRequireProdVertex();
362 //SetRequireDCAToVertex();
363 //fDCAtoVtx[0] = 0.5;
364 //fDCAtoVtx[1] = 1.5;
365 fMinClustersTPC = 80;
367 fMinTrackletsTRD = 0;
368 SetRequireITSPixel();
369 fCutITSPixel = AliHFEextraCuts::kFirst;
370 fMaxChi2clusterITS = -1.;
371 fMaxChi2clusterTPC = 4.;
372 fMinClusterRatioTPC = 0.6;
375 SetRequireKineMCCuts();