Module to analyze the performance of muon reconstruction on the example of Z->mumu events. More...

#include "PhysicsTools/PatExamples/plugins/PatZToMuMuAnalyzer.h"

Inheritance diagram for PatZToMuMuAnalyzer:

Public Types
typedef math::XYZTLorentzVector	LorentzVector

typedef math::XYZVector	Vector
	typedef's to simplify get functions More...

Public Types inherited from edm::one::EDAnalyzerBase
typedef EDAnalyzerBase	ModuleType

Public Types inherited from edm::EDConsumerBase
typedef ProductLabels	Labels

Public Member Functions
	PatZToMuMuAnalyzer (const edm::ParameterSet &cfg)
	default constructor More...

	~PatZToMuMuAnalyzer () override
	default destructor More...

Public Member Functions inherited from edm::one::EDAnalyzer< edm::one::SharedResources >
	EDAnalyzer ()=default

	EDAnalyzer (const EDAnalyzer &)=delete

SerialTaskQueue *	globalLuminosityBlocksQueue () final

SerialTaskQueue *	globalRunsQueue () final

const EDAnalyzer &	operator= (const EDAnalyzer &)=delete

bool	wantsGlobalLuminosityBlocks () const final

bool	wantsGlobalRuns () const final

bool	wantsInputProcessBlocks () const final

bool	wantsProcessBlocks () const final

Public Member Functions inherited from edm::one::EDAnalyzerBase
void	callWhenNewProductsRegistered (std::function< void(BranchDescription const &)> const &func)

	EDAnalyzerBase ()

ModuleDescription const &	moduleDescription () const

bool	wantsStreamLuminosityBlocks () const

bool	wantsStreamRuns () const

	~EDAnalyzerBase () override

Public Member Functions inherited from edm::EDConsumerBase
std::vector< ConsumesInfo >	consumesInfo () const

void	convertCurrentProcessAlias (std::string const &processName)
	Convert "@currentProcess" in InputTag process names to the actual current process name. More...

	EDConsumerBase ()

	EDConsumerBase (EDConsumerBase const &)=delete

	EDConsumerBase (EDConsumerBase &&)=default

ESResolverIndex const *	esGetTokenIndices (edm::Transition iTrans) const

std::vector< ESResolverIndex > const &	esGetTokenIndicesVector (edm::Transition iTrans) const

std::vector< ESRecordIndex > const &	esGetTokenRecordIndicesVector (edm::Transition iTrans) const

ProductResolverIndexAndSkipBit	indexFrom (EDGetToken, BranchType, TypeID const &) const

void	itemsMayGet (BranchType, std::vector< ProductResolverIndexAndSkipBit > &) const

void	itemsToGet (BranchType, std::vector< ProductResolverIndexAndSkipBit > &) const

std::vector< ProductResolverIndexAndSkipBit > const &	itemsToGetFrom (BranchType iType) const

void	labelsForToken (EDGetToken iToken, Labels &oLabels) const

void	modulesWhoseProductsAreConsumed (std::array< std::vector< ModuleDescription const > , NumBranchTypes > &modulesAll, std::vector< ModuleProcessName > &modulesInPreviousProcesses, ProductRegistry const &preg, std::map< std::string, ModuleDescription const *> const &labelsToDesc, std::string const &processName) const

EDConsumerBase const &	operator= (EDConsumerBase const &)=delete

EDConsumerBase &	operator= (EDConsumerBase &&)=default

bool	registeredToConsume (ProductResolverIndex, bool, BranchType) const

void	selectInputProcessBlocks (ProductRegistry const &productRegistry, ProcessBlockHelperBase const &processBlockHelperBase)

ProductResolverIndexAndSkipBit	uncheckedIndexFrom (EDGetToken) const

void	updateLookup (BranchType iBranchType, ProductResolverIndexHelper const &, bool iPrefetchMayGet)

void	updateLookup (eventsetup::ESRecordsToProductResolverIndices const &)

virtual	~EDConsumerBase () noexcept(false)

Private Member Functions
void	analyze (const edm::Event &event, const edm::EventSetup &setup) override
	everything that needs to be done during the event loop More...

bool	booked (const std::string histName) const
	check if histogram was booked More...

void	fill (const std::string histName, double value) const
	fill histogram if it had been booked before More...

