A charged lepton meta-particle created by clustering photons close to the bare lepton. More...

#include <DressedLeptons.hh>

Inheritance diagram for DressedLepton:

Collaboration diagram for DressedLepton:

Public Member Functions
	DressedLepton (const Particle &lepton)
void	addPhoton (const Particle &p, bool cluster)
const Particle &	constituentLepton () const
const Particles &	constituentPhotons () const
virtual fastjet::PseudoJet	pseudojet () const
	Converter to FastJet3 PseudoJet.
	operator PseudoJet () const
	Cast operator to FastJet3 PseudoJet.
Basic particle specific properties
const GenParticle *	genParticle () const
	Get a const pointer to the original GenParticle.
	operator const GenParticle * () const
	Cast operator for conversion to GenParticle*.
const FourMomentum &	momentum () const
	The momentum.
Particle &	setMomentum (const FourMomentum &momentum)
	Set the momentum.
Particle ID code accessors
PdgId	pid () const
	This Particle's PDG ID code.
PdgId	abspid () const
	Absolute value of the PDG ID code.
PdgId	pdgId () const
Particle species properties
double	charge () const
	The charge of this Particle.
int	threeCharge () const
	Three times the charge of this Particle (i.e. integer multiple of smallest quark charge).
bool	isHadron () const
	Is this a hadron?
bool	isMeson () const
	Is this a meson?
bool	isBaryon () const
	Is this a baryon?
bool	isLepton () const
	Is this a lepton?
bool	isNeutrino () const
	Is this a neutrino?
bool	hasBottom () const
	Does this (hadron) contain a b quark?
bool	hasCharm () const
	Does this (hadron) contain a c quark?
bool	isVisible () const
	Is this particle potentially visible in a detector?
Ancestry properties
bool	hasAncestor (PdgId pdg_id) const
bool	fromBottom () const
	Determine whether the particle is from a b-hadron decay.
bool	fromCharm () const
	Determine whether the particle is from a c-hadron decay.
bool	fromHadron () const
	Determine whether the particle is from a hadron decay.
bool	fromTau (bool prompt_taus_only=false) const
	Determine whether the particle is from a tau decay.
bool	fromPromptTau () const
	Determine whether the particle is from a prompt tau decay.
bool	fromDecay () const
	Determine whether the particle is from a hadron or tau decay.
Decay info
bool	isStable () const
	Whether this particle is stable according to the generator.
vector< Particle >	children () const
	Get a list of the direct descendants from the current particle.
vector< Particle >	allDescendants () const
vector< Particle >	stableDescendants () const
double	flightLength () const
	Flight length (divide by mm or cm to get the appropriate units)
Effective momentum accessors
const FourMomentum &	mom () const
	Get equivalent single momentum four-vector (const) (alias).
	operator const FourMomentum & () const
	Cast operator for conversion to FourMomentum.
Convenience access to the effective 4-vector properties
double	E () const
	Get the energy directly.
double	energy () const
	Get the energy directly (alias).
double	pt () const
	Get the directly.
double	pT () const
	Get the directly (alias).
double	perp () const
	Get the directly (alias).
double	pt2 () const
	Get the directly.
double	pT2 () const
	Get the directly (alias).
double	perp2 () const
	Get the directly (alias).
double	Et () const
	Get the directly.
double	mass () const
	Get the mass directly.
double	mass2 () const
	Get the mass**2 directly.
double	pseudorapidity () const
	Get the $\eta$ directly.
double	eta () const
	Get the $\eta$ directly (alias).
double	abspseudorapidity () const
	Get the $\|\eta\|$ directly.
double	abseta () const
	Get the $\|\eta\|$ directly (alias).
double	rapidity () const
	Get the directly.
double	rap () const
	Get the directly (alias).
double	absrapidity () const
	Get the directly.
double	absrap () const
	Get the directly (alias).
double	azimuthalAngle (const PhiMapping mapping=ZERO_2PI) const
	Azimuthal angle $\phi$ .
double	phi (const PhiMapping mapping=ZERO_2PI) const
	Get the $\phi$ directly.
Vector3	p3 () const
	Get the 3-momentum directly.
double	px () const
	x component of momentum.
double	py () const
	y component of momentum.
double	pz () const
	z component of momentum.
double	polarAngle () const
	Angle subtended by the 3-vector and the z-axis.
double	theta () const
	Synonym for polarAngle.
double	angle (const ParticleBase &v) const
	Angle between this vector and another.
double	angle (const FourVector &v) const
	Angle between this vector and another.
double	angle (const Vector3 &v3) const
	Angle between this vector and another (3-vector)
Private Attributes
Particles	_constituentPhotons
Particle	_constituentLepton

Detailed Description

A charged lepton meta-particle created by clustering photons close to the bare lepton.

Definition at line 18 of file DressedLeptons.hh.

Constructor & Destructor Documentation

DressedLepton ( const Particle & lepton ) [inline]

Definition at line 21 of file DressedLeptons.hh.

                                          :
      Particle(lepton.pid(), lepton.momentum()),
      _constituentLepton(lepton) {}

Member Function Documentation

double abseta ( ) const [inline, inherited]

Get the $|\eta|$ directly (alias).

Definition at line 73 of file ParticleBase.hh.

References FourVector::abseta(), and ParticleBase::momentum().

