Base class to hold information for ttbar event interpretation. More...

#include "AnalysisDataFormats/TopObjects/interface/TtEvent.h"

Inheritance diagram for TtEvent:

Classes
struct	HypoClassKeyStringToEnum
	a lightweight map for selection type string label and enum value More...

Public Types
enum	HypoClassKey { kGeom, kWMassMaxSumPt, kMaxSumPtWMass, kGenMatch, kMVADisc, kKinFit, kKinSolution, kWMassDeltaTopMass, kHitFit }
	supported classes of event hypotheses More...

typedef std::pair < reco::CompositeCandidate, std::vector< int > >	HypoCombPair
	pair of hypothesis and lepton jet combinatorics for a given hypothesis More...

Public Member Functions
void	addEventHypo (const HypoClassKey &key, const HypoCombPair &hyp)
	add new hypotheses More...

int	correspondingHypo (const std::string &key1, const unsigned &hyp1, const std::string &key2) const
	return the hypothesis in hypothesis class 'key2', which corresponds to hypothesis 'hyp1' in hypothesis class 'key1' More...

int	correspondingHypo (const HypoClassKey &key1, const unsigned &hyp1, const HypoClassKey &key2) const
	return the hypothesis in hypothesis class 'key2', which corresponds to hypothesis 'hyp1' in hypothesis class 'key1' More...

const reco::CompositeCandidate &	eventHypo (const HypoClassKey &key, const unsigned &cmb=0) const

double	fitChi2 (const unsigned &cmb=0) const
	return the chi2 of the kinematic fit of hypothesis 'cmb' if available; -1 else More...

double	fitProb (const unsigned &cmb=0) const
	return the fit probability of hypothesis 'cmb' if available; -1 else More...

const edm::RefProd< TtGenEvent > &	genEvent () const
	get TtGenEvent More...

double	genMatchSumDR (const unsigned &cmb=0) const
	return the sum dr of the generator match if available; -1 else More...

double	genMatchSumPt (const unsigned &cmb=0) const
	return the sum pt of the generator match if available; -1 else More...

double	hitFitChi2 (const unsigned &cmb=0) const
	return the hitfit chi2 of hypothesis 'cmb' if available; -1 else More...

double	hitFitMT (const unsigned &cmb=0) const
	return the hitfit top mass of hypothesis 'cmb' if available; -1 else More...

double	hitFitProb (const unsigned &cmb=0) const
	return the hitfit probability of hypothesis 'cmb' if available; -1 else More...

double	hitFitSigMT (const unsigned &cmb=0) const
	return the hitfit top mass uncertainty of hypothesis 'cmb' if available; -1 else More...

bool	isHypoAvailable (const std::string &key, const unsigned &cmb=0) const

bool	isHypoAvailable (const HypoClassKey &key, const unsigned &cmb=0) const
	check if hypothesis 'cmb' is available within the hypothesis class More...

bool	isHypoClassAvailable (const std::string &key) const
	check if hypothesis class 'key' was added to the event structure More...

bool	isHypoClassAvailable (const HypoClassKey &key) const
	check if hypothesis class 'key' was added to the event structure More...

bool	isHypoValid (const std::string &key, const unsigned &cmb=0) const
	check if hypothesis 'cmb' within the hypothesis class was valid; if not it lead to an empty CompositeCandidate More...

bool	isHypoValid (const HypoClassKey &key, const unsigned &cmb=0) const
	check if hypothesis 'cmb' within the hypothesis class was valid; if not it lead to an empty CompositeCandidate More...

std::vector< int >	jetLeptonCombination (const std::string &key, const unsigned &cmb=0) const
	return the vector of jet lepton combinatorics for a given hypothesis and class More...

std::vector< int >	jetLeptonCombination (const HypoClassKey &key, const unsigned &cmb=0) const
	return the vector of jet lepton combinatorics for a given hypothesis and class More...

std::pair< WDecay::LeptonType, WDecay::LeptonType >	lepDecays () const
	get leptonic decay channels More...