void	fill (std::string hists, const reco::TrackRef &t1, const reco::TrackRef &t2) const
	fill a predefined set of histograms from inner outer or global tracks for first and second mu candidate More...

double	mass (const math::XYZVector &t1, const math::XYZVector &t2) const
	calculate the mass of the Z boson from the tracker momenta by hand More...

Private Attributes
std::map< std::string, TH1D * >	hists_
	management of 1d histograms More...

edm::EDGetTokenT< edm::View< pat::Muon > >	muonsToken_
	input for muons More...

double	shift_

Additional Inherited Members
Static Public Member Functions inherited from edm::one::EDAnalyzerBase
static const std::string &	baseType ()

static void	fillDescriptions (ConfigurationDescriptions &descriptions)

static void	prevalidate (ConfigurationDescriptions &descriptions)

Protected Member Functions inherited from edm::EDConsumerBase
template<typename ProductType , BranchType B = InEvent>
EDGetTokenT< ProductType >	consumes (edm::InputTag const &tag)

template<BranchType B = InEvent>
EDConsumerBaseAdaptor< B >	consumes (edm::InputTag tag) noexcept

EDGetToken	consumes (const TypeToGet &id, edm::InputTag const &tag)

template<BranchType B>
EDGetToken	consumes (TypeToGet const &id, edm::InputTag const &tag)

ConsumesCollector	consumesCollector ()
	Use a ConsumesCollector to gather consumes information from helper functions. More...

template<typename ESProduct , typename ESRecord , Transition Tr = Transition::Event>
auto	esConsumes ()

template<typename ESProduct , typename ESRecord , Transition Tr = Transition::Event>
auto	esConsumes (ESInputTag const &tag)

template<Transition Tr = Transition::Event>
constexpr auto	esConsumes ()

template<Transition Tr = Transition::Event>
auto	esConsumes (ESInputTag tag)

template<Transition Tr = Transition::Event>
ESGetTokenGeneric	esConsumes (eventsetup::EventSetupRecordKey const &iRecord, eventsetup::DataKey const &iKey)
	Used with EventSetupRecord::doGet. More...

template<typename ProductType , BranchType B = InEvent>
EDGetTokenT< ProductType >	mayConsume (edm::InputTag const &tag)

EDGetToken	mayConsume (const TypeToGet &id, edm::InputTag const &tag)

template<BranchType B>
EDGetToken	mayConsume (const TypeToGet &id, edm::InputTag const &tag)

void	resetItemsToGetFrom (BranchType iType)

Detailed Description

Module to analyze the performance of muon reconstruction on the example of Z->mumu events.

Module to analyze the performance of muon reconstruction on the example of Z->mumu events: transverse momentum and eta of the muon candidates and the mass of the Z boson candidate are plotted from inner, outer and global tracks. The mass is recalculated by an extra finction. The difference of the outer track and the global track are plotted for the transverse momentum, eta and phi of the two muon candi- dates, for global muons as far as available. The only input parameters are:

muons –> indicating the muon collection of choice. shift –> indicating the relative shift of the transverse momentum for the estimate of the effect on the invariant mass.

The shift is applied to all mass calculations.

Definition at line 32 of file PatZToMuMuAnalyzer.cc.

Member Typedef Documentation

◆ LorentzVector

typedef math::XYZTLorentzVector PatZToMuMuAnalyzer::LorentzVector

Definition at line 36 of file PatZToMuMuAnalyzer.cc.

◆ Vector

typedef math::XYZVector PatZToMuMuAnalyzer::Vector

typedef's to simplify get functions

Definition at line 35 of file PatZToMuMuAnalyzer.cc.

Constructor & Destructor Documentation

◆ PatZToMuMuAnalyzer()

PatZToMuMuAnalyzer::PatZToMuMuAnalyzer ( const edm::ParameterSet & cfg )

explicit

default constructor

Definition at line 77 of file PatZToMuMuAnalyzer.cc.

References hists_, TFileService::kSharedResource, and TFileService::make().

     : muonsToken_(consumes<edm::View<pat::Muon> >(cfg.getParameter<edm::InputTag>("muons"))),
       shift_(cfg.getParameter<double>("shift")) {
   usesResource(TFileService::kSharedResource);
 
   edm::Service<TFileService> fileService;
 
   // mass plot around Z peak from global tracks
   hists_["globalMass"] = fileService->make<TH1D>("globalMass", "Mass_{Z} (global) (GeV)", 90, 30., 120.);
   // eta from global tracks
   hists_["globalEta"] = fileService->make<TH1D>("globalEta", "#eta (global)", 48, -2.4, 2.4);
   // pt from global tracks
   hists_["globalPt"] = fileService->make<TH1D>("globalPt", "p_{T} (global) (GeV)", 100, 0., 100.);
   // mass plot around Z peak from inner tracks
   hists_["innerMass"] = fileService->make<TH1D>("innerMass", "Mass_{Z} (inner) (GeV)", 90, 30., 120.);
   // eta from inner tracks
   hists_["innerEta"] = fileService->make<TH1D>("innerEta", "#eta (inner)", 48, -2.4, 2.4);
   // pt from inner tracks
   hists_["innerPt"] = fileService->make<TH1D>("innerPt", "p_{T} (inner) (GeV)", 100, 0., 100.);
   // mass plot around Z peak from outer tracks
   hists_["outerMass"] = fileService->make<TH1D>("outerMass", "Mass_{Z} (outer) (GeV)", 90, 30., 120.);
   // eta from outer tracks
   hists_["outerEta"] = fileService->make<TH1D>("outerEta", "#eta (outer)", 48, -2.4, 2.4);
   // pt from outer tracks
   hists_["outerPt"] = fileService->make<TH1D>("outerPt", "p_{T} (outer) (GeV)", 100, 0., 100.);
   // delta pt between global and outer track
   hists_["deltaPt"] = fileService->make<TH1D>("deltaPt", "#Delta p_{T} (GeV)", 100, -20., 20.);
   // delta eta between global and outer track
   hists_["deltaEta"] = fileService->make<TH1D>("deltaEta", "#Delta #eta", 100, -0.2, 0.2);
   // delta phi between global and outer track
   hists_["deltaPhi"] = fileService->make<TH1D>("deltaPhi", "#Delta #phi", 100, -0.2, 0.2);
 }

◆ ~PatZToMuMuAnalyzer()

PatZToMuMuAnalyzer::~PatZToMuMuAnalyzer ( )

inlineoverride

default destructor

Definition at line 41 of file PatZToMuMuAnalyzer.cc.

41 {};

Member Function Documentation

◆ analyze()

void PatZToMuMuAnalyzer::analyze	(	const edm::Event &	event,
		const edm::EventSetup &	setup
	)

overrideprivatevirtual

everything that needs to be done during the event loop

Implements edm::one::EDAnalyzerBase.

Definition at line 129 of file PatZToMuMuAnalyzer.cc.

References fill(), PDWG_BPHSkim_cff::muons, muonsToken_, and AlCaHLTBitMon_QueryRunRegistry::string.

                                                                                   {
   // pat candidate collection
   edm::Handle<edm::View<pat::Muon> > muons;
   event.getByToken(muonsToken_, muons);
 
   // Fill some basic muon quantities as
   // reconstructed from inner and outer
   // tack
   for (edm::View<pat::Muon>::const_iterator mu1 = muons->begin(); mu1 != muons->end(); ++mu1) {
     for (edm::View<pat::Muon>::const_iterator mu2 = muons->begin(); mu2 != muons->end(); ++mu2) {
       if (mu2 > mu1) {                            // prevent double conting
         if (mu1->charge() * mu2->charge() < 0) {  // check only muon pairs of unequal charge
           fill(std::string("inner"), mu1->innerTrack(), mu2->innerTrack());
           fill(std::string("outer"), mu1->outerTrack(), mu2->outerTrack());
           fill(std::string("global"), mu1->globalTrack(), mu2->globalTrack());
 
           if (mu1->isGlobalMuon()) {
             fill("deltaPt", mu1->outerTrack()->pt() - mu1->globalTrack()->pt());
             fill("deltaEta", mu1->outerTrack()->eta() - mu1->globalTrack()->eta());
             fill("deltaPhi", mu1->outerTrack()->phi() - mu1->globalTrack()->phi());
           }
           if (mu2->isGlobalMuon()) {
             fill("deltaPt", mu2->outerTrack()->pt() - mu2->globalTrack()->pt());
             fill("deltaEta", mu2->outerTrack()->eta() - mu2->globalTrack()->eta());
             fill("deltaPhi", mu2->outerTrack()->phi() - mu2->globalTrack()->phi());
           }
         }
       }
     }
   }
 }