{ return momentum().abseta(); }

PdgId abspid ( ) const [inline, inherited]

Absolute value of the PDG ID code.

Definition at line 90 of file Particle.hh.

References Particle::_id.

{ return std::abs(_id); }

double abspseudorapidity ( ) const [inline, inherited]

Get the $|\eta|$ directly.

Definition at line 71 of file ParticleBase.hh.

References FourVector::abspseudorapidity(), and ParticleBase::momentum().

{ return momentum().abspseudorapidity(); }

double absrap ( ) const [inline, inherited]

Get the $ |y| $ directly (alias).

Definition at line 82 of file ParticleBase.hh.

References FourMomentum::absrap(), and ParticleBase::momentum().

{ return momentum().absrap(); }

double absrapidity ( ) const [inline, inherited]

Get the $ |y| $ directly.

Definition at line 80 of file ParticleBase.hh.

References FourMomentum::absrapidity(), and ParticleBase::momentum().

Referenced by CMS_2014_I1298810::analyze().

{ return momentum().absrapidity(); }

void addPhoton	(	const Particle &	p,
		bool	cluster
	)		`[inline]`

Definition at line 25 of file DressedLeptons.hh.

References DressedLepton::_constituentPhotons, Particle::momentum(), and Particle::setMomentum().

                                                    {
      _constituentPhotons.push_back(p);
      if (cluster) setMomentum(momentum() + p.momentum());
    }

vector<Particle> allDescendants ( ) const [inline, inherited]

Get a list of all the descendants (including duplication of parents and children) from the current particle

Todo:

Use recursion through replica-avoiding MCUtils functions to avoid bookkeeping duplicates

Insist that the current particle is post-hadronization, otherwise throw an exception?

Todo:: Remove this const mess crap when HepMC doesn't suck

Todo:: Would like to do this, but the range objects are broken

Definition at line 247 of file Particle.hh.

References Particle::genParticle(), Particle::isStable(), and Particle::Particle().

                                            {
      vector<Particle> rtn;
      if (isStable()) return rtn;
      /// @todo Remove this const mess crap when HepMC doesn't suck
      HepMC::GenVertex* gv = const_cast<HepMC::GenVertex*>( genParticle()->end_vertex() );
      /// @todo Would like to do this, but the range objects are broken
      // foreach (const GenParticle* gp, gv->particles(HepMC::descendants))
      //   rtn += Particle(gp);
      for (GenVertex::particle_iterator it = gv->particles_begin(HepMC::descendants); it != gv->particles_end(HepMC::descendants); ++it)
        rtn += Particle(*it);
      return rtn;
    }

double angle ( const ParticleBase & v ) const [inline, inherited]

Angle between this vector and another.

Definition at line 108 of file ParticleBase.hh.

References FourVector::angle(), and ParticleBase::momentum().

Referenced by H1_2000_S4129130::analyze(), and H1_1994_S2919893::analyze().

{ return momentum().angle(v.momentum()); }

double angle ( const FourVector & v ) const [inline, inherited]

Angle between this vector and another.

Definition at line 110 of file ParticleBase.hh.

References FourVector::angle(), and ParticleBase::momentum().

{ return momentum().angle(v); }

double angle ( const Vector3 & v3 ) const [inline, inherited]

Angle between this vector and another (3-vector)

Definition at line 112 of file ParticleBase.hh.

References FourVector::angle(), and ParticleBase::momentum().

{ return momentum().angle(v3); }

double azimuthalAngle ( const PhiMapping mapping = ZERO_2PI ) const [inline, inherited]

Azimuthal angle $\phi$ .

Definition at line 85 of file ParticleBase.hh.

References FourVector::azimuthalAngle(), and ParticleBase::momentum().

Referenced by ATLAS_2012_I1112263::analyze(), ATLAS_2012_I1095236::analyze(), ATLAS_2012_CONF_2012_001::analyze(), ATLAS_2012_I1204447::analyze(), ATLAS_2014_I1327229::analyze(), and ATLAS_2012_I943401::analyze().

{ return momentum().azimuthalAngle(mapping); }

double charge ( ) const [inline, inherited]

The charge of this Particle.

Definition at line 102 of file Particle.hh.

References Particle::pid().

Referenced by ATLAS_2014_I1282441::analyze(), CDF_1993_S2742446::analyze(), ATLAS_2011_I928289_W::FillPlots1d(), NeutralFinalState::project(), and PromptFinalState::project().

                          {
      return PID::charge(pid());
    }

vector<Particle> children ( ) const [inline, inherited]

Get a list of the direct descendants from the current particle.

Todo:: Remove this const mess crap when HepMC doesn't suck

Todo:: Would like to do this, but the range objects are broken

Definition at line 231 of file Particle.hh.

References Particle::genParticle(), Particle::isStable(), and Particle::Particle().