double	mvaDisc (const unsigned &cmb=0) const
	return the mva discriminant value of hypothesis 'cmb' if available; -1 else More...

std::string	mvaMethod () const
	return the label of the mva method in use for the jet parton association (if kMVADisc is not available the string is empty) More...

unsigned int	numberOfAvailableHypoClasses () const
	return number of available hypothesis classes More...

unsigned int	numberOfAvailableHypos (const std::string &key) const
	return number of available hypotheses within a given hypothesis class More...

unsigned int	numberOfAvailableHypos (const HypoClassKey &key) const
	return number of available hypotheses within a given hypothesis class More...

int	numberOfConsideredJets (const std::string &key) const
	return number of jets that were considered when building a given hypothesis More...

int	numberOfConsideredJets (const HypoClassKey &key) const
	return number of jets that were considered when building a given hypothesis More...

void	printParticle (edm::LogInfo &log, const char name, const reco::Candidate cand) const
	print pt, eta, phi, mass of a given candidate into an existing LogInfo More...

void	setFitChi2 (const std::vector< double > &val)
	set chi2 of kKinFit hypothesis More...

void	setFitProb (const std::vector< double > &val)
	set fit probability of kKinFit hypothesis More...

void	setGenEvent (const edm::Handle< TtGenEvent > &evt)
	set TtGenEvent More...

void	setGenMatchSumDR (const std::vector< double > &val)
	set sum dr of kGenMatch hypothesis More...

void	setGenMatchSumPt (const std::vector< double > &val)
	set sum pt of kGenMatch hypothesis More...

void	setHitFitChi2 (const std::vector< double > &val)
	set chi2 of kHitFit hypothesis More...

void	setHitFitMT (const std::vector< double > &val)
	set fitted top mass of kHitFit hypothesis More...

void	setHitFitProb (const std::vector< double > &val)
	set fit probability of kHitFit hypothesis More...

void	setHitFitSigMT (const std::vector< double > &val)
	set fitted top mass uncertainty of kHitFit hypothesis More...

void	setLepDecays (const WDecay::LeptonType &lepDecTop1, const WDecay::LeptonType &lepDecTop2)
	set leptonic decay channels More...

void	setMvaDiscriminators (const std::vector< double > &val)
	set mva discriminant values of kMVADisc hypothesis More...

void	setMvaMethod (const std::string &name)
	set label of mva method for kMVADisc hypothesis More...

void	setNumberOfConsideredJets (const HypoClassKey &key, const unsigned int nJets)
	set number of jets considered when building a given hypothesis More...

const reco::Candidate *	topPair (const std::string &key, const unsigned &cmb=0) const
	get combined 4-vector of top and topBar of the given hypothesis More...

const reco::Candidate *	topPair (const HypoClassKey &key, const unsigned &cmb=0) const
	get combined 4-vector of top and topBar of the given hypothesis More...

const math::XYZTLorentzVector *	topPair () const
	get combined 4-vector of top and topBar from the TtGenEvent More...

	TtEvent ()
	empty constructor More...

virtual	~TtEvent ()
	default destructor More...

Protected Member Functions
HypoClassKey	hypoClassKeyFromString (const std::string &label) const
	return the corresponding enum value from a string More...

Protected Attributes
std::map< HypoClassKey, std::vector< HypoCombPair > >	evtHyp_

std::vector< double >	fitChi2_
	result of kinematic fit More...

std::vector< double >	fitProb_
	result of kinematic fit More...

edm::RefProd< TtGenEvent >	genEvt_
	reference to TtGenEvent (has to be kept in the event!) More...

std::vector< double >	genMatchSumDR_
	result of gen match More...

std::vector< double >	genMatchSumPt_
	result of gen match More...

std::vector< double >	hitFitChi2_

std::vector< double >	hitFitMT_
	result of hitfit More...

std::vector< double >	hitFitProb_

std::vector< double >	hitFitSigMT_

