Representation of a clustered jet of particles. More...

#include <Jet.hh>

Inheritance diagram for Jet:

Collaboration diagram for Jet:

Public Member Functions
Constructors
	Jet (const fastjet::PseudoJet &pj, const Particles &particles=Particles(), const Particles &tags=Particles())
	Constructor from a FastJet PseudoJet, with optional full particle constituents information.
	Jet (const FourMomentum &pjet, const Particles &particles=Particles(), const Particles &tags=Particles())
	Set the jet data, with optional full particle information.
	Jet (const Particles &particles, const FourMomentum &pjet)
	Jet ()
	Default constructor -- only for STL storability.
Access jet constituents
size_t	size () const
	Number of particles in this jet.
vector< Particle > &	particles ()
	Get the particles in this jet.
const vector< Particle > &	particles () const
	Get the particles in this jet (const version)
vector< Particle > &	constituents ()
	Get the particles in this jet (FastJet-like alias)
const vector< Particle > &	constituents () const
	Get the particles in this jet (FastJet-like alias, const version)
bool	containsParticle (const Particle &particle) const
	Check whether this jet contains a particular particle.
bool	containsPID (const Particle &particle) const
	Nicer alias for containsParticleId.
bool	containsParticleId (PdgId pid) const
	Check whether this jet contains a certain particle type.
bool	containsPID (PdgId pid) const
	Nicer alias for containsParticleId.
bool	containsParticleId (const vector< PdgId > &pids) const
	Check whether this jet contains at least one of certain particle types.
bool	containsPID (const vector< PdgId > &pids) const
	Nicer alias for containsParticleId.
Tagging
Note: General sources of tag particles are planned. The default jet finding adds b-hadron, c-hadron, and tau tags by ghost association.
Particles &	tags ()
	Particles which have been tag-matched to this jet.
const Particles &	tags () const
	Particles which have been tag-matched to this jet (const version)
Particles	tags (const Cut &c) const
	Particles which have been tag-matched to this jet _and_ pass a Cut.
Particles	bTags (const Cut &c=Cuts::open()) const
	b particles which have been tag-matched to this jet (and pass an optional Cut)
bool	bTagged (const Cut &c=Cuts::open()) const
	Does this jet have at least one b-tag (that passes an optional Cut)?
Particles	cTags (const Cut &c=Cuts::open()) const
	c (and not b) particles which have been tag-matched to this jet (and pass an optional Cut)
bool	cTagged (const Cut &c=Cuts::open()) const
	Does this jet have at least one c-tag (that passes an optional Cut)?
Particles	tauTags (const Cut &c=Cuts::open()) const
	Tau particles which have been tag-matched to this jet (and pass an optional Cut)
bool	tauTagged (const Cut &c=Cuts::open()) const
	Does this jet have at least one tau-tag (that passes an optional Cut)?
bool	containsBottom (bool include_decay_products=true) const
	Check whether this jet contains a bottom-flavoured hadron.
bool	containsCharm (bool include_decay_products=true) const
	Check whether this jet contains a charm-flavoured hadron.
Access additional effective jet 4-vector properties
const FourMomentum &	momentum () const
	Get equivalent single momentum four-vector.
double	totalEnergy () const
	Get the total energy of this jet.
double	neutralEnergy () const
	Get the energy carried in this jet by neutral particles.
double	hadronicEnergy () const
	Get the energy carried in this jet by hadrons.
Interaction with FastJet
const fastjet::PseudoJet &	pseudojet () const
	Access the internal FastJet3 PseudoJet (as a const reference)
	operator const fastjet::PseudoJet & () const
	Cast operator to FastJet3 PseudoJet (as a const reference)
Set the jet constituents and properties
Jet &	setState (const fastjet::PseudoJet &pj, const Particles &particles=Particles(), const Particles &tags=Particles())
	Set the jet data from a FastJet PseudoJet, with optional particle constituents and tags lists.
Jet &	setState (const FourMomentum &mom, const Particles &particles, const Particles &tags=Particles())
	Set all the jet data, with optional full particle constituent and tag information.
Jet &	setState (const Particles &particles, const FourMomentum &mom)
Jet &	setParticles (const Particles &particles)
	Set the particles collection with full particle information.
