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 **************************************************************************/
26 #include <TMCProcess.h>
28 #include "AliAnalysisTaskPhiCorrelations.h"
29 #include "AliAnalyseLeadingTrackUE.h"
30 #include "AliUEHistograms.h"
31 #include "AliUEHist.h"
33 #include "AliAnalysisHelperJetTasks.h"
34 #include "AliAnalysisManager.h"
35 #include "AliAODHandler.h"
36 #include "AliAODInputHandler.h"
37 #include "AliAODMCParticle.h"
38 #include "AliGenPythiaEventHeader.h"
39 #include "AliInputEventHandler.h"
41 #include "AliMCEventHandler.h"
42 #include "AliVParticle.h"
43 #include "AliCFContainer.h"
45 #include "AliESDEvent.h"
46 #include "AliESDInputHandler.h"
47 #include "AliMultiplicity.h"
48 #include "AliCentrality.h"
51 #include "AliEventPoolManager.h"
54 ////////////////////////////////////////////////////////////////////////
56 // Analysis class for azimuthal correlation studies
57 // Based on the UE task from Sara Vallero and Jan Fiete
59 // This class needs input AODs.
60 // The output is a list of analysis-specific containers.
62 // The AOD can be either connected to the InputEventHandler
63 // for a chain of AOD files
65 // to the OutputEventHandler
66 // for a chain of ESD files,
67 // in this case the class should be in the train after the jet-finder
70 // Jan Fiete Grosse-Oetringhaus
72 ////////////////////////////////////////////////////////////////////////
75 ClassImp( AliAnalysisTaskPhiCorrelations )
77 //____________________________________________________________________
78 AliAnalysisTaskPhiCorrelations:: AliAnalysisTaskPhiCorrelations(const char* name):
79 AliAnalysisTask(name,""),
80 // general configuration
83 fReduceMemoryFootprint(kFALSE),
85 fCompareCentralities(kFALSE),
86 fTwoTrackEfficiencyStudy(kFALSE),
87 // pointers to UE classes
91 fkTrackingEfficiency(0x0),
92 // handlers and events
100 // histogram settings
103 fnTracksVertex(1), // QA tracks pointing to principal vertex (= 3 default)
105 fCentralityMethod("V0M"),
111 fUseChargeHadrons(kFALSE),
114 // Default constructor
115 // Define input and output slots here
116 // Input slot #0 works with a TChain
117 DefineInput(0, TChain::Class());
118 // Output slot #0 writes into a TList container
119 DefineOutput(0, TList::Class());
122 AliAnalysisTaskPhiCorrelations::~AliAnalysisTaskPhiCorrelations()
126 if (fListOfHistos && !AliAnalysisManager::GetAnalysisManager()->IsProofMode())
127 delete fListOfHistos;
130 //____________________________________________________________________
131 void AliAnalysisTaskPhiCorrelations::ConnectInputData(Option_t* /*option*/)
134 // Connect the input data
135 if (fDebug > 1) AliInfo("ConnectInputData() ");
137 // Since AODs can either be connected to the InputEventHandler
138 // or to the OutputEventHandler ( the AOD is created by a previus task in the train )
139 // we need to get the pointer to the AODEvent correctly.
141 // Delta AODs are also accepted.
143 TObject* handler = AliAnalysisManager::GetAnalysisManager()->GetInputEventHandler();
145 if( handler && handler->InheritsFrom("AliAODInputHandler") )
147 fAOD = ((AliAODInputHandler*)handler)->GetEvent();
148 if (fDebug > 1) AliInfo(" ==== Tracks and Jets from AliAODInputHandler");
152 handler = AliAnalysisManager::GetAnalysisManager()->GetOutputEventHandler();
153 if (handler && handler->InheritsFrom("AliAODHandler") )
155 fAOD = ((AliAODHandler*)handler)->GetAOD();
156 if (fDebug > 1) AliInfo(" ==== Tracks and Jets from AliAODHandler");
160 AliWarning("I can't get any AOD Event Handler");
164 if (handler && handler->InheritsFrom("AliESDInputHandler") )
166 // pointer received per event in ::Exec
167 if (fDebug > 1) AliInfo(" ==== Tracks and Jets from AliESDInputHandler");
170 // Initialize common pointers
174 //____________________________________________________________________
175 void AliAnalysisTaskPhiCorrelations::CreateOutputObjects()
177 // Create the output container
179 if (fDebug > 1) AliInfo("CreateOutputObjects()");
181 // Initialize class with main algorithms, event and track selection.
182 fAnalyseUE = new AliAnalyseLeadingTrackUE();
183 fAnalyseUE->SetParticleSelectionCriteria(fFilterBit, fUseChargeHadrons, fTrackEtaCut, fPtMin);
184 fAnalyseUE->SetDebug(fDebug);
185 fAnalyseUE->DefineESDCuts(fFilterBit);
187 // Initialize output list of containers
188 if (fListOfHistos != NULL){
189 delete fListOfHistos;
190 fListOfHistos = NULL;
193 fListOfHistos = new TList();
194 fListOfHistos->SetOwner(kTRUE);
197 // Initialize class to handle histograms
198 fHistos = new AliUEHistograms("AliUEHistogramsSame", "4");
199 fHistosMixed = new AliUEHistograms("AliUEHistogramsMixed", "4");
201 fHistos->SetSelectCharge(fSelectCharge);
202 fHistosMixed->SetSelectCharge(fSelectCharge);
204 // add histograms to list
205 fListOfHistos->Add(fHistos);
206 fListOfHistos->Add(fHistosMixed);
208 fListOfHistos->Add(new TH2F("trackletsVsV0Cent", ";L1 clusters;v0 centrality", 100, -0.5, 9999.5, 101, 0, 101));
209 fListOfHistos->Add(new TH2F("processIDs", ";#Delta#phi;process id", 100, -0.5 * TMath::Pi(), 1.5 * TMath::Pi(), kPNoProcess + 1, -0.5, kPNoProcess + 0.5));
211 PostData(0,fListOfHistos);
213 // Add task configuration to output list
217 // Int_t trackDepth = 100; // Require e.g. 20 5-track events, or 2 50-track events
218 Int_t trackDepth = 5000;
219 Int_t poolsize = 100; // Maximum number of events
221 Int_t nCentralityBins = fHistos->GetUEHist(2)->GetEventHist()->GetNBins(1);
222 Double_t* centralityBins = (Double_t*) fHistos->GetUEHist(2)->GetEventHist()->GetAxis(1, 0)->GetXbins()->GetArray();
225 Double_t vertexBins[] = { -7, -5, -3, -1, 1, 3, 5, 7 };
226 Double_t* zvtxbin = vertexBins;
228 if (fHistos->GetUEHist(2)->GetEventHist()->GetNVar() > 2)
230 nZvtxBins = fHistos->GetUEHist(2)->GetEventHist()->GetNBins(2);
231 zvtxbin = (Double_t*) fHistos->GetUEHist(2)->GetEventHist()->GetAxis(2, 0)->GetXbins()->GetArray();
234 fPoolMgr = new AliEventPoolManager(poolsize, trackDepth, nCentralityBins, centralityBins, nZvtxBins, zvtxbin);
237 //____________________________________________________________________
238 void AliAnalysisTaskPhiCorrelations::Exec(Option_t */*option*/)
240 // array of MC particles
244 fArrayMC = dynamic_cast<TClonesArray*>(fAOD->FindListObject(AliAODMCParticle::StdBranchName()));
246 AliFatal("No array of MC particles found !!!");
248 fMcEvent = fMcHandler->MCEvent();
251 // receive ESD pointer if we are not running AOD analysis
254 AliVEventHandler* handler = AliAnalysisManager::GetAnalysisManager()->GetInputEventHandler();
255 if (handler && handler->InheritsFrom("AliESDInputHandler"))
256 fESD = ((AliESDInputHandler*)handler)->GetEvent();
260 if (fMode) AnalyseCorrectionMode();
261 else AnalyseDataMode();
264 /******************** ANALYSIS METHODS *****************************/
266 //____________________________________________________________________
267 void AliAnalysisTaskPhiCorrelations::AddSettingsTree()
269 //Write settings to output list
270 TTree *settingsTree = new TTree("UEAnalysisSettings","Analysis Settings in UE estimation");
271 settingsTree->Branch("fFilterBit", &fFilterBit,"FilterBit/I");
272 settingsTree->Branch("fSelectBit", &fSelectBit,"EventSelectionBit/I");
273 settingsTree->Branch("fTrackEtaCut", &fTrackEtaCut, "TrackEtaCut/D");
274 settingsTree->Branch("fPtMin", &fPtMin, "PtMin/D");
275 settingsTree->Branch("fUseChargeHadrons", &fUseChargeHadrons,"UseChHadrons/O");
276 settingsTree->Branch("fkTrackingEfficiency", "TH1D", &fkTrackingEfficiency);
277 settingsTree->Fill();
278 fListOfHistos->Add(settingsTree);
281 //____________________________________________________________________
282 void AliAnalysisTaskPhiCorrelations::AnalyseCorrectionMode()
284 // Run the analysis on MC to get the correction maps
287 if ( fDebug > 3 ) AliInfo( " Processing event in Corrections mode ..." );
289 Double_t centrality = 0;
291 if (fCentralityMethod.Length() > 0)
293 AliCentrality *centralityObj = 0;
295 centralityObj = fAOD->GetHeader()->GetCentralityP();
297 centralityObj = fESD->GetCentrality();
301 centrality = centralityObj->GetCentralityPercentileUnchecked(fCentralityMethod);
302 AliInfo(Form("Centrality is %f", centrality));
306 Printf("WARNING: Centrality object is 0");
311 // Support for ESD and AOD based analysis
312 AliVEvent* inputEvent = fAOD;
316 TObject* mc = fArrayMC;
321 fHistos->FillEvent(centrality, -1);
323 // Only consider MC events within the vtx-z region used also as cut on the reconstructed vertex
324 if (!fAnalyseUE->VertexSelection(fMcEvent, 0, fZVertex))
327 Float_t zVtx = fMcEvent->GetPrimaryVertex()->GetZ();
330 TObjArray* tracksMC = fAnalyseUE->GetAcceptedParticles(mc, 0, kTRUE, -1, kTRUE);
332 // (MC-true all particles)
334 fHistos->FillCorrelations(centrality, zVtx, AliUEHist::kCFStepAll, tracksMC);
336 // Trigger selection ************************************************
337 if (fAnalyseUE->TriggerSelection(fInputHandler))
339 // (MC-true all particles)
341 if (!fReduceMemoryFootprint)
342 fHistos->FillCorrelations(centrality, zVtx, AliUEHist::kCFStepTriggered, tracksMC);
344 fHistos->FillEvent(centrality, AliUEHist::kCFStepTriggered);
347 AliFatal("UNEXPECTED: inputEvent is 0. Trigger selection should have failed");
351 // Vertex selection *************************************************
352 if (fAnalyseUE->VertexSelection(inputEvent, fnTracksVertex, fZVertex))
354 // fill here for tracking efficiency
355 // loop over particle species
357 for (Int_t particleSpecies = 0; particleSpecies < 4; particleSpecies++)
359 TObjArray* primMCParticles = fAnalyseUE->GetAcceptedParticles(mc, 0x0, kTRUE, particleSpecies, kTRUE);
360 TObjArray* primRecoTracksMatched = fAnalyseUE->GetAcceptedParticles(inputEvent, mc, kTRUE, particleSpecies, kTRUE);
361 TObjArray* allRecoTracksMatched = fAnalyseUE->GetAcceptedParticles(inputEvent, mc, kFALSE, particleSpecies, kTRUE);
363 fHistos->FillTrackingEfficiency(primMCParticles, primRecoTracksMatched, allRecoTracksMatched, particleSpecies, centrality);
365 // Printf("%d --> %d %d %d", particleSpecies, primMCParticles->GetEntries(), primRecoTracksMatched->GetEntries(), allRecoTracksMatched->GetEntries());
367 delete primMCParticles;
368 delete primRecoTracksMatched;
369 delete allRecoTracksMatched;
372 // (MC-true all particles)
374 if (!fReduceMemoryFootprint)
375 fHistos->FillCorrelations(centrality, zVtx, AliUEHist::kCFStepVertex, tracksMC);
377 fHistos->FillEvent(centrality, AliUEHist::kCFStepVertex);
379 // Get MC primaries that match reconstructed track
380 TObjArray* tracksRecoMatchedPrim = fAnalyseUE->GetAcceptedParticles(inputEvent, mc, kTRUE, -1, kTRUE);
382 // (RECO-matched (quantities from MC particle) primary particles)
384 fHistos->FillCorrelations(centrality, zVtx, AliUEHist::kCFStepTrackedOnlyPrim, tracksRecoMatchedPrim);
386 // Get MC primaries + secondaries that match reconstructed track
387 TObjArray* tracksRecoMatchedAll = fAnalyseUE->GetAcceptedParticles(inputEvent, mc, kFALSE, -1, kTRUE);
389 // (RECO-matched (quantities from MC particle) all particles)
391 fHistos->FillCorrelations(centrality, zVtx, AliUEHist::kCFStepTracked, tracksRecoMatchedAll);
394 TObjArray* tracks = fAnalyseUE->GetAcceptedParticles(inputEvent, 0, kTRUE, -1, kTRUE);
398 fHistos->FillCorrelations(centrality, zVtx, AliUEHist::kCFStepReconstructed, tracks);
400 if (0 && !fReduceMemoryFootprint)
402 // make list of secondaries (matched with MC)
403 TObjArray* tracksRecoMatchedSecondaries = new TObjArray;
404 for (Int_t i=0; i<tracksRecoMatchedAll->GetEntries(); i++)
405 if (((AliAODMCParticle*)tracksRecoMatchedAll->At(i))->IsPhysicalPrimary() == kFALSE)
406 tracksRecoMatchedSecondaries->Add(tracksRecoMatchedAll->At(i));
408 // Study: Use only secondaries as trigger particles and plot the correlation vs. all particles; store in step 9
409 fHistos->FillCorrelations(centrality, zVtx, AliUEHist::kCFStepBiasStudy2, tracksRecoMatchedSecondaries, tracksRecoMatchedAll);
411 // Study: Use only primaries as trigger particles and plot the correlation vs. secondaries; store in step 8
412 fHistos->FillCorrelations(centrality, zVtx, AliUEHist::kCFStepBiasStudy, tracksRecoMatchedPrim, tracksRecoMatchedSecondaries);
414 // plot delta phi vs process id of secondaries
415 // trigger particles: primaries in 4 < pT < 10
416 // associated particles: secondaries in 1 < pT < 10
418 for (Int_t i=0; i<tracksRecoMatchedPrim->GetEntries(); i++)
420 AliVParticle* triggerParticle = (AliVParticle*) tracksRecoMatchedPrim->At(i);
422 if (triggerParticle->Pt() < 4 || triggerParticle->Pt() > 10)
425 for (Int_t j=0; j<tracksRecoMatchedSecondaries->GetEntries(); j++)
427 AliAODMCParticle* particle = (AliAODMCParticle*) tracksRecoMatchedSecondaries->At(j);
429 if (particle->Pt() < 1 || particle->Pt() > 10)
432 if (particle->Pt() > triggerParticle->Pt())
435 Double_t deltaPhi = triggerParticle->Phi() - particle->Phi();
436 if (deltaPhi > 1.5 * TMath::Pi())
437 deltaPhi -= TMath::TwoPi();
438 if (deltaPhi < -0.5 * TMath::Pi())
439 deltaPhi += TMath::TwoPi();
441 Int_t processID = fMcEvent->Stack()->Particle(particle->GetLabel())->GetUniqueID();
443 ((TH2F*) fListOfHistos->FindObject("processIDs"))->Fill(deltaPhi, processID);
447 delete tracksRecoMatchedSecondaries;
450 delete tracksRecoMatchedPrim;
451 delete tracksRecoMatchedAll;
459 //____________________________________________________________________
460 void AliAnalysisTaskPhiCorrelations::AnalyseDataMode()
463 // Run the analysis on DATA or MC to get raw distributions
465 if ( fDebug > 3 ) AliInfo( " Processing event in Data mode ..." );
467 // skip not selected events here (the AOD is not updated for those)
471 if (!(fInputHandler->IsEventSelected() & (AliVEvent::kMB | AliVEvent::kUserDefined)))
474 Double_t centrality = 0;
476 AliCentrality *centralityObj = 0;
477 if (fCentralityMethod.Length() > 0)
480 centralityObj = fAOD->GetHeader()->GetCentralityP();
482 centralityObj = fESD->GetCentrality();
485 centrality = centralityObj->GetCentralityPercentile(fCentralityMethod);
486 //centrality = centralityObj->GetCentralityPercentileUnchecked(fCentralityMethod);
489 AliInfo(Form("Centrality is %f", centrality));
492 // Support for ESD and AOD based analysis
493 AliVEvent* inputEvent = fAOD;
497 fHistos->SetRunNumber(inputEvent->GetRunNumber());
499 // Fill the "event-counting-container", it is needed to get the number of events remaining after each event-selection cut
500 fHistos->FillEvent(centrality, AliUEHist::kCFStepAll);
502 // Trigger selection ************************************************
503 if (!fAnalyseUE->TriggerSelection(fInputHandler)) return;
505 // Fill the "event-counting-container", it is needed to get the number of events remaining after each event-selection cut
506 fHistos->FillEvent(centrality, AliUEHist::kCFStepTriggered);
508 // Vertex selection *************************************************
509 if(!fAnalyseUE->VertexSelection(inputEvent, fnTracksVertex, fZVertex)) return;
511 // Fill the "event-counting-container", it is needed to get the number of events remaining after each event-selection cut
512 fHistos->FillEvent(centrality, AliUEHist::kCFStepVertex);
515 if (centrality < 0 && !fCompareCentralities)
518 TObjArray* tracks = fAnalyseUE->GetAcceptedParticles(inputEvent, 0, kTRUE, -1, kTRUE);
519 //Printf("Accepted %d tracks", tracks->GetEntries());
521 const AliVVertex* vertex = inputEvent->GetPrimaryVertex();
522 Double_t zVtx = vertex->GetZ();
524 // fill two different centralities (syst study)
525 // the zvtx axis is used to distinguish the results of both centralities: configured centrality in zvtx = 0, SPD in zvtx = 2
526 if (fCompareCentralities)
529 // Fill containers at STEP 6 (reconstructed)
531 fHistos->FillCorrelations(centrality, zVtx, AliUEHist::kCFStepReconstructed, tracks);
533 // Two-track effect study
534 if (fTwoTrackEfficiencyStudy)
536 TObjArray* reduced = fHistos->ApplyTwoTrackCut(tracks);
538 fHistos->FillCorrelations(centrality, zVtx, AliUEHist::kCFStepBiasStudy, reduced);
542 // fill second time with SPD centrality
543 if (fCompareCentralities && centralityObj)
545 centrality = centralityObj->GetCentralityPercentile("CL1");
547 fHistos->FillCorrelations(centrality, 2, AliUEHist::kCFStepReconstructed, tracks);
554 // 1. First get an event pool corresponding in mult (cent) and
555 // zvertex to the current event. Once initialized, the pool
556 // should contain nMix (reduced) events. This routine does not
557 // pre-scan the chain. The first several events of every chain
558 // will be skipped until the needed pools are filled to the
559 // specified depth. If the pool categories are not too rare, this
560 // should not be a problem. If they are rare, you could lose
563 // 2. Collect the whole pool's content of tracks into one TObjArray
564 // (bgTracks), which is effectively a single background super-event.
566 // 3. The reduced and bgTracks arrays must both be passed into
567 // FillCorrelations(). Also nMix should be passed in, so a weight
568 // of 1./nMix can be applied.
570 AliEventPool* pool = fPoolMgr->GetEventPool(centrality, zVtx);
573 AliFatal(Form("No pool found for centrality = %f, zVtx = %f", centrality, zVtx));
580 Int_t nMix = pool->GetCurrentNEvents();
581 //cout << "nMix = " << nMix << endl;
583 // Fill mixed-event histos here
584 for (Int_t jMix=0; jMix<nMix; jMix++) {
585 TObjArray* bgTracks = pool->GetEvent(jMix);
586 fHistosMixed->FillCorrelations(centrality, zVtx, AliUEHist::kCFStepReconstructed, tracks, bgTracks, 1.0 / nMix, (jMix == 0));
590 // clone and give ownership to event pool
591 TObjArray* tracksClone = (TObjArray*) tracks->Clone();
592 tracksClone->SetOwner(kTRUE);
594 pool->UpdatePool(tracksClone);
601 //____________________________________________________________________
602 void AliAnalysisTaskPhiCorrelations::Initialize()
605 fInputHandler = (AliInputEventHandler*)
606 ((AliAnalysisManager::GetAnalysisManager())->GetInputEventHandler());
608 fMcHandler = dynamic_cast<AliMCEventHandler*> (AliAnalysisManager::GetAnalysisManager()->GetMCtruthEventHandler());