◆ booked()

bool PatZToMuMuAnalyzer::booked ( const std::string histName ) const

inlineprivate

check if histogram was booked

Definition at line 50 of file PatZToMuMuAnalyzer.cc.

References hists_.

Referenced by fill().

50 { return hists_.find(histName) != hists_.end(); };

PatZToMuMuAnalyzer::hists_

std::map< std::string, TH1D * > hists_

management of 1d histograms

Definition: PatZToMuMuAnalyzer.cc:65

◆ fill() [1/2]

void PatZToMuMuAnalyzer::fill	(	const std::string	histName,
		double	value
	)		const

inlineprivate

fill histogram if it had been booked before

Definition at line 52 of file PatZToMuMuAnalyzer.cc.

References booked(), and hists_.

Referenced by analyze(), and fill().

                                                           {
     if (booked(histName))
       hists_.find(histName)->second->Fill(value);
   };

◆ fill() [2/2]

void PatZToMuMuAnalyzer::fill	(	std::string	hists,
		const reco::TrackRef &	t1,
		const reco::TrackRef &	t2
	)		const

private

fill a predefined set of histograms from inner outer or global tracks for first and second mu candidate

Definition at line 110 of file PatZToMuMuAnalyzer.cc.

References mps_setup::append, fill(), compare::hists, mass(), AlCaHLTBitMon_QueryRunRegistry::string, RandomServiceHelper::t1, and RandomServiceHelper::t2.

                                                                                                    {
   if (t1.isAvailable()) {
     // fill pt from global track for first muon
     fill(std::string(hists).append("Pt"), t1->pt());
     // fill pt from global track for second muon
     fill(std::string(hists).append("Eta"), t1->eta());
   }
   if (t2.isAvailable()) {
     // fill eta from global track for first muon
     fill(std::string(hists).append("Pt"), t2->pt());
     // fill eta from global track for second muon
     fill(std::string(hists).append("Eta"), t2->eta());
   }
   if (t1.isAvailable() && t2.isAvailable()) {
     // fill invariant mass of the Z boson candidate
     fill(std::string(hists).append("Mass"), mass(t1->momentum(), t2->momentum()));
   }
 }

◆ mass()

double PatZToMuMuAnalyzer::mass	(	const math::XYZVector &	t1,
		const math::XYZVector &	t2
	)		const

inlineprivate

calculate the mass of the Z boson from the tracker momenta by hand

Definition at line 68 of file PatZToMuMuAnalyzer.cc.

References shift_, mathSSE::sqrt(), RandomServiceHelper::t1, and RandomServiceHelper::t2.

Referenced by Particle.Particle::__str__(), DiObject.DiMuon::__str__(), fill(), and datamodel.Object::p4().

                                                                                {
   return (LorentzVector(shift_ * t1.x(), shift_ * t1.y(), t1.z(), sqrt((0.1057 * 0.1057) + t1.mag2())) +
           LorentzVector(shift_ * t2.x(), shift_ * t2.y(), t2.z(), sqrt((0.1057 * 0.1057) + t2.mag2())))
       .mass();
 }

Member Data Documentation

◆ hists_

std::map<std::string, TH1D*> PatZToMuMuAnalyzer::hists_

private

management of 1d histograms

Definition at line 65 of file PatZToMuMuAnalyzer.cc.

Referenced by booked(), fill(), and PatZToMuMuAnalyzer().

◆ muonsToken_

edm::EDGetTokenT<edm::View<pat::Muon> > PatZToMuMuAnalyzer::muonsToken_

private

input for muons

Definition at line 60 of file PatZToMuMuAnalyzer.cc.

Referenced by analyze().

◆ shift_

double PatZToMuMuAnalyzer::shift_

private

shift in transverse momentum to determine a rough uncertainty on the Z mass estimation

Definition at line 63 of file PatZToMuMuAnalyzer.cc.

Referenced by mass().

Public Types

Public Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ LorentzVector

◆ Vector

Constructor & Destructor Documentation

◆ PatZToMuMuAnalyzer()

◆ ~PatZToMuMuAnalyzer()

Member Function Documentation

◆ analyze()

◆ booked()

◆ fill() [1/2]

◆ fill() [2/2]

◆ mass()

Member Data Documentation

◆ hists_

◆ muonsToken_

◆ shift_