2 // Class that contains the forward multiplicity data per event
4 // This class contains a histogram of
6 // \frac{d^2N_{ch}}{d\eta d\phi}\quad,
8 // as well as a trigger mask for each analysed event.
10 // The eta acceptance of the event is stored in the underflow bins of
11 // the histogram. So to build the final histogram, one needs to
12 // correct for this acceptance (properly weighted by the events), and
13 // the vertex efficiency. This simply boils down to defining a 2D
14 // histogram and summing the event histograms in that histogram. One
15 // should of course also do proper book-keeping of the accepted event.
17 #include "AliAODForwardMult.h"
21 #include <TObjString.h>
22 #include <TObjArray.h>
24 ClassImp(AliAODForwardMult)
29 //____________________________________________________________________
30 const Float_t AliAODForwardMult::fgkInvalidIpZ = 1e6;
32 //____________________________________________________________________
33 AliAODForwardMult::AliAODForwardMult()
46 //____________________________________________________________________
47 AliAODForwardMult::AliAODForwardMult(Bool_t isMC)
49 fHist("forwardMult", "d^{2}N_{ch}/d#etad#varphi in the forward regions",
50 200, -4, 6, 20, 0, 2*TMath::Pi()),
60 // isMC If set to true this is for MC data (effects branch name)
62 fHist.SetXTitle("#eta");
63 fHist.SetYTitle("#varphi [radians]");
64 fHist.SetZTitle("#frac{d^{2}N_{ch}}{d#etad#varphi}");
65 fHist.SetDirectory(0);
69 //____________________________________________________________________
71 AliAODForwardMult::Init(const TAxis& etaAxis)
73 // Initialize the histogram with an eta axis
76 // etaAxis Eta axis to use
78 fHist.SetBins(etaAxis.GetNbins(), etaAxis.GetXmin(), etaAxis.GetXmax(),
79 20, 0, 2*TMath::Pi());
82 //____________________________________________________________________
84 AliAODForwardMult::Clear(Option_t* option)
86 // Clear (or reset) internal values
89 // option Passed to TH1::Reset
96 //____________________________________________________________________
98 AliAODForwardMult::SetSNN(UShort_t snn)
100 // set the center of mass energy per nucleon pair (GeV).
101 // This is stored in bin (0,0) of the histogram
104 // sNN Center of mass energy per nuclean
105 fHist.SetBinContent(0,0,snn);
107 //____________________________________________________________________
109 AliAODForwardMult::SetSystem(UShort_t sys)
111 // set the center of mass energy per nucleon pair (GeV).
112 // This is stored in bin (N+1,0) of the histogram
115 // sys Collision system number
116 fHist.SetBinContent(fHist.GetNbinsX()+1,0,sys);
119 //____________________________________________________________________
121 AliAODForwardMult::HasIpZ() const
123 // Check if we have valid z coordinate of the interaction point
126 // true if the z coordinate of the interaction point is valid
128 return TMath::Abs(fIpZ - fgkInvalidIpZ) > 1;
131 //____________________________________________________________________
133 AliAODForwardMult::GetSNN() const
135 // set the center of mass energy per nucleon pair (GeV).
136 // This is stored in bin (0,0) of the histogram
139 // sNN Center of mass energy per nuclean
140 return UShort_t(fHist.GetBinContent(0,0));
143 //____________________________________________________________________
145 AliAODForwardMult::GetSystem() const
147 // set the center of mass energy per nucleon pair (GeV).
148 // This is stored in bin (N+1,0) of the histogram
151 // sNN Center of mass energy per nuclean
152 return UShort_t(fHist.GetBinContent(fHist.GetNbinsX()+1,0));
155 //____________________________________________________________________
157 AliAODForwardMult::Browse(TBrowser* b)
159 // Browse this object
163 static TObjString ipz;
164 static TObjString trg;
165 static TObjString cnt;
166 static TObjString ncl;
167 ipz = Form("ip_z=%fcm", fIpZ);
168 trg = GetTriggerString(fTriggers);
169 cnt = Form("%+6.1f%%", fCentrality);
170 ncl = Form("%d clusters", fNClusters);
179 void AppendAnd(TString& trg, const TString& what)
181 if (!trg.IsNull()) trg.Append(" & ");
185 //____________________________________________________________________
187 AliAODForwardMult::GetTriggerString(UInt_t mask)
189 // Get a string that describes the triggers
192 // mask Bit pattern of triggers
194 // Character string representation of mask
197 if ((mask & kInel) != 0x0) AppendAnd(trg, "INEL");
198 if ((mask & kInelGt0) != 0x0) AppendAnd(trg, "INEL>0");
199 if ((mask & kNSD) != 0x0) AppendAnd(trg, "NSD");
200 if ((mask & kV0AND) != 0x0) AppendAnd(trg, "V0AND");
201 if ((mask & kA) != 0x0) AppendAnd(trg, "A");
202 if ((mask & kB) != 0x0) AppendAnd(trg, "B");
203 if ((mask & kC) != 0x0) AppendAnd(trg, "C");
204 if ((mask & kE) != 0x0) AppendAnd(trg, "E");
205 if ((mask & kMCNSD) != 0x0) AppendAnd(trg, "MCNSD");
206 if ((mask & kNClusterGt0) != 0x0) AppendAnd(trg, "NCluster>0");
207 if ((mask & kSatellite) != 0x0) AppendAnd(trg, "Satellite");
211 //____________________________________________________________________
213 AliAODForwardMult::MakeTriggerHistogram(const char* name, Int_t mask)
216 // Make a histogram to record triggers in.
218 // The bins defined by the trigger enumeration in this class. One
219 // can use this enumeration to retrieve the number of triggers for
223 // name Name of the histogram
226 // Newly allocated histogram
231 sel = GetTriggerString(mask);
232 andSel = GetTriggerString(mask & ~kB);
233 andSel.Prepend(" & ");
235 TH1I* ret = new TH1I(name, "Triggers", kAccepted+1, -.5, kAccepted+.5);
236 ret->SetYTitle("Events");
237 ret->SetFillColor(kRed+1);
238 ret->SetFillStyle(3001);
239 ret->GetXaxis()->SetBinLabel(kBinAll, "All events");
240 ret->GetXaxis()->SetBinLabel(kBinB, Form("B (Coll.)%s",
242 ret->GetXaxis()->SetBinLabel(kBinA, Form("A%s", andSel.Data()));
243 ret->GetXaxis()->SetBinLabel(kBinC, Form("C%s", andSel.Data()));
244 ret->GetXaxis()->SetBinLabel(kBinE, Form("E%s", andSel.Data()));
245 ret->GetXaxis()->SetBinLabel(kBinInel, "Coll. & INEL");
246 ret->GetXaxis()->SetBinLabel(kBinInelGt0, "Coll. & INEL>0");
247 ret->GetXaxis()->SetBinLabel(kBinNSD, "Coll. & NSD");
248 ret->GetXaxis()->SetBinLabel(kBinV0AND, "Coll. & V0AND");
249 ret->GetXaxis()->SetBinLabel(kBinMCNSD, "NSD (MC truth)");
250 ret->GetXaxis()->SetBinLabel(kBinSatellite, "Satellite");
251 ret->GetXaxis()->SetBinLabel(kBinPileUp, "w/Pileup");
252 ret->GetXaxis()->SetBinLabel(kBinOffline, "w/Offline");
253 ret->GetXaxis()->SetBinLabel(kBinNClusterGt0, "w/N_{cluster}>1");
254 ret->GetXaxis()->SetBinLabel(kWithVertex, "w/Vertex");
255 ret->GetXaxis()->SetBinLabel(kWithTrigger, Form("w/Selected trigger (%s)",
257 ret->GetXaxis()->SetBinLabel(kAccepted, "Accepted by cut");
258 ret->GetXaxis()->SetNdivisions(kAccepted, false);
264 //____________________________________________________________________
266 AliAODForwardMult::MakeStatusHistogram(const char* name)
269 // Make a histogram to record status in.
271 // The bins defined by the status enumeration in this class.
274 // name Name of the histogram
277 // Newly allocated histogram
279 TH1I* ret = new TH1I(name, "Event selection status",
280 kWrongVertex+1, -.5, kWrongVertex+.5);
281 ret->SetYTitle("Events");
282 ret->SetFillColor(kBlue+1);
283 ret->SetFillStyle(3001);
284 ret->GetXaxis()->SetBinLabel(kGoodEvent+1, "Good");
285 ret->GetXaxis()->SetBinLabel(kWrongCentrality+1, "Out-of-range centrality");
286 ret->GetXaxis()->SetBinLabel(kWrongTrigger+1, "Wrong trigger");
287 ret->GetXaxis()->SetBinLabel(kIsPileup+1, "Pile-up");
288 ret->GetXaxis()->SetBinLabel(kNoVertex+1, "No IP_{z}");
289 ret->GetXaxis()->SetBinLabel(kWrongVertex+1, "Out-or-range IP_{z}");
290 ret->GetXaxis()->SetNdivisions(kWrongVertex, false);
295 //____________________________________________________________________
297 AliAODForwardMult::MakeTriggerMask(const char* what)
299 UShort_t trgMask = 0;
302 TObjArray* parts = trgs.Tokenize("&");
305 while ((trg = static_cast<TObjString*>(next()))) {
306 TString s(trg->GetString());
307 s.Strip(TString::kBoth, ' ');
309 if (s.IsNull()) continue;
310 if (s.CompareTo("INEL") == 0) trgMask |= kInel;
311 else if (s.CompareTo("INEL>0") == 0) trgMask |= kInelGt0;
312 else if (s.CompareTo("INELGT0") == 0) trgMask |= kInelGt0;
313 else if (s.CompareTo("NSD") == 0) trgMask |= kNSD;
314 else if (s.CompareTo("V0AND") == 0) trgMask |= kV0AND;
315 else if (s.CompareTo("MCNSD") == 0) trgMask |= kMCNSD;
316 else if (s.CompareTo("B") == 0) trgMask |= kB;
317 else if (s.CompareTo("A") == 0) trgMask |= kA;
318 else if (s.CompareTo("C") == 0) trgMask |= kC;
319 else if (s.CompareTo("SAT") == 0) trgMask |= kSatellite;
320 else if (s.CompareTo("E") == 0) trgMask |= kE;
321 else if (s.CompareTo("NCLUSTER>0") == 0) trgMask |= kNClusterGt0;
322 else if (s.CompareTo("CENT") == 0) trgMask |= kInel;
323 // trgMask &= ~(kInel|kInelGt0|kNSD|kV0AND|kMCNSD);
325 AliWarningGeneral("MakeTriggerMask",
326 Form("Unknown trigger %s", s.Data()));
332 //____________________________________________________________________
334 AliAODForwardMult::CheckEvent(Int_t triggerMask,
335 Double_t vzMin, Double_t vzMax,
336 UShort_t cMin, UShort_t cMax,
337 TH1* hist, TH1* status) const
340 // Check if event meets the passses requirements.
342 // It returns true if @e all of the following is true
344 // - The trigger is within the bit mask passed.
345 // - The vertex is within the specified limits.
346 // - The centrality is within the specified limits, or if lower
347 // limit is equal to or larger than the upper limit.
349 // If a histogram is passed in the last parameter, then that
350 // histogram is filled with the trigger bits.
353 // triggerMask Trigger mask
354 // vzMin Minimum @f$ v_z@f$ (in centimeters)
355 // vzMax Maximum @f$ v_z@f$ (in centimeters)
356 // cMin Minimum centrality (in percent)
357 // cMax Maximum centrality (in percent)
358 // hist Histogram to fill
361 // @c true if the event meets the requirements
363 if (cMin < cMax && (cMin > fCentrality || cMax <= fCentrality)) {
364 if (status) status->Fill(kWrongCentrality);
369 Int_t tmp = triggerMask & ~kB;
370 hist->AddBinContent(kBinAll);
371 if (IsTriggerBits(kB|tmp)) hist->AddBinContent(kBinB);
372 if (IsTriggerBits(kA|tmp)) hist->AddBinContent(kBinA);
373 if (IsTriggerBits(kC|tmp)) hist->AddBinContent(kBinC);
374 if (IsTriggerBits(kE|tmp)) hist->AddBinContent(kBinE);
375 if (IsTriggerBits(kB|kInel)) hist->AddBinContent(kBinInel);
376 if (IsTriggerBits(kB|kInelGt0)) hist->AddBinContent(kBinInelGt0);
377 if (IsTriggerBits(kB|kNSD)) hist->AddBinContent(kBinNSD);
378 if (IsTriggerBits(kB|kV0AND)) hist->AddBinContent(kBinV0AND);
379 if (IsTriggerBits(kPileUp)) hist->AddBinContent(kBinPileUp);
380 if (IsTriggerBits(kMCNSD)) hist->AddBinContent(kBinMCNSD);
381 if (IsTriggerBits(kOffline)) hist->AddBinContent(kBinOffline);
382 if (IsTriggerBits(kNClusterGt0)) hist->AddBinContent(kBinNClusterGt0);
383 if (IsTriggerBits(kSatellite)) hist->AddBinContent(kBinSatellite);
384 if (IsTriggerBits(triggerMask) && !IsTriggerBits(kB|tmp))
385 Warning("CheckEvent", "event: 0x%x, mask: 0x%x, tmp: 0x%x, tmp|b: 0x%x",
386 fTriggers, triggerMask, tmp, tmp|kB);
388 // Check if we have an event of interest.
389 Int_t mask = triggerMask; //|kB
390 if (!IsTriggerBits(mask)) {
391 if (status) status->Fill(kWrongTrigger);
396 if (IsTriggerBits(kPileUp)) {
397 if (status) status->Fill(kIsPileup);
400 if (hist) hist->AddBinContent(kWithTrigger);
402 // Check that we have a valid vertex
403 if (vzMin < vzMax && !HasIpZ()) {
404 if (status) status->Fill(kNoVertex);
407 if (hist) hist->AddBinContent(kWithVertex);
409 // Check that vertex is within cuts
410 if (vzMin < vzMax && !InRange(vzMin, vzMax)) {
411 if (status) status->Fill(kWrongVertex);
414 if (hist) hist->AddBinContent(kAccepted);
416 if (status) status->Fill(kGoodEvent);
420 //____________________________________________________________________
422 AliAODForwardMult::Print(Option_t* option) const
427 // option Passed to TH1::Print
429 UShort_t sys = GetSystem();
430 TString str = "unknown";
432 case 1: str = "pp"; break;
433 case 2: str = "PbPb"; break;
434 case 3: str = "pPb" ; break;
436 std::cout << "Ipz: " << fIpZ << "cm " << (HasIpZ() ? "" : "in")
438 << "Triggers: " << GetTriggerString(fTriggers) << "\n"
439 << "sNN: " << GetSNN() << "GeV\n"
440 << "System: " << str << "\n"
441 << "Centrality: " << fCentrality << "%"
445 //____________________________________________________________________