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);
263 //____________________________________________________________________
265 AliAODForwardMult::MakeTriggerMask(const char* what)
267 UShort_t trgMask = 0;
270 TObjArray* parts = trgs.Tokenize("&");
273 while ((trg = static_cast<TObjString*>(next()))) {
274 TString s(trg->GetString());
275 s.Strip(TString::kBoth, ' ');
277 if (s.IsNull()) continue;
278 if (s.CompareTo("INEL") == 0) trgMask |=AliAODForwardMult::kInel;
279 else if (s.CompareTo("INEL>0")== 0) trgMask |=AliAODForwardMult::kInelGt0;
280 else if (s.CompareTo("NSD") == 0) trgMask |=AliAODForwardMult::kNSD;
281 else if (s.CompareTo("V0AND") == 0) trgMask |=AliAODForwardMult::kV0AND;
282 else if (s.CompareTo("MCNSD") == 0) trgMask |=AliAODForwardMult::kMCNSD;
283 else if (s.CompareTo("B") == 0) trgMask |=AliAODForwardMult::kB;
284 else if (s.CompareTo("A") == 0) trgMask |=AliAODForwardMult::kA;
285 else if (s.CompareTo("C") == 0) trgMask |=AliAODForwardMult::kC;
286 else if (s.CompareTo("SAT") == 0) trgMask |=AliAODForwardMult::kSatellite;
287 else if (s.CompareTo("E") == 0) trgMask |=AliAODForwardMult::kE;
288 else if (s.CompareTo("NCLUSTER>0") == 0)
289 trgMask |= AliAODForwardMult::kNClusterGt0;
291 AliWarningGeneral("MakeTriggerMask",
292 Form("Unknown trigger %s", s.Data()));
298 //____________________________________________________________________
300 AliAODForwardMult::CheckEvent(Int_t triggerMask,
301 Double_t vzMin, Double_t vzMax,
302 UShort_t cMin, UShort_t cMax,
306 // Check if event meets the passses requirements.
308 // It returns true if @e all of the following is true
310 // - The trigger is within the bit mask passed.
311 // - The vertex is within the specified limits.
312 // - The centrality is within the specified limits, or if lower
313 // limit is equal to or larger than the upper limit.
315 // If a histogram is passed in the last parameter, then that
316 // histogram is filled with the trigger bits.
319 // triggerMask Trigger mask
320 // vzMin Minimum @f$ v_z@f$ (in centimeters)
321 // vzMax Maximum @f$ v_z@f$ (in centimeters)
322 // cMin Minimum centrality (in percent)
323 // cMax Maximum centrality (in percent)
324 // hist Histogram to fill
327 // @c true if the event meets the requirements
329 if (cMin < cMax && (cMin > fCentrality || cMax <= fCentrality)) return false;
332 Int_t tmp = triggerMask & ~kB;
333 hist->AddBinContent(kBinAll);
334 if (IsTriggerBits(kB|tmp)) hist->AddBinContent(kBinB);
335 if (IsTriggerBits(kA|tmp)) hist->AddBinContent(kBinA);
336 if (IsTriggerBits(kC|tmp)) hist->AddBinContent(kBinC);
337 if (IsTriggerBits(kE|tmp)) hist->AddBinContent(kBinE);
338 if (IsTriggerBits(kB|kInel)) hist->AddBinContent(kBinInel);
339 if (IsTriggerBits(kB|kInelGt0)) hist->AddBinContent(kBinInelGt0);
340 if (IsTriggerBits(kB|kNSD)) hist->AddBinContent(kBinNSD);
341 if (IsTriggerBits(kB|kV0AND)) hist->AddBinContent(kBinV0AND);
342 if (IsTriggerBits(kPileUp)) hist->AddBinContent(kBinPileUp);
343 if (IsTriggerBits(kMCNSD)) hist->AddBinContent(kBinMCNSD);
344 if (IsTriggerBits(kOffline)) hist->AddBinContent(kBinOffline);
345 if (IsTriggerBits(kNClusterGt0)) hist->AddBinContent(kBinNClusterGt0);
346 if (IsTriggerBits(kSatellite)) hist->AddBinContent(kBinSatellite);
347 if (IsTriggerBits(triggerMask) && !IsTriggerBits(kB|tmp))
348 Warning("CheckEvent", "event: 0x%x, mask: 0x%x, tmp: 0x%x, tmp|b: 0x%x",
349 fTriggers, triggerMask, tmp, tmp|kB);
351 // Check if we have an event of interest.
352 Int_t mask = triggerMask; //|kB
353 if (!IsTriggerBits(mask)) return false;
356 if (IsTriggerBits(kPileUp)) return false;
357 if (hist) hist->AddBinContent(kWithTrigger);
359 // Check that we have a valid vertex
360 if (vzMin < vzMax && !HasIpZ()) return false;
361 if (hist) hist->AddBinContent(kWithVertex);
363 // Check that vertex is within cuts
364 if (vzMin < vzMax && !InRange(vzMin, vzMax)) return false;
365 if (hist) hist->AddBinContent(kAccepted);
370 //____________________________________________________________________
372 AliAODForwardMult::Print(Option_t* option) const
377 // option Passed to TH1::Print
379 UShort_t sys = GetSystem();
380 TString str = "unknown";
382 case 1: str = "pp"; break;
383 case 2: str = "PbPb"; break;
384 case 3: str = "pPb" ; break;
386 std::cout << "Ipz: " << fIpZ << "cm " << (HasIpZ() ? "" : "in")
388 << "Triggers: " << GetTriggerString(fTriggers) << "\n"
389 << "sNN: " << GetSNN() << "GeV\n"
390 << "System: " << str << "\n"
391 << "Centrality: " << fCentrality << "%"
395 //____________________________________________________________________