RecoMuon/MuonIsolation/doc/MuonIsolation.doc - master - githubmirror/cmssw

RecoMuon/MuonIsolation/doc/MuonIsolation.doc
71 строка4 KB
Slava Krutelyov
remove ExtractorFromDeposits
02 апр 2018, 19:35
02 апр 2018, 19:353e23bdf

/*!

\page RecoMuon_MuonIsolation Package RecoMuon/MuonIsolation

<center>
<small>

<!-- @CVS_TAG@ will be substituted at build time, no need to touch -->
<a href=http://cmssw.cvs.cern.ch/cgi-bin/cmssw.cgi/CMSSW/RecoMuon/MuonIsolation/?cvsroot=CMSSW&only_with_tag=@CVS_TAG@>Source code (CVS tag: @CVS_TAG@)</a> - 
<a href=http://cmssw.cvs.cern.ch/cgi-bin/cmssw.cgi/CMSSW/RecoMuon/MuonIsolation/.admin/developers?rev=HEAD&cvsroot=CMSSW&content-type=text/vnd.viewcvs-markup>Administrative privileges</a>
</small>
</center>

\section desc Description
<!-- Short description of what this package is supposed to provide -->
Provide algorithms used for muon isolation in HLT and Offline.
\n "Isolation" process can procede in two stages:
-# extraction of IsoDeposit(s) from event data (tracks, calo towers/hits, jets, etc.): abstracted by MuIsoExtractor
with concrete implmentation provided via IsoDepositExtractorFactory
-# using IsoDeposit calculate an "isolation value" (weightedSumPt in a cone, isolation flag, isolation likelihood etc.):
abstracted by MuIsoBaseIsolator.
The above two steps can be combined in a concrete implementation of MuIsoBaseAlgorithm.

\subsection interface Public interface
<!-- List the classes that are provided for use in other packages (if any) -->

- MuIsoExtractor: abstract base class for methods that extract IsoDeposit(s) from an event record given a muon (reco::Track).
- IsoDepositExtractorFactory: extractor factory to be used as a source of concrete extractors.
- CutsConeSizeFunction: given track eta derives coneSize based on input set of "Cuts"
- Cuts: class used for configuration of et (pt) thresholds and cone size in a given eta range

- MuIsoBaseIsolator: abstract base class for isolators; uses IsoDeposit(s) on input and gives float "result" on output.
- IsolatorByDeposit: the "result" is the sumDeposits in a given cone (can use CutsConeSizeFunction).
- IsolatorByNominalEfficiency: the "result" is the likelihood-like value (apply val < eff0 to get cut efficiency of not less than eff0)
using a lookup (text) table.

- MuIsoBaseAlgorithm: abstract class for isolation algorithms with single float or "is isolated" flag on output for a given input muon (reco::Track). 
- MuIsoByTrackPt
Concrete isolation algorithm: extract IsoDeposit using extractor and get sumPt in a cone.

- Range:  helper class implementation of (min, max) range for ordered types.

\subsection plugins Plugins
- TrackExtractor: make IsoDeposit using "other" tracks within "DR_Veto" to "DR_Max", with |dZ|< "Diff_z" and |dr_xy| < "Diff_r" from the muon track.
- CaloExtractorByAssociator: with CaloTowers or recHits on input would provide MuIsoDeposits for ecal, hcal and ho separately (3 cts) using TrackDetectorAssociator.
The deposit values are hit/tower et; each hit/tower with energy>3*sigmaNoise and et> threshold, being within "DR_Max" and excluding "DR_Veto" gets an entry.
- CaloExtractor: with CaloTowers on input provide a weighted sum of "Weight_E"*ecalEt+"Weight_H"*hcalEt using simple (analytical form) propagator.
Each tower with energy>3*sigmaNoise and et> threshold, being within "DR_Max" and excluding "DR_Veto" gets an entry.
CaloExtractor is slightly less precise in picking up the point where muon hits the calorimeter (compared to CaloExtractorByAssociator), but is considerably faster.


\subsection modules Modules
<!-- Describe modules implemented in this package and their parameter set -->
None.

\subsection tests Unit tests and examples
<!-- Describe cppunit tests and example configuration files -->
None.

\section status Status and planned development
<!-- e.g. completed, stable, missing features -->
- JetExtractor awaits implementation.
- CombinedTrackCalIsolator awaits implementation.
- CaloExtractor(ByAssociator) use muon (eta, phi) at vertex as the cone axis (center): 
should be "position at calorimeter" of a neutral particle tangential to the muon at vertex ("neutral" muon)


<hr>
Last updated:
@DATE@  Author: computer-generated.
*/