CMS 3D CMS Logo

List of all members | Public Types | Public Member Functions | Protected Member Functions | Friends
reco::RecoCandidate Class Referenceabstract

#include <RecoCandidate.h>

Inheritance diagram for reco::RecoCandidate:
reco::LeafCandidate reco::Candidate pat::PATObject< reco::RecoCandidate > reco::BaseTau reco::Electron reco::GsfElectron reco::HcalIsolatedTrackCandidate reco::IsolatedPixelTrackCandidate reco::MET reco::Muon reco::Photon reco::RecoCaloTowerCandidate reco::RecoChargedCandidate reco::RecoEcalCandidate reco::RecoStandAloneMuonCandidate reco::SiStripElectron

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

const TrackbestTrack () const override
 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...
 
RecoCandidateclone () const override
 returns a clone of the Candidate object More...
 
virtual reco::TrackRef combinedMuon () const
 reference to a stand-alone muon Track More...
 
float dxyError () const override
 uncertainty on dxy More...
 
float dzError () const override
 uncertainty on dz More...
 
virtual reco::GsfTrackRef gsfTrack () const
 reference to a GsfTrack More...
 
virtual size_t numberOfTracks () const
 number of multiple Tracks More...
 
bool overlap (const Candidate &) const override=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...
 
 ~RecoCandidate () override
 destructor More...
 
- Public Member Functions inherited from reco::LeafCandidate
Vector boostToCM () const final
 
int charge () const final
 electric charge More...
 
void construct (int qx3, float pt, float eta, float phi, float mass, const Point &vtx, int pdgId, int status)
 
const Candidatedaughter (const std::string &s) const override
 return daughter with a specified role name More...
 
Candidatedaughter (const std::string &s) override
 return daughter with a specified role name More...
 
const Candidatedaughter (size_type) const override
 return daughter at a given position (throws an exception) More...
 
Candidatedaughter (size_type) override
 return daughter at a given position (throws an exception) More...
 
double energy () const final
 energy More...
 
double et () const final
 transverse energy More...
 
double et2 () const final
 transverse energy squared (use this for cut!) More...
 
double eta () const final
 momentum pseudorapidity More...
 
void fillVertexCovariance (CovarianceMatrix &v) const override
 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...
 
bool hasMasterClone () const override
 
bool hasMasterClonePtr () const override
 
bool isCaloMuon () const override
 
bool isConvertedPhoton () const override
 
bool isElectron () const override
 
bool isGlobalMuon () const override
 
bool isJet () const override
 
bool isMuon () const override
 
bool isPhoton () const override
 
bool isStandAloneMuon () const override
 
bool isTrackerMuon () const override
 
 LeafCandidate ()
 
template<typename... Args>
 LeafCandidate (Args &&... args)
 
 LeafCandidate (const Candidate &c)
 
 LeafCandidate (LeafCandidate &&)=default
 
 LeafCandidate (LeafCandidate &rh)
 
 LeafCandidate (LeafCandidate const &)=default
 
bool longLived () const final
 is long lived? More...
 
double mass () const final
 mass More...
 
bool massConstraint () const final
 do mass constraint? More...
 
double massSqr () const final
 mass squared More...
 
const CandidateBaseRefmasterClone () const override
 
const CandidatePtrmasterClonePtr () const override
 
template<typename Ref >
Ref masterRef () const
 cast master clone reference to a concrete type More...
 
Vector momentum () const final
 spatial momentum vector More...
 
const Candidatemother (size_type) const override
 return mother at a given position (throws an exception) More...
 
double mt () const final
 transverse mass More...
 
double mtSqr () const final
 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...
 
size_t numberOfDaughters () const override
 number of daughters More...
 
size_t numberOfMothers () const override
 number of mothers More...
 
size_t numberOfSourceCandidatePtrs () const override
 
LeafCandidateoperator= (LeafCandidate &&)=default
 
LeafCandidateoperator= (LeafCandidate const &)=default
 
