4 /* Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
5 * See cxx source for full Copyright notice */
7 /* $Id: AliUEHist.h 20164 2007-08-14 15:31:50Z morsch $ */
9 // encapsulate histogram and corrections for one underlying event histogram
22 class AliCFGridSparse;
24 class AliUEHist : public TObject
27 AliUEHist(const char* reqHist = "");
30 const UInt_t fkRegions;
31 enum Region { kToward = 0, kAway, kMin, kMax };
33 static const Int_t fgkCFSteps;
34 enum CFStep { kCFStepAll = 0, kCFStepTriggered, kCFStepVertex, kCFStepAnaTopology, kCFStepTrackedOnlyPrim, kCFStepTracked, kCFStepReconstructed, kCFStepRealLeading, kCFStepBiasStudy, kCFStepBiasStudy2 };
36 const char* GetRegionTitle(Region region);
37 const char* GetStepTitle(CFStep step);
39 AliCFContainer* GetTrackHist(Region region) { return fTrackHist[region]; }
40 AliCFContainer* GetEventHist() { return fEventHist; }
41 AliCFContainer* GetTrackHistEfficiency() { return fTrackHistEfficiency; }
43 void SetTrackHist(Region region, AliCFContainer* hist) { fTrackHist[region] = hist; }
44 void SetEventHist(AliCFContainer* hist) { fEventHist = hist; }
45 void SetTrackHistEfficiency(AliCFContainer* hist) { fTrackHistEfficiency = hist; }
47 void CopyReconstructedData(AliUEHist* from);
49 TH1* GetUEHist(CFStep step, Region region, Float_t ptLeadMin = -1, Float_t ptLeadMax = -1, Int_t multBinBegin = 0, Int_t multBinEnd = -1, Int_t twoD = 0, Bool_t etaNorm = kTRUE);
50 TH1* GetPtHist(CFStep step, Region region, Float_t ptLeadMin, Float_t ptLeadMax, Int_t multBinBegin, Int_t multBinEnd, Float_t phiMin, Float_t phiMax, Float_t etaMin, Float_t etaMax, Bool_t skipPhiNormalization = kFALSE);
52 TH1* GetTrackEfficiency(CFStep step1, CFStep step2, Int_t axis1, Int_t axis2 = -1, Int_t source = 1, Int_t axis3 = -1);
53 TH1* GetEventEfficiency(CFStep step1, CFStep step2, Int_t axis1, Int_t axis2 = -1, Float_t ptLeadMin = -1, Float_t ptLeadMax = -1);
54 TH1* GetBias(CFStep step1, CFStep step2, Int_t region, const char* axis, Float_t leadPtMin = 0, Float_t leadPtMax = -1, Int_t weighting = 0);
56 TH1D* GetTrackingEfficiency(Int_t axis);
57 TH2D* GetTrackingEfficiency();
58 TH2D* GetTrackingEfficiencyCentrality();
60 TH1D* GetTrackingContamination(Int_t axis);
61 TH2D* GetTrackingContamination();
62 TH2D* GetTrackingContaminationCentrality();
64 TH1D* GetTrackingCorrection(Int_t axis);
65 TH2D* GetTrackingCorrection();
67 TH1D* GetTrackingEfficiencyCorrection(Int_t axis);
68 TH2D* GetTrackingEfficiencyCorrection();
69 TH2D* GetTrackingEfficiencyCorrectionCentrality();
71 TH2* GetCorrelatedContamination();
73 void ExtendTrackingEfficiency(Bool_t verbose = kFALSE);
75 void Correct(AliUEHist* corrections);
76 void CorrectTracks(CFStep step1, CFStep step2, TH1* trackCorrection, Int_t var1, Int_t var2 = -1);
77 void CorrectTracks(CFStep step1, CFStep step2, Int_t region, TH1* trackCorrection, Int_t var1, Int_t var2 = -1);
78 void CorrectEvents(CFStep step1, CFStep step2, TH1* eventCorrection, Int_t var1, Int_t var2 = -1);
79 void CorrectCorrelatedContamination(CFStep step1, Int_t region, TH1* trackCorrection);
81 void SetCombineMinMax(Bool_t flag) { fCombineMinMax = flag; }
83 void SetEtaRange(Float_t etaMin, Float_t etaMax) { fEtaMin = etaMin; fEtaMax = etaMax; }
84 void SetPtRange(Float_t ptMin, Float_t ptMax) { fPtMin = ptMin; fPtMax = ptMax; }
85 void SetCentralityRange(Float_t min, Float_t max) { fCentralityMin = min; fCentralityMax = max; }
86 void SetZVtxRange(Float_t min, Float_t max) { fZVtxMin = min; fZVtxMax = max; }
88 void SetContaminationEnhancement(TH1F* hist) { fContaminationEnhancement = hist; }
90 void SetHistogramType(const char* histogramType) { fHistogramType = histogramType; }
92 void CountEmptyBins(AliUEHist::CFStep step, Float_t ptLeadMin, Float_t ptLeadMax);
94 void AdditionalDPhiCorrection(Int_t step);
96 void SetBinLimits(AliCFGridSparse* grid);
97 void ResetBinLimits(AliCFGridSparse* grid);
99 AliUEHist(const AliUEHist &c);
100 AliUEHist& operator=(const AliUEHist& corr);
101 virtual void Copy(TObject& c) const;
103 virtual Long64_t Merge(TCollection* list);
104 void Scale(Double_t factor);
108 void SetStepNames(AliCFContainer* container);
109 void WeightHistogram(TH3* hist1, TH1* hist2);
111 AliCFContainer* fTrackHist[4]; // container for track level distributions in four regions (toward, away, min, max) and at four analysis steps
112 AliCFContainer* fEventHist; // container for event level distribution at four analysis steps
113 AliCFContainer* fTrackHistEfficiency; // container for tracking efficiency and contamination (all particles filled including leading one): axes: eta, pT, particle species
115 Float_t fEtaMin; // eta min for projections
116 Float_t fEtaMax; // eta max for projections
117 Float_t fPtMin; // pT min for projections (for track pT, not pT,lead)
118 Float_t fPtMax; // pT max for projections (for track pT, not pT,lead)
119 Float_t fCentralityMin; // centrality min for projections
120 Float_t fCentralityMax; // centrality max for projections
121 Float_t fZVtxMin; // z vtx min for projections
122 Float_t fZVtxMax; // z vtx max for projections
124 TH1F* fContaminationEnhancement; // histogram that contains the underestimation of secondaries in the MC as function of pT
126 Bool_t fCombineMinMax; // flag to combine min and max to a general towards region
128 AliCFContainer* fCache; //! cache variable for GetTrackEfficiency
130 TString fHistogramType; // what is stored in this histogram
132 ClassDef(AliUEHist, 8) // underlying event histogram container