Jet &	setConstituents (const Particles &particles)
Jet &	clear ()
	Reset this jet as empty.
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
fastjet::PseudoJet	_pseudojet
	FJ3 PseudoJet member to unify PseudoJet and Jet.
Particles	_particles
Particles	_tags
	Particles used to tag this jet (can be anything, but c and b hadrons are the most common)
FourMomentum	_momentum
	Effective jet 4-vector (just for caching)

Detailed Description

Representation of a clustered jet of particles.

Definition at line 17 of file Jet.hh.

Constructor & Destructor Documentation

Jet	(	const fastjet::PseudoJet &	pj,
		const Particles &	particles = `Particles()`,
		const Particles &	tags = `Particles()`
	)		`[inline]`

Constructor from a FastJet PseudoJet, with optional full particle constituents information.

Definition at line 24 of file Jet.hh.

References Jet::particles(), Jet::setState(), and Jet::tags().

                                                                                                               {
      setState(pj, particles, tags);
    }

Jet	(	const FourMomentum &	pjet,
		const Particles &	particles = `Particles()`,
		const Particles &	tags = `Particles()`
	)		`[inline]`

Set the jet data, with optional full particle information.

Definition at line 29 of file Jet.hh.

References Jet::particles(), Jet::setState(), and Jet::tags().

                                                                                                             {
      setState(pjet, particles, tags);
    }

Jet	(	const Particles &	particles,
		const FourMomentum &	pjet
	)		`[inline]`

Set all the jet data, with full particle information.

Deprecated:: Prefer the form where the 4-vec comes first and the particles list is optional.

Definition at line 36 of file Jet.hh.

References Jet::setState().

                                                              {
      setState(pjet, particles);
    }

Jet ( ) [inline]

Default constructor -- only for STL storability.

Definition at line 41 of file Jet.hh.

References Jet::clear().

{ clear(); }

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(); }

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(); }

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); }

bool bTagged ( const Cut & c = Cuts::open() ) const [inline]

Does this jet have at least one b-tag (that passes an optional Cut)?

Definition at line 101 of file Jet.hh.

References Jet::bTags().

Referenced by ATLAS_2012_I1188891::analyze(), CDF_2008_S7782535::analyze(), EXAMPLE::analyze(), ATLAS_2012_I1126136::analyze(), ATLAS_2011_CONF_2011_098::analyze(), ATLAS_2012_I1112263::analyze(), ATLAS_2012_I1095236::analyze(), MC_TTBAR::analyze(), and MC_VH2BB::analyze().

{ return !bTags(c).empty(); }

Particles bTags ( const Cut & c = Cuts::open() ) const

b particles which have been tag-matched to this jet (and pass an optional Cut)

The default jet finding adds b-hadron tags by ghost association.

Definition at line 162 of file Jet.cc.

References Rivet::PID::hasBottom(), and Jet::tags().

Referenced by MC_JETTAGS::analyze(), ATLAS_2014_I1304688::analyze(), ATLAS_2015_I1345452::analyze(), and Jet::bTagged().

                                         {
    Particles rtn;
    foreach (const Particle& tp, tags()) {
      if (hasBottom(tp) && c->accept(tp)) rtn.push_back(tp);
    }
    return rtn;
  }

Jet & clear ( )

Reset this jet as empty.

Definition at line 10 of file Jet.cc.

References Jet::_momentum, Jet::_particles, and Jet::_pseudojet.

Referenced by Jet::Jet(), and Jet::setState().

                  {
    _momentum = FourMomentum();
    _pseudojet.reset(0,0,0,0);
    _particles.clear();
    return *this;
  }

vector<Particle>& constituents ( ) [inline]

Get the particles in this jet (FastJet-like alias)

Definition at line 58 of file Jet.hh.

References Jet::particles().

{ return particles(); }

const vector<Particle>& constituents ( ) const [inline]

Get the particles in this jet (FastJet-like alias, const version)

Definition at line 60 of file Jet.hh.

References Jet::particles().

{ return particles(); }

bool containsBottom ( bool include_decay_products = true ) const