double p () const final
 magnitude of momentum vector More...
 
const LorentzVectorp4 () const final
 four-momentum Lorentz vector More...
 
int pdgId () const final
 PDG identifier. More...
 
double phi () const final
 momentum azimuthal angle More...
 
const PolarLorentzVectorpolarP4 () const final
 four-momentum Lorentz vector More...
 
double pt () const final
 transverse momentum More...
 
double px () const final
 x coordinate of momentum vector More...
 
double py () const final
 y coordinate of momentum vector More...
 
double pz () const final
 z coordinate of momentum vector More...
 
double rapidity () const final
 rapidity More...
 
void setCharge (Charge q) final
 set electric charge More...
 
void setLongLived () final
 
void setMass (double m) final
 set particle mass More...
 
void setMassConstraint () final
 
void setP4 (const LorentzVector &p4) final
 set 4-momentum More...
 
void setP4 (const PolarLorentzVector &p4) final
 set 4-momentum More...
 
void setPdgId (int pdgId) final
 
void setPz (double pz) final
 
void setStatus (int status) final
 set status word More...
 
void setThreeCharge (Charge qx3) final
 set electric charge More...
 
void setVertex (const Point &vertex) override
 set vertex More...
 
CandidatePtr sourceCandidatePtr (size_type i) const override
 
int status () const final
 status word More...
 
double theta () const final
 momentum polar angle More...
 
int threeCharge () const final
 electric charge More...
 
const Pointvertex () const override
 vertex position (overwritten by PF...) More...
 
double vertexChi2 () const override
 chi-squares More...
 
CovarianceMatrix vertexCovariance () const final
 return SMatrix More...
 
double vertexCovariance (int i, int j) const override
 (i, j)-th element of error matrix, i, j = 0, ... 2 More...
 
double vertexNdof () const override
 
double vertexNormalizedChi2 () const override
 chi-squared divided by n.d.o.f. More...
 
double vx () const override
 x coordinate of vertex position More...
 
double vy () const override
 y coordinate of vertex position More...
 
double vz () const override
 z coordinate of vertex position More...
 
double y () const final
 rapidity More...
 
 ~LeafCandidate () override
 destructor More...
 
- Public Member Functions inherited from reco::Candidate
iterator begin ()
 first daughter iterator More...
 
const_iterator begin () const
 first daughter const_iterator More...
 
 Candidate ()
 default constructor More...
 
iterator end ()
 last daughter iterator More...
 
const_iterator end () const
 last daughter const_iterator 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...
 
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...
 

Friends

template<typename , typename , typename >
struct component
 

Detailed Description

base class for all Reco Candidates

Author
Luca Lista, INFN

Definition at line 20 of file RecoCandidate.h.

Member Enumeration Documentation

◆ TrackType

track type

Enumerator
noTrackType 
recoTrackType 
gsfTrackType 

Definition at line 56 of file RecoCandidate.h.

Constructor & Destructor Documentation

◆ RecoCandidate() [1/2]

reco::RecoCandidate::RecoCandidate ( )
inline

default constructor

Definition at line 23 of file RecoCandidate.h.

23 : LeafCandidate() {}

◆ RecoCandidate() [2/2]

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.

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

◆ ~RecoCandidate()

RecoCandidate::~RecoCandidate ( )
override

destructor

Definition at line 7 of file RecoCandidate.cc.

7 {}

Member Function Documentation

◆ bestTrack()

const Track * RecoCandidate::bestTrack ( ) const
overridevirtual

best track pointer

Reimplemented from reco::Candidate.

Definition at line 29 of file RecoCandidate.cc.

29  {
30  TrackRef muRef = combinedMuon();
31  if (muRef.isNonnull())
32  return muRef.get();
33  TrackRef trkRef = track();
34  if (trkRef.isNonnull())
35  return trkRef.get();
36  GsfTrackRef gsfTrkRef = gsfTrack();
37  if (gsfTrkRef.isNonnull())
38  return gsfTrkRef.get();
39  TrackRef staRef = standAloneMuon();
40  if (staRef.isNonnull())
41  return staRef.get();
42  return nullptr;
43 }

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

Referenced by dxyError(), dzError(), CandIsoDepositProducer::extractTrack(), and Muon.Muon::ptErr().

◆ bestTrackRef()

TrackBaseRef RecoCandidate::bestTrackRef ( ) const
virtual

best track RefToBase

Reimplemented in reco::Muon.

Definition at line 45 of file RecoCandidate.cc.

45  {
46  TrackRef muRef = combinedMuon();
47  if (muRef.isNonnull())
48  return TrackBaseRef(muRef);
49  TrackRef trkRef = track();
50  if (trkRef.isNonnull())
51  return TrackBaseRef(trkRef);
52  GsfTrackRef gsfTrkRef = gsfTrack();
53  if (gsfTrkRef.isNonnull())
54  return TrackBaseRef(gsfTrkRef);
55  TrackRef staRef = standAloneMuon();
56  if (staRef.isNonnull())
57  return TrackBaseRef(staRef);
58  return TrackBaseRef();
59 }

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

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

◆ bestTrackType()

RecoCandidate::TrackType RecoCandidate::bestTrackType ( ) const
virtual

track type

Definition at line 61 of file RecoCandidate.cc.

61  {
62  if (combinedMuon().isNonnull())
63  return recoTrackType;
64  if (track().isNonnull())
65  return recoTrackType;
66  if (gsfTrack().isNonnull())
67  return gsfTrackType;
68  return noTrackType;
69 }

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

◆ caloTower()

CaloTowerRef RecoCandidate::caloTower ( ) const
virtual

reference to a CaloTower

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

Definition at line 27 of file RecoCandidate.cc.

27 { return CaloTowerRef(); }

Referenced by pat::GenericParticle::overlap().

◆ checkOverlap()

template<typename R >
bool reco::RecoCandidate::checkOverlap ( const R &  r1,
const R &  r2 
) const
inlineprotected

◆ clone()

RecoCandidate * RecoCandidate::clone ( void  ) const
overridevirtual

returns a clone of the Candidate object

Reimplemented from reco::LeafCandidate.

Reimplemented in reco::PFTau, pat::Lepton< reco::BaseTau >, pat::Lepton< reco::GsfElectron >, pat::Lepton< reco::Muon >, reco::RecoChargedCandidate, reco::RecoEcalCandidate, reco::RecoStandAloneMuonCandidate, and reco::BaseTau.

Definition at line 9 of file RecoCandidate.cc.

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

References Exception.

◆ combinedMuon()

TrackRef RecoCandidate::combinedMuon ( ) const
virtual

◆ dxyError()

float RecoCandidate::dxyError ( ) const
overridevirtual

uncertainty on dxy

Reimplemented from reco::Candidate.

Definition at line 78 of file RecoCandidate.cc.

78  {
79  const Track* tr = bestTrack();
80  if (tr != nullptr)
81  return tr->dxyError();
82  else
83  return 0;
84 }

References bestTrack(), and reco::TrackBase::dxyError().

◆ dzError()

float RecoCandidate::dzError ( ) const
overridevirtual

uncertainty on dz

Reimplemented from reco::Candidate.

Definition at line 71 of file RecoCandidate.cc.

71  {
72  const Track* tr = bestTrack();
73  if (tr != nullptr)
74  return tr->dzError();
75  else
76  return 0;
77 }

References bestTrack(), and reco::TrackBase::dzError().

◆ gsfTrack()

GsfTrackRef RecoCandidate::gsfTrack ( ) const
virtual

◆ numberOfTracks()

size_t RecoCandidate::numberOfTracks ( ) const
virtual

number of multiple Tracks

Reimplemented in pat::GenericParticle.

Definition at line 17 of file RecoCandidate.cc.

17 { return 0; }

◆ overlap()

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

◆ standAloneMuon()

TrackRef RecoCandidate::standAloneMuon ( ) const
virtual

◆ superCluster()

SuperClusterRef RecoCandidate::superCluster ( ) const
virtual

◆ track() [1/2]

TrackRef RecoCandidate::track ( ) const
virtual

◆ track() [2/2]

TrackRef RecoCandidate::track ( size_t  ) const
virtual

reference to one of multiple Tracks

Reimplemented in pat::GenericParticle.

Definition at line 15 of file RecoCandidate.cc.

15 { return TrackRef(); }

Friends And Related Function Documentation

◆ component

template<typename , typename , typename >
friend struct component
friend

Definition at line 73 of file RecoCandidate.h.

reco::GsfTrackRef
edm::Ref< GsfTrackCollection > GsfTrackRef
persistent reference to a GsfTrack
Definition: GsfTrackFwd.h:13
reco::LeafCandidate::status
int status() const final
status word
Definition: LeafCandidate.h:180
reco::RecoCandidate::combinedMuon
virtual reco::TrackRef combinedMuon() const
reference to a stand-alone muon Track
Definition: RecoCandidate.cc:23
edm::Ref::get
T const * get() const
Returns C++ pointer to the item.
Definition: Ref.h:232
reco::TrackBaseRef
edm::RefToBase< reco::Track > TrackBaseRef
persistent reference to a Track, using views
Definition: TrackFwd.h:35
reco::RecoCandidate::standAloneMuon
virtual reco::TrackRef standAloneMuon() const
reference to a stand-alone muon Track
Definition: RecoCandidate.cc:21
reco::RecoCandidate::gsfTrack
virtual reco::GsfTrackRef gsfTrack() const
reference to a GsfTrack
Definition: RecoCandidate.cc:19
reco::RecoCandidate::noTrackType
Definition: RecoCandidate.h:56
reco::TrackBase::dxyError
double dxyError() const
error on dxy
Definition: TrackBase.h:769
reco::RecoCandidate::track
virtual reco::TrackRef track() const
reference to a Track
Definition: RecoCandidate.cc:13
edm::Ref< TrackCollection >
reco::RecoCandidate::bestTrack
const Track * bestTrack() const override
best track pointer
Definition: RecoCandidate.cc:29
reco::SuperClusterRef
edm::Ref< SuperClusterCollection > SuperClusterRef
reference to an object in a collection of SuperCluster objects
Definition: SuperClusterFwd.h:15
reco::Track
Definition: Track.h:27
reco::TrackRef
edm::Ref< TrackCollection > TrackRef
persistent reference to a Track
Definition: TrackFwd.h:20
reco::LeafCandidate::pdgId
int pdgId() const final
PDG identifier.
Definition: LeafCandidate.h:176
edm::Ref::isNonnull
bool isNonnull() const
Checks for non-null.
Definition: Ref.h:238
diffTwoXMLs.r2
r2
Definition: diffTwoXMLs.py:73
reco::TrackBase::dzError
double dzError() const
error on dz
Definition: TrackBase.h:778
reco::LeafCandidate::p4
const LorentzVector & p4() const final
four-momentum Lorentz vector
Definition: LeafCandidate.h:114
submitPVResolutionJobs.q
q
Definition: submitPVResolutionJobs.py:84
reco::LeafCandidate::LeafCandidate
LeafCandidate()
Definition: LeafCandidate.h:33
reco::RecoCandidate::recoTrackType
Definition: RecoCandidate.h:56
extraflags_cff.vtx
vtx
Definition: extraflags_cff.py:18
diffTwoXMLs.r1
r1
Definition: diffTwoXMLs.py:53
Exception
Definition: hltDiff.cc:246
CaloTowerRef
edm::Ref< CaloTowerCollection > CaloTowerRef
Definition: CaloTowerDefs.h:17
reco::RecoCandidate::gsfTrackType
Definition: RecoCandidate.h:56