ATLAS Offline Software
Loading...
Searching...
No Matches
TruthClasses.h
Go to the documentation of this file.
1/*
2 Copyright (C) 2002-2024 CERN for the benefit of the ATLAS collaboration
3*/
4#ifndef TRUTHUTILS_TRUTHCLASSES_H
5#define TRUTHUTILS_TRUTHCLASSES_H
6#include <vector>
7#include <string>
8namespace MCTruthPartClassifier {
25 // cppcheck-suppress syntaxError; cppcheck 2.16 bug (https://sourceforge.net/p/cppcheck/discussion/general/thread/44654d46c3)
68
133
153
154
155
165 struct ParticleDef {
170 std::vector<std::string> sParticleType{
171 "Unknown",
172 "UnknownElectron",
173 "IsoElectron",
174 "NonIsoElectron",
175 "BkgElectron",
176 "UnknownMuon",
177 "IsoMuon",
178 "NonIsoMuon",
179 "BkgMuon",
180 "UnknownTau",
181 "IsoTau",
182 "NonIsoTau",
183 "BkgTau",
184 "UnknownPhoton",
185 "IsoPhoton",
186 "NonIsoPhoton",
187 "BkgPhoton",
188 "Hadron",
189 "Neutrino",
190 "NuclFrag",
191 "NonPrimary",
192 "GenParticle",
193 "SUSYParticle",
194 "BBbarMesonPart",
195 "BottomMesonPart",
196 "CCbarMesonPart",
197 "CharmedMesonPart",
198 "BottomBaryonPart",
199 "CharmedBaryonPart",
200 "StrangeBaryonPart",
201 "LightBaryonPart",
202 "StrangeMesonPart",
203 "LightMesonPart",
204 "BJet",
205 "CJet",
206 "LJet",
207 "GJet",
208 "TauJet",
209 "UnknownJet",
210 "OtherBSMParticle"};
211
215 std::vector<std::string> sParticleOrigin{
216 "NonDefined",
217 "SingleElec",
218 "SingleMuon",
219 "SinglePhot",
220 "SingleTau",
221 "PhotonConv",
222 "DalitzDec",
223 "ElMagProc",
224 "Mu",
225 "TauLep",
226 "top",
227 "QuarkWeakDec",
228 "WBoson",
229 "ZBoson",
230 "Higgs",
231 "HiggsMSSM",
232 "WZMSSM",
233 "WBosonLRSM",
234 "NuREle",
235 "NuRMu",
236 "NuRTau",
237 "LQ",
238 "SUSY",
239 "LightMeson",
240 "StrangeMeson",
241 "CharmedMeson",
242 "BottomMeson",
243 "CCbarMeson",
244 "JPsi",
245 "BBbarMeson",
246 "LightBaryon",
247 "StrangeBaryon",
248 "CharmedBaryon",
249 "BottomBaryon",
250 "PionDecay",
251 "KaonDecay",
252 "BremPhot",
253 "PromptPhot",
254 "UndrPhot",
255 "ISRPhot",
256 "FSRPhot",
257 "NucReact",
258 "PiZero",
259 "DiBoson",
260 "ZorHeavyBoson",
261 "QCD",
262 "OtherBSM",
263 "MultiBoson"};
264 };
265}
266
267#endif
ParticleOutCome
Outcome of a (simulated) truth particle: what happened to it after being produced,...
@ ThreeProng
Tau decayed hadronically with three charged pions or kaons.
@ DecaytoMuon
Tau decayed to mu nu nu (with optional photons).
@ NonInteract
Particle without an end vertex (survived the detector) – also used for neutrinos.
@ NonDefinedOutCome
UNUSED: never assigned; the default of the outcome of IMCTruthClassifier::Result is UnknownOutCome.
@ Converted
Photon converted: end vertex has exactly one e+ and one e-.
@ DecaytoElectron
Muon decayed to e nu_e nu_mu, or tau decayed to e nu nu (with optional photons).
@ NuclInteraction
Interaction with nuclei: the end vertex contains hadrons, nucleons or nuclear fragments.
@ FiveProng
Tau decayed hadronically with five charged pions or kaons.
@ UnConverted
Photon without an end vertex: it did not convert.
@ UnknownOutCome
End vertex exists, but its content matches none of the patterns below.
@ ElectrMagInter
Electron that only scattered electromagnetically: its end vertex has one electron and nothing else.
@ OneProng
Tau decayed hadronically with one charged pion or kaon.
ParticleOrigin
Origin of a truth particle, as assigned by MCTruthClassifier::particleTruthClassifier (the second mem...
@ BottomMeson
Decay of an open-bottom meson.
@ ElMagProc
Electromagnetic or nuclear material process: bremsstrahlung/pair production in the detector,...
@ LightBaryon
Decay of a light (u, d only) baryon.
@ UndrPhot
"Underlying" photon: radiated from a quark or gluon in the parton shower/underlying event
@ WBosonLRSM
Decay of the W_R boson of the left-right symmetric model (Pythia-specific PDG 9900024).
@ JPsi
Decay of a J/psi.
@ ZBoson
Z boson (or Z/gamma*) decay (including Sherpa Z records and Z+gamma).
@ BBbarMeson
Decay of a hidden-bottom meson.
@ ISRPhot
Initial-state radiation photon (quark/gluon mother whose copy is a Herwig cluster).
@ PromptPhot
Prompt (direct) photon of the hard process, e.g. Pythia8 gamma+jet.
@ BremPhot
Bremsstrahlung photon: the mother continues as a copy of itself plus this photon.
@ StrangeMeson
Decay of a meson containing s quark (e.g. kaon).
@ DiBoson
Two-boson (WW, WZ, ZZ) production recorded without explicit bosons: four leptons/neutrinos in the har...
@ Higgs
Higgs boson decay (SM Higgs, PDG 25).
@ CharmedBaryon
Decay of a charmed baryon.
@ StrangeBaryon
Decay of a strange baryon.
@ LightMeson
Decay of a light (u, d only) meson.
@ HiggsMSSM
Decay of an extra (MSSM/2HDM) Higgs boson: H (35), A (36) or H+ (37).
@ ZorHeavyBoson
UNUSED: never returned by the classifier; only compared against in defTypeOfElectron/Muon/Tau.
@ LQ
Leptoquark: the ancestor is a leptoquark, or the decay vertex contains one.
@ BottomBaryon
Decay of a bottom baryon.
@ PhotonConv
Photon conversion (gamma -> e+ e-, or gamma -> mu+ mu- for muons).
@ NuREle
Decay of a right-handed electron neutrino (Pythia-specific PDG 9900012), or of a W_R decaying to it.
@ TauLep
Decay (or radiation) of a tau lepton that is not itself prompt.
@ NuRMu
Decay of a right-handed muon neutrino (Pythia-specific PDG 9900014).
@ KaonDecay
Muon from K -> mu nu in flight.
@ FSRPhot
Final-state radiation photon, e.g. from the leptons of W/Z/H decays or from Photos.
@ WBoson
W boson decay (including Sherpa W records and W+gamma).
@ Mu
Decay (or radiation) of a muon.
@ OtherBSM
Decay of a non-SUSY BSM particle (added later, hence the out-of-order value).
@ NuRTau
Decay of a right-handed tau neutrino (Pythia-specific PDG 9900016).
@ NonDefined
Origin could not be determined (no production vertex, no ancestor, or particle not classified).
@ PiZero
Photon from a pi0 decay.
@ CharmedMeson
Decay of an open-charm meson.
@ NucReact
Photon from a nuclear reaction in the material.
@ SingleElec
Single-electron particle gun: production vertex with no mother and one outgoing particle.
@ CCbarMeson
Decay of a hidden-charm meson other than J/psi.
@ top
Decay of a top quark (including through W).
@ DalitzDec
Dalitz decay of a pi0 (pi0 -> gamma e+ e-, or pi0 -> e+ e- e+ e-).
@ QuarkWeakDec
Weak decay of a quark: q -> q' l nu with a single other quark in the final state.
@ SingleTau
Single-tau particle gun.
@ HeavyBoson
Decay of a heavy gauge boson Z', Z'', W'+ (PDG 32, 33, 34), or a KK graviton (5100039) in the photon ...
@ SingleMuon
Single-muon particle gun.
@ QCD
Jet origin: a quark or gluon mother (see defJetOrig); only assigned by the jet classifier,...
@ SinglePhot
Single-photon particle gun.
@ PionDecay
Muon from pi -> mu nu in flight.
@ MultiBoson
Three or more bosons (VVV, 4-top with leptonic W decays): six or eight leptons/neutrinos in the hard-...
ParticleType
Type of a truth particle, as assigned by MCTruthClassifier::particleTruthClassifier (the first member...
@ BkgTau
Background tau (remaining cases).
@ BBbarMesonPart
Hidden-bottom meson (e.g. Upsilon, chi_b).
@ Unknown
Not classified: not a lepton, photon, neutrino or hadron (e.g. a quark, a gluon, a boson),...
@ LJet
Jet with only light/strange hadrons (jet overload of the classifier).
@ Neutrino
Neutrino (an origin is determined for it, see ParticleOrigin).
@ LightMesonPart
Meson made of u and d quarks only, e.g. a pion.
@ GJet
UNUSED: never assigned or checked anywhere in Athena (gluon jet).
@ TauJet
UNUSED: never assigned or checked anywhere in Athena (hadronic tau jet).
@ CharmedMesonPart
Open-charm meson (D, D_s).
@ NonPrimary
Not a primary particle: a copy produced by the simulation (e.g. Geant4) with no production vertex,...
@ IsoPhoton
Isolated (prompt) photon: from W/Z/H/BSM decay, a hard-process prompt photon, or a single-photon gun.
@ StrangeBaryonPart
Baryon containing an s quark (and no c, b).
@ IsoTau
Isolated (prompt) tau.
@ UnknownMuon
Muon with undefined origin.
@ NuclFrag
Nuclear fragment: a nucleus other than a proton, produced in a material interaction.
@ StrangeMesonPart
Meson containing an s quark (and no c, b), e.g. a kaon.
@ CCbarMesonPart
Hidden-charm meson (e.g. J/psi, chi_c).
@ NonIsoPhoton
Non-isolated photon: initial/final-state radiation, or from tau, muon or right-handed neutrino/W_R de...
@ BkgPhoton
Background photon: bremsstrahlung, pi0 decay, hadron decay, nuclear reaction, underlying-event photon...
@ NonIsoMuon
Non-isolated muon from J/psi, B/D hadron, tau or quark weak decay.
@ OtherBSMParticle
Stable non-SUSY BSM particle (added later, hence the out-of-order value).
@ BottomBaryonPart
Baryon containing a b quark.
@ UnknownJet
Jet with no classifiable hadron among its constituents (also the initial value of the jet classifier)...
@ BkgMuon
Background muon: pion/kaon decay in flight and other remaining cases.
@ NonIsoTau
Non-isolated tau from J/psi, B/D hadron or quark weak decay.
@ CharmedBaryonPart
Baryon containing a c quark (and no b).
@ IsoElectron
Isolated (prompt) electron, e.g. from W/Z/H/top/BSM decay, or a single-electron particle gun.
@ IsoMuon
Isolated (prompt) muon.
@ NonIsoElectron
Non-isolated electron from J/psi, B/D hadron, tau, muon or quark weak decay.
@ GenParticle
Generator-level intermediate particle (decayed, or otherwise not a final-state candidate) that is not...
@ UnknownPhoton
Photon with undefined origin.
@ SUSYParticle
Stable SUSY particle (e.g. the LSP).
@ UnknownElectron
Electron with undefined origin (no production vertex, or origin could not be traced).
@ BottomMesonPart
Open-bottom meson (B, B_s, B_c).
@ Hadron
Any hadron (neither the beam nor a nuclear fragment); the origin is not studied further.
@ BkgElectron
Background electron: photon conversion, Dalitz decay, material interaction, light-hadron decay,...
@ BJet
Jet containing a b-hadron (jet overload of the classifier; DR-matched or constituent truth particles)...
@ UnknownTau
Tau with undefined origin.
@ CJet
Jet with a c-hadron and no b-hadron (jet overload of the classifier).
@ LightBaryonPart
Baryon made of u and d quarks only.
Human-readable names for the values of ParticleType, ParticleOrigin and ParticleOutCome.
std::vector< std::string > sParticleOrigin
Names of the ParticleOrigin values, indexed by value (0 = "NonDefined" ... 47 = "MultiBoson").
std::vector< std::string > sParticleType
Names of the ParticleType values, indexed by value (0 = "Unknown" ... 39 = "OtherBSMParticle").