Referenced by FinalPartons::accept(), PDG_TAUS::analyze(), PDG_TAUS::analyzeDecay(), PDG_TAUS::analyzeRadiativeDecay(), PDG_TAUS::contains(), and PDG_TAUS::countProngs().

                                      {
      vector<Particle> rtn;
      if (isStable()) return rtn;
      /// @todo Remove this const mess crap when HepMC doesn't suck
      HepMC::GenVertex* gv = const_cast<HepMC::GenVertex*>( genParticle()->end_vertex() );
      /// @todo Would like to do this, but the range objects are broken
      // foreach (const GenParticle* gp, gv->particles(HepMC::children))
      //   rtn += Particle(gp);
      for (GenVertex::particle_iterator it = gv->particles_begin(HepMC::children); it != gv->particles_end(HepMC::children); ++it)
        rtn += Particle(*it);
      return rtn;
    }

const Particle& constituentLepton ( ) const [inline]

Definition at line 30 of file DressedLeptons.hh.

References DressedLepton::_constituentLepton.

Referenced by ATLAS_2013_I1190187::analyze(), CMS_2014_I1303894::analyze(), ATLAS_2014_I1306615::analyze(), ATLAS_2012_I1203852::analyze(), DressedLeptons::project(), ZFinder::project(), and WFinder::project().

{ return _constituentLepton; }

const Particles& constituentPhotons ( ) const [inline]

Definition at line 31 of file DressedLeptons.hh.

References DressedLepton::_constituentPhotons.

Referenced by DressedLeptons::project(), ZFinder::project(), and WFinder::project().

{ return _constituentPhotons; }

double E ( ) const [inline, inherited]

Get the energy directly.

Definition at line 40 of file ParticleBase.hh.

References FourMomentum::E(), and ParticleBase::momentum().

Referenced by H1_2000_S4129130::analyze(), CMS_2012_I1184941::analyze(), SLD_2004_S5693039::analyze(), OPAL_1998_S3780481::analyze(), SLD_1999_S3743934::analyze(), OPAL_2000_S4418603::analyze(), ARGUS_1993_S2669951::analyze(), ATLAS_2015_I1387176::analyze(), H1_1994_S2919893::analyze(), ALEPH_1999_S4193598::analyze(), OPAL_2002_S5361494::analyze(), SLD_1996_S3398250::analyze(), DELPHI_2000_S4328825::analyze(), CMS_2011_S9215166::analyze(), OPAL_1998_S3749908::analyze(), D0_2006_S6438750::analyze(), MC_PHOTONINC::analyze(), ALEPH_1996_S3196992::analyze(), MC_PHOTONKTSPLITTINGS::analyze(), MC_PHOTONJETS::analyze(), ATLAS_2012_I1082009::analyze(), MC_PHOTONS::analyze(), ARGUS_1993_S2789213::analyze(), LHCB_2013_I1208105::analyze(), ATLAS_2012_I1190891::analyze(), CMS_2013_I1218372::analyze(), ATLAS_2013_I1217863_Z::analyze(), ATLAS_2013_I1217863_W::analyze(), ATLAS_2011_S9108483::analyze(), MC_GENERIC::analyze(), ATLAS_2012_CONF_2012_109::analyze(), D0_2008_S7719523::analyze(), ALEPH_1996_S3486095::analyze(), ALEPH_2004_S5765862::analyze(), DELPHI_1996_S3430090::analyze(), Jet::hadronicEnergy(), Jet::neutralEnergy(), ALEPH_1996_S3196992::particleInJet(), and Particle::pseudojet().

{ return momentum().E(); }

double energy ( ) const [inline, inherited]

Get the energy directly (alias).

Definition at line 42 of file ParticleBase.hh.

References FourMomentum::E(), and ParticleBase::momentum().

{ return momentum().E(); }

double Et ( ) const [inline, inherited]

Get the $ E_T $ directly.

Definition at line 59 of file ParticleBase.hh.

References FourMomentum::Et(), and ParticleBase::momentum().

Referenced by CDF_1996_S3349578::_fiveJetAnalysis(), CDF_1996_S3349578::_fourJetAnalysis(), CDF_1996_S3349578::_threeJetAnalysis(), CDF_2001_S4563131::analyze(), CDF_2005_S6080774::analyze(), MC_DIPHOTON::analyze(), CDF_1998_S3618439::analyze(), CDF_1993_S2742446::analyze(), D0_2010_S8570965::analyze(), CDF_1996_S3108457::analyze(), CDF_1997_S3541940::analyze(), ATLAS_2013_I1216670::analyze(), CDF_2009_S8233977::analyze(), ATLAS_2012_I1183818::analyze(), ATLAS_2013_I1217863_Z::analyze(), ATLAS_2011_I921594::analyze(), ATLAS_2013_I1263495::analyze(), ATLAS_2013_I1217863_W::analyze(), MC_GENERIC::analyze(), CDF_1996_S3349578::analyze(), ATLAS_2011_S9019561::analyze(), CDF_2004_S5839831::analyze(), CentralEtHCM::project(), and NeutralFinalState::project().

{ return momentum().Et(); }

double eta ( ) const [inline, inherited]

Get the $\eta$ directly (alias).

Definition at line 69 of file ParticleBase.hh.

References FourVector::eta(), and ParticleBase::momentum().

{ return momentum().eta(); }

double flightLength ( ) const [inline, inherited]

Flight length (divide by mm or cm to get the appropriate units)

Definition at line 279 of file Particle.hh.

