1 /*************************************************************************
2 * Copyright(c) 1998-2009, 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 ///////////////////////////////////////////////////////////////////////////
26 ///////////////////////////////////////////////////////////////////////////
32 #include <AliVTrack.h>
33 #include <AliVCluster.h>
35 #include <AliExternalTrackParam.h>
36 #include <AliPIDResponse.h>
37 #include <AliTRDPIDResponse.h>
38 #include <AliESDtrack.h> //!!!!! Remove once Eta correction is treated in the tender
39 #include <AliAODTrack.h>
40 #include <AliAODPid.h>
42 #include "AliDielectronVarManager.h"
44 #include "AliDielectronPID.h"
46 ClassImp(AliDielectronPID)
48 TGraph *AliDielectronPID::fgFitCorr=0x0;
49 Double_t AliDielectronPID::fgCorr=0.0;
50 Double_t AliDielectronPID::fgCorrdEdx=1.0;
51 TF1 *AliDielectronPID::fgFunEtaCorr=0x0;
52 TGraph *AliDielectronPID::fgdEdxRunCorr=0x0;
54 AliDielectronPID::AliDielectronPID() :
60 // Default Constructor
62 for (Int_t icut=0; icut<kNmaxPID; ++icut){
64 fPartType[icut]=AliPID::kPion;
69 fExclude[icut]=kFALSE;
70 fFunUpperCut[icut]=0x0;
71 fFunLowerCut[icut]=0x0;
72 fRequirePIDbit[icut]=0;
80 //______________________________________________
81 AliDielectronPID::AliDielectronPID(const char* name, const char* title) :
82 AliAnalysisCuts(name, title),
89 for (Int_t icut=0; icut<kNmaxPID; ++icut){
91 fPartType[icut]=AliPID::kPion;
96 fExclude[icut]=kFALSE;
97 fFunUpperCut[icut]=0x0;
98 fFunLowerCut[icut]=0x0;
99 fRequirePIDbit[icut]=0;
101 fSigmaFunLow[icut]=0;
107 //______________________________________________
108 AliDielectronPID::~AliDielectronPID()
111 // Default Destructor
115 //______________________________________________
116 void AliDielectronPID::AddCut(DetType det, AliPID::EParticleType type, Double_t nSigmaLow, Double_t nSigmaUp/*=-99999.*/,
117 Double_t min/*=0*/, Double_t max/*=0*/, Bool_t exclude/*=kFALSE*/,
118 UInt_t pidBitType/*=AliDielectronPID::kRequire*/, Int_t var/*=-1*/)
121 // Add a pid nsigma cut
122 // use response of detector 'det' in the range ['min'] to ['max'] for var
123 // use a sigma band between 'nSigmaLow' and 'nSigmaUp'
124 // if nSigmaUp==-99999. then nSigmaLow will be uesd as a symmetric band +- nSigmaLow
125 // specify whether to 'exclude' the given band
128 if (fNcuts>=kNmaxPID){
129 AliError(Form("only %d pid cut ranges allowed",kNmaxPID));
132 if (TMath::Abs(nSigmaUp+99999.)<1e-20){
133 nSigmaUp=TMath::Abs(nSigmaLow);
134 nSigmaLow=-1.*nSigmaUp;
136 fDetType[fNcuts]=det;
137 fPartType[fNcuts]=type;
138 fNsigmaLow[fNcuts]=nSigmaLow;
139 fNsigmaUp[fNcuts]=nSigmaUp;
142 fExclude[fNcuts]=exclude;
143 fRequirePIDbit[fNcuts]=pidBitType;
144 fActiveCuts[fNcuts]=(var==-1 ? AliDielectronVarManager::kP : var);
146 AliDebug(1,Form("Add PID cut %d: sigma [% .1f,% .1f] \t cut [% .1f,% .f] \t var %d->%s \n",
147 fNcuts,nSigmaLow,nSigmaUp,min,max,fActiveCuts[fNcuts],AliDielectronVarManager::GetValueName(fActiveCuts[fNcuts])));
153 //______________________________________________
154 void AliDielectronPID::AddCut(DetType det, AliPID::EParticleType type, Double_t nSigmaLow, TF1 * const funUp,
155 Double_t min/*=0*/, Double_t max/*=0*/, Bool_t exclude/*=kFALSE*/,
156 UInt_t pidBitType/*=AliDielectronPID::kRequire*/, Int_t var/*=-1*/)
159 // cut using a TF1 as upper cut
162 AliError("A valid function is required for the upper cut. Not adding the cut!");
165 fFunUpperCut[fNcuts]=funUp;
166 AddCut(det,type,nSigmaLow,0.,min,max,exclude,pidBitType,var);
169 //______________________________________________
170 void AliDielectronPID::AddCut(DetType det, AliPID::EParticleType type, TF1 * const funLow, Double_t nSigmaUp,
171 Double_t min/*=0*/, Double_t max/*=0*/, Bool_t exclude/*=kFALSE*/,
172 UInt_t pidBitType/*=AliDielectronPID::kRequire*/, Int_t var/*=-1*/)
175 // cut using a TF1 as lower cut
178 AliError("A valid function is required for the lower cut. Not adding the cut!");
181 fFunLowerCut[fNcuts]=funLow;
182 AddCut(det,type,0.,nSigmaUp,min,max,exclude,pidBitType,var);
185 //______________________________________________
186 void AliDielectronPID::AddCut(DetType det, AliPID::EParticleType type, TF1 * const funLow, TF1 * const funUp,
187 Double_t min/*=0*/, Double_t max/*=0*/, Bool_t exclude/*=kFALSE*/,
188 UInt_t pidBitType/*=AliDielectronPID::kRequire*/, Int_t var/*=-1*/)
191 // cut using a TF1 as lower and upper cut
193 if ( (funUp==0x0) || (funLow==0x0) ){
194 AliError("A valid function is required for upper and lower cut. Not adding the cut!");
197 fFunUpperCut[fNcuts]=funUp;
198 fFunLowerCut[fNcuts]=funLow;
199 AddCut(det,type,0.,0.,min,max,exclude,pidBitType,var);
202 //______________________________________________
203 void AliDielectronPID::AddCut(DetType det, AliPID::EParticleType type, Double_t nSigmaLow, Double_t nSigmaUp,
204 Double_t min, Double_t max, Bool_t exclude,
205 UInt_t pidBitType, TF1 * const funSigma)
208 // cut using a TF1 as lower cut
211 AliError("A valid function is required for the sigma cut. Not adding the cut!");
214 fFunSigma[fNcuts]=funSigma;
215 fSigmaFunLow[fNcuts]=min;
216 fSigmaFunUp[fNcuts]=max;
218 AddCut(det,type,nSigmaLow,nSigmaUp,0,0,exclude,pidBitType,-1);
221 //______________________________________________
222 Bool_t AliDielectronPID::IsSelected(TObject* track)
229 AliVTrack *part=static_cast<AliVTrack*>(track);
230 AliESDtrack *esdTrack=0x0;
231 AliAODTrack *aodTrack=0x0;
232 Double_t origdEdx=-1;
234 // apply ETa correction, remove once this is in the tender
235 if( (part->IsA() == AliESDtrack::Class()) ){
236 esdTrack=static_cast<AliESDtrack*>(part);
237 origdEdx=esdTrack->GetTPCsignal();
238 esdTrack->SetTPCsignal(origdEdx/GetEtaCorr(esdTrack)/fgCorrdEdx,esdTrack->GetTPCsignalSigma(),esdTrack->GetTPCsignalN());
239 } else if ( (part->IsA() == AliAODTrack::Class()) ){
240 aodTrack=static_cast<AliAODTrack*>(track);
241 AliAODPid *pid=const_cast<AliAODPid*>(aodTrack->GetDetPid());
242 origdEdx=pid->GetTPCsignal();
243 pid->SetTPCsignal(origdEdx/GetEtaCorr(aodTrack)/fgCorrdEdx);
247 Double_t values[AliDielectronVarManager::kNMaxValues];
248 AliDielectronVarManager::Fill(track,values);
250 Bool_t selected=kFALSE;
251 fPIDResponse=AliDielectronVarManager::GetPIDResponse();
252 for (UChar_t icut=0; icut<fNcuts; ++icut){
253 Double_t min=fmin[icut];
254 Double_t max=fmax[icut];
255 Double_t val=values[fActiveCuts[icut]];
257 // test var range. In case min==max do not cut
258 if ( (TMath::Abs(min-max)>1e-20) && (val<min || val>=max) ) continue;
261 // check if fFunSigma is set, then check if 'part' is in sigma range of the function
263 val= fPIDResponse->NumberOfSigmasTPC(part, fPartType[icut]);
264 if (fPartType[icut]==AliPID::kElectron){
267 min= fFunSigma[icut]->Eval(part->GetTPCmomentum())+fSigmaFunLow[icut];
268 max= fFunSigma[icut]->Eval(part->GetTPCmomentum())+fSigmaFunUp[icut];
269 if(val<min || val>=max) continue;
272 switch (fDetType[icut]){
274 selected = IsSelectedITS(part,icut);
277 selected = IsSelectedTPC(part,icut);
280 selected = IsSelectedTRD(part,icut);
283 selected = IsSelectedTRDeleEff(part,icut);
286 selected = IsSelectedTRDeleEff(part,icut,AliTRDPIDResponse::kLQ2D);
289 selected = IsSelectedTOF(part,icut);
292 selected = IsSelectedEMCAL(part,icut);
296 if (esdTrack) esdTrack->SetTPCsignal(origdEdx,esdTrack->GetTPCsignalSigma(),esdTrack->GetTPCsignalN());
298 AliAODPid *pid=const_cast<AliAODPid*>(aodTrack->GetDetPid());
299 pid->SetTPCsignal(origdEdx);
306 if (esdTrack) esdTrack->SetTPCsignal(origdEdx,esdTrack->GetTPCsignalSigma(),esdTrack->GetTPCsignalN());
308 AliAODPid *pid=const_cast<AliAODPid*>(aodTrack->GetDetPid());
309 pid->SetTPCsignal(origdEdx);
314 //______________________________________________
315 Bool_t AliDielectronPID::IsSelectedITS(AliVTrack * const part, Int_t icut)
318 // ITS part of the PID check
319 // Don't accept the track if there was no pid bit set
322 if (fRequirePIDbit[icut]==AliDielectronPID::kRequire&&!(part->GetStatus()&AliVTrack::kITSpid)) return kFALSE;
323 if (fRequirePIDbit[icut]==AliDielectronPID::kIfAvailable&&!(part->GetStatus()&AliVTrack::kITSpid)) return kTRUE;
325 Double_t mom=part->P();
327 Float_t numberOfSigmas=fPIDResponse->NumberOfSigmasITS(part, fPartType[icut]);
329 // test if we are supposed to use a function for the cut
330 if (fFunUpperCut[icut]) fNsigmaUp[icut] =fFunUpperCut[icut]->Eval(mom);
331 if (fFunLowerCut[icut]) fNsigmaLow[icut]=fFunLowerCut[icut]->Eval(mom);
333 Bool_t selected=((numberOfSigmas>=fNsigmaLow[icut])&&(numberOfSigmas<=fNsigmaUp[icut]))^fExclude[icut];
337 //______________________________________________
338 Bool_t AliDielectronPID::IsSelectedTPC(AliVTrack * const part, Int_t icut)
341 // TPC part of the PID check
342 // Don't accept the track if there was no pid bit set
344 if (fRequirePIDbit[icut]==AliDielectronPID::kRequire&&!(part->GetStatus()&AliVTrack::kTPCpid)) return kFALSE;
345 if (fRequirePIDbit[icut]==AliDielectronPID::kIfAvailable&&!(part->GetStatus()&AliVTrack::kTPCpid)) return kTRUE;
347 Double_t mom=part->GetTPCmomentum();
349 Float_t numberOfSigmas=fPIDResponse->NumberOfSigmasTPC(part, fPartType[icut]);
351 if (fPartType[icut]==AliPID::kElectron){
352 numberOfSigmas-=fgCorr;
355 // test if we are supposed to use a function for the cut
356 if (fFunUpperCut[icut]) fNsigmaUp[icut] =fFunUpperCut[icut]->Eval(mom);
357 if (fFunLowerCut[icut]) fNsigmaLow[icut]=fFunLowerCut[icut]->Eval(mom);
359 Bool_t selected=((numberOfSigmas>=fNsigmaLow[icut])&&(numberOfSigmas<=fNsigmaUp[icut]))^fExclude[icut];
363 //______________________________________________
364 Bool_t AliDielectronPID::IsSelectedTRD(AliVTrack * const part, Int_t icut)
367 // TRD part of the pid check
368 // the TRD checks on the probabilities.
371 if (fRequirePIDbit[icut]==AliDielectronPID::kRequire&&!(part->GetStatus()&AliVTrack::kTRDpid)) return kFALSE;
372 if (fRequirePIDbit[icut]==AliDielectronPID::kIfAvailable&&!(part->GetStatus()&AliVTrack::kTRDpid)) return kTRUE;
373 if (fRequirePIDbit[icut]==AliDielectronPID::kIfAvailable && (part->GetTRDntrackletsPID()<4)) return kTRUE;
375 Double_t p[AliPID::kSPECIES]={0.};
376 fPIDResponse->ComputeTRDProbability(part,AliPID::kSPECIES,p);
377 Float_t particleProb=p[fPartType[icut]];
379 Bool_t selected=((particleProb>=fNsigmaLow[icut])&&(particleProb<=fNsigmaUp[icut]))^fExclude[icut];
383 //______________________________________________
384 Bool_t AliDielectronPID::IsSelectedTRDeleEff(AliVTrack * const part, Int_t icut, AliTRDPIDResponse::ETRDPIDMethod PIDmethod)
387 // TRD part of the pid check using electron efficiency requirement
388 // in this case the upper limit as well as the particle specie is ignored
389 // and the lower limit regarded as the requested electron efficiency
392 if (fRequirePIDbit[icut]==AliDielectronPID::kRequire&&!(part->GetStatus()&AliVTrack::kTRDpid)) return kFALSE;
393 if (fRequirePIDbit[icut]==AliDielectronPID::kIfAvailable&&!(part->GetStatus()&AliVTrack::kTRDpid)) return kTRUE;
395 Double_t centrality = -1.;
396 if(part->IsA() == AliESDtrack::Class())
397 centrality=(const_cast<AliESDEvent*>( (static_cast<const AliESDtrack*>(part))->GetESDEvent()) )->GetCentrality()->GetCentralityPercentile("V0M");
398 if(part->IsA() == AliAODTrack::Class())
399 centrality=(const_cast<AliAODEvent*>( (static_cast<const AliAODTrack*>(part))->GetAODEvent()) )->GetCentrality()->GetCentralityPercentile("V0M");
401 Bool_t selected=fPIDResponse->IdentifiedAsElectronTRD(part,fNsigmaLow[icut], centrality, PIDmethod)^fExclude[icut];
405 //______________________________________________
406 Bool_t AliDielectronPID::IsSelectedTOF(AliVTrack * const part, Int_t icut)
409 // TOF part of the PID check
410 // Don't accept the track if there was no pid bit set
413 if (fRequirePIDbit[icut]==AliDielectronPID::kRequire&&!(part->GetStatus()&AliVTrack::kTOFpid)) return kFALSE;
414 if (fRequirePIDbit[icut]==AliDielectronPID::kIfAvailable&&!(part->GetStatus()&AliVTrack::kTOFpid)) return kTRUE;
416 Float_t numberOfSigmas=fPIDResponse->NumberOfSigmasTOF(part, fPartType[icut]);
418 Bool_t selected=((numberOfSigmas>=fNsigmaLow[icut])&&(numberOfSigmas<=fNsigmaUp[icut]))^fExclude[icut];
422 //______________________________________________
423 Bool_t AliDielectronPID::IsSelectedEMCAL(AliVTrack * const part, Int_t icut)
426 // emcal pid selecttion
429 //TODO: correct way to check for emcal pid?
430 Float_t numberOfSigmas=fPIDResponse->NumberOfSigmasEMCAL(part, fPartType[icut]);
432 Bool_t hasPID=numberOfSigmas>-998.;
434 if (fRequirePIDbit[icut]==AliDielectronPID::kRequire&&!hasPID) return kFALSE;
435 if (fRequirePIDbit[icut]==AliDielectronPID::kIfAvailable&&!hasPID) return kTRUE;
438 Bool_t selected=((numberOfSigmas>=fNsigmaLow[icut])&&(numberOfSigmas<=fNsigmaUp[icut]))^fExclude[icut];
442 //______________________________________________
443 void AliDielectronPID::SetDefaults(Int_t def){
445 // initialise default pid strategies
451 // - exclude mu,K,pi,p
453 AddCut(kTPC,AliPID::kElectron,2);
454 AddCut(kTPC,AliPID::kMuon,-2.,2.,0.,0.,kTRUE);
455 AddCut(kTPC,AliPID::kPion,-2.,2.,0.,0.,kTRUE);
456 AddCut(kTPC,AliPID::kKaon,-2.,2.,0.,0.,kTRUE);
457 AddCut(kTPC,AliPID::kProton,-2.,2.,0.,0.,kTRUE);
460 // - include e 0<p<inf
461 // - exclude mu,K,pi,p 0<p<2
462 AddCut(kTPC,AliPID::kElectron,2.);
463 AddCut(kTPC,AliPID::kMuon,-2.,2.,0.,2.,kTRUE);
464 AddCut(kTPC,AliPID::kPion,-2.,2.,0.,2.,kTRUE);
465 AddCut(kTPC,AliPID::kKaon,-2.,2.,0.,2.,kTRUE);
466 AddCut(kTPC,AliPID::kProton,-2.,2.,0.,2.,kTRUE);
469 // include 2sigma e TPC
472 AddCut(kTPC,AliPID::kElectron,-3.,3.);
473 AddCut(kTPC,AliPID::kPion,-3.,3.,0.,0.,kTRUE);
474 AddCut(kTPC,AliPID::kProton,-3.,3.,0.,0.,kTRUE);
476 } else if (def==3 || def==4) { // def3 and def4 are the same??
477 // include 2sigma e TPC
481 AddCut(kTPC,AliPID::kElectron,2);
482 AddCut(kTOF,AliPID::kKaon,-3.,3.,0.,1.,kTRUE);
483 AddCut(kTOF,AliPID::kProton,-6.,6.,0.,1.,kTRUE);
484 AddCut(kTOF,AliPID::kProton,-3.,3.,1.,2.,kTRUE);
487 AddCut(kTPC,AliPID::kElectron,-0.5,3);
488 AddCut(kTOF,AliPID::kElectron,-3,3,0,1.5);
490 // lower cut TPC: parametrisation by HFE
491 // upper cut TPC: 3 sigma
492 // TOF ele band 3sigma 0<p<1.5GeV
493 TF1 *lowerCut=new TF1("lowerCut", "[0] * TMath::Exp([1]*x)", 0, 100);
494 lowerCut->SetParameters(-2.7,-0.4357);
495 AddCut(kTPC,AliPID::kElectron,lowerCut,3.);
496 AddCut(kTOF,AliPID::kElectron,-3,3,0,1.5);
499 // TOF ele band 3sigma 0<p<1.5GeV
500 AddCut(kTPC,AliPID::kElectron,10.);
501 AddCut(kTOF,AliPID::kElectron,-3,3,0,1.5);
503 // TOF 5 sigma inclusion if TOFpid available
504 // this should reduce K,p,Pi to a large extent
505 AddCut(kTOF,AliPID::kElectron,-5,5,0,200,kFALSE,AliDielectronPID::kIfAvailable);
507 // lower cut TPC: parametrisation by HFE
508 // upper cut TPC: 3 sigma
509 // TOF 5 sigma inclusion if TOFpid available
510 // this should reduce K,p,Pi to a large extent
511 TF1 *lowerCut=new TF1("lowerCut", "[0] * TMath::Exp([1]*x)", 0, 100);
512 lowerCut->SetParameters(-2.65,-0.6757);
513 AddCut(kTPC,AliPID::kElectron,lowerCut,4.);
514 AddCut(kTOF,AliPID::kElectron,-5,5,0,200,kFALSE,AliDielectronPID::kIfAvailable);
516 } else if (def==10) {
517 AddCut(kTOF,AliPID::kElectron,-5,5,0,200,kFALSE,AliDielectronPID::kIfAvailable);
518 AddCut(kTPC,AliPID::kElectron,3.);
519 AddCut(kTPC,AliPID::kPion,-3.,3.,0.,0.,kTRUE);
520 AddCut(kTPC,AliPID::kProton,-3.,3.,0.,0.,kTRUE);
522 } else if (def==11) {
523 // lower cut TPC: parametrisation by HFE
524 // only use from period d on !!
525 // upper cut TPC: 3 sigma
526 // TOF ele band 3sigma 0<p<2.0GeV
527 TF1 *lowerCut=new TF1("lowerCut", "[0] * TMath::Exp([1]*x)+[2]", 0, 100);
528 lowerCut->SetParameters(-3.718,-0.4,0.27);
529 AddCut(kTPC,AliPID::kElectron,lowerCut,3.);
530 AddCut(kTOF,AliPID::kElectron,-3,3,0,2.);
531 } else if (def==12) {
532 // lower cut TPC: parametrisation by HFE
533 // only use from period d on !!
534 // upper cut TPC: 3 sigma
535 // TOF 5 sigma inclusion if TOFpid available
536 // this should reduce K,p,Pi to a large extent
537 TF1 *lowerCut=new TF1("lowerCut", "[0] * TMath::Exp([1]*x)+[2]", 0, 100);
538 lowerCut->SetParameters(-3.718,-0.4,0.27);
539 AddCut(kTPC,AliPID::kElectron,lowerCut,4.);
540 AddCut(kTOF,AliPID::kElectron,-5,5,0,200,kFALSE,AliDielectronPID::kIfAvailable);
545 //______________________________________________
546 void AliDielectronPID::SetCorrVal(Double_t run)
549 // set correction value for run
555 fgCorr=fgFitCorr->Eval(run);
556 if (run<fgFitCorr->GetX()[0]) fgCorr=fgFitCorr->GetY()[0];
557 if (run>fgFitCorr->GetX()[fgFitCorr->GetN()-1]) fgCorr=fgFitCorr->GetY()[fgFitCorr->GetN()-1];
561 fgCorrdEdx=fgdEdxRunCorr->Eval(run);
562 if (run<fgdEdxRunCorr->GetX()[0]) fgCorrdEdx=fgdEdxRunCorr->GetY()[0];
563 if (run>fgdEdxRunCorr->GetX()[fgFitCorr->GetN()-1]) fgCorrdEdx=fgdEdxRunCorr->GetY()[fgdEdxRunCorr->GetN()-1];
567 //______________________________________________
568 Double_t AliDielectronPID::GetEtaCorr(const AliVTrack *track)
571 // return eta correction
573 if (!fgFunEtaCorr) return 1;
574 return fgFunEtaCorr->Eval(track->Eta());