Check whether this jet contains a bottom-flavoured hadron.

Deprecated:: The bTags() or bTagged() function is probably what you want for tagging. This one ignores the tags() list and draws conclusions based directly on the jet constituents; the other gives a much better match to typical experimental methods.

Note:: The decision is made by first trying to find a bottom-flavoured particle in the particles list. Most likely this will fail unless bottom hadrons are set stable. If include_decay_products is true (the default), a fallback is attempted, using the post-hadronization ancestor history of all constituents.

Definition at line 134 of file Jet.cc.

References Rivet::PID::BQUARK, Particle::genParticle(), Rivet::PID::hasBottom(), Rivet::PID::isHadron(), Rivet::particles(), Jet::particles(), Rivet::pi, and Particle::pid().

                                                            {
    foreach (const Particle& p, particles()) {
      const PdgId pid = p.pid();
      if (abs(pid) == PID::BQUARK) return true;
      if (PID::isHadron(pid) && PID::hasBottom(pid)) return true;
      if (include_decay_products) {
        const HepMC::GenVertex* gv = p.genParticle()->production_vertex();
        if (gv) {
          foreach (const GenParticle* pi, Rivet::particles(gv, HepMC::ancestors)) {
            const PdgId pid2 = pi->pdg_id();
            if (PID::isHadron(pid2) && PID::hasBottom(pid2)) return true;
          }
        }
      }
    }
    return false;
  }

bool containsCharm ( bool include_decay_products = true ) const

Check whether this jet contains a charm-flavoured hadron.

Deprecated:: The cTags() or cTagged() function is probably what you want for tagging. This one ignores the tags() list and draws conclusions based directly on the jet constituents; the other gives a much better match to typical experimental methods.

Note:: The decision is made by first trying to find a charm-flavoured particle in the particles list. Most likely this will fail unless charmed hadrons are set stable. If include_decay_products is true (the default), a fallback is attempted, using the post-hadronization ancestor history of all constituents.

Definition at line 115 of file Jet.cc.

References Rivet::PID::CQUARK, Particle::genParticle(), Rivet::PID::hasCharm(), Rivet::PID::isHadron(), Rivet::particles(), Jet::particles(), Rivet::pi, and Particle::pid().

                                                           {
    foreach (const Particle& p, particles()) {
      const PdgId pid = p.pid();
      if (abs(pid) == PID::CQUARK) return true;
      if (PID::isHadron(pid) && PID::hasCharm(pid)) return true;
      if (include_decay_products) {
        const HepMC::GenVertex* gv = p.genParticle()->production_vertex();
        if (gv) {
          foreach (const GenParticle* pi, Rivet::particles(gv, HepMC::ancestors)) {
            const PdgId pid2 = pi->pdg_id();
            if (PID::isHadron(pid2) && PID::hasCharm(pid2)) return true;
          }
        }
      }
    }
    return false;
  }

bool containsParticle ( const Particle & particle ) const

Check whether this jet contains a particular particle.

Definition at line 61 of file Jet.cc.

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

Referenced by Jet::containsPID().

                                                           {
    const int barcode = particle.genParticle()->barcode();
    foreach (const Particle& p, particles()) {
      if (p.genParticle()->barcode() == barcode) return true;
    }
    return false;
  }

bool containsParticleId ( PdgId pid ) const

Check whether this jet contains a certain particle type.

Definition at line 70 of file Jet.cc.

References Jet::particles(), and Particle::pid().

Referenced by Jet::containsPID().

                                              {
    foreach (const Particle& p, particles()) {
      if (p.pid() == pid) return true;
    }
    return false;
  }

bool containsParticleId ( const vector< PdgId > & pids ) const

Check whether this jet contains at least one of certain particle types.

Definition at line 78 of file Jet.cc.

References Jet::particles(), and Particle::pid().

                                                              {
    foreach (const Particle& p, particles()) {
      foreach (PdgId pid, pids) {
        if (p.pid() == pid) return true;
      }
    }
    return false;
  }

bool containsPID ( const Particle & particle ) const [inline]

Nicer alias for containsParticleId.

Definition at line 65 of file Jet.hh.

References Jet::containsParticle().

{ return containsParticle(particle); }