References Particle::genParticle(), Particle::isStable(), and Rivet::sqr().

                                {
      if (isStable()) return -1;
      if (genParticle() == NULL) return 0;
      if (genParticle()->production_vertex() == NULL) return 0;
      const HepMC::FourVector v1 = genParticle()->production_vertex()->position();
      const HepMC::FourVector v2 = genParticle()->end_vertex()->position();
      return sqrt(sqr(v2.x()-v1.x()) + sqr(v2.y()-v1.y()) + sqr(v2.z()-v1.z()));
    }

bool fromBottom ( ) const [inherited]

Determine whether the particle is from a b-hadron decay.

Note:: This question is valid in MC, but may not be perfectly answerable experimentally -- use this function with care when replicating experimental analyses!

Definition at line 21 of file Particle.cc.

References Particle::genParticle(), Particle::hasBottom(), Particle::isHadron(), Rivet::particles(), and Particle::pid().

Referenced by LHCB_2013_I1218996::analyze(), and ATLAS_2014_I1282447::analyze().

                                  {
    const GenVertex* prodVtx = genParticle()->production_vertex();
    if (prodVtx == NULL) return false;
    foreach (const GenParticle* ancestor, particles(prodVtx, HepMC::ancestors)) {
      const PdgId pid = ancestor->pdg_id();
      if (ancestor->status() == 2 && (PID::isHadron(pid) && PID::hasBottom(pid))) return true;
    }
    return false;
  }

bool fromCharm ( ) const [inherited]

Determine whether the particle is from a c-hadron decay.

Note:: If a hadron contains b and c quarks it is considered a bottom hadron and NOT a charm hadron.; This question is valid in MC, but may not be perfectly answerable experimentally -- use this function with care when replicating experimental analyses!

Definition at line 32 of file Particle.cc.

References Particle::genParticle(), Particle::hasBottom(), Particle::hasCharm(), Particle::isHadron(), Rivet::particles(), and Particle::pid().

                                 {
    const GenVertex* prodVtx = genParticle()->production_vertex();
    if (prodVtx == NULL) return false;
    foreach (const GenParticle* ancestor, particles(prodVtx, HepMC::ancestors)) {
      const PdgId pid = ancestor->pdg_id();
      if (ancestor->status() == 2 && (PID::isHadron(pid) && PID::hasCharm(pid) && !PID::hasBottom(pid))) return true;
    }
    return false;
  }

bool fromDecay ( ) const [inline, inherited]

Determine whether the particle is from a hadron or tau decay.

Specifically, walk up the ancestor chain until a status 2 hadron or tau is found, if at all.

Note:: This question is valid in MC, but may not be perfectly answerable experimentally -- use this function with care when replicating experimental analyses!

Definition at line 217 of file Particle.hh.

References Particle::fromHadron(), and Particle::fromPromptTau().

Referenced by MC_ParticleAnalysis::_analyze(), FinalPartons::accept(), CMS_2015_I1346843::analyze(), and DressedLeptons::project().

{ return fromHadron() || fromPromptTau(); }

bool fromHadron ( ) const [inherited]

Determine whether the particle is from a hadron decay.

Note:: This question is valid in MC, but may not be perfectly answerable experimentally -- use this function with care when replicating experimental analyses!

Definition at line 44 of file Particle.cc.

References Particle::genParticle(), Particle::isHadron(), Rivet::particles(), and Particle::pid().

Referenced by ATLAS_2015_I1364361::analyze(), Particle::fromDecay(), and Particle::fromTau().

                                  {
    const GenVertex* prodVtx = genParticle()->production_vertex();
    if (prodVtx == NULL) return false;
    foreach (const GenParticle* ancestor, particles(prodVtx, HepMC::ancestors)) {
      const PdgId pid = ancestor->pdg_id();
      if (ancestor->status() == 2 && PID::isHadron(pid)) return true;
    }
    return false;
  }

bool fromPromptTau ( ) const [inline, inherited]

Determine whether the particle is from a prompt tau decay.

Note:: This question is valid in MC, but may not be perfectly answerable experimentally -- use this function with care when replicating experimental analyses!

Definition at line 207 of file Particle.hh.

References Particle::fromTau().

Referenced by Particle::fromDecay().

{ return fromTau(true); }

bool fromTau ( bool prompt_taus_only = false ) const [inherited]

Determine whether the particle is from a tau decay.

Note:: This question is valid in MC, but may not be perfectly answerable experimentally -- use this function with care when replicating experimental analyses!

Definition at line 55 of file Particle.cc.

References Particle::fromHadron(), Particle::genParticle(), Rivet::particles(), Particle::pid(), and Rivet::PID::TAU.

Referenced by Particle::fromPromptTau().

                                                    {
    if (prompt_taus_only && fromHadron()) return false;
    const GenVertex* prodVtx = genParticle()->production_vertex();
    if (prodVtx == NULL) return false;
    foreach (const GenParticle* ancestor, particles(prodVtx, HepMC::ancestors)) {
      const PdgId pid = ancestor->pdg_id();
      if (ancestor->status() == 2 && abs(pid) == PID::TAU) return true;
    }
    return false;
  }

const GenParticle* genParticle ( ) const [inline, inherited]

Get a const pointer to the original GenParticle.

Definition at line 64 of file Particle.hh.

References Particle::_original.

