ATLAS Offline Software
Loading...
Searching...
No Matches
Public Member Functions | Public Attributes | List of all members
python.MetAnalysisConfig.MetAnalysisConfig Class Reference
Inheritance diagram for python.MetAnalysisConfig.MetAnalysisConfig:
Collaboration diagram for python.MetAnalysisConfig.MetAnalysisConfig:

Public Member Functions

 __init__ (self)
 instanceName (self)
 makeAlgs (self, config)

Public Attributes

 useLRT
 useJVT
 useFJVT
 selectionNameFJVT
list invisible
 saveSignificance
str jetCalibConfig = "":
str jetCalibArea = "00-04-81"
str jetCalibSequence = 'JetArea_Residual_EtaJES_GSC_Smear'
str egammaESModel = "":
str egammaDecorrelationModel = "":
 containerName
 addExtraSignificanceVars

Detailed Description

the ConfigBlock for the MET configuration

Definition at line 8 of file MetAnalysisConfig.py.

Constructor & Destructor Documentation

◆ __init__()

python.MetAnalysisConfig.MetAnalysisConfig.__init__ ( self)

Definition at line 11 of file MetAnalysisConfig.py.

11 def __init__ (self) :
12 super (MetAnalysisConfig, self).__init__ ()
13 self.addOption('containerName', '', type=str,
14 noneAction='error',
15 info="the name of the output container.")
16 self.addOption ('useJVT', True, type=bool,
17 info="whether to use the JVT decision in the MET calculation.")
18 self.addOption ('useFJVT', False, type=bool,
19 info="whether to use the forward JVT decision in the MET calculation.")
20 self.addOption ('selectionNameFJVT', "", type=str,
21 info="name of the forward JVT selection to be used if `useFJVT` is activated.")
22 self.addOption ('treatPUJets', False, type=bool,
23 info="whether to treat pile-up jets in the MET significance calculation.")
24 self.addOption ('setMuonJetEMScale', True, type=bool,
25 info="enables the handling of muons in jets for the MET calculation. "
26 "Should be turned off for analyses where muons are not reconstructed "
27 "at all.")
28 self.addOption ('jets', "", type=str,
29 info="the input jet container.")
30 self.addOption ('electrons', "", type=str,
31 info="the input electron container, with a possible selection, in "
32 "the format `container` or `container.selection`.")
33 self.addOption ('muons', "", type=str,
34 info="the input muon container, with a possible selection, in the "
35 "format `container` or `container.selection`.")
36 self.addOption ('photons', "", type=str,
37 info="the input photon container, with a possible selection, in "
38 "the format `container` or `container.selection`.")
39 self.addOption ('taus', "", type=str,
40 info="the input tau-jet container, with a possible selection, in "
41 "the format `container` or `container.selection`.")
42 self.addOption ('invisible', [], type=None,
43 info="any input containers to be treated as invisible particles, "
44 "as a single string or a list of strings in the format `container` or `container.selection`.")
45 self.addOption ('metWP', "Tight", type=str,
46 info="the MET working point to use: `Loose`, `Tight`, `Tighter`, "
47 "`Tenacious`.")
48 self.addOption ('skipSystematicJetSelection', False, type=bool,
49 info="EXPERIMENTAL: whether to use simplified OR based on nominal jets "
50 "and for jet-related systematics only. "
51 "WARNING: this option is strictly for doing physics studies of the feasibility "
52 "of this OR scheme, it should not be used in a regular analysis.",
53 expertMode=True)
54 self.addOption ('saveSignificance', True, type=bool,
55 info="whether to save the MET significance.")
56 self.addOption ('jetCalibConfig', "", type=str,
57 info="config file used in jet calibration (for MET significance).")
58 self.addOption ('jetCalibSequence', "", type=str,
59 info="jet calibration sequence (for MET significance).")
60 self.addOption ('jetCalibArea', "", type=str,
61 info="name of the CalibArea used in jet calibration (for MET significance).")
62 self.addOption ('egammaESModel', "", type=str,
63 info="ESModel for EGamma calibration (for MET significance).")
64 self.addOption ('egammaDecorrelationModel', "", type=str,
65 info="decorrelation model for EGamma calibration (for MET significance).")
66 self.addOption ('tauTESConfig', "CombinedTES_R22_Round2.5_v2.root", type=str,
67 info="config file for tau energy scale calibration (for MET significance).")
68 self.addOption ('tauUseMVAResolution', True, type=bool,
69 info="whether to use MVA resolution for taus-jets (for MET significance).")
70 self.addOption ('addExtraSignificanceVars', False, type=bool,
71 info="whether to save some additional (event-based) MET significance variables.")
72 self.addOption ('useLRT', False, type=bool,
73 info="whether to use LRT MET Core and association map.")
74 self.addOption ('useCaloSoftTerm', False, type=bool,
75 info="whether to use calo- instead of track-based soft term.",
76 expertMode=True)
77 self.addOption ('softTermResolution', -1.0, type=float,
78 info="override the default soft term resolution in METSignificance.",
79 expertMode=True)
80 self.addOption ('switchTauMuOrder', False, type=bool,
81 info="whether to switch order of taus and muons",
82 expertMode=True)
83

Member Function Documentation

◆ instanceName()

python.MetAnalysisConfig.MetAnalysisConfig.instanceName ( self) 
Return the instance name for this block

Definition at line 84 of file MetAnalysisConfig.py.

84 def instanceName (self) :
85 """Return the instance name for this block"""
86 return self.containerName
87

◆ makeAlgs()

python.MetAnalysisConfig.MetAnalysisConfig.makeAlgs ( self,
config )

Definition at line 88 of file MetAnalysisConfig.py.

88 def makeAlgs (self, config) :
89
90 if config.isPhyslite() :
91 metSuffix = 'AnalysisMET'
92 else :
93 jetContainer = config.originalName (self.jets)
94 metSuffix = jetContainer[:-4]
95 if self.useLRT:
96 metSuffix += "_LRT"
97
98 # Remove b-tagging calibration from the MET suffix name
99 btIndex = metSuffix.find('_BTagging')
100 if btIndex != -1:
101 metSuffix = metSuffix[:btIndex]
102
103 # Set up the met maker algorithm:
104 alg = config.createAlgorithm( 'CP::MetMakerAlg', 'MetMakerAlg' )
105 config.addPrivateTool( 'makerTool', 'met::METMaker' )
106 alg.makerTool.skipSystematicJetSelection = self.skipSystematicJetSelection
107
108 alg.doJetJVT = self.useJVT
109 if self.useJVT:
110 config.addPrivateTool( 'makerTool.JvtSelTool', 'CP::NNJvtSelectionTool' )
111 alg.makerTool.JvtSelTool.JetContainer = config.readName (self.jets)
112 alg.makerTool.JvtSelTool.JvtMomentName = "NNJvt"
113 if self.useFJVT:
114 # for backwards compatibility with "old" FJVT handling in JetAnalysisConfig.py
115 if not self.selectionNameFJVT:
116 alg.makerTool.JetRejectionDec = 'fjvt_selection'
117 # otherwise get the decoration from the selection
118 else:
119 fjvt_decoration = config.getFullSelection(self.jets, self.selectionNameFJVT, skipBase=True).replace(",as_char", "")
120 alg.makerTool.JetRejectionDec = fjvt_decoration
121
122 alg.makerTool.JetSelection = self.metWP
123 alg.makerTool.DoPFlow = 'PFlow' in metSuffix or metSuffix=="AnalysisMET"
124 alg.makerTool.DoSetMuonJetEMScale = self.setMuonJetEMScale if self.muons else False
125 alg.switchTauMu = self.switchTauMuOrder
126
127 if config.dataType() is not DataType.Data :
128 config.addPrivateTool( 'systematicsTool', 'met::METSystematicsTool' )
129
130 alg.metCore = 'MET_Core_' + metSuffix
131 alg.metAssociation = 'METAssoc_' + metSuffix
132 alg.jets = config.readName (self.jets)
133 alg.softTermKey = "PVSoftTrk" if not self.useCaloSoftTerm else "SoftClus"
134 if self.muons != "" :
135 alg.muons, alg.muonsSelection = config.readNameAndSelection (self.muons, excludeFrom={'or'})
136 if self.electrons != "" :
137 alg.electrons, alg.electronsSelection = config.readNameAndSelection (self.electrons, excludeFrom={'or'})
138 if self.photons != "" :
139 alg.photons, alg.photonsSelection = config.readNameAndSelection (self.photons, excludeFrom={'or'})
140 if self.taus != "" :
141 alg.taus, alg.tausSelection = config.readNameAndSelection (self.taus, excludeFrom={'or'})
142 if self.invisible:
143 if isinstance(self.invisible, str):
144 self.invisible = [self.invisible]
145 invisibleContainers, invisibleSelections = zip(*[config.readNameAndSelection (container, excludeFrom={'or'}) for container in self.invisible])
146 alg.invisible = list(invisibleContainers)
147 alg.invisibleSelection = list(invisibleSelections)
148 alg.met = config.writeName (self.containerName, isMet = True)
149
150
151 # Set up the met builder algorithm:
152 alg = config.createAlgorithm( 'CP::MetBuilderAlg', 'MetBuilderAlg' )
153 alg.softTerm = "PVSoftTrk" if not self.useCaloSoftTerm else "SoftClus"
154 alg.met = config.readName (self.containerName)
155
156
157 # Set up the met significance algorithm:
158 if self.saveSignificance:
159 alg = config.createAlgorithm( 'CP::MetSignificanceAlg', 'MetSignificanceAlg' )
160 config.addPrivateTool( 'significanceTool', 'met::METSignificance' )
161 if self.muons != "" :
162 config.addPrivateTool( 'significanceTool.MuonCalibTool', 'CP::MuonCalibTool' )
163 # Retrieve the calibMode from the container name.selections
164 alg.significanceTool.MuonCalibTool.calibMode = (
165 config.getContainerMeta(self.muons.split(".")[0], 'calibMode', failOnMiss=True))
166
167 # Preliminary R22 recommendation is to use R21 jet resolutions from 2018 for MET significance.
168 # See Jet/Etmiss recommendation documentation for details.
169 if self.jetCalibConfig == "":
170 self.jetCalibConfig = "JES_data2017_2016_2015_Recommendation_PFlow_Aug2018_rel21.config"
171 self.jetCalibArea = "00-04-81"
172 # Include Smear and not InSitu, even when running on data.
173 # This is for technical reasons and allows access to the correct resolutions for both data and MC.
174 self.jetCalibSequence = 'JetArea_Residual_EtaJES_GSC_Smear'
175
176 # Standard e/gamma calibration. Must be kept in agreement with ElectronAnalysisConfig.py
177 if self.egammaESModel == "":
178 self.egammaESModel = (
179 config.getContainerMeta(self.electrons.split(".")[0], 'ESModel', failOnMiss=True))
180 if self.egammaDecorrelationModel == "":
181 self.egammaDecorrelationModel = (
182 config.getContainerMeta(self.electrons.split(".")[0], 'decorrelationModel', failOnMiss=True))
183
184 alg.significanceTool.SoftTermParam = 0
185 if self.softTermResolution > 0:
186 alg.significanceTool.SoftTermReso = self.softTermResolution
187 alg.significanceTool.TreatPUJets = self.treatPUJets
188 alg.significanceTool.JetCalibConfig = self.jetCalibConfig
189 alg.significanceTool.JetCalibSequence = self.jetCalibSequence
190 alg.significanceTool.JetCalibArea = self.jetCalibArea
191 alg.significanceTool.EgammaESModel = self.egammaESModel
192 alg.significanceTool.EgammaDecorrelationModel = self.egammaDecorrelationModel
193 alg.significanceTool.EgammaUseFastsim = (config.dataType() is DataType.FastSim)
194 alg.significanceTool.TauTESConfig = self.tauTESConfig
195 alg.significanceTool.TauUseMVAResolution = self.tauUseMVAResolution
196 alg.met = config.readName (self.containerName)
197 config.addOutputVar (self.containerName, 'significance_%SYS%', 'significance')
198 if self.addExtraSignificanceVars:
199 alg.sigDirectionalDecoration = "sigDirectional_%SYS%"
200 alg.METOverSqrtSumETDecoration = "METOverSqrtSumET_%SYS%"
201 alg.METOverSqrtHTDecoration = "METOverSqrtHT_%SYS%"
202 config.addOutputVar (self.containerName, 'sigDirectional_%SYS%', 'sigDirectional')
203 config.addOutputVar (self.containerName, 'METOverSqrtSumET_%SYS%', 'METOverSqrtSumET')
204 config.addOutputVar (self.containerName, 'METOverSqrtHT_%SYS%', 'METOverSqrtHT')
205
206 config.addOutputVar (self.containerName, 'met', 'met')
207 config.addOutputVar (self.containerName, 'phi', 'phi')
208 config.addOutputVar (self.containerName, 'sumet', 'sumet')
209 config.addOutputVar (self.containerName, 'name', 'name', noSys=True, enabled=False)
replace
std::string replace(std::string s, const std::string &s2, const std::string &s3)
Definition hcg.cxx:312
split
std::vector< std::string > split(const std::string &s, const std::string &t=":")
Definition hcg.cxx:179

Member Data Documentation

◆ addExtraSignificanceVars

python.MetAnalysisConfig.MetAnalysisConfig.addExtraSignificanceVars

Definition at line 198 of file MetAnalysisConfig.py.

◆ containerName

python.MetAnalysisConfig.MetAnalysisConfig.containerName

Definition at line 197 of file MetAnalysisConfig.py.

◆ egammaDecorrelationModel

str python.MetAnalysisConfig.MetAnalysisConfig.egammaDecorrelationModel = "":

Definition at line 180 of file MetAnalysisConfig.py.

◆ egammaESModel

str python.MetAnalysisConfig.MetAnalysisConfig.egammaESModel = "":

Definition at line 177 of file MetAnalysisConfig.py.

◆ invisible

python.MetAnalysisConfig.MetAnalysisConfig.invisible

Definition at line 142 of file MetAnalysisConfig.py.

◆ jetCalibArea

str python.MetAnalysisConfig.MetAnalysisConfig.jetCalibArea = "00-04-81"

Definition at line 171 of file MetAnalysisConfig.py.

◆ jetCalibConfig

str python.MetAnalysisConfig.MetAnalysisConfig.jetCalibConfig = "":

Definition at line 169 of file MetAnalysisConfig.py.

◆ jetCalibSequence

str python.MetAnalysisConfig.MetAnalysisConfig.jetCalibSequence = 'JetArea_Residual_EtaJES_GSC_Smear'

Definition at line 174 of file MetAnalysisConfig.py.

◆ saveSignificance

python.MetAnalysisConfig.MetAnalysisConfig.saveSignificance

Definition at line 158 of file MetAnalysisConfig.py.

◆ selectionNameFJVT

python.MetAnalysisConfig.MetAnalysisConfig.selectionNameFJVT

Definition at line 115 of file MetAnalysisConfig.py.

◆ useFJVT

python.MetAnalysisConfig.MetAnalysisConfig.useFJVT

Definition at line 113 of file MetAnalysisConfig.py.

◆ useJVT

python.MetAnalysisConfig.MetAnalysisConfig.useJVT

Definition at line 109 of file MetAnalysisConfig.py.

◆ useLRT

python.MetAnalysisConfig.MetAnalysisConfig.useLRT

Definition at line 95 of file MetAnalysisConfig.py.

The documentation for this class was generated from the following file:
Generated on for ATLAS Offline Software by doxygen 1.16.1