bool containsPID ( PdgId pid ) const [inline]

Nicer alias for containsParticleId.

Definition at line 70 of file Jet.hh.

References Jet::containsParticleId().

{ return containsParticleId(pid); }

bool containsPID ( const vector< PdgId > & pids ) const [inline]

Nicer alias for containsParticleId.

Definition at line 75 of file Jet.hh.

References Jet::containsParticleId().

{ return containsParticleId(pids); }

bool cTagged ( const Cut & c = Cuts::open() ) const [inline]

Does this jet have at least one c-tag (that passes an optional Cut)?

Definition at line 109 of file Jet.hh.

References Jet::cTags().

Referenced by ATLAS_2012_I1188891::analyze().

{ return !cTags(c).empty(); }

Particles cTags ( const Cut & c = Cuts::open() ) const

c (and not b) particles which have been tag-matched to this jet (and pass an optional Cut)

The default jet finding adds c-hadron tags by ghost association.

Todo:: Is making b and c tags exclusive the right thing to do?

Definition at line 171 of file Jet.cc.

References Rivet::PID::hasBottom(), Rivet::PID::hasCharm(), and Jet::tags().

Referenced by MC_JETTAGS::analyze(), and Jet::cTagged().

                                         {
    Particles rtn;
    foreach (const Particle& tp, tags()) {
      /// @todo Is making b and c tags exclusive the right thing to do?
      if (hasCharm(tp) && !hasBottom(tp) && c->accept(tp)) rtn.push_back(tp);
    }
    return rtn;
  }

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 hadronicEnergy ( ) const

Get the energy carried in this jet by hadrons.

Definition at line 103 of file Jet.cc.

References ParticleBase::E(), Rivet::PID::isHadron(), Jet::particles(), and Particle::pid().

                                   {
    double e_hadr = 0.0;
    foreach (const Particle& p, particles()) {
      const PdgId pid = p.pid();
      if (PID::isHadron(pid)) {
        e_hadr += p.E();
      }
    }
    return e_hadr;
  }

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]

Get equivalent single momentum four-vector.

Implements ParticleBase.

Definition at line 157 of file Jet.hh.

References Jet::_momentum.

{ return _momentum; }

double neutralEnergy ( ) const

Get the energy carried in this jet by neutral particles.

Todo:: Jet::containsMatch(Matcher m) { ... if m(pid) return true; ... }

Definition at line 91 of file Jet.cc.

References ParticleBase::E(), Jet::particles(), Particle::pid(), and Rivet::PID::threeCharge().

Referenced by STAR_2009_UE_HELEN::analyze().

                                  {
    double e_neutral = 0.0;
    foreach (const Particle& p, particles()) {
      const PdgId pid = p.pid();
      if (PID::threeCharge(pid) == 0) {
        e_neutral += p.E();
      }
    }
    return e_neutral;
  }

operator const fastjet::PseudoJet & ( ) const [inline]

Cast operator to FastJet3 PseudoJet (as a const reference)

Definition at line 178 of file Jet.hh.

References Jet::pseudojet().

{ return pseudojet(); }

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(); }

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(), BELLE_2008_I786560::analyze(), SLD_2004_S5693039::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(); }

vector<Particle>& particles ( ) [inline]

Get the particles in this jet.

Definition at line 53 of file Jet.hh.

References Jet::_particles.

Referenced by ATLAS_2010_CONF_2010_049::analyze(), ATLAS_2013_I1243871::analyze(), ATLAS_2011_I919017::analyze(), JetShape::calc(), Jet::constituents(), Jet::containsBottom(), Jet::containsCharm(), Jet::containsParticle(), Jet::containsParticleId(), Jet::hadronicEnergy(), Jet::Jet(), Jet::neutralEnergy(), Jet::setParticles(), and Jet::setState().

{ return _particles; }

const vector<Particle>& particles ( ) const [inline]

Get the particles in this jet (const version)

Definition at line 55 of file Jet.hh.

References Jet::_particles.

{ return _particles; }

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); }

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(); }

const fastjet::PseudoJet& pseudojet ( ) const [inline]

Access the internal FastJet3 PseudoJet (as a const reference)