Referenced by FinalPartons::accept(), FinalState::accept(), Particle::allDescendants(), BABAR_2005_S6181155::analyze(), BELLE_2001_S4598261::analyze(), BABAR_2003_I593379::analyze(), BABAR_2013_I1238276::analyze(), ARGUS_1993_S2653028::analyze(), H1_2000_S4129130::analyze(), BELLE_2008_I786560::analyze(), ARGUS_1993_S2669951::analyze(), H1_1994_S2919893::analyze(), BABAR_2007_S7266081::analyze(), ATLAS_2011_S8994773::analyze(), ATLAS_2011_S9035664::analyze(), CDF_2008_S7540469::analyze(), D0_2010_S8570965::analyze(), CMS_2013_I1256943::analyze(), ARGUS_1993_S2789213::analyze(), ATLAS_2012_I1204447::analyze(), ATLAS_2014_I1327229::analyze(), ATLAS_2010_S8894728::analyze(), ATLAS_2014_I1282447::analyze(), InvMassFinalState::calc(), Particle::children(), Jet::containsBottom(), Jet::containsCharm(), Jet::containsParticle(), ATLAS_2011_I944826::daughtersSurviveCuts(), Particle::flightLength(), Particle::fromBottom(), Particle::fromCharm(), Particle::fromHadron(), ATLAS_2014_I1306615::fromHadronDecay(), Particle::fromTau(), ATLAS_2012_I1204447::get_tau_neutrino_mom(), ATLAS_2014_I1327229::get_tau_neutrino_momentum(), LHCB_2014_I1281685::getAncestorSumLifetime(), LHCB_2010_S8758301::getLongestLivedAncestor(), LHCB_2011_I917009::getMotherLifeTimeSum(), LHCB_2012_I1119400::getMotherLifeTimeSum(), ATLAS_2011_I944826::getPerpFlightDistance(), Particle::hasAncestor(), ATLAS_2014_I1282447::isFromBDecay(), PromptFinalState::isPrompt(), Particle::isStable(), Particle::operator const GenParticle *(), DISLepton::project(), MergedFinalState::project(), DISFinalState::project(), PrimaryHadrons::project(), HeavyHadrons::project(), and Particle::stableDescendants().

                                           {
      return _original;
    }

bool hasAncestor ( PdgId pdg_id ) const [inherited]

Check whether a given PID is found in the GenParticle's ancestor list

Note:: This question is valid in MC, but may not be answerable experimentally -- use this function with care when replicating experimental analyses!

Todo:: Neaten this up with C++11, via one walker function and several uses with lamba tests

Definition at line 11 of file Particle.cc.

References Particle::genParticle(), and Rivet::particles().

Referenced by ALICE_2014_I1300380::analyze(), ALICE_2011_S8945144::analyze(), ALICE_2011_S8909580::analyze(), ATLAS_2014_I1282441::analyze(), ALICE_2015_I1357424::analyze(), CMS_2011_S8978280::analyze(), CMS_2014_I1303894::analyze(), ATLAS_2012_I1204447::analyze(), and ATLAS_2014_I1327229::analyze().

                                               {
    const GenVertex* prodVtx = genParticle()->production_vertex();
    if (prodVtx == NULL) return false;
    foreach (const GenParticle* ancestor, particles(prodVtx, HepMC::ancestors)) {
      if (ancestor->pdg_id() == pdg_id) return true;
    }
    return false;
  }

bool hasBottom ( ) const [inline, inherited]

Does this (hadron) contain a b quark?

Definition at line 126 of file Particle.hh.

References Particle::pid().

Referenced by Particle::fromBottom(), and Particle::fromCharm().

{ return PID::hasBottom(pid()); }

bool hasCharm ( ) const [inline, inherited]

Does this (hadron) contain a c quark?

Definition at line 129 of file Particle.hh.

References Particle::pid().

Referenced by LHCB_2013_I1218996::analyze(), ATLAS_2014_I1282447::analyze(), and Particle::fromCharm().

{ return PID::hasCharm(pid()); }

bool isBaryon ( ) const [inline, inherited]

Is this a baryon?

Definition at line 117 of file Particle.hh.

References Particle::pid().

{ return PID::isBaryon(pid()); }

bool isHadron ( ) const [inline, inherited]

Is this a hadron?

Definition at line 111 of file Particle.hh.

References Particle::pid().

Referenced by LHCB_2013_I1218996::analyze(), Particle::fromBottom(), Particle::fromCharm(), and Particle::fromHadron().

{ return PID::isHadron(pid()); }

bool isLepton ( ) const [inline, inherited]

Is this a lepton?

Definition at line 120 of file Particle.hh.

References Particle::pid().

{ return PID::isLepton(pid()); }

bool isMeson ( ) const [inline, inherited]

Is this a meson?

Definition at line 114 of file Particle.hh.

References Particle::pid().

{ return PID::isMeson(pid()); }

bool isNeutrino ( ) const [inline, inherited]

Is this a neutrino?

Definition at line 123 of file Particle.hh.

References Particle::pid().

Referenced by ATLAS_2015_I1364361::analyze(), and ATLAS_2014_I1307756::analyze().

{ return PID::isNeutrino(pid()); }

bool isStable ( ) const [inline, inherited]

Whether this particle is stable according to the generator.

Definition at line 226 of file Particle.hh.

References Particle::genParticle().

