reco::RecoCandidate Class Reference

#include <RecoCandidate.h>

Inheritance diagram for reco::RecoCandidate:

Public Types
enum	TrackType { noTrackType, recoTrackType, gsfTrackType }
	track type More...
Public Types inherited from reco::LeafCandidate
typedef int	Charge
	electric charge type More...
typedef CandidateCollection	daughters
	collection of daughter candidates More...
typedef unsigned int	index
typedef math::XYZTLorentzVector	LorentzVector
	Lorentz vector. More...
typedef math::XYZPoint	Point
	point in the space More...
typedef math::PtEtaPhiMLorentzVector	PolarLorentzVector
	Lorentz vector. More...
typedef math::XYZVector	Vector
	point in the space More...
Public Types inherited from reco::Candidate
enum	{ dimension = 3 }
enum	{ size = dimension * (dimension + 1)/2 }
	matix size More...
typedef int	Charge
	electric charge type More...
typedef candidate::const_iterator	const_iterator
typedef math::Error< dimension > ::type	CovarianceMatrix
	covariance error matrix (3x3) More...
typedef unsigned int	index
	index type More...
typedef candidate::iterator	iterator
typedef math::XYZTLorentzVector	LorentzVector
	Lorentz vector. More...
typedef math::XYZPoint	Point
	point in the space More...
typedef math::PtEtaPhiMLorentzVector	PolarLorentzVector
	Lorentz vector. More...
typedef size_t	size_type
typedef math::XYZVector	Vector
	point in the space More...

Public Member Functions
virtual const Track *	bestTrack () const
	best track pointer More...
virtual TrackBaseRef	bestTrackRef () const
	best track RefToBase More...
virtual TrackType	bestTrackType () const
	track type More...
virtual CaloTowerRef	caloTower () const
	reference to a CaloTower More...
virtual RecoCandidate *	clone () const
	returns a clone of the Candidate object More...
virtual reco::TrackRef	combinedMuon () const
	reference to a stand-alone muon Track More...
virtual reco::GsfTrackRef	gsfTrack () const
	reference to a GsfTrack More...
virtual size_t	numberOfTracks () const
	number of multiple Tracks More...
virtual bool	overlap (const Candidate &) const =0
	check overlap with another candidate More...
	RecoCandidate ()
	default constructor More...
template<typename P4 >
	RecoCandidate (Charge q, const P4 &p4, const Point &vtx=Point(0, 0, 0), int pdgId=0, int status=0)
	constructor from values More...
virtual reco::TrackRef	standAloneMuon () const
	reference to a stand-alone muon Track More...
virtual reco::SuperClusterRef	superCluster () const
	reference to a SuperCluster More...
virtual reco::TrackRef	track () const
	reference to a Track More...
virtual reco::TrackRef	track (size_t) const
	reference to one of multiple Tracks More...
virtual	~RecoCandidate ()
	destructor More...
Public Member Functions inherited from reco::LeafCandidate
virtual const_iterator	begin () const
	first daughter const_iterator More...
virtual iterator	begin ()
	first daughter iterator More...
template<typename S >
daughter_iterator< S >::type	beginFilter (const S &s) const
virtual Vector	boostToCM () const
virtual int	charge () const
	electric charge More...
virtual const Candidate *	daughter (size_type) const
	return daughter at a given position (throws an exception) More...
virtual Candidate *	daughter (size_type)
	return daughter at a given position (throws an exception) More...
virtual Candidate *	daughter (const std::string &s)
	return daughter with a specified role name More...
virtual const Candidate *	daughter (const std::string &s) const
	return daughter with a specified role name More...
virtual const_iterator	end () const
	last daughter const_iterator More...
virtual iterator	end ()
	last daughter iterator More...
template<typename S >
daughter_iterator< S >::type	endFilter (const S &s) const
virtual double	energy () const
	energy More...
virtual double	et () const
	transverse energy More...
virtual float	eta () const
	momentum pseudorapidity More...
virtual void	fillVertexCovariance (CovarianceMatrix &v) const
	fill SMatrix More...
template<typename T >
T	get () const
	get a component More...
template<typename T , typename Tag >
T	get () const
	get a component More...
template<typename T >
T	get (size_type i) const
	get a component More...
template<typename T , typename Tag >
T	get (size_type i) const
	get a component More...
virtual bool	hasMasterClone () const
virtual bool	hasMasterClonePtr () const
virtual bool	isCaloMuon () const
virtual bool	isConvertedPhoton () const
virtual bool	isElectron () const
virtual bool	isGlobalMuon () const
virtual bool	isJet () const
virtual bool	isMuon () const
virtual bool	isPhoton () const
virtual bool	isStandAloneMuon () const
virtual bool	isTrackerMuon () const
	LeafCandidate ()
	default constructor More...
	LeafCandidate (const Candidate &c)
template<typename P4 >
	LeafCandidate (Charge q, const P4 &p4, const Point &vtx=Point(0, 0, 0), int pdgId=0, int status=0, bool integerCharge=true)
	constructor from Any values More...
	LeafCandidate (Charge q, const PtEtaPhiMass &p4, const Point &vtx=Point(0, 0, 0), int pdgId=0, int status=0, bool integerCharge=true)
	constructor from values More...
	LeafCandidate (Charge q, const LorentzVector &p4, const Point &vtx=Point(0, 0, 0), int pdgId=0, int status=0, bool integerCharge=true)
	constructor from values More...
	LeafCandidate (Charge q, const PolarLorentzVector &p4, const Point &vtx=Point(0, 0, 0), int pdgId=0, int status=0, bool integerCharge=true)
	constructor from values More...
	LeafCandidate (Charge q, const GlobalVector &p3, float iEnergy, bool massless, const Point &vtx=Point(0, 0, 0), int pdgId=0, int status=0, bool integerCharge=true)
	constructor from values More...
	LeafCandidate (Charge q, const GlobalVector &p3, float iEnergy, float imass, const Point &vtx=Point(0, 0, 0), int pdgId=0, int status=0, bool integerCharge=true)
	constructor from values More...
virtual bool	longLived () const
	is long lived? More...
virtual float	mass () const
	mass More...
virtual bool	massConstraint () const
	do mass constraint? More...
virtual float	massSqr () const
	mass squared More...
virtual const CandidateBaseRef &	masterClone () const
virtual const CandidatePtr &	masterClonePtr () const
template<typename Ref >
Ref	masterRef () const
	cast master clone reference to a concrete type More...
virtual Vector	momentum () const
	spatial momentum vector More...
virtual const Candidate *	mother (size_type) const
	return mother at a given position (throws an exception) More...
virtual double	mt () const
	transverse mass More...
virtual double	mtSqr () const
	transverse mass squared More...
template<typename T >
size_type	numberOf () const
	number of components More...
template<typename T , typename Tag >
size_type	numberOf () const
	number of components More...
virtual size_t	numberOfDaughters () const
	number of daughters More...
virtual size_t	numberOfMothers () const
	number of mothers More...
virtual size_t	numberOfSourceCandidatePtrs () const
virtual double	p () const
	magnitude of momentum vector More...
virtual const LorentzVector &	p4 () const
	four-momentum Lorentz vector More...
virtual int	pdgId () const
	PDG identifier. More...
virtual float	phi () const
	momentum azimuthal angle More...
virtual const PolarLorentzVector &	polarP4 () const
	four-momentum Lorentz vector More...
virtual float	pt () const
	transverse momentum More...
virtual double	px () const
	x coordinate of momentum vector More...
virtual double	py () const
	y coordinate of momentum vector More...
virtual double	pz () const
	z coordinate of momentum vector More...
virtual double	rapidity () const
	rapidity More...
virtual void	setCharge (Charge q)
	set electric charge More...
virtual void	setLongLived ()
	set long lived flag More...
virtual void	setMass (double m)
	set particle mass More...
virtual void	setMassConstraint ()
	set mass constraint flag More...
virtual void	setP4 (const LorentzVector &p4)
	set 4-momentum More...
virtual void	setP4 (const PolarLorentzVector &p4)
	set 4-momentum More...
virtual void	setPdgId (int pdgId)
virtual void	setPz (double pz)
virtual void	setStatus (int status)
	set status word More...
virtual void	setThreeCharge (Charge qx3)
	set electric charge More...
virtual void	setVertex (const Point &vertex)
	set vertex More...
virtual CandidatePtr	sourceCandidatePtr (size_type i) const
virtual int	status () const
	status word More...
virtual double	theta () const
	momentum polar angle More...
virtual int	threeCharge () const
	electric charge More...
virtual const Point &	vertex () const
	vertex position (overwritten by PF...) More...
virtual double	vertexChi2 () const
	chi-squares More...
virtual double	vertexCovariance (int i, int j) const
	(i, j)-th element of error matrix, i, j = 0, ... 2 More...
CovarianceMatrix	vertexCovariance () const
	return SMatrix More...
virtual double	vertexNdof () const
virtual double	vertexNormalizedChi2 () const
	chi-squared divided by n.d.o.f. More...
virtual double	vx () const
	x coordinate of vertex position More...
virtual double	vy () const
	y coordinate of vertex position More...
virtual double	vz () const
	z coordinate of vertex position More...
virtual double	y () const
	rapidity More...
virtual	~LeafCandidate ()
	destructor More...
Public Member Functions inherited from reco::Candidate
template<typename S >
daughter_iterator< S >::type	beginFilter (const S &s) const
	Candidate ()
	default constructor More...
template<typename S >
daughter_iterator< S >::type	endFilter (const S &s) const
template<typename T >
T	get () const
	get a component More...
template<typename T , typename Tag >
T	get () const
	get a component More...
template<typename T >
T	get (size_type i) const
	get a component More...
template<typename T , typename Tag >
T	get (size_type i) const
	get a component More...
template<typename Ref >
Ref	masterRef () const
	cast master clone reference to a concrete type More...
template<typename T >
size_type	numberOf () const
	number of components More...
template<typename T , typename Tag >
size_type	numberOf () const
	number of components More...
virtual void	setSourceCandidatePtr (const CandidatePtr &ptr)
	Set the ptr to the source Candidate. More...
virtual	~Candidate ()
	destructor More...

Protected Member Functions
template<typename R >
bool	checkOverlap (const R &r1, const R &r2) const
	check if two components overlap More...
Protected Member Functions inherited from reco::LeafCandidate
void	cacheCartesian () const
	set internal cache More...
void	cachePolar () const
	set internal cache More...
void	clearCache () const
	clear internal cache More...

Friends
template<typename , typename , typename >
struct	component

Additional Inherited Members
Static Public Member Functions inherited from reco::LeafCandidate
static double	dmass (GlobalVector v, double e)
static double	magd (GlobalVector v)
Static Public Attributes inherited from reco::LeafCandidate
static const unsigned int	longLivedTag = 65536
	long lived flag More...
static const unsigned int	massConstraintTag = 131072
	do mass constraint flag More...
Protected Attributes inherited from reco::LeafCandidate
bool	cacheCartesianFixed_
bool	cachePolarFixed_
	has cache been set? More...
float	eta_
float	mass_
LorentzVector	p4Cartesian_
	internal cache for p4 More...
PolarLorentzVector	p4Polar_
	internal cache for p4 More...
int	pdgId_
	PDG identifier. More...
float	phi_
float	pt_
	four-momentum Lorentz vector More...
Charge	qx3_
	electric charge More...
int	status_
	status word More...
Point	vertex_
	vertex position More...

Detailed Description

base class for all Reco Candidates

Author

Luca Lista, INFN

Definition at line 20 of file RecoCandidate.h.

Member Enumeration Documentation

enum reco::RecoCandidate::TrackType

track type

Enumerator
noTrackType
recoTrackType
gsfTrackType

Definition at line 57 of file RecoCandidate.h.

{ noTrackType, recoTrackType, gsfTrackType };

Constructor & Destructor Documentation

reco::RecoCandidate::RecoCandidate ( )

inline

default constructor

Definition at line 23 of file RecoCandidate.h.

: LeafCandidate() { }

template<typename P4 >

reco::RecoCandidate::RecoCandidate ( Charge  q, const P4 &  p4, const Point &  vtx = Point( 0, 0, 0 ), int  pdgId = 0, int  status = 0  )

inline

constructor from values

Definition at line 26 of file RecoCandidate.h.

                                           : 
      LeafCandidate( q, p4, vtx, pdgId, status ) { }

RecoCandidate::~RecoCandidate ( )

virtual

destructor

Definition at line 7 of file RecoCandidate.cc.

{ }

Member Function Documentation

const Track * RecoCandidate::bestTrack ( ) const

virtual

best track pointer

Reimplemented in pat::Muon, and reco::Muon.

Definition at line 45 of file RecoCandidate.cc.

References combinedMuon(), edm::Ref< C, T, F >::get(), gsfTrack(), edm::Ref< C, T, F >::isNonnull(), standAloneMuon(), and track().

Referenced by CandIsoDepositProducer::extractTrack().

                                             {
  TrackRef muRef = combinedMuon();
  if( muRef.isNonnull() ) 
    return muRef.get();
  TrackRef trkRef = track();
  if ( trkRef.isNonnull() ) 
    return trkRef.get();
  GsfTrackRef gsfTrkRef = gsfTrack();
  if ( gsfTrkRef.isNonnull() )
    return gsfTrkRef.get();
  TrackRef staRef = standAloneMuon(); 
  if ( staRef.isNonnull() ) 
    return staRef.get(); 
  return 0;
}

TrackBaseRef RecoCandidate::bestTrackRef ( ) const

virtual

best track RefToBase

Reimplemented in reco::Muon.

Definition at line 61 of file RecoCandidate.cc.

References combinedMuon(), gsfTrack(), edm::Ref< C, T, F >::isNonnull(), standAloneMuon(), and track().

Referenced by pat::helper::VertexingHelper::getTrack_().

                                               {
  TrackRef muRef = combinedMuon();
  if( muRef.isNonnull() ) return TrackBaseRef(muRef);
  TrackRef trkRef = track();
  if ( trkRef.isNonnull() ) return TrackBaseRef(trkRef);
  GsfTrackRef gsfTrkRef = gsfTrack();
  if ( gsfTrkRef.isNonnull() ) return TrackBaseRef(gsfTrkRef);
  TrackRef staRef = standAloneMuon(); 
  if ( staRef.isNonnull() ) return TrackBaseRef(staRef); 
  return TrackBaseRef();
}

RecoCandidate::TrackType RecoCandidate::bestTrackType ( ) const

virtual

track type

Definition at line 74 of file RecoCandidate.cc.

References combinedMuon(), gsfTrack(), gsfTrackType, noTrackType, recoTrackType, and track().

                                                          {
  if( combinedMuon().isNonnull() ) 
    return recoTrackType;
  if ( track().isNonnull() ) 
    return recoTrackType;
  if ( gsfTrack().isNonnull() ) 
    return gsfTrackType;
  return noTrackType;
}

CaloTowerRef RecoCandidate::caloTower ( ) const

virtual

reference to a CaloTower

Reimplemented in pat::GenericParticle, and reco::RecoCaloTowerCandidate.

Definition at line 41 of file RecoCandidate.cc.

Referenced by reco::RecoCaloTowerCandidate::overlap(), and pat::GenericParticle::overlap().

                                            {
  return CaloTowerRef();
}

template<typename R >

bool reco::RecoCandidate::checkOverlap ( const R &  r1, const R &  r2  ) const

inlineprotected

check if two components overlap

Definition at line 63 of file RecoCandidate.h.

References diffTwoXMLs::r2.

Referenced by reco::RecoCaloTowerCandidate::overlap(), reco::RecoChargedCandidate::overlap(), reco::RecoEcalCandidate::overlap(), reco::RecoStandAloneMuonCandidate::overlap(), reco::BaseTau::overlap(), reco::Electron::overlap(), reco::CaloTau::overlap(), reco::IsolatedPixelTrackCandidate::overlap(), reco::SiStripElectron::overlap(), reco::GsfElectron::overlap(), reco::PFTau::overlap(), reco::Muon::overlap(), and reco::Photon::overlap().

                                                          {
      return( ! r1.isNull() && ! r2.isNull() && r1 == r2 );
    }

RecoCandidate * RecoCandidate::clone ( void  ) const

virtual

returns a clone of the Candidate object

Reimplemented from reco::LeafCandidate.

Reimplemented in reco::GsfElectron, pat::Tau, reco::SiStripElectron, pat::Electron, pat::Muon, pat::Photon, reco::IsolatedPixelTrackCandidate, pat::MET, reco::PFTau, pat::GenericParticle, reco::MET, reco::Photon, pat::Lepton< reco::BaseTau >, pat::Lepton< reco::GsfElectron >, pat::Lepton< reco::Muon >, reco::Muon, reco::RecoChargedCandidate, reco::RecoEcalCandidate, reco::RecoStandAloneMuonCandidate, reco::RecoCaloTowerCandidate, reco::Electron, reco::BaseTau, and reco::CaloTau.

Definition at line 9 of file RecoCandidate.cc.

References edm::hlt::Exception.

                                           {
   throw cms::Exception("LogicError", "reco::RecoCandidate is abstract, so it's clone() method can't be implemented.\n");
}

TrackRef RecoCandidate::combinedMuon ( ) const

virtual

reference to a stand-alone muon Track

Reimplemented in pat::GenericParticle, pat::Muon, and reco::Muon.

Definition at line 33 of file RecoCandidate.cc.

Referenced by bestTrack(), bestTrackRef(), bestTrackType(), CandIsoDepositProducer::extractTrack(), MatcherUsingTracksAlgorithm::getTrack(), reco::RecoStandAloneMuonCandidate::overlap(), reco::RecoChargedCandidate::overlap(), pat::GenericParticle::overlap(), reco::Muon::overlap(), PropagateToMuon::startingState(), and MatcherByPullsAlgorithm::track().

                                           {
  return TrackRef();
}

GsfTrackRef RecoCandidate::gsfTrack ( ) const

virtual

reference to a GsfTrack

Reimplemented in reco::GsfElectron, pat::GenericParticle, pat::Electron, and reco::Electron.

Definition at line 25 of file RecoCandidate.cc.

Referenced by bestTrack(), bestTrackRef(), bestTrackType(), CandIsoDepositProducer::extractTrack(), pat::GenericParticle::overlap(), and reco::GsfElectron::overlap().

                                          {
  return GsfTrackRef();
}

size_t RecoCandidate::numberOfTracks ( ) const

virtual

number of multiple Tracks

Reimplemented in pat::GenericParticle.

Definition at line 21 of file RecoCandidate.cc.

                                           {
  return 0;
}

virtual bool reco::RecoCandidate::overlap ( const Candidate &  ) const

pure virtual

check overlap with another candidate

Reimplemented from reco::LeafCandidate.

Implemented in reco::Photon, reco::Muon, reco::PFTau, reco::GsfElectron, reco::SiStripElectron, reco::IsolatedPixelTrackCandidate, reco::GenMET, reco::CaloMET, reco::MET, reco::CaloTau, reco::Electron, reco::BaseTau, reco::RecoChargedCandidate, reco::RecoEcalCandidate, reco::RecoStandAloneMuonCandidate, and reco::RecoCaloTowerCandidate.

TrackRef RecoCandidate::standAloneMuon ( ) const

virtual

reference to a stand-alone muon Track

Reimplemented in pat::GenericParticle, pat::Muon, reco::Muon, and reco::RecoStandAloneMuonCandidate.

Definition at line 29 of file RecoCandidate.cc.

Referenced by bestTrack(), bestTrackRef(), CandIsoDepositProducer::extractTrack(), MatcherUsingTracksAlgorithm::getTrack(), reco::RecoChargedCandidate::overlap(), reco::RecoStandAloneMuonCandidate::overlap(), pat::GenericParticle::overlap(), reco::Muon::overlap(), PropagateToMuon::startingState(), and MatcherByPullsAlgorithm::track().

                                             {
  return TrackRef();
}

SuperClusterRef RecoCandidate::superCluster ( ) const

virtual

reference to a SuperCluster

Reimplemented in reco::GsfElectron, pat::GenericParticle, reco::SiStripElectron, pat::Electron, pat::Photon, reco::Photon, reco::RecoEcalCandidate, and reco::Electron.

Definition at line 37 of file RecoCandidate.cc.

Referenced by PFCandIsolatorFromDeposits::SingleDeposit::compute(), pat::helper::OverlapBySuperClusterSeed::fillOverlapsForItem(), EgammaHLTEcalIsolation::isolPtSum(), EgammaHLTHcalIsolationDoubleCone::isolPtSum(), reco::RecoEcalCandidate::overlap(), reco::Electron::overlap(), pat::GenericParticle::overlap(), reco::SiStripElectron::overlap(), reco::GsfElectron::overlap(), reco::Photon::overlap(), and EgammaHLTTrackIsolation::photonIsolation().

                                                  {
  return SuperClusterRef();
}

TrackRef RecoCandidate::track ( void  ) const

virtual

reference to a Track

Reimplemented in pat::Electron, pat::Muon, reco::IsolatedPixelTrackCandidate, pat::GenericParticle, reco::Muon, reco::RecoChargedCandidate, and reco::Electron.

Definition at line 13 of file RecoCandidate.cc.

Referenced by bestTrack(), bestTrackRef(), bestTrackType(), CandIsoDepositProducer::extractTrack(), MatcherUsingTracksAlgorithm::getTrack(), reco::RecoStandAloneMuonCandidate::overlap(), reco::RecoChargedCandidate::overlap(), reco::BaseTau::overlap(), reco::Electron::overlap(), pat::GenericParticle::overlap(), reco::CaloTau::overlap(), reco::IsolatedPixelTrackCandidate::overlap(), reco::SiStripElectron::overlap(), reco::PFTau::overlap(), reco::Muon::overlap(), PropagateToMuon::startingState(), and MatcherByPullsAlgorithm::track().

                                    {
  return TrackRef();
}

TrackRef RecoCandidate::track ( size_t  ) const

virtual

reference to one of multiple Tracks

Reimplemented in pat::GenericParticle.

Definition at line 17 of file RecoCandidate.cc.

                                            {
  return TrackRef();
}

Friends And Related Function Documentation

template<typename , typename , typename >

friend struct component

friend

Definition at line 68 of file RecoCandidate.h.