Definition at line 175 of file Jet.hh.

References Jet::_pseudojet.

Referenced by Jet::operator const fastjet::PseudoJet &().

{ return _pseudojet; }

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]

Jet& setConstituents ( const Particles & particles ) [inline]

Definition at line 203 of file Jet.hh.

References Jet::setParticles().

{ return setParticles(particles); }

Jet & setParticles ( const Particles & particles )

Set the particles collection with full particle information.

If set, this overrides particle info extracted from the PseudoJet

Definition at line 55 of file Jet.cc.

References Jet::_particles, and Jet::particles().

Referenced by Jet::setConstituents().

                                                          {
    _particles = particles;
    return *this;
  }

Jet& setState	(	const fastjet::PseudoJet &	pj,
		const Particles &	particles = `Particles()`,
		const Particles &	tags = `Particles()`
	)

Set the jet data from a FastJet PseudoJet, with optional particle constituents and tags lists.

Note:: The particles() list will be extracted from PseudoJet constituents by default, making use of an attached user info if one is found.

Referenced by Jet::Jet().

Jet & setState	(	const FourMomentum &	mom,
		const Particles &	particles,
		const Particles &	tags = `Particles()`
	)

Set all the jet data, with optional full particle constituent and tag information.

Definition at line 18 of file Jet.cc.

References Jet::_momentum, Jet::_particles, Jet::_pseudojet, Jet::_tags, Jet::clear(), FourMomentum::E(), ParticleBase::mom(), Jet::particles(), FourMomentum::px(), FourMomentum::py(), FourMomentum::pz(), and Jet::tags().

                                                                                               {
    clear();
    _momentum = mom;
    _pseudojet = fastjet::PseudoJet(mom.px(), mom.py(), mom.pz(), mom.E());
    _particles = particles;
    _tags = tags;
    return *this;
  }

Jet& setState	(	const Particles &	particles,
		const FourMomentum &	mom
	)		`[inline]`

Deprecated:: Prefer the 4-mom first-arg versions

Definition at line 197 of file Jet.hh.

References Jet::setState().

Referenced by Jet::setState().

{ return setState(mom, particles); }

size_t size ( ) const [inline]

Number of particles in this jet.

Definition at line 50 of file Jet.hh.

References Jet::_particles.

Referenced by ATLAS_2015_CONF_2015_041::analyze(), and MC_TTBAR::analyze().

{ return _particles.size(); }

Particles& tags ( ) [inline]

Particles which have been tag-matched to this jet.

Definition at line 87 of file Jet.hh.

References Jet::_tags.

Referenced by Jet::bTags(), Jet::cTags(), Jet::Jet(), Jet::setState(), Jet::tags(), and Jet::tauTags().

{ return _tags; }

const Particles& tags ( ) const [inline]

Particles which have been tag-matched to this jet (const version)

Definition at line 89 of file Jet.hh.

References Jet::_tags.

{ return _tags; }

Particles tags ( const Cut & c ) const

Particles which have been tag-matched to this jet _and_ pass a Cut.

Note:: Note the less efficient return by value, due to the cut-pass filtering.

Definition at line 153 of file Jet.cc.

References Jet::tags().

                                        {
    Particles rtn;
    foreach (const Particle& p, tags()) {
      if (c->accept(p)) rtn.push_back(p);
    }
    return rtn;
  }

bool tauTagged ( const Cut & c = Cuts::open() ) const [inline]

Does this jet have at least one tau-tag (that passes an optional Cut)?

Definition at line 117 of file Jet.hh.

References Jet::tauTags().

{ return !tauTags(c).empty(); }

Particles tauTags ( const Cut & c = Cuts::open() ) const

Tau particles which have been tag-matched to this jet (and pass an optional Cut)

The default jet finding adds tau tags by ghost association.

Definition at line 181 of file Jet.cc.

References Rivet::PID::isTau(), and Jet::tags().

Referenced by MC_JETTAGS::analyze(), and Jet::tauTagged().

                                           {
    Particles rtn;
    foreach (const Particle& tp, tags()) {
      if (isTau(tp) && c->accept(tp)) rtn.push_back(tp);
    }
    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().