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 /* $Id: AliESDpid.cxx 64123 2013-09-05 15:09:53Z morsch $ */
18 //-----------------------------------------------------------------
19 // Implementation of the combined PID class
20 // For the Event Summary Data Class
21 // produced by the reconstruction process
22 // and containing information on the particle identification
23 // Origin: Iouri Belikov, CERN, Jouri.Belikov@cern.ch
24 //-----------------------------------------------------------------
32 #include "AliTOFHeader.h"
33 #include "AliESDpid.h"
34 #include "AliESDEvent.h"
35 #include "AliESDtrack.h"
36 #include "AliMCEvent.h"
37 #include "AliTOFPIDParams.h"
39 #include <AliDetectorPID.h>
43 Int_t AliESDpid::MakePID(AliESDEvent *event, Bool_t TPConly, Float_t timeZeroTOF) const {
45 // Calculate probabilities for all detectors, except if TPConly==kTRUE
48 // Option TPConly==kTRUE is used during reconstruction,
49 // because ITS tracking uses TPC pid
50 // HMPID and TRD pid are done in detector reconstructors
54 Float_t timeZeroTOF = 0;
56 timeZeroTOF = event->GetT0();
58 Int_t nTrk=event->GetNumberOfTracks();
59 for (Int_t iTrk=0; iTrk<nTrk; iTrk++) {
60 AliESDtrack *track=event->GetTrack(iTrk);
64 //MakeTOFPID(track, timeZeroTOF);
65 //MakeHMPIDPID(track);
72 //_________________________________________________________________________
73 Float_t AliESDpid::GetTPCsignalTunedOnData(const AliVTrack *t) const {
74 AliESDtrack *track = (AliESDtrack *) t;
75 Float_t dedx = track->GetTPCsignalTunedOnData();
77 if(dedx > 0) return dedx;
79 dedx = t->GetTPCsignal();
80 track->SetTPCsignalTunedOnData(dedx);
81 if(dedx < 20) return dedx;
83 AliPID::EParticleType type = AliPID::kPion;
85 AliMCEventHandler* eventHandler=dynamic_cast<AliMCEventHandler*>(fEventHandler);
87 AliMCEvent* mcEvent = eventHandler->MCEvent();
90 AliMCParticle *MCpart = (AliMCParticle *) mcEvent->GetTrack(TMath::Abs(t->GetLabel()));
91 TParticle *part = MCpart->Particle();
93 Int_t iS = TMath::Abs(part->GetPdgCode());
95 if(iS==AliPID::ParticleCode(AliPID::kElectron)){
96 type = AliPID::kElectron;
98 else if(iS==AliPID::ParticleCode(AliPID::kMuon)){
101 else if(iS==AliPID::ParticleCode(AliPID::kPion)){
102 type = AliPID::kPion;
104 else if(iS==AliPID::ParticleCode(AliPID::kKaon)){
105 type = AliPID::kKaon;
107 else if(iS==AliPID::ParticleCode(AliPID::kProton)){
108 type = AliPID::kProton;
110 else if(iS==AliPID::ParticleCode(AliPID::kDeuteron)){ // d
111 type = AliPID::kDeuteron;
113 else if(iS==AliPID::ParticleCode(AliPID::kTriton)){ // t
114 type = AliPID::kTriton;
116 else if(iS==AliPID::ParticleCode(AliPID::kHe3)){ // 3He
119 else if(iS==AliPID::ParticleCode(AliPID::kAlpha)){ // 4He
120 type = AliPID::kAlpha;
126 //TODO maybe introduce different dEdxSources?
127 Double_t bethe = fTPCResponse.GetExpectedSignal(track, type, AliTPCPIDResponse::kdEdxDefault, this->UseTPCEtaCorrection(),
128 this->UseTPCMultiplicityCorrection());
129 Double_t sigma = fTPCResponse.GetExpectedSigma(track, type, AliTPCPIDResponse::kdEdxDefault, this->UseTPCEtaCorrection(),
130 this->UseTPCMultiplicityCorrection());
131 dedx = gRandom->Gaus(bethe,sigma);
132 // if(iS == AliPID::ParticleCode(AliPID::kHe3) || iS == AliPID::ParticleCode(AliPID::kAlpha)) dedx *= 5;
137 track->SetTPCsignalTunedOnData(dedx);
140 //_________________________________________________________________________
141 Float_t AliESDpid::GetTOFsignalTunedOnData(const AliVTrack *t) const {
142 AliESDtrack *track = (AliESDtrack *) t;
143 Double_t tofSignal = track->GetTOFsignalTunedOnData();
145 if(tofSignal < 99999) return (Float_t)tofSignal; // it has been already set
146 // read additional mismatch fraction
147 Float_t addmism = GetTOFPIDParams()->GetTOFadditionalMismForMC();
149 Float_t centr = GetCurrentCentrality();
150 if(centr > 50) addmism *= 0.1667;
151 else if(centr > 20) addmism *= 0.33;
154 tofSignal = t->GetTOFsignal() + fTOFResponse.GetTailRandomValue(t->Pt(),t->Eta(),t->GetTOFsignal(),addmism);
155 track->SetTOFsignalTunedOnData(tofSignal);
156 return (Float_t)tofSignal;
158 //_________________________________________________________________________
159 void AliESDpid::MakeTPCPID(AliESDtrack *track) const
162 // TPC pid using bethe-bloch and gaussian response
164 if ((track->GetStatus()&AliESDtrack::kTPCin )==0)
165 if ((track->GetStatus()&AliESDtrack::kTPCout)==0) return;
167 Double_t mom = track->GetP();
168 const AliExternalTrackParam *in=track->GetInnerParam();
169 if (in) mom = in->GetP();
171 Double_t p[AliPID::kSPECIES];
172 Double_t dedx=track->GetTPCsignal();
173 Bool_t mismatch=kTRUE, heavy=kTRUE;
175 for (Int_t j=0; j<AliPID::kSPECIES; j++) {
176 AliPID::EParticleType type=AliPID::EParticleType(j);
177 Double_t bethe=fTPCResponse.GetExpectedSignal(mom,type);
178 Double_t sigma=fTPCResponse.GetExpectedSigma(mom,track->GetTPCsignalN(),type);
179 if (TMath::Abs(dedx-bethe) > fRange*sigma) {
180 p[j]=TMath::Exp(-0.5*fRange*fRange)/sigma;
182 p[j]=TMath::Exp(-0.5*(dedx-bethe)*(dedx-bethe)/(sigma*sigma))/sigma;
186 // Check for particles heavier than (AliPID::kSPECIES - 1)
187 if (dedx < (bethe + fRange*sigma)) heavy=kFALSE;
192 for (Int_t j=0; j<AliPID::kSPECIES; j++) p[j]=1./AliPID::kSPECIES;
196 if (heavy) track->ResetStatus(AliESDtrack::kTPCpid);
199 //_________________________________________________________________________
200 void AliESDpid::MakeITSPID(AliESDtrack *track) const
204 // Two options, depending on fITSPIDmethod:
205 // 1) Truncated mean method
206 // 2) Likelihood, using charges measured in all 4 layers and
207 // Landau+gaus response functions
210 if ((track->GetStatus()&AliESDtrack::kITSin)==0 &&
211 (track->GetStatus()&AliESDtrack::kITSout)==0) return;
213 Double_t mom=track->GetP();
214 if (fITSPIDmethod == kITSTruncMean) {
215 Double_t dedx=track->GetITSsignal();
218 ULong_t trStatus=track->GetStatus();
219 if(trStatus&AliESDtrack::kTPCin) isSA=kFALSE;
220 UChar_t clumap=track->GetITSClusterMap();
221 Int_t nPointsForPid=0;
222 for(Int_t i=2; i<6; i++){
223 if(clumap&(1<<i)) ++nPointsForPid;
226 if(nPointsForPid<3) { // track not to be used for combined PID purposes
227 track->ResetStatus(AliESDtrack::kITSpid);
233 Bool_t mismatch=kTRUE, heavy=kTRUE;
234 for (Int_t j=0; j<AliPID::kSPECIES; j++) {
235 Double_t mass=AliPID::ParticleMass(j);//GeV/c^2
236 Double_t bethe=fITSResponse.Bethe(momITS,mass);
237 Double_t sigma=fITSResponse.GetResolution(bethe,nPointsForPid,isSA);
238 if (TMath::Abs(dedx-bethe) > fRange*sigma) {
239 p[j]=TMath::Exp(-0.5*fRange*fRange)/sigma;
241 p[j]=TMath::Exp(-0.5*(dedx-bethe)*(dedx-bethe)/(sigma*sigma))/sigma;
245 // Check for particles heavier than (AliPID::kSPECIES - 1)
246 if (dedx < (bethe + fRange*sigma)) heavy=kFALSE;
251 for (Int_t j=0; j<AliPID::kSPECIES; j++) p[j]=1./AliPID::kSPECIES;
255 if (heavy) track->ResetStatus(AliESDtrack::kITSpid);
257 else { // Likelihood method
258 Double_t condprobfun[AliPID::kSPECIES];
260 track->GetITSdEdxSamples(qclu);
261 fITSResponse.GetITSProbabilities(mom,qclu,condprobfun);
262 track->SetITSpid(condprobfun);
266 //_________________________________________________________________________
267 void AliESDpid::MakeTOFPID(AliESDtrack *track, Float_t /*timeZeroTOF*/) const
270 // TOF PID using gaussian response
273 if ((track->GetStatus()&AliESDtrack::kTOFout)==0) return;
274 if ((track->GetStatus()&AliESDtrack::kTIME)==0) return;
275 if ((track->GetStatus()&AliESDtrack::kITSin)==0) return;
277 Int_t ibin = fTOFResponse.GetMomBin(track->GetP());
278 Float_t timezero = fTOFResponse.GetT0bin(ibin);
280 Double_t time[AliPID::kSPECIESC];
281 track->GetIntegratedTimes(time);
283 Double_t sigma[AliPID::kSPECIES];
284 for (Int_t iPart = 0; iPart < AliPID::kSPECIES; iPart++) {
285 sigma[iPart] = fTOFResponse.GetExpectedSigma(track->GetP(),time[iPart],AliPID::ParticleMass(iPart));
288 AliDebugGeneral("AliESDpid::MakeTOFPID",2,
289 Form("Expected TOF signals [ps]: %f %f %f %f %f",
290 time[AliPID::kElectron],
294 time[AliPID::kProton]));
296 AliDebugGeneral("AliESDpid::MakeTOFPID",2,
297 Form("Expected TOF std deviations [ps]: %f %f %f %f %f",
298 sigma[AliPID::kElectron],
299 sigma[AliPID::kMuon],
300 sigma[AliPID::kPion],
301 sigma[AliPID::kKaon],
302 sigma[AliPID::kProton]
305 Double_t tof = track->GetTOFsignal() - timezero;
307 Double_t p[AliPID::kSPECIES];
308 // Bool_t mismatch = kTRUE;
309 Bool_t heavy = kTRUE;
310 for (Int_t j=0; j<AliPID::kSPECIES; j++) {
311 Double_t sig = sigma[j];
312 if (TMath::Abs(tof-time[j]) > (fRange+2)*sig) {
313 p[j] = TMath::Exp(-0.5*(fRange+2)*(fRange+2))/sig;
315 p[j] = TMath::Exp(-0.5*(tof-time[j])*(tof-time[j])/(sig*sig))/sig;
317 // Check the mismatching
319 // Double_t mass = AliPID::ParticleMass(j);
320 // Double_t pm = fTOFResponse.GetMismatchProbability(track->GetP(),mass);
321 // if (p[j]>pm) mismatch = kFALSE;
323 // Check for particles heavier than (AliPID::kSPECIES - 1)
324 if (tof < (time[j] + fRange*sig)) heavy=kFALSE;
330 for (Int_t j=0; j<AliPID::kSPECIES; j++) p[j]=1./AliPID::kSPECIES;
335 if (heavy) track->ResetStatus(AliESDtrack::kTOFpid);
337 // kTOFmismatch flas is not set because deprecated from 18/02/2013
338 // if (!CheckTOFMatching(track)) track->SetStatus(AliESDtrack::kTOFmismatch);
339 // else track->ResetStatus(AliESDtrack::kTOFmismatch);
341 //_________________________________________________________________________
342 void AliESDpid::MakeTRDPID(AliESDtrack *track) const
345 // Method to recalculate the TRD PID probabilities
347 Double_t prob[AliPID::kSPECIES];
348 GetComputeTRDProbability(track, AliPID::kSPECIES, prob);
349 track->SetTRDpid(prob);
351 //_________________________________________________________________________
352 void AliESDpid::CombinePID(AliESDtrack *track) const
355 // Combine the information of various detectors
356 // to determine the Particle Identification
358 Int_t ns=AliPID::kSPECIES;
359 Double_t p[10]={1.,1.,1.,1.,1.,1.,1.,1.,1.,1.};
361 if (track->IsOn(AliESDtrack::kITSpid)) {
364 for (Int_t j=0; j<ns; j++) p[j]*=d[j];
367 if (track->IsOn(AliESDtrack::kTPCpid)) {
370 for (Int_t j=0; j<ns; j++) p[j]*=d[j];
373 if (track->IsOn(AliESDtrack::kTRDpid)) {
376 for (Int_t j=0; j<ns; j++) p[j]*=d[j];
379 if (track->IsOn(AliESDtrack::kTOFpid)) {
382 for (Int_t j=0; j<ns; j++) p[j]*=d[j];
385 if (track->IsOn(AliESDtrack::kHMPIDpid)) {
387 track->GetHMPIDpid(d);
388 for (Int_t j=0; j<ns; j++) p[j]*=d[j];
393 //_________________________________________________________________________
394 Bool_t AliESDpid::CheckTOFMatching(AliESDtrack *track) const{
396 // Check pid matching of TOF with TPC as reference
398 Bool_t status = kFALSE;
400 Double_t exptimes[AliPID::kSPECIESC];
401 track->GetIntegratedTimes(exptimes);
403 Float_t p = track->P();
405 Float_t dedx = track->GetTPCsignal();
406 Float_t time = track->GetTOFsignal() - fTOFResponse.GetStartTime(p);
409 track->GetInnerPxPyPz(ptpc);
410 Float_t momtpc=TMath::Sqrt(ptpc[0]*ptpc[0] + ptpc[1]*ptpc[1] + ptpc[2]*ptpc[2]);
412 for(Int_t i=0;i < 5;i++){
413 AliPID::EParticleType type=AliPID::EParticleType(i);
415 Float_t resolutionTOF = fTOFResponse.GetExpectedSigma(p, exptimes[i], AliPID::ParticleMass(i));
416 if(TMath::Abs(exptimes[i] - time) < fRange * resolutionTOF){
417 Float_t dedxExp = fTPCResponse.GetExpectedSignal(momtpc,type);
418 Float_t resolutionTPC = fTPCResponse.GetExpectedSigma(momtpc,track->GetTPCsignalN(),type);
420 if(TMath::Abs(dedx - dedxExp) < fRangeTOFMismatch * resolutionTPC){
427 Float_t resolutionTOFpr = fTOFResponse.GetExpectedSigma(p, exptimes[4], AliPID::ParticleMass(4));
428 if(!status && (exptimes[4] + fRange*resolutionTOFpr < time)) status = kTRUE;
434 //_________________________________________________________________________
435 Float_t AliESDpid::GetSignalDeltaTOFold(const AliVParticle *track, AliPID::EParticleType type, Bool_t ratio/*=kFALSE*/) const
438 // TOF signal - expected
440 AliVTrack *vtrack=(AliVTrack*)track;
442 const Double_t expTime = fTOFResponse.GetExpectedSignal(vtrack,type);
443 Double_t tofTime = 99999;
444 if (fTuneMConData && ((fTuneMConDataMask & kDetTOF) == kDetTOF) ) tofTime = (Double_t)this->GetTOFsignalTunedOnData((AliVTrack*)vtrack);
445 else tofTime=vtrack->GetTOFsignal();
446 tofTime = tofTime - fTOFResponse.GetStartTime(vtrack->P());
447 Double_t delta=-9999.;
449 if (!ratio) delta=tofTime-expTime;
450 else if (expTime>1.e-20) delta=tofTime/expTime;
455 //_________________________________________________________________________
456 Float_t AliESDpid::GetNumberOfSigmasTOFold(const AliVParticle *track, AliPID::EParticleType type) const
459 // Number of sigma implementation for the TOF
462 AliVTrack *vtrack=(AliVTrack*)track;
463 Double_t tofTime = 99999;
464 if (fTuneMConData && ((fTuneMConDataMask & kDetTOF) == kDetTOF) ) tofTime = (Double_t)this->GetTOFsignalTunedOnData((AliVTrack*)vtrack);
465 else tofTime=vtrack->GetTOFsignal();
467 Double_t expTime = fTOFResponse.GetExpectedSignal(vtrack,type);
468 return (tofTime - fTOFResponse.GetStartTime(vtrack->P()) - expTime)/fTOFResponse.GetExpectedSigma(vtrack->P(),expTime,AliPID::ParticleMassZ(type));
471 //_________________________________________________________________________
472 void AliESDpid::SetMassForTracking(AliESDtrack *esdtr) const
474 // assign mass for tracking
476 int pid = AliPID::kPion; // this should be substituted by real most probable TPC pid (e,mu -> pion) or poin if no PID possible
478 if (pid<AliPID::kPion || pid>AliPID::kSPECIESC-1) pid = AliPID::kPion;
480 esdtr->SetMassForTracking( AliPID::ParticleCharge(pid)==1 ? AliPID::ParticleMass(pid) : -AliPID::ParticleMass(pid));
485 //_________________________________________________________________________
486 void AliESDpid::MakePIDForTracking(AliESDEvent *event) const
488 // assign masses using for tracking
489 Int_t nTrk=event->GetNumberOfTracks();
490 for (Int_t iTrk=nTrk; iTrk--;) {
491 AliESDtrack *track = event->GetTrack(iTrk);
492 SetMassForTracking(track);