Referenced by Particle::allDescendants(), CMS_2015_I1346843::analyze(), Particle::children(), Particle::flightLength(), and Particle::stableDescendants().

                          {
      return genParticle() != NULL && genParticle()->status() == 1 && genParticle()->end_vertex() == NULL;
    }

bool isVisible ( ) const [inline, inherited]

Is this particle potentially visible in a detector?

Definition at line 132 of file Particle.hh.

References Rivet::PID::GLUON, Rivet::PID::isHadron(), Rivet::PID::PHOTON, Particle::pid(), and Rivet::PID::threeCharge().

                           {
      // Charged particles are visible
      if ( PID::threeCharge(pid()) != 0 ) return true;
      // Neutral hadrons are visible
      if ( PID::isHadron(pid()) ) return true;
      // Photons are visible
      if ( pid() == PID::PHOTON ) return true;
      // Gluons are visible (for parton level analyses)
      if ( pid() == PID::GLUON ) return true;
      // Everything else is invisible
      return false;
    }

double mass ( ) const [inline, inherited]

Get the mass directly.

Definition at line 62 of file ParticleBase.hh.

References FourMomentum::mass(), and ParticleBase::momentum().

Referenced by ALICE_2014_I1300380::analyze(), ALICE_2011_S8945144::analyze(), ARGUS_1993_S2669951::analyze(), ATLAS_2014_I1282441::analyze(), ATLAS_2012_I1119557::analyze(), ARGUS_1993_S2789213::analyze(), ATLAS_2013_I1217863_Z::analyze(), and MC_VH2BB::analyze().

{ return momentum().mass(); }

double mass2 ( ) const [inline, inherited]

Get the mass**2 directly.

Definition at line 64 of file ParticleBase.hh.

References FourMomentum::mass2(), and ParticleBase::momentum().

{ return momentum().mass2(); }

const FourMomentum& mom ( ) const [inline, inherited]

Get equivalent single momentum four-vector (const) (alias).

Definition at line 28 of file ParticleBase.hh.

References ParticleBase::momentum().

Referenced by CMS_2015_I1346843::analyze(), Hemispheres::calc(), Particle::pseudojet(), Jet::setState(), and Variables::Variables().

{ return momentum(); };

const FourMomentum& momentum ( ) const [inline, virtual, inherited]

The momentum.

Implements ParticleBase.

Definition at line 72 of file Particle.hh.

References Particle::_momentum.

                                         {
      return _momentum;
    }

operator const FourMomentum & ( ) const [inline, inherited]

Cast operator for conversion to FourMomentum.

Definition at line 31 of file ParticleBase.hh.

References ParticleBase::momentum().

{ return momentum(); }

operator const GenParticle * ( ) const [inline, inherited]

Cast operator for conversion to GenParticle*.

Definition at line 69 of file Particle.hh.

References Particle::genParticle().

{ return genParticle(); }

operator PseudoJet ( ) const [inline, inherited]

Cast operator to FastJet3 PseudoJet.

Definition at line 55 of file Particle.hh.

References Particle::pseudojet().

{ return pseudojet(); }

Vector3 p3 ( ) const [inline, inherited]

Get the 3-momentum directly.

Definition at line 91 of file ParticleBase.hh.

References ParticleBase::momentum(), and FourVector::vector3().

Referenced by ARGUS_1993_S2653028::analyze(), OPAL_1994_S2927284::analyze(), SLD_2004_S5693039::analyze(), BELLE_2008_I786560::analyze(), OPAL_1998_S3780481::analyze(), SLD_1999_S3743934::analyze(), ARGUS_1993_S2669951::analyze(), OPAL_1995_S3198391::analyze(), OPAL_1997_S3608263::analyze(), CMS_2011_S8957746::analyze(), ALEPH_2002_S4823664::analyze(), DELPHI_1999_S3960137::analyze(), OPAL_1996_S3257789::analyze(), OPAL_1998_S3702294::analyze(), ATLAS_2014_I1282441::analyze(), BABAR_2007_S7266081::analyze(), DELPHI_1995_S3137023::analyze(), ATLAS_2010_CONF_2010_049::analyze(), OPAL_1998_S3749908::analyze(), OPAL_1997_S3396100::analyze(), ATLAS_2014_I1298811::analyze(), ATLAS_2012_I1082009::analyze(), ARGUS_1993_S2789213::analyze(), ATLAS_2012_I1183818::analyze(), ATLAS_2012_I1124167::analyze(), TASSO_1990_S2148048::analyze(), ALEPH_1996_S3486095::analyze(), ALEPH_2004_S5765862::analyze(), DELPHI_1996_S3430090::analyze(), and ATLAS_2012_I1091481::getPionEnergy().

{ return momentum().vector3(); }

PdgId pdgId ( ) const [inline, inherited]

This Particle's PDG ID code (alias).

Deprecated:: Prefer the pid/abspid form

Definition at line 93 of file Particle.hh.

References Particle::_id.

Referenced by ALICE_2014_I1300380::analyze(), ATLAS_2014_I1298811::analyze(), LHCB_2014_I1281685::analyze(), and FinalState::project().

{ return _id; }

double perp ( ) const [inline, inherited]

Get the $ p_T $ directly (alias).

Definition at line 49 of file ParticleBase.hh.

References ParticleBase::pt().

{ return pt(); }

double perp2 ( ) const [inline, inherited]

