Fork me on GitHub

source: git/classes/DelphesClasses.h@ 151255d

ImprovedOutputFile Timing dual_readout llp
Last change on this file since 151255d was 151255d, checked in by Pavel Demin <pavel.demin@…>, 8 years ago

update descriptions of the variables in DelphesClasses.h
  • Property mode set to 100644
File size: 18.5 KB
Line 
1/*
2 * Delphes: a framework for fast simulation of a generic collider experiment
3 * Copyright (C) 2012-2014 Universite catholique de Louvain (UCL), Belgium
4 *
5 * This program is free software: you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation, either version 3 of the License, or
8 * (at your option) any later version.
9 *
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
14 *
15 * You should have received a copy of the GNU General Public License
16 * along with this program. If not, see <http://www.gnu.org/licenses/>.
17 */
18
19#ifndef DelphesClasses_h
20#define DelphesClasses_h
21
22/**
23 *
24 * Definition of classes to be stored in the root tree.
25 * Function CompareXYZ sorts objects by the variable XYZ that MUST be
26 * present in the data members of the root tree class of the branch.
27 *
28 * \author P. Demin - UCL, Louvain-la-Neuve
29 *
30 */
31
32// Dependencies (#includes)
33
34#include "TRef.h"
35#include "TObject.h"
36#include "TRefArray.h"
37#include "TLorentzVector.h"
38
39#include "classes/SortableObject.h"
40
41class DelphesFactory;
42
43//---------------------------------------------------------------------------
44
45class Event: public TObject
46{
47public:
48
49 Long64_t Number; // event number
50
51 Float_t ReadTime; // read time
52 Float_t ProcTime; // processing time
53
54 ClassDef(Event, 1)
55};
56
57//---------------------------------------------------------------------------
58
59class LHCOEvent: public Event
60{
61public:
62
63 Int_t Trigger; // trigger word
64
65 ClassDef(LHCOEvent, 1)
66};
67
68//---------------------------------------------------------------------------
69
70class LHEFEvent: public Event
71{
72public:
73
74 Int_t ProcessID; // subprocess code for the event | hepup.IDPRUP
75
76 Float_t Weight; // weight for the event | hepup.XWGTUP
77 Float_t ScalePDF; // scale in GeV used in the calculation of the PDFs in the event | hepup.SCALUP
78 Float_t AlphaQED; // value of the QED coupling used in the event | hepup.AQEDUP
79 Float_t AlphaQCD; // value of the QCD coupling used in the event | hepup.AQCDUP
80
81 ClassDef(LHEFEvent, 2)
82};
83
84//---------------------------------------------------------------------------
85
86class LHEFWeight: public TObject
87{
88public:
89 Int_t ID; // weight ID
90 Float_t Weight; // weight value
91
92 ClassDef(LHEFWeight, 1)
93};
94
95//---------------------------------------------------------------------------
96
97class HepMCEvent: public Event
98{
99public:
100
101 Int_t ProcessID; // unique signal process id | signal_process_id()
102 Int_t MPI; // number of multi parton interactions | mpi ()
103
104 Float_t Weight; // weight for the event
105
106 Float_t Scale; // energy scale, see hep-ph/0109068 | event_scale()
107 Float_t AlphaQED; // QED coupling, see hep-ph/0109068 | alphaQED()
108 Float_t AlphaQCD; // QCD coupling, see hep-ph/0109068 | alphaQCD()
109
110 Int_t ID1; // flavour code of first parton | pdf_info()->id1()
111 Int_t ID2; // flavour code of second parton | pdf_info()->id2()
112
113 Float_t X1; // fraction of beam momentum carried by first parton ("beam side") | pdf_info()->x1()
114 Float_t X2; // fraction of beam momentum carried by second parton ("target side") | pdf_info()->x2()
115
116 Float_t ScalePDF; // Q-scale used in evaluation of PDF's (in GeV) | pdf_info()->scalePDF()
117
118 Float_t PDF1; // PDF (id1, x1, Q) | pdf_info()->pdf1()
119 Float_t PDF2; // PDF (id2, x2, Q) | pdf_info()->pdf2()
120
121 ClassDef(HepMCEvent, 2)
122};
123
124//---------------------------------------------------------------------------
125
126class GenParticle: public SortableObject
127{
128public:
129 Int_t PID; // particle HEP ID number | hepevt.idhep[number]
130
131 Int_t Status; // particle status | hepevt.isthep[number]
132 Int_t IsPU; // 0 or 1 for particles from pile-up interactions
133
134 Int_t M1; // particle 1st mother | hepevt.jmohep[number][0] - 1
135 Int_t M2; // particle 2nd mother | hepevt.jmohep[number][1] - 1
136
137 Int_t D1; // particle 1st daughter | hepevt.jdahep[number][0] - 1
138 Int_t D2; // particle last daughter | hepevt.jdahep[number][1] - 1
139
140 Int_t Charge; // particle charge
141
142 Float_t Mass; // particle mass
143
144 Float_t E; // particle energy | hepevt.phep[number][3]
145 Float_t Px; // particle momentum vector (x component) | hepevt.phep[number][0]
146 Float_t Py; // particle momentum vector (y component) | hepevt.phep[number][1]
147 Float_t Pz; // particle momentum vector (z component) | hepevt.phep[number][2]
148
149 Float_t D0; // particle transverse impact parameter
150 Float_t DZ; // particle longitudinal impact parameter
151 Float_t P; // particle momentum
152 Float_t PT; // particle transverse momentum
153 Float_t CtgTheta; // particle cotangent of theta
154 Float_t Phi; // particle azimuthal angle
155 Float_t Eta; // particle pseudorapidity
156 Float_t Rapidity; // particle rapidity
157
158 Float_t T; // particle vertex position (t component) | hepevt.vhep[number][3]
159 Float_t X; // particle vertex position (x component) | hepevt.vhep[number][0]
160 Float_t Y; // particle vertex position (y component) | hepevt.vhep[number][1]
161 Float_t Z; // particle vertex position (z component) | hepevt.vhep[number][2]
162
163 static CompBase *fgCompare; //!
164 const CompBase *GetCompare() const { return fgCompare; }
165
166 TLorentzVector P4() const;
167
168 ClassDef(GenParticle, 1)
169};
170
171//---------------------------------------------------------------------------
172
173class Vertex: public SortableObject
174{
175public:
176
177 Float_t X; // vertex position (x component)
178 Float_t Y; // vertex position (y component)
179 Float_t Z; // vertex position (z component)
180 Float_t T; // vertex position (t component)
181
182 Double_t ErrorX; // vertex position error (x component)
183 Double_t ErrorY; // vertex position error (y component)
184 Double_t ErrorZ; // vertex position error (z component)
185 Double_t ErrorT; // vertex position error (t component)
186
187 Int_t Index; // vertex index
188 Int_t NDF; // number of degrees of freedom
189 Double_t Sigma;
190 Double_t SumPT2;
191 Double_t BTVSumPT2;
192 Double_t GenDeltaZ;
193 Double_t GenSumPT2;
194
195 TRefArray Constituents; // references to constituents
196
197 static CompBase *fgCompare; //!
198 const CompBase *GetCompare() const { return fgCompare; }
199
200 ClassDef(Vertex, 3)
201};
202
203//---------------------------------------------------------------------------
204
205class MissingET: public TObject
206{
207public:
208 Float_t MET; // mising transverse energy
209 Float_t Eta; // mising energy pseudorapidity
210 Float_t Phi; // mising energy azimuthal angle
211
212 TLorentzVector P4() const;
213
214 ClassDef(MissingET, 1)
215};
216
217//---------------------------------------------------------------------------
218
219class ScalarHT: public TObject
220{
221public:
222 Float_t HT; // scalar sum of transverse momenta
223
224 ClassDef(ScalarHT, 1)
225};
226
227//---------------------------------------------------------------------------
228
229class Rho: public TObject
230{
231public:
232 Float_t Rho; // rho energy density
233 Float_t Edges[2]; // pseudorapidity range edges
234
235 ClassDef(Rho, 1)
236};
237
238//---------------------------------------------------------------------------
239
240class Weight: public TObject
241{
242public:
243 Float_t Weight; // weight for the event
244
245 ClassDef(Weight, 1)
246};
247
248//---------------------------------------------------------------------------
249
250class Photon: public SortableObject
251{
252public:
253
254 Float_t PT; // photon transverse momentum
255 Float_t Eta; // photon pseudorapidity
256 Float_t Phi; // photon azimuthal angle
257
258 Float_t E; // photon energy
259
260 Float_t T; // particle arrival time of flight
261
262 Float_t EhadOverEem; // ratio of the hadronic versus electromagnetic energy deposited in the calorimeter
263
264 TRefArray Particles; // references to generated particles
265
266 Float_t IsolationVar; // isolation variable
267 Float_t IsolationVarRhoCorr; // isolation variable
268 Float_t SumPtCharged; // isolation variable
269 Float_t SumPtNeutral; // isolation variable
270 Float_t SumPtChargedPU; // isolation variable
271 Float_t SumPt; // isolation variable
272
273 static CompBase *fgCompare; //!
274 const CompBase *GetCompare() const { return fgCompare; }
275
276 TLorentzVector P4() const;
277
278 ClassDef(Photon, 3)
279};
280
281//---------------------------------------------------------------------------
282
283class Electron: public SortableObject
284{
285public:
286
287 Float_t PT; // electron transverse momentum
288 Float_t Eta; // electron pseudorapidity
289 Float_t Phi; // electron azimuthal angle
290
291 Float_t T; // particle arrival time of flight
292
293 Int_t Charge; // electron charge
294
295 Float_t EhadOverEem; // ratio of the hadronic versus electromagnetic energy deposited in the calorimeter
296
297 TRef Particle; // reference to generated particle
298
299 Float_t IsolationVar; // isolation variable
300 Float_t IsolationVarRhoCorr; // isolation variable
301 Float_t SumPtCharged; // isolation variable
302 Float_t SumPtNeutral; // isolation variable
303 Float_t SumPtChargedPU; // isolation variable
304 Float_t SumPt; // isolation variable
305
306 static CompBase *fgCompare; //!
307 const CompBase *GetCompare() const { return fgCompare; }
308
309 TLorentzVector P4() const;
310
311 ClassDef(Electron, 3)
312};
313
314//---------------------------------------------------------------------------
315
316class Muon: public SortableObject
317{
318public:
319
320 Float_t PT; // muon transverse momentum
321 Float_t Eta; // muon pseudorapidity
322 Float_t Phi; // muon azimuthal angle
323
324 Float_t T; // particle arrival time of flight
325
326 Int_t Charge; // muon charge
327
328 TRef Particle; // reference to generated particle
329
330 Float_t IsolationVar; // isolation variable
331 Float_t IsolationVarRhoCorr; // isolation variable
332 Float_t SumPtCharged; // isolation variable
333 Float_t SumPtNeutral; // isolation variable
334 Float_t SumPtChargedPU; // isolation variable
335 Float_t SumPt; // isolation variable
336
337 static CompBase *fgCompare; //!
338 const CompBase *GetCompare() const { return fgCompare; }
339
340 TLorentzVector P4() const;
341
342 ClassDef(Muon, 3)
343};
344
345//---------------------------------------------------------------------------
346
347class Jet: public SortableObject
348{
349public:
350
351 Float_t PT; // jet transverse momentum
352 Float_t Eta; // jet pseudorapidity
353 Float_t Phi; // jet azimuthal angle
354
355 Float_t T; //particle arrival time of flight
356
357 Float_t Mass; // jet invariant mass
358
359 Float_t DeltaEta; // jet radius in pseudorapidity
360 Float_t DeltaPhi; // jet radius in azimuthal angle
361
362 UInt_t Flavor; // jet flavor
363 UInt_t FlavorAlgo; // jet flavor
364 UInt_t FlavorPhys; // jet flavor
365
366 UInt_t BTag; // 0 or 1 for a jet that has been tagged as containing a heavy quark
367 UInt_t BTagAlgo; // 0 or 1 for a jet that has been tagged as containing a heavy quark
368 UInt_t BTagPhys; // 0 or 1 for a jet that has been tagged as containing a heavy quark
369
370 UInt_t TauTag; // 0 or 1 for a jet that has been tagged as a tau
371
372 Int_t Charge; // tau charge
373
374 Float_t EhadOverEem; // ratio of the hadronic versus electromagnetic energy deposited in the calorimeter
375
376 Int_t NCharged; // number of charged constituents
377 Int_t NNeutrals; // number of neutral constituents
378 Float_t Beta; // (sum pt of charged pile-up constituents)/(sum pt of charged constituents)
379 Float_t BetaStar; // (sum pt of charged constituents coming from hard interaction)/(sum pt of charged constituents)
380 Float_t MeanSqDeltaR; // average distance (squared) between constituent and jet weighted by pt (squared) of constituent
381 Float_t PTD; // average pt between constituent and jet weighted by pt of constituent
382 Float_t FracPt[5]; // (sum pt of constituents within a ring 0.1*i < DeltaR < 0.1*(i+1))/(sum pt of constituents)
383
384 Float_t Tau[5]; // N-subjettiness
385
386 TLorentzVector TrimmedP4[5]; // first entry (i = 0) is the total Trimmed Jet 4-momenta and from i = 1 to 4 are the trimmed subjets 4-momenta
387 TLorentzVector PrunedP4[5]; // first entry (i = 0) is the total Pruned Jet 4-momenta and from i = 1 to 4 are the pruned subjets 4-momenta
388 TLorentzVector SoftDroppedP4[5]; // first entry (i = 0) is the total SoftDropped Jet 4-momenta and from i = 1 to 4 are the pruned subjets 4-momenta
389
390 Int_t NSubJetsTrimmed; // number of subjets trimmed
391 Int_t NSubJetsPruned; // number of subjets pruned
392 Int_t NSubJetsSoftDropped; // number of subjets soft-dropped
393
394 TRefArray Constituents; // references to constituents
395 TRefArray Particles; // references to generated particles
396
397 static CompBase *fgCompare; //!
398 const CompBase *GetCompare() const { return fgCompare; }
399
400 TLorentzVector P4() const;
401 TLorentzVector Area;
402
403 ClassDef(Jet, 3)
404};
405
406//---------------------------------------------------------------------------
407
408class Track: public SortableObject
409{
410public:
411 Int_t PID; // HEP ID number
412
413 Int_t Charge; // track charge
414
415 Float_t Eta; // track pseudorapidity
416
417 Float_t EtaOuter; // track pseudorapidity at the tracker edge
418 Float_t PhiOuter; // track azimuthal angle at the tracker edge
419
420 Float_t X; // track vertex position (x component)
421 Float_t Y; // track vertex position (y component)
422 Float_t Z; // track vertex position (z component)
423 Float_t T; // track vertex position (t component)
424
425 Float_t XOuter; // track position (x component) at the tracker edge
426 Float_t YOuter; // track position (y component) at the tracker edge
427 Float_t ZOuter; // track position (z component) at the tracker edge
428 Float_t TOuter; // track position (t component) at the tracker edge
429
430 Float_t L; // track path length
431 Float_t ErrorT; // time measurement error
432
433 Float_t D0; // track transverse impact parameter
434 Float_t ErrorD0; // track transverse impact parameter error
435
436 Float_t DZ; // track longitudinal impact parameter
437 Float_t ErrorDZ; // track longitudinal impact parameter error
438
439 Float_t P; // track momentum
440 Float_t ErrorP; // track momentum error
441
442 Float_t PT; // track transverse momentum
443 Float_t ErrorPT; // track transverse momentum error
444
445 Float_t CtgTheta; // track cotangent of theta
446 Float_t ErrorCtgTheta; // track cotangent of theta error
447
448 Float_t Phi; // track azimuthal angle
449 Float_t ErrorPhi; // track azimuthal angle error
450
451 Float_t Xd; // X coordinate of point of closest approach to vertex
452 Float_t Yd; // Y coordinate of point of closest approach to vertex
453 Float_t Zd; // Z coordinate of point of closest approach to vertex
454
455 TRef Particle; // reference to generated particle
456
457 Int_t VertexIndex; // reference to vertex
458
459 static CompBase *fgCompare; //!
460 const CompBase *GetCompare() const { return fgCompare; }
461
462 TLorentzVector P4() const;
463
464 ClassDef(Track, 2)
465};
466
467//---------------------------------------------------------------------------
468
469class Tower: public SortableObject
470{
471public:
472 Float_t ET; // calorimeter tower transverse energy
473 Float_t Eta; // calorimeter tower pseudorapidity
474 Float_t Phi; // calorimeter tower azimuthal angle
475
476 Float_t E; // calorimeter tower energy
477
478 Float_t T; // ecal deposit time, averaged by sqrt(EM energy) over all particles, not smeared
479 Int_t NTimeHits; // number of hits contributing to time measurement
480
481 Float_t Eem; // calorimeter tower electromagnetic energy
482 Float_t Ehad; // calorimeter tower hadronic energy
483
484 Float_t Edges[4]; // calorimeter tower edges
485
486 TRefArray Particles; // references to generated particles
487
488 static CompBase *fgCompare; //!
489 const CompBase *GetCompare() const { return fgCompare; }
490
491 TLorentzVector P4() const;
492
493 ClassDef(Tower, 2)
494};
495
496//---------------------------------------------------------------------------
497
498class HectorHit: public SortableObject
499{
500public:
501 Float_t E; // reconstructed energy [GeV]
502
503 Float_t Tx; // angle of the momentum in the horizontal (x,z) plane [urad]
504 Float_t Ty; // angle of the momentum in the verical (y,z) plane [urad]
505
506 Float_t T; // time of flight to the detector [s]
507
508 Float_t X; // horizontal distance to the beam [um]
509 Float_t Y; // vertical distance to the beam [um]
510 Float_t S; // distance to the interaction point [m]
511
512 TRef Particle; // reference to generated particle
513
514 static CompBase *fgCompare; //!
515 const CompBase *GetCompare() const { return fgCompare; }
516
517 ClassDef(HectorHit, 1)
518};
519
520//---------------------------------------------------------------------------
521
522class Candidate: public SortableObject
523{
524 friend class DelphesFactory;
525
526public:
527 Candidate();
528
529 Int_t PID;
530
531 Int_t Status;
532 Int_t M1, M2, D1, D2;
533
534 Int_t Charge;
535
536 Float_t Mass;
537
538 Int_t IsPU;
539 Int_t IsRecoPU;
540
541 Int_t IsConstituent;
542
543 Int_t IsFromConversion;
544
545 UInt_t Flavor;
546 UInt_t FlavorAlgo;
547 UInt_t FlavorPhys;
548
549 UInt_t BTag;
550 UInt_t BTagAlgo;
551 UInt_t BTagPhys;
552
553 UInt_t TauTag;
554
555 Float_t Eem;
556 Float_t Ehad;
557
558 Float_t Edges[4];
559 Float_t DeltaEta;
560 Float_t DeltaPhi;
561
562 TLorentzVector Momentum, Position, InitialPosition, PositionError, Area;
563
564 Float_t L; // path length
565 Float_t ErrorT; // path length
566 Float_t D0;
567 Float_t ErrorD0;
568 Float_t DZ;
569 Float_t ErrorDZ;
570 Float_t P;
571 Float_t ErrorP;
572 Float_t PT;
573 Float_t ErrorPT;
574 Float_t CtgTheta;
575 Float_t ErrorCtgTheta;
576 Float_t Phi;
577 Float_t ErrorPhi;
578
579 Float_t Xd;
580 Float_t Yd;
581 Float_t Zd;
582
583 // tracking resolution
584
585 Float_t TrackResolution;
586
587 // PileUpJetID variables
588
589 Int_t NCharged;
590 Int_t NNeutrals;
591 Float_t Beta;
592 Float_t BetaStar;
593 Float_t MeanSqDeltaR;
594 Float_t PTD;
595 Float_t FracPt[5];
596
597 // Timing information
598
599 Int_t NTimeHits;
600 std::vector< std::pair< Float_t, Float_t > > ECalEnergyTimePairs;
601
602 // Isolation variables
603
604 Float_t IsolationVar;
605 Float_t IsolationVarRhoCorr;
606 Float_t SumPtCharged;
607 Float_t SumPtNeutral;
608 Float_t SumPtChargedPU;
609 Float_t SumPt;
610
611 // vertex variables
612
613 Int_t ClusterIndex;
614 Int_t ClusterNDF;
615 Double_t ClusterSigma;
616 Double_t SumPT2;
617 Double_t BTVSumPT2;
618 Double_t GenDeltaZ;
619 Double_t GenSumPT2;
620
621 // N-subjettiness variables
622
623 Float_t Tau[5];
624
625 // Other Substructure variables
626
627 TLorentzVector TrimmedP4[5]; // first entry (i = 0) is the total Trimmed Jet 4-momenta and from i = 1 to 4 are the trimmed subjets 4-momenta
628 TLorentzVector PrunedP4[5]; // first entry (i = 0) is the total Pruned Jet 4-momenta and from i = 1 to 4 are the pruned subjets 4-momenta
629 TLorentzVector SoftDroppedP4[5]; // first entry (i = 0) is the total SoftDropped Jet 4-momenta and from i = 1 to 4 are the pruned subjets 4-momenta
630
631 Int_t NSubJetsTrimmed; // number of subjets trimmed
632 Int_t NSubJetsPruned; // number of subjets pruned
633 Int_t NSubJetsSoftDropped; // number of subjets soft-dropped
634
635
636 static CompBase *fgCompare; //!
637 const CompBase *GetCompare() const { return fgCompare; }
638
639 void AddCandidate(Candidate *object);
640 TObjArray *GetCandidates();
641
642 Bool_t Overlaps(const Candidate *object) const;
643
644 virtual void Copy(TObject &object) const;
645 virtual TObject *Clone(const char *newname = "") const;
646 virtual void Clear(Option_t* option = "");
647
648private:
649 DelphesFactory *fFactory; //!
650 TObjArray *fArray; //!
651
652 void SetFactory(DelphesFactory *factory) { fFactory = factory; }
653
654 ClassDef(Candidate, 5)
655};
656
657#endif // DelphesClasses_h
658
659
Note: See TracBrowser for help on using the repository browser.