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 // Class AliEMCALTracker
17 // -----------------------
18 // Implementation of the track matching method between barrel tracks and
20 // Besides algorithm implementation, some cuts are required to be set
21 // in order to define, for each track, an acceptance window where clusters
22 // are searched to find best match (if any).
23 // The class accepts as input an ESD container, and works directly on it,
24 // simply setting, for each of its tracks, the fEMCALindex flag, for each
25 // track which is matched to a cluster.
26 // In order to use method, one must launch PropagateBack().
28 // ------------------------------------------------------------------------
29 // author: A. Pulvirenti (alberto.pulvirenti@ct.infn.it)
30 // Revised by Rongrong 2010-05-31 (rongrong.ma@cern.ch)
31 //=========================================================================
33 #include <Riostream.h>
41 #include <TClonesArray.h>
42 #include <TGeoMatrix.h>
45 #include "AliESDEvent.h"
46 #include "AliESDtrack.h"
47 #include "AliESDCaloCluster.h"
48 #include "AliEMCALRecPoint.h"
49 #include "AliRunLoader.h"
50 #include "AliEMCALTrack.h"
51 #include "AliEMCALLoader.h"
52 #include "AliEMCALGeometry.h"
53 #include "AliEMCALReconstructor.h"
54 #include "AliEMCALRecParam.h"
55 #include "AliCDBEntry.h"
56 #include "AliCDBManager.h"
57 #include "AliEMCALReconstructor.h"
58 #include "AliEMCALRecoUtils.h"
60 #include "AliEMCALTracker.h"
64 ClassImp(AliEMCALTracker)
67 //------------------------------------------------------------------------------
69 AliEMCALTracker::AliEMCALTracker()
75 fTrackCorrMode(kTrackCorrMMB),
85 // Default constructor.
86 // Initializes all simple data members to default values,
87 // and all collections to NULL.
88 // Output file name is set to a default value.
93 //------------------------------------------------------------------------------
95 AliEMCALTracker::AliEMCALTracker(const AliEMCALTracker& copy)
98 fCutNITS(copy.fCutNITS),
99 fCutNTPC(copy.fCutNTPC),
101 fTrackCorrMode(copy.fTrackCorrMode),
102 fClusterWindow(copy.fClusterWindow),
103 fCutEta(copy.fCutEta),
104 fCutPhi(copy.fCutPhi),
105 fITSTrackSA(copy.fITSTrackSA),
106 fTracks((TObjArray*)copy.fTracks->Clone()),
107 fClusters((TObjArray*)copy.fClusters->Clone()),
112 // Besides copying all parameters, duplicates all collections.
116 //------------------------------------------------------------------------------
118 AliEMCALTracker& AliEMCALTracker::operator=(const AliEMCALTracker& source)
119 { // assignment operator; use copy ctor
120 if (&source == this) return *this;
122 new (this) AliEMCALTracker(source);
126 //------------------------------------------------------------------------------
128 void AliEMCALTracker::InitParameters()
131 // Retrieve initialization parameters
134 // Check if the instance of AliEMCALRecParam exists,
135 const AliEMCALRecParam* recParam = AliEMCALReconstructor::GetRecParam();
138 AliFatal("Reconstruction parameters for EMCAL not set!");
142 fCutEta = recParam->GetMthCutEta();
143 fCutPhi = recParam->GetMthCutPhi();
144 fStep = recParam->GetExtrapolateStep();
145 fCutPt = recParam->GetTrkCutPt();
146 fCutNITS = recParam->GetTrkCutNITS();
147 fCutNTPC = recParam->GetTrkCutNTPC();
153 //------------------------------------------------------------------------------
155 void AliEMCALTracker::Clear(Option_t* option)
159 // Deletes all objects in arrays and the arrays themselves
163 Bool_t clearTracks = opt.Contains("TRACKS");
164 Bool_t clearClusters = opt.Contains("CLUSTERS");
165 if (opt.Contains("ALL")) {
167 clearClusters = kTRUE;
170 //fTracks is a collection of esdTrack
171 //When clearing this array, the linked objects should not be deleted
172 if (fTracks != 0x0 && clearTracks) {
177 if (fClusters != 0x0 && clearClusters) {
184 //------------------------------------------------------------------------------
186 Int_t AliEMCALTracker::LoadClusters(TTree *cTree)
189 // Load EMCAL clusters in the form of AliEMCALRecPoint,
190 // from simulation temporary files.
191 // (When included in reconstruction chain, this method is used automatically)
196 cTree->SetBranchStatus("*",0); //disable all branches
197 cTree->SetBranchStatus("EMCALECARP",1); //Enable only the branch we need
199 TBranch *branch = cTree->GetBranch("EMCALECARP");
201 AliError("Can't get the branch with the EMCAL clusters");
205 TClonesArray *clusters = new TClonesArray("AliEMCALRecPoint", 1000);
206 branch->SetAddress(&clusters);
208 //cTree->GetEvent(0);
210 Int_t nClusters = (Int_t)clusters->GetEntries();
211 if(fClusters) fClusters->Delete();
212 else fClusters = new TObjArray(0);
213 for (Int_t i = 0; i < nClusters; i++) {
214 AliEMCALRecPoint *cluster = (AliEMCALRecPoint*)clusters->At(i);
215 if (!cluster) continue;
216 AliEMCALMatchCluster *matchCluster = new AliEMCALMatchCluster(i, cluster);
217 fClusters->AddLast(matchCluster);
220 branch->SetAddress(0);
224 AliInfo(Form("Collected %d RecPoints from Tree", fClusters->GetEntries()));
229 //------------------------------------------------------------------------------
231 Int_t AliEMCALTracker::LoadClusters(AliESDEvent *esd)
234 // Load EMCAL clusters in the form of AliESDCaloClusters,
235 // from an AliESD object.
238 // make sure that tracks/clusters collections are empty
240 fClusters = new TObjArray(0);
242 Int_t nClusters = esd->GetNumberOfCaloClusters();
243 for (Int_t i=0; i<nClusters; i++)
245 AliESDCaloCluster *cluster = esd->GetCaloCluster(i);
246 if (!cluster || !cluster->IsEMCAL()) continue ;
247 AliEMCALMatchCluster *matchCluster = new AliEMCALMatchCluster(i, cluster);
248 fClusters->AddLast(matchCluster);
251 AliInfo(Form("Collected %d clusters from ESD", fClusters->GetEntries()));
255 //------------------------------------------------------------------------------
257 Int_t AliEMCALTracker::LoadTracks(AliESDEvent *esd)
263 UInt_t mask1 = esd->GetESDRun()->GetDetectorsInDAQ();
264 UInt_t mask2 = esd->GetESDRun()->GetDetectorsInReco();
265 Bool_t desc1 = (mask1 >> 3) & 0x1;
266 Bool_t desc2 = (mask2 >> 3) & 0x1;
267 if (desc1==0 || desc2==0) {
268 // AliError(Form("TPC not in DAQ/RECO: %u (%u)/%u (%u)",
269 // mask1, esd->GetESDRun()->GetDetectorsInReco(),
270 // mask2, esd->GetESDRun()->GetDetectorsInDAQ()));
275 fTracks = new TObjArray(0);
277 Int_t nTracks = esd->GetNumberOfTracks();
278 //Bool_t isKink=kFALSE;
279 for (Int_t i = 0; i < nTracks; i++)
281 AliESDtrack *esdTrack = esd->GetTrack(i);
282 // set by default the value corresponding to "no match"
283 esdTrack->SetEMCALcluster(kUnmatched);
284 esdTrack->ResetStatus(AliESDtrack::kEMCALmatch);
286 //Select good quaulity tracks
287 if(esdTrack->Pt()<fCutPt) continue;
289 if(esdTrack->GetNcls(1)<fCutNTPC)continue;
291 //Loose geometric cut
292 Double_t phi = esdTrack->Phi()*TMath::RadToDeg();
293 if(TMath::Abs(esdTrack->Eta())>0.8 || phi <= 20 || phi >= 240 ) continue;
295 fTracks->AddLast(esdTrack);
298 AliInfo(Form("Collected %d tracks", fTracks->GetEntries()));
302 //------------------------------------------------------------------------------
304 void AliEMCALTracker::SetTrackCorrectionMode(Option_t *option)
307 // Set track correction mode
308 // gest the choice in string format and converts into
315 if (!opt.CompareTo("NONE"))
317 fTrackCorrMode = kTrackCorrNone;
319 else if (!opt.CompareTo("MMB"))
321 fTrackCorrMode = kTrackCorrMMB;
325 cerr << "E-AliEMCALTracker::SetTrackCorrectionMode '" << option << "': Unrecognized option" << endl;
329 //------------------------------------------------------------------------------
331 Int_t AliEMCALTracker::PropagateBack(AliESDEvent* esd)
334 // Main operation method.
335 // Gets external AliESD containing tracks to be matched.
336 // After executing match finding, stores in the same ESD object all infos
337 // and releases the object for further reconstruction steps.
340 // Note: should always return 0=OK, because otherwise all tracking
341 // is aborted for this event
344 AliError("NULL ESD passed");
348 // step 1: collect clusters
349 Int_t okLoadClusters, nClusters;
350 if (!fClusters || (fClusters && fClusters->IsEmpty())) {
351 okLoadClusters = LoadClusters(esd);
353 nClusters = fClusters->GetEntries();
355 // step 2: collect ESD tracks
356 Int_t nTracks, okLoadTracks;
357 okLoadTracks = LoadTracks(esd);
358 nTracks = fTracks->GetEntries();
360 // step 3: for each track, find the closest cluster as matched within residual cuts
362 for (Int_t it = 0; it < nTracks; it++)
364 AliESDtrack *track = (AliESDtrack*)fTracks->At(it);
365 index = FindMatchedCluster(track);
368 AliEMCALMatchCluster *cluster = (AliEMCALMatchCluster*)fClusters->At(index);
369 track->SetEMCALcluster(cluster->Index());
370 track->SetStatus(AliESDtrack::kEMCALmatch);
378 //------------------------------------------------------------------------------
380 Int_t AliEMCALTracker::FindMatchedCluster(AliESDtrack *track)
383 // For each track, extrapolate it to all the clusters
384 // Find the closest one as matched if the residuals (dEta, dPhi) satisfy the cuts
387 Float_t maxEta=fCutEta;
388 Float_t maxPhi=fCutPhi;
391 // If the esdFriend is available, use the TPCOuter point as the starting point of extrapolation
392 // Otherwise use the TPCInner point
393 AliExternalTrackParam *trkParam = 0;
396 const AliESDfriendTrack* friendTrack = track->GetFriendTrack();
397 if(friendTrack && friendTrack->GetTPCOut())
398 trkParam = const_cast<AliExternalTrackParam*>(friendTrack->GetTPCOut());
399 else if(track->GetInnerParam())
400 trkParam = const_cast<AliExternalTrackParam*>(track->GetInnerParam());
403 trkParam = new AliExternalTrackParam(*track);
405 if(!trkParam) return index;
407 AliExternalTrackParam trkParamTmp(*trkParam);
409 if(!AliEMCALRecoUtils::ExtrapolateTrackToEMCalSurface(&trkParamTmp, 430., track->GetMass(kTRUE), fStep, eta, phi)) {
410 if(fITSTrackSA) delete trkParam;
413 track->SetTrackPhiEtaOnEMCal(phi,eta);
414 if(TMath::Abs(eta)>0.75 || (phi) < 70*TMath::DegToRad() || (phi) > 190*TMath::DegToRad()){
415 if(fITSTrackSA) delete trkParam;
419 //Perform extrapolation
421 trkParamTmp.GetXYZ(trkPos);
422 Int_t nclusters = fClusters->GetEntries();
423 for(Int_t ic=0; ic<nclusters; ic++)
425 AliEMCALMatchCluster *cluster = (AliEMCALMatchCluster*)fClusters->At(ic);
426 Float_t clsPos[3] = {cluster->X(),cluster->Y(),cluster->Z()};
427 Double_t dR = TMath::Sqrt(TMath::Power(trkPos[0]-clsPos[0],2)+TMath::Power(trkPos[1]-clsPos[1],2)+TMath::Power(trkPos[2]-clsPos[2],2));
428 // printf("\n dR=%f,wind=%f\n",dR,fClusterWindow); //MARCEL
429 if(dR > fClusterWindow) continue;
431 AliExternalTrackParam trkParTmp(trkParamTmp);
433 Float_t tmpEta, tmpPhi;
434 if(!AliEMCALRecoUtils::ExtrapolateTrackToPosition(&trkParTmp, clsPos,track->GetMass(kTRUE), 5, tmpEta, tmpPhi)) continue;
435 if(TMath::Abs(tmpPhi)<TMath::Abs(maxPhi) && TMath::Abs(tmpEta)<TMath::Abs(maxEta))
443 if(fITSTrackSA) delete trkParam;
448 //------------------------------------------------------------------------------
450 void AliEMCALTracker::UnloadClusters()
453 // Free memory from all arrays
454 // This method is called after the local tracking step
455 // so we can safely delete everything
462 //------------------------------------------------------------------------------
464 AliEMCALTracker::AliEMCALMatchCluster::AliEMCALMatchCluster(Int_t index, AliEMCALRecPoint *recPoint)
471 // Translates an AliEMCALRecPoint object into the internal format.
472 // Index of passed cluster in its native array must be specified.
475 recPoint->GetGlobalPosition(clpos);
482 //------------------------------------------------------------------------------
484 AliEMCALTracker::AliEMCALMatchCluster::AliEMCALMatchCluster(Int_t index, AliESDCaloCluster *caloCluster)
491 // Translates an AliESDCaloCluster object into the internal format.
492 // Index of passed cluster in its native array must be specified.
494 Float_t clpos[3]= {0., 0., 0.};
495 caloCluster->GetPosition(clpos);
497 fX = (Double_t)clpos[0];
498 fY = (Double_t)clpos[1];
499 fZ = (Double_t)clpos[2];