Get the $ p_T^2 $ directly (alias).

Definition at line 56 of file ParticleBase.hh.

References ParticleBase::pt2().

{ return pt2(); }

double phi ( const PhiMapping mapping = ZERO_2PI ) const [inline, inherited]

Get the $\phi$ directly.

Definition at line 87 of file ParticleBase.hh.

References ParticleBase::momentum(), and FourVector::phi().

{ return momentum().phi(mapping); }

PdgId pid ( ) const [inline, inherited]

This Particle's PDG ID code.

Definition at line 88 of file Particle.hh.

References Particle::_id.

Referenced by BABAR_2003_I593379::analyze(), BELLE_2001_S4598261::analyze(), ARGUS_1993_S2653028::analyze(), OPAL_1993_S2692198::analyze(), TOTEM_2012_002::analyze(), SLD_2004_S5693039::analyze(), BELLE_2008_I786560::analyze(), CMS_2010_S8656010::analyze(), OPAL_1998_S3780481::analyze(), LHCF_2012_I1115479::analyze(), SLD_1999_S3743934::analyze(), ALICE_2011_S8909580::analyze(), ALICE_2011_S8945144::analyze(), ARGUS_1993_S2669951::analyze(), ALICE_2012_I1181770::analyze(), H1_1994_S2919893::analyze(), ALICE_2015_I1357424::analyze(), BABAR_2007_S7266081::analyze(), CMS_2010_S8547297::analyze(), DELPHI_2000_S4328825::analyze(), SLD_1996_S3398250::analyze(), CDF_2008_S7540469::analyze(), OPAL_2002_S5361494::analyze(), MC_IDENTIFIED::analyze(), STAR_2006_S6500200::analyze(), MC_HFJETS::analyze(), MC_WINC::analyze(), ATLAS_2015_I1364361::analyze(), STAR_2006_S6860818::analyze(), CMS_2011_S8884919::analyze(), LHCB_2010_S8758301::analyze(), CMS_2013_I1256943::analyze(), LHCB_2011_I917009::analyze(), ATLAS_2012_I1126136::analyze(), ARGUS_1993_S2789213::analyze(), ATLAS_2012_I1183818::analyze(), LHCB_2012_I1119400::analyze(), ATLAS_2012_I1095236::analyze(), STAR_2008_S7869363::analyze(), ATLAS_2012_CONF_2012_153::analyze(), MC_SUSY::analyze(), ATLAS_2014_I1306615::analyze(), ATLAS_2011_I944826::analyze(), ALEPH_1996_S3486095::analyze(), ATLAS_2012_I1203852::analyze(), PDG_TAUS::analyzeRadiativeDecay(), InvMassFinalState::calc(), Particle::charge(), Jet::containsBottom(), Jet::containsCharm(), Jet::containsParticleId(), CMS_2013_I1122847::cosThetaCS(), Particle::fromBottom(), Particle::fromCharm(), Particle::fromHadron(), Particle::fromTau(), Rivet::hadronFilter(), Jet::hadronicEnergy(), Particle::hasBottom(), Particle::hasCharm(), Rivet::identifyZstates(), LeadingParticlesFinalState::inList(), Particle::isBaryon(), Particle::isHadron(), Particle::isLepton(), Particle::isMeson(), Particle::isNeutrino(), ATLAS_2012_I1204447::isonZ(), ATLAS_2014_I1327229::isonZ(), ATLAS_2014_I1327229::isOSSF_mass(), Particle::isVisible(), Jet::neutralEnergy(), Rivet::nonHadronFilter(), HasPID::operator()(), ChargedLeptons::project(), DISLepton::project(), PrimaryHadrons::project(), NeutralFinalState::project(), PromptFinalState::project(), HeavyHadrons::project(), ZFinder::project(), WFinder::project(), IdentifiedFinalState::project(), VetoedFinalState::project(), and Particle::threeCharge().

{ return _id; }

double polarAngle ( ) const [inline, inherited]

Angle subtended by the 3-vector and the z-axis.

Definition at line 103 of file ParticleBase.hh.

References ParticleBase::momentum(), and FourVector::polarAngle().

{ return momentum().polarAngle(); }

virtual fastjet::PseudoJet pseudojet ( ) const [inline, virtual, inherited]

Converter to FastJet3 PseudoJet.

Definition at line 50 of file Particle.hh.

References ParticleBase::E(), ParticleBase::mom(), ParticleBase::px(), ParticleBase::py(), and ParticleBase::pz().

Referenced by Particle::operator PseudoJet().

                                               {
      return fastjet::PseudoJet(mom().px(), mom().py(), mom().pz(), mom().E());
    }

double pseudorapidity ( ) const [inline, inherited]

Get the $\eta$ directly.

Definition at line 67 of file ParticleBase.hh.

References FourVector::eta(), and ParticleBase::momentum().

{ return momentum().eta(); }

double pt ( ) const [inline, inherited]

Get the $ p_T $ directly.

Definition at line 45 of file ParticleBase.hh.

References ParticleBase::momentum(), and FourMomentum::pt().

Referenced by ParticleBase::perp(), and ParticleBase::pT().

{ return momentum().pt(); }

double pT ( ) const [inline, inherited]

Get the $ p_T $ directly (alias).