std::pair< WDecay::LeptonType, WDecay::LeptonType >	lepDecays_
	leptonic decay channels More...

std::vector< double >	mvaDisc_
	MVA discriminants. More...

std::string	mvaMethod_
	label of the MVA method More...

std::map< HypoClassKey, int >	nJetsConsidered_
	number of jets considered when building the hypotheses More...

Detailed Description

Base class to hold information for ttbar event interpretation.

The structure holds information for ttbar event interpretation. All event hypotheses of different classes (user defined during production) and a reference to the TtGenEvent (if available). It provides access and administration.

Definition at line 27 of file TtEvent.h.

Member Typedef Documentation

typedef std::pair<reco::CompositeCandidate, std::vector<int> > TtEvent::HypoCombPair

pair of hypothesis and lepton jet combinatorics for a given hypothesis

Definition at line 33 of file TtEvent.h.

Member Enumeration Documentation

enum TtEvent::HypoClassKey

supported classes of event hypotheses

Enumerator
kGeom
kWMassMaxSumPt
kMaxSumPtWMass
kGenMatch
kMVADisc
kKinFit
kKinSolution
kWMassDeltaTopMass
kHitFit

Definition at line 31 of file TtEvent.h.

Constructor & Destructor Documentation

TtEvent::TtEvent ( )

inline

empty constructor

Definition at line 43 of file TtEvent.h.

virtual TtEvent::~TtEvent ( )

inlinevirtual

default destructor

Definition at line 45 of file TtEvent.h.

Member Function Documentation

void TtEvent::addEventHypo	(	const HypoClassKey &	key,
		const HypoCombPair &	hyp
	)

inline

add new hypotheses

Definition at line 121 of file TtEvent.h.

int TtEvent::correspondingHypo	(	const std::string &	key1,
		const unsigned &	hyp1,
		const std::string &	key2
	)		const

inline

return the hypothesis in hypothesis class 'key2', which corresponds to hypothesis 'hyp1' in hypothesis class 'key1'

Definition at line 102 of file TtEvent.h.

int TtEvent::correspondingHypo	(	const HypoClassKey &	key1,
		const unsigned &	hyp1,
		const HypoClassKey &	key2
	)		const

return the hypothesis in hypothesis class 'key2', which corresponds to hypothesis 'hyp1' in hypothesis class 'key1'

Definition at line 8 of file TtEvent.cc.

References jetLeptonCombination(), and numberOfAvailableHypos().

 {
   for(unsigned hyp2 = 0; hyp2 < this->numberOfAvailableHypos(key2); ++hyp2) {
     if( this->jetLeptonCombination(key1, hyp1) == this->jetLeptonCombination(key2, hyp2) )
       return hyp2;
   }
   return -1; // if no corresponding hypothesis was found
 }

const reco::CompositeCandidate& TtEvent::eventHypo	(	const HypoClassKey &	key,
		const unsigned &	cmb = `0`
	)		const

inline

get event hypothesis; there can be more hypotheses of a certain class (sorted by quality); per default the best hypothesis is returned

Definition at line 51 of file TtEvent.h.

double TtEvent::fitChi2 ( const unsigned & cmb = 0 ) const

inline

return the chi2 of the kinematic fit of hypothesis 'cmb' if available; -1 else

Definition at line 90 of file TtEvent.h.

Referenced by TtFullHadronicEvent::print().

double TtEvent::fitProb ( const unsigned & cmb = 0 ) const

inline

return the fit probability of hypothesis 'cmb' if available; -1 else

Definition at line 94 of file TtEvent.h.

Referenced by TtFullHadronicEvent::print().

const edm::RefProd<TtGenEvent>& TtEvent::genEvent ( ) const

inline

get TtGenEvent

Definition at line 53 of file TtEvent.h.

Referenced by TtFullLeptonicEvent::print(), and TtFullHadronicEvent::print().

double TtEvent::genMatchSumDR ( const unsigned & cmb = 0 ) const

inline

return the sum dr of the generator match if available; -1 else

Definition at line 84 of file TtEvent.h.

Referenced by TtFullLeptonicEvent::print(), and TtFullHadronicEvent::print().

double TtEvent::genMatchSumPt ( const unsigned & cmb = 0 ) const

inline

return the sum pt of the generator match if available; -1 else

Definition at line 82 of file TtEvent.h.

Referenced by TtFullLeptonicEvent::print(), and TtFullHadronicEvent::print().

double TtEvent::hitFitChi2 ( const unsigned & cmb = 0 ) const

inline

return the hitfit chi2 of hypothesis 'cmb' if available; -1 else

Definition at line 92 of file TtEvent.h.

double TtEvent::hitFitMT ( const unsigned & cmb = 0 ) const

inline

return the hitfit top mass of hypothesis 'cmb' if available; -1 else

Definition at line 98 of file TtEvent.h.

double TtEvent::hitFitProb ( const unsigned & cmb = 0 ) const

inline

return the hitfit probability of hypothesis 'cmb' if available; -1 else

Definition at line 96 of file TtEvent.h.

double TtEvent::hitFitSigMT ( const unsigned & cmb = 0 ) const

inline

return the hitfit top mass uncertainty of hypothesis 'cmb' if available; -1 else

Definition at line 100 of file TtEvent.h.

TtEvent::HypoClassKey TtEvent::hypoClassKeyFromString ( const std::string & label ) const

protected

return the corresponding enum value from a string

Definition at line 19 of file TtEvent.cc.

References diffTwoXMLs::label.

 {
   return (HypoClassKey) StringToEnumValue<HypoClassKey>(label);
 }

bool TtEvent::isHypoAvailable	(	const std::string &	key,
		const unsigned &	cmb = `0`
	)		const

inline

Definition at line 60 of file TtEvent.h.

bool TtEvent::isHypoAvailable	(	const HypoClassKey &	key,
		const unsigned &	cmb = `0`
	)		const

inline

check if hypothesis 'cmb' is available within the hypothesis class

Definition at line 62 of file TtEvent.h.

bool TtEvent::isHypoClassAvailable ( const std::string & key ) const

inline

check if hypothesis class 'key' was added to the event structure

Definition at line 56 of file TtEvent.h.

bool TtEvent::isHypoClassAvailable ( const HypoClassKey & key ) const

inline

check if hypothesis class 'key' was added to the event structure

Definition at line 58 of file TtEvent.h.

bool TtEvent::isHypoValid	(	const std::string &	key,
		const unsigned &	cmb = `0`
	)		const

inline

check if hypothesis 'cmb' within the hypothesis class was valid; if not it lead to an empty CompositeCandidate

Definition at line 64 of file TtEvent.h.

Referenced by TtFullLeptonicEvent::print(), and TtFullHadronicEvent::print().

bool TtEvent::isHypoValid	(	const HypoClassKey &	key,
		const unsigned &	cmb = `0`
	)		const

inline

check if hypothesis 'cmb' within the hypothesis class was valid; if not it lead to an empty CompositeCandidate

Definition at line 66 of file TtEvent.h.

std::vector<int> TtEvent::jetLeptonCombination	(	const std::string &	key,
		const unsigned &	cmb = `0`
	)		const

inline

return the vector of jet lepton combinatorics for a given hypothesis and class

Definition at line 78 of file TtEvent.h.

Referenced by correspondingHypo(), TtFullLeptonicEvent::print(), and TtFullHadronicEvent::print().

std::vector<int> TtEvent::jetLeptonCombination	(	const HypoClassKey &	key,
		const unsigned &	cmb = `0`
	)		const

inline

return the vector of jet lepton combinatorics for a given hypothesis and class

Definition at line 80 of file TtEvent.h.

std::pair<WDecay::LeptonType, WDecay::LeptonType> TtEvent::lepDecays ( ) const

inline

get leptonic decay channels

Definition at line 48 of file TtEvent.h.

double TtEvent::mvaDisc ( const unsigned & cmb = 0 ) const

inline

return the mva discriminant value of hypothesis 'cmb' if available; -1 else

Definition at line 88 of file TtEvent.h.

std::string TtEvent::mvaMethod ( ) const

inline

return the label of the mva method in use for the jet parton association (if kMVADisc is not available the string is empty)

Definition at line 86 of file TtEvent.h.

unsigned int TtEvent::numberOfAvailableHypoClasses ( ) const

inline

return number of available hypothesis classes

Definition at line 68 of file TtEvent.h.

Referenced by TtFullLeptonicEvent::print(), and TtFullHadronicEvent::print().

unsigned int TtEvent::numberOfAvailableHypos ( const std::string & key ) const

inline

return number of available hypotheses within a given hypothesis class

Definition at line 70 of file TtEvent.h.

Referenced by correspondingHypo(), TtFullLeptonicEvent::print(), and TtFullHadronicEvent::print().

unsigned int TtEvent::numberOfAvailableHypos ( const HypoClassKey & key ) const

inline

return number of available hypotheses within a given hypothesis class

Definition at line 72 of file TtEvent.h.

int TtEvent::numberOfConsideredJets ( const std::string & key ) const

inline

return number of jets that were considered when building a given hypothesis

Definition at line 74 of file TtEvent.h.

int TtEvent::numberOfConsideredJets ( const HypoClassKey & key ) const

inline

return number of jets that were considered when building a given hypothesis

Definition at line 76 of file TtEvent.h.

void TtEvent::printParticle	(	edm::LogInfo &	log,
		const char *	name,
		const reco::Candidate *	cand
	)		const

print pt, eta, phi, mass of a given candidate into an existing LogInfo

Definition at line 26 of file TtEvent.cc.

References reco::Candidate::eta(), reco::Candidate::mass(), reco::Candidate::phi(), and reco::Candidate::pt().

Referenced by TtFullLeptonicEvent::print(), and TtFullHadronicEvent::print().

 {
   if(!cand) {
     log << std::setw(15) << name << ": not available!\n";
     return;
   }
   log << std::setprecision(3) << setiosflags(std::ios::fixed | std::ios::showpoint);
   log << std::setw(15) << name         << ": "
       << std::setw( 7) << cand->pt()   << "; "
       << std::setw( 7) << cand->eta()  << "; "
       << std::setw( 7) << cand->phi()  << "; "
       << resetiosflags(std::ios::fixed | std::ios::showpoint) << setiosflags(std::ios::scientific)
       << std::setw(10) << cand->mass() << "\n";
   log << resetiosflags(std::ios::scientific);
 }

void TtEvent::setFitChi2 ( const std::vector< double > & val )

inline

set chi2 of kKinFit hypothesis

Definition at line 133 of file TtEvent.h.

void TtEvent::setFitProb ( const std::vector< double > & val )

inline

set fit probability of kKinFit hypothesis

Definition at line 137 of file TtEvent.h.

void TtEvent::setGenEvent ( const edm::Handle< TtGenEvent > & evt )

inline

set TtGenEvent

Definition at line 119 of file TtEvent.h.

void TtEvent::setGenMatchSumDR ( const std::vector< double > & val )

inline

set sum dr of kGenMatch hypothesis

Definition at line 127 of file TtEvent.h.

void TtEvent::setGenMatchSumPt ( const std::vector< double > & val )

inline

set sum pt of kGenMatch hypothesis

Definition at line 125 of file TtEvent.h.

void TtEvent::setHitFitChi2 ( const std::vector< double > & val )

inline

set chi2 of kHitFit hypothesis

Definition at line 135 of file TtEvent.h.

void TtEvent::setHitFitMT ( const std::vector< double > & val )

inline

set fitted top mass of kHitFit hypothesis

Definition at line 141 of file TtEvent.h.

void TtEvent::setHitFitProb ( const std::vector< double > & val )

inline

set fit probability of kHitFit hypothesis

Definition at line 139 of file TtEvent.h.

void TtEvent::setHitFitSigMT ( const std::vector< double > & val )

inline

set fitted top mass uncertainty of kHitFit hypothesis

Definition at line 143 of file TtEvent.h.

void TtEvent::setLepDecays	(	const WDecay::LeptonType &	lepDecTop1,
		const WDecay::LeptonType &	lepDecTop2
	)

inline

set leptonic decay channels

Definition at line 117 of file TtEvent.h.

void TtEvent::setMvaDiscriminators ( const std::vector< double > & val )

inline

set mva discriminant values of kMVADisc hypothesis

Definition at line 131 of file TtEvent.h.

void TtEvent::setMvaMethod ( const std::string & name )

inline

set label of mva method for kMVADisc hypothesis

Definition at line 129 of file TtEvent.h.

void TtEvent::setNumberOfConsideredJets	(	const HypoClassKey &	key,
		const unsigned int	nJets
	)

inline

set number of jets considered when building a given hypothesis

Definition at line 123 of file TtEvent.h.

const reco::Candidate* TtEvent::topPair	(	const std::string &	key,
		const unsigned &	cmb = `0`
	)		const

inline

get combined 4-vector of top and topBar of the given hypothesis

Definition at line 107 of file TtEvent.h.

const reco::Candidate* TtEvent::topPair	(	const HypoClassKey &	key,
		const unsigned &	cmb = `0`
	)		const

inline

get combined 4-vector of top and topBar of the given hypothesis

Definition at line 109 of file TtEvent.h.

const math::XYZTLorentzVector* TtEvent::topPair ( ) const

inline

get combined 4-vector of top and topBar from the TtGenEvent

Definition at line 111 of file TtEvent.h.

Referenced by TtFullLeptonicEvent::print(), and TtFullHadronicEvent::print().

Member Data Documentation

std::map<HypoClassKey, std::vector<HypoCombPair> > TtEvent::evtHyp_

protected

map of hypotheses; for each HypoClassKey a vector of hypothesis and their lepton jet combinatorics are kept

Definition at line 153 of file TtEvent.h.

Referenced by TtFullLeptonicEvent::print(), and TtFullHadronicEvent::print().

std::vector<double> TtEvent::fitChi2_

protected

result of kinematic fit

Definition at line 158 of file TtEvent.h.

std::vector<double> TtEvent::fitProb_

protected

result of kinematic fit

Definition at line 161 of file TtEvent.h.

edm::RefProd<TtGenEvent> TtEvent::genEvt_

protected

reference to TtGenEvent (has to be kept in the event!)

Definition at line 150 of file TtEvent.h.

Referenced by TtFullHadronicEvent::print().

std::vector<double> TtEvent::genMatchSumDR_

protected

result of gen match

Definition at line 169 of file TtEvent.h.

std::vector<double> TtEvent::genMatchSumPt_

protected

result of gen match

Definition at line 167 of file TtEvent.h.

std::vector<double> TtEvent::hitFitChi2_

protected

Definition at line 159 of file TtEvent.h.

std::vector<double> TtEvent::hitFitMT_

protected

result of hitfit

Definition at line 164 of file TtEvent.h.

std::vector<double> TtEvent::hitFitProb_

protected

Definition at line 162 of file TtEvent.h.

std::vector<double> TtEvent::hitFitSigMT_

protected

Definition at line 165 of file TtEvent.h.

std::pair<WDecay::LeptonType, WDecay::LeptonType> TtEvent::lepDecays_

protected

leptonic decay channels

Definition at line 143 of file TtEvent.h.

std::vector<double> TtEvent::mvaDisc_

protected

MVA discriminants.

Definition at line 173 of file TtEvent.h.

std::string TtEvent::mvaMethod_

protected

label of the MVA method

Definition at line 171 of file TtEvent.h.

std::map<HypoClassKey, int> TtEvent::nJetsConsidered_

protected

number of jets considered when building the hypotheses

Definition at line 155 of file TtEvent.h.

Classes

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Member Typedef Documentation

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation