ATLAS Offline Software
ZZ.py
Go to the documentation of this file.
1 # Copyright (C) 2002-2021 CERN for the benefit of the ATLAS collaboration
2 
3 from AthenaCommon import Logging
4 from ..powheg_V2 import PowhegV2
5 
6 
7 logger = Logging.logging.getLogger("PowhegControl")
8 
9 
10 class ZZ(PowhegV2):
11  """! Default Powheg configuration for Z-boson pair production including interference for identical leptons.
12 
13  Create a configurable object with all applicable Powheg options.
14 
15  @author James Robinson <james.robinson@cern.ch>
16  """
17 
18  def __init__(self, base_directory, **kwargs):
19  """! Constructor: all process options are set here.
20 
21  @param base_directory: path to PowhegBox code.
22  @param kwargs dictionary of arguments from Generate_tf.
23  """
24  super(ZZ, self).__init__(base_directory, "ZZ", **kwargs)
25 
26  # Add parameter validation functions
27  self.validation_functions.append("validate_decays")
28 
29 
30  self.allowed_decay_modes = ["z z > e+ e- e+ e-", "z z > e+ e- tau+ tau-", "z z > j j j j", "z z > j j l+ l-",
31  "z z > l+ l- l'+ l'-", "z z > mu+ mu- e+ e-", "z z > mu+ mu- mu+ mu-",
32  "z z > tau+ tau- mu+ mu-", "z z > tau+ tau- tau+ tau-", "z z > v v~ e+ e-",
33  "z z > v v~ j j", "z z > v v~ l+ l-", "z z > v v~ mu+ mu-", "z z > v v~ tau+ tau-",
34  "z z > v v~ v' v'~"]
35 
36  # Add all keywords for this process, overriding defaults if required
37  self.add_keyword("bornktmin")
38  self.add_keyword("bornonly")
39  self.add_keyword("bornsuppfact")
40  self.add_keyword("bornzerodamp")
41  self.add_keyword("bottomthr")
42  self.add_keyword("bottomthrpdf")
43  self.add_keyword("btildeborn")
44  self.add_keyword("btildecoll")
45  self.add_keyword("btildereal")
46  self.add_keyword("btildevirt")
47  self.add_keyword("btlscalect")
48  self.add_keyword("btlscalereal")
49  self.add_keyword("charmthr")
50  self.add_keyword("charmthrpdf")
51  self.add_keyword("check_bad_st2")
52  self.add_keyword("clobberlhe")
53  self.add_keyword("colltest")
54  self.add_keyword("compress_lhe")
55  self.add_keyword("compress_upb")
56  self.add_keyword("compute_rwgt")
57  self.add_keyword("cutallpairs")
58  self.add_keyword("doublefsr")
59  self.add_keyword("dronly")
60  self.add_keyword("evenmaxrat")
61  self.add_keyword("facscfact", self.default_scales[0])
62  self.add_keyword("fastbtlbound")
63  self.add_keyword("fixedgrid")
64  self.add_keyword("fixedscale")
65  self.add_keyword("flg_debug")
66  self.add_keyword("foldcsi", 2)
67  self.add_keyword("foldphi")
68  self.add_keyword("foldy", 2)
69  self.add_keyword("fullrwgt")
70  self.add_keyword("fullrwgtmode")
71  self.add_keyword("hdamp")
72  self.add_keyword("hfact")
73  self.add_keyword("icsimax")
74  self.add_keyword("ih1")
75  self.add_keyword("ih2")
76  self.add_keyword("itmx1", 6)
77  self.add_keyword("itmx1rm")
78  self.add_keyword("itmx2", 6)
79  self.add_keyword("itmx2rm")
80  self.add_keyword("iupperfsr")
81  self.add_keyword("iupperisr")
82  self.add_keyword("iymax")
83  self.add_keyword("lhans1", self.default_PDFs)
84  self.add_keyword("lhans2", self.default_PDFs)
85  self.add_keyword("lhapdf6maxsets")
86  self.add_keyword("lhrwgt_descr")
87  self.add_keyword("lhrwgt_group_combine")
88  self.add_keyword("lhrwgt_group_name")
89  self.add_keyword("lhrwgt_id")
90  self.add_keyword("LOevents")
91  self.add_keyword("manyseeds")
92  self.add_keyword("max_io_bufsize")
93  self.add_keyword("maxseeds")
94  self.add_keyword("minlo")
95  self.add_keyword("mintupbratlim")
96  self.add_keyword("mintupbxless")
97  self.add_keyword("mllmin")
98  self.add_keyword("ncall1", 40000)
99  self.add_keyword("ncall1rm")
100  self.add_keyword("ncall2", 60000)
101  self.add_keyword("ncall2rm")
102  self.add_keyword("ncallfrominput")
103  self.add_keyword("noevents")
104  self.add_keyword("novirtual")
105  self.add_keyword("nubound", 20000)
106  self.add_keyword("olddij")
107  self.add_keyword("par_2gsupp")
108  self.add_keyword("par_diexp")
109  self.add_keyword("par_dijexp")
110  self.add_keyword("parallelstage")
111  self.add_keyword("pdfreweight")
112  self.add_keyword("ptsqmin")
113  self.add_keyword("ptsupp")
114  self.add_keyword("radregion")
115  self.add_keyword("rand1")
116  self.add_keyword("rand2")
117  self.add_keyword("renscfact", self.default_scales[1])
118  self.add_keyword("runningwidth")
119  self.add_keyword("rwl_add")
120  self.add_keyword("rwl_file")
121  self.add_keyword("rwl_format_rwgt")
122  self.add_keyword("rwl_group_events")
123  self.add_keyword("smartsig")
124  self.add_keyword("softtest")
125  self.add_keyword("stage2init")
126  self.add_keyword("storeinfo_rwgt")
127  self.add_keyword("storemintupb")
128  self.add_keyword("testplots")
129  self.add_keyword("testsuda")
130  self.add_keyword("ubexcess_correct")
131  self.add_keyword("ubsigmadetails")
132  self.add_keyword("use-old-grid")
133  self.add_keyword("use-old-ubound")
134  self.add_keyword("withdamp")
135  self.add_keyword("withinterference")
136  self.add_keyword("withnegweights")
137  self.add_keyword("withsubtr")
138  self.add_keyword("xgriditeration")
139  self.add_keyword("xupbound", 4)
140  self.add_keyword("zerowidth")
141  self.add_keyword("ZZeeee", self.allowed_decay_modes[0], name="decay_mode", hidden=False)
142  self.add_keyword("ZZeetautau")
143  self.add_keyword("ZZllll")
144  self.add_keyword("ZZmumuee")
145  self.add_keyword("ZZmumumumu")
146  self.add_keyword("ZZqqll")
147  self.add_keyword("ZZqqqq")
148  self.add_keyword("ZZtautaumumu")
149  self.add_keyword("ZZtautautautau")
150  self.add_keyword("ZZvvee")
151  self.add_keyword("ZZvvll")
152  self.add_keyword("ZZvvmumu")
153  self.add_keyword("ZZvvqq")
154  self.add_keyword("ZZvvtautau")
155  self.add_keyword("ZZvvvv")
156 
157  def validate_decays(self):
158  """! Validate idvecbos and vdecaymode keywords."""
159  # See https://docs.google.com/spreadsheets/d/1Aa7FwB74ppHbXles5LyHrKGlvUFi5PxbZC-Mrc3Lz90 for meanings
160  self.expose() # convenience call to simplify syntax
161  self.check_decay_mode(self.decay_mode, self.allowed_decay_modes)
162  # Enable appropriate decay mode
163  list(self.parameters_by_keyword("ZZeeee"))[0].value = 0 # disable the one used as a proxy for decay mode
164  __decay_mode_lookup = {"z z > e+ e- e+ e-": "ZZeeee",
165  "z z > e+ e- tau+ tau-": "ZZeetautau",
166  "z z > j j j j": "ZZqqqq",
167  "z z > j j l+ l-": "ZZqqll",
168  "z z > l+ l- l'+ l'-": "ZZllll",
169  "z z > mu+ mu- e+ e-": "ZZmumuee",
170  "z z > mu+ mu- mu+ mu-": "ZZmumumumu",
171  "z z > tau+ tau- mu+ mu-": "ZZtautaumumu",
172  "z z > tau+ tau- tau+ tau-": "ZZtautautautau",
173  "z z > v v~ e+ e-": "ZZvvee",
174  "z z > v v~ j j": "ZZvvqq",
175  "z z > v v~ l+ l-": "ZZvvll",
176  "z z > v v~ mu+ mu-": "ZZvvmumu",
177  "z z > v v~ tau+ tau-": "ZZvvtautau",
178  "z z > v v~ v' v'~": "ZZvvvv"}
179  list(self.parameters_by_keyword(__decay_mode_lookup[self.decay_mode]))[0].value = 1
python.processes.configurable.Configurable.expose
def expose(self)
Add all names to the interface of this object.
Definition: configurable.py:46
python.processes.powheg_base.PowhegBase.default_scales
def default_scales(self)
Default scale variations for this process.
Definition: powheg_base.py:244
python.processes.configurable.Configurable.add_keyword
def add_keyword(self, keyword, value=None, name=None, frozen=None, hidden=None, description=None, **kwargs)
Register configurable parameter that is exposed to the user.
Definition: configurable.py:21
dumpHVPathFromNtuple.append
bool append
Definition: dumpHVPathFromNtuple.py:91
python.processes.configurable.Configurable.parameters_by_keyword
def parameters_by_keyword(self, keyword)
Retrieve all parameters that use a given keyword.
Definition: configurable.py:57
python.processes.powheg.ZZ.ZZ.validate_decays
def validate_decays(self)
Validate idvecbos and vdecaymode keywords.
Definition: ZZ.py:157
python.processes.powheg.ZZ.ZZ
Default Powheg configuration for Z-boson pair production including interference for identical leptons...
Definition: ZZ.py:10
python.processes.powheg_base.PowhegBase.validation_functions
validation_functions
List of validation functions to run before preparing runcard.
Definition: powheg_base.py:177
python.processes.powheg_base.PowhegBase.check_decay_mode
def check_decay_mode(self, decay_mode, allowed_decay_modes=None)
Check whether a decay mode is allowed an raise an exception if it is not.
Definition: powheg_base.py:281
python.processes.powheg_base.PowhegBase.default_PDFs
def default_PDFs(self)
Default PDFs for this process.
Definition: powheg_base.py:239
python.processes.powheg.ZZ.ZZ.__init__
def __init__(self, base_directory, **kwargs)
Constructor: all process options are set here.
Definition: ZZ.py:18
python.processes.powheg_V2.PowhegV2
Base class for PowhegBox V2 processes.
Definition: powheg_V2.py:6
python.KeyStore.list
def list(self, key=None)
Definition: KeyStore.py:318
python.processes.powheg.ZZ.ZZ.allowed_decay_modes
allowed_decay_modes
List of allowed decay modes.
Definition: ZZ.py:30