Definition at line 47 of file ParticleBase.hh.

References ParticleBase::pt().

{ return pt(); }

double pt2 ( ) const [inline, inherited]

Get the $ p_T^2 $ directly.

Definition at line 52 of file ParticleBase.hh.

References ParticleBase::momentum(), and FourMomentum::pt2().

Referenced by ParticleBase::perp2(), and ParticleBase::pT2().

{ return momentum().pt2(); }

double pT2 ( ) const [inline, inherited]

Get the $ p_T^2 $ directly (alias).

Definition at line 54 of file ParticleBase.hh.

References ParticleBase::pt2().

Referenced by ATLAS_2011_S9108483::analyze().

{ return pt2(); }

double px ( ) const [inline, inherited]

x component of momentum.

Definition at line 96 of file ParticleBase.hh.

References ParticleBase::momentum(), and FourVector::x().

Referenced by ATLAS_2012_CONF_2012_104::analyze(), ATLAS_2012_I1095236::analyze(), ATLAS_2012_I1180197::analyze(), ALEPH_1996_S3196992::particleInJet(), and Particle::pseudojet().

{ return momentum().x(); }

double py ( ) const [inline, inherited]

y component of momentum.

Definition at line 98 of file ParticleBase.hh.

References ParticleBase::momentum(), and FourVector::y().

Referenced by ATLAS_2012_CONF_2012_104::analyze(), ATLAS_2012_I1095236::analyze(), ATLAS_2012_I1180197::analyze(), ALEPH_1996_S3196992::particleInJet(), and Particle::pseudojet().

{ return momentum().y(); }

double pz ( ) const [inline, inherited]

z component of momentum.

Definition at line 100 of file ParticleBase.hh.

References ParticleBase::momentum(), and FourVector::z().

Referenced by SFM_1984_S1178091::analyze(), ATLAS_2011_S9108483::analyze(), ALEPH_1996_S3196992::particleInJet(), and Particle::pseudojet().

{ return momentum().z(); }

double rap ( ) const [inline, inherited]

Get the $ y $ directly (alias).

Definition at line 78 of file ParticleBase.hh.

References ParticleBase::momentum(), and FourMomentum::rapidity().

Referenced by ATLAS_2013_I1244522::analyze().

{ return momentum().rapidity(); }

double rapidity ( ) const [inline, inherited]

Particle& setMomentum ( const FourMomentum & momentum ) [inline, inherited]

Set the momentum.

Definition at line 76 of file Particle.hh.

References Particle::_momentum, and Particle::momentum().

Referenced by DressedLepton::addPhoton(), ATLAS_2012_I1204447::analyze(), ATLAS_2014_I1327229::analyze(), and DISFinalState::project().

                                                        {
      _momentum = momentum;
      return *this;
    }

vector<Particle> stableDescendants ( ) const [inline, inherited]

Get a list of all the stable descendants from the current particle

Todo:

Use recursion through replica-avoiding MCUtils functions to avoid bookkeeping duplicates

Insist that the current particle is post-hadronization, otherwise throw an exception?

Todo:: Remove this const mess crap when HepMC doesn't suck

Todo:: Would like to do this, but the range objects are broken

Definition at line 263 of file Particle.hh.

References Particle::genParticle(), Particle::isStable(), and Particle::Particle().

Referenced by TauFinder::isHadronic().

                                               {
      vector<Particle> rtn;
      if (isStable()) return rtn;
      /// @todo Remove this const mess crap when HepMC doesn't suck
      HepMC::GenVertex* gv = const_cast<HepMC::GenVertex*>( genParticle()->end_vertex() );
      /// @todo Would like to do this, but the range objects are broken
      // foreach (const GenParticle* gp, gv->particles(HepMC::descendants))
      //   if (gp->status() == 1 && gp->end_vertex() == NULL)
      //     rtn += Particle(gp);
      for (GenVertex::particle_iterator it = gv->particles_begin(HepMC::descendants); it != gv->particles_end(HepMC::descendants); ++it)
        if ((*it)->status() == 1 && (*it)->end_vertex() == NULL)
          rtn += Particle(*it);
      return rtn;
    }

double theta ( ) const [inline, inherited]

Synonym for polarAngle.

Definition at line 105 of file ParticleBase.hh.

References ParticleBase::momentum(), and FourVector::theta().

Referenced by CMS_2012_I1184941::analyze(), and ALEPH_1996_S3196992::analyze().

{ return momentum().theta(); }

int threeCharge ( ) const [inline, inherited]

Three times the charge of this Particle (i.e. integer multiple of smallest quark charge).

Definition at line 106 of file Particle.hh.

References Particle::pid().

Referenced by PDG_TAUS::countProngs(), Rivet::diffCharge(), Rivet::oppCharge(), Rivet::sameCharge(), and Rivet::sameSign().

                            {
      return PID::threeCharge(pid());
    }

Member Data Documentation

Particle _constituentLepton [private]

Definition at line 36 of file DressedLeptons.hh.

Referenced by DressedLepton::constituentLepton().

Particles _constituentPhotons [private]

Definition at line 35 of file DressedLeptons.hh.

Referenced by DressedLepton::addPhoton(), and DressedLepton::constituentPhotons().

The documentation for this class was generated from the following file:

DressedLeptons.hh

Public Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation