PYTHIA8/pythia8145/phpdoc/MasterSwitches.php

   1 <html>
   2 <head>
   3 <title>Master Switches</title>
   4 <link rel="stylesheet" type="text/css" href="pythia.css"/>
   5 <link rel="shortcut icon" href="pythia32.gif"/>
   6 </head>
   7 <body>
   8
   9 <script language=javascript type=text/javascript>
  10 function stopRKey(evt) {
  11 var evt = (evt) ? evt : ((event) ? event : null);
  12 var node = (evt.target) ? evt.target :((evt.srcElement) ? evt.srcElement : null);
  13 if ((evt.keyCode == 13) && (node.type=="text"))
  14 {return false;}
  15 }
  16
  17 document.onkeypress = stopRKey;
  18 </script>
  19 <?php
  20 if($_POST['saved'] == 1) {
  21 if($_POST['filepath'] != "files/") {
  22 echo "<font color='red'>SETTINGS SAVED TO FILE</font><br/><br/>"; }
  23 else {
  24 echo "<font color='red'>NO FILE SELECTED YET.. PLEASE DO SO </font><a href='SaveSettings.php'>HERE</a><br/><br/>"; }
  25 }
  26 ?>
  27
  28 <form method='post' action='MasterSwitches.php'>
  29
  30 <h2>Master Switches</h2>
  31
  32 Sometimes it may be convenient to omit certain aspects of the event
  33 generation chain. This cannot be motivated in a full-blown production
  34 run, but can often be convenient for own understanding and for
  35 debug purposes. The flags on this page allow just that.
  36
  37 <p/>
  38 The event generation is subdivided into three levels: the process
  39 level, the parton level and the hadron level, and flags are grouped
  40 accordingly.
  41
  42 <h3>Process Level</h3>
  43
  44 The <code>ProcessLevel</code> class administrates the initial step of
  45 the event generation, wherein the basic process is selected. Currently
  46 this is done either using some of the internal processes, or with
  47 Les Houches Accord input.
  48
  49 <p/>
  50 There could not be a complete event without an initial process, so
  51 it would not be a normal action to switch off this step. Furthermore,
  52 without a process set, it is also not possible to carry out the tasks
  53 on the parton level. It is still possible, however, to hadronize
  54 a parton-level configuration provided by some external program.
  55
  56 <br/><br/><strong>ProcessLevel:all</strong>  <input type="radio" name="1" value="on" checked="checked"><strong>On</strong>
  57 <input type="radio" name="1" value="off"><strong>Off</strong>
  58  &nbsp;&nbsp;(<code>default = <strong>on</strong></code>)<br/>
  59 If off, do not attempt to carry out any generation at all on the
  60 process or parton level. Do allow parton configurations stored in
  61 the event record to hadronize and hadrons to decay, however, as set
  62 by the <code>HadronLevel</code> switches. Further details are found
  63 <?php $filepath = $_GET["filepath"];
  64 echo "<a href='HadronLevelStandalone.php?filepath=".$filepath."' target='page'>";?>here</a>.
  65
  66
  67 <p/>
  68 For <code>ProcessLevel:all = on</code> one part of the event generation
  69 on this level may be switched off individually:
  70
  71 <br/><br/><strong>ProcessLevel:resonanceDecays</strong>  <input type="radio" name="2" value="on" checked="checked"><strong>On</strong>
  72 <input type="radio" name="2" value="off"><strong>Off</strong>
  73  &nbsp;&nbsp;(<code>default = <strong>on</strong></code>)<br/>
  74 Master switch to allow resonance decays; on/off = true/false.
  75 Normal hadrons and leptons do not count as resonances, so this is
  76 aimed specifically towards <i>Z^0, W^+-, t, h^0</i> and similar
  77 objects beyond the Standard Model. Do not use this option if you
  78 may produce coloured resonances and intend to allow hadronization,
  79 since currently the program would not know how to handle this.
  80
  81
  82 <p/>
  83 It is possible to stop the generation immediately after the basic
  84 process has been selected, see <code>PartonLevel:all</code> below.
  85
  86 <h3>PartonLevel</h3>
  87
  88 The <code>PartonLevel</code> class administrates the middle step of the
  89 event generation, i.e. the evolution from an input (hard) process from
  90 <code>ProcessLevel</code>, containing a few partons only, to a complete
  91 parton-level configuration to be handed on to <code>HadronLevel</code>.
  92 This step involves the application of initial- and final-state radiation,
  93 multiple interactions and the structure of beam remnants.
  94
  95 <br/><br/><strong>PartonLevel:all</strong>  <input type="radio" name="3" value="on" checked="checked"><strong>On</strong>
  96 <input type="radio" name="3" value="off"><strong>Off</strong>
  97  &nbsp;&nbsp;(<code>default = <strong>on</strong></code>)<br/>
  98 If off then stop the generation after the hard process has been
  99 generated, but before the parton-level and hadron-level steps.
 100 The <code>process</code> record is filled, but the <code>event</code>
 101 one is then not.
 102
 103
 104 <p/>
 105 For <code>PartonLevel:all = on</code> some parts of the event generation
 106 on this level may be switched off individually:
 107
 108 <br/><br/><strong>PartonLevel:MI</strong>  <input type="radio" name="4" value="on" checked="checked"><strong>On</strong>
 109 <input type="radio" name="4" value="off"><strong>Off</strong>
 110  &nbsp;&nbsp;(<code>default = <strong>on</strong></code>)<br/>
 111 Master switch for multiple interactions; on/off = true/false.
 112 Further options are found <?php $filepath = $_GET["filepath"];
 113 echo "<a href='MultipleInteractions.php?filepath=".$filepath."' target='page'>";?>here</a>.
 114
 115
 116 <br/><br/><strong>PartonLevel:ISR</strong>  <input type="radio" name="5" value="on" checked="checked"><strong>On</strong>
 117 <input type="radio" name="5" value="off"><strong>Off</strong>
 118  &nbsp;&nbsp;(<code>default = <strong>on</strong></code>)<br/>
 119 Master switch for initial-state radiation; on/off = true/false.
 120 Further options are found <?php $filepath = $_GET["filepath"];
 121 echo "<a href='SpacelikeShowers.php?filepath=".$filepath."' target='page'>";?>here</a>.
 122
 123
 124 <br/><br/><strong>PartonLevel:FSR</strong>  <input type="radio" name="6" value="on" checked="checked"><strong>On</strong>
 125 <input type="radio" name="6" value="off"><strong>Off</strong>
 126  &nbsp;&nbsp;(<code>default = <strong>on</strong></code>)<br/>
 127 Master switch for initial-state radiation; on/off = true/false.
 128 Further options are found <?php $filepath = $_GET["filepath"];
 129 echo "<a href='TimelikeShowers.php?filepath=".$filepath."' target='page'>";?>here</a>.
 130 If you leave this switch on, the following two switches allow
 131 more detailed control to switch off only parts of the showers.
 132
 133
 134 <br/><br/><strong>PartonLevel:FSRinProcess</strong>  <input type="radio" name="7" value="on" checked="checked"><strong>On</strong>
 135 <input type="radio" name="7" value="off"><strong>Off</strong>
 136  &nbsp;&nbsp;(<code>default = <strong>on</strong></code>)<br/>
 137 Switch for final-state radiation in association with the hard process
 138 itself; on/off = true/false. In addition <code>PartonLevel:FSR</code>
 139 must be on for these emissions to occur.
 140
 141
 142 <br/><br/><strong>PartonLevel:FSRinResonances</strong>  <input type="radio" name="8" value="on" checked="checked"><strong>On</strong>
 143 <input type="radio" name="8" value="off"><strong>Off</strong>
 144  &nbsp;&nbsp;(<code>default = <strong>on</strong></code>)<br/>
 145 Master switch for final-state radiation in any resonance decays
 146 subsequent to the hard process itself; on/off = true/false. In addition
 147 <code>PartonLevel:FSR</code> must be on for these emissions to occur.
 148
 149
 150 <p/>
 151 Switching off all the above MI/ISR/FSR switches is <b>not</b> equivalent
 152 to setting <code>PartonLevel:all = off</code>. In the former case a
 153 minimal skeleton of parton-level operations are carried out, such as
 154 tying together the scattered partons with the beam remnants into colour
 155 singlets, and storing this information in the <code>event</code> record.
 156 It is therefore possible to go on and hadronize the event, if desired.
 157 In the latter case <b>no</b> operations at all are carried out on the
 158 parton level, and therefore it is also not possible to go on to the
 159 hadron level.
 160
 161 <br/><br/><strong>PartonLevel:Remnants</strong>  <input type="radio" name="9" value="on" checked="checked"><strong>On</strong>
 162 <input type="radio" name="9" value="off"><strong>Off</strong>
 163  &nbsp;&nbsp;(<code>default = <strong>on</strong></code>)<br/>
 164 Master switch for addition of beam remnants; on/off = true/false.
 165 Only intended for very special applications, and cannot be used to
 166 generate complete events. Specifically, unlike the other switches above,
 167 the program will complain and possibly crash unlike you also set
 168 <code>HadronLevel:all = off</code> and <code>Check:event = off</code>.
 169
 170
 171 <p/>
 172 It is possible to stop the generation immediately after the parton level
 173 has been set up, see <code>HadronLevel:all</code> below.
 174
 175 <h3>HadronLevel</h3>
 176
 177 The <code>HadronLevel</code> class administrates the final step of the
 178 event generation, wherein the partonic configuration from
 179 <code>PartonLevel</code> is hadronized, including string fragmentation
 180 and secondary decays.
 181
 182 <p/>
 183 Most of the code in this class itself deals with subdividing the partonic
 184 content of the event into separate colour singlets, that can be
 185 treated individually by the string fragmentation machinery. When a
 186 junction and an antijunction are directly connected, it also breaks
 187 the string between the two, so that the topology can be reduced back
 188 to two separate one-junction systems, while still preserving the
 189 expected particle flow in the junction-junction string region(s).
 190
 191 <br/><br/><strong>HadronLevel:all</strong>  <input type="radio" name="10" value="on" checked="checked"><strong>On</strong>
 192 <input type="radio" name="10" value="off"><strong>Off</strong>
 193  &nbsp;&nbsp;(<code>default = <strong>on</strong></code>)<br/>
 194 If off then stop the generation after the hard process and
 195 parton-level activity has been generated, but before the
 196 hadron-level steps.
 197
 198
 199 <p/>
 200 For <code>HadronLevel:all = on</code> some parts of the event generation
 201 on this level may be switched off individually:
 202
 203 <br/><br/><strong>HadronLevel:Hadronize</strong>  <input type="radio" name="11" value="on" checked="checked"><strong>On</strong>
 204 <input type="radio" name="11" value="off"><strong>Off</strong>
 205  &nbsp;&nbsp;(<code>default = <strong>on</strong></code>)<br/>
 206 Master switch for hadronization; on/off = true/false.
 207 Further options are found <?php $filepath = $_GET["filepath"];
 208 echo "<a href='Fragmentation.php?filepath=".$filepath."' target='page'>";?>here</a>.
 209
 210
 211 <br/><br/><strong>HadronLevel:Decay</strong>  <input type="radio" name="12" value="on" checked="checked"><strong>On</strong>
 212 <input type="radio" name="12" value="off"><strong>Off</strong>
 213  &nbsp;&nbsp;(<code>default = <strong>on</strong></code>)<br/>
 214 Master switch for decays; on/off = true/false.
 215 Further options are found <?php $filepath = $_GET["filepath"];
 216 echo "<a href='ParticleDecays.php?filepath=".$filepath."' target='page'>";?>here</a>.
 217
 218
 219 <br/><br/><strong>HadronLevel:BoseEinstein</strong>  <input type="radio" name="13" value="on"><strong>On</strong>
 220 <input type="radio" name="13" value="off" checked="checked"><strong>Off</strong>
 221  &nbsp;&nbsp;(<code>default = <strong>off</strong></code>)<br/>
 222 Master switch for the simulation of Bose-Einstein effects;
 223 on/off = true/false. Further options are found
 224 <?php $filepath = $_GET["filepath"];
 225 echo "<a href='BoseEinsteinEffects.php?filepath=".$filepath."' target='page'>";?>here</a>.
 226
 227
 228
 229
 230 <input type="hidden" name="saved" value="1"/>
 231
 232 <?php
 233 echo "<input type='hidden' name='filepath' value='".$_GET["filepath"]."'/>"?>
 234
 235 <table width="100%"><tr><td align="right"><input type="submit" value="Save Settings" /></td></tr></table>
 236 </form>
 237
 238 <?php
 239
 240 if($_POST["saved"] == 1)
 241 {
 242 $filepath = $_POST["filepath"];
 243 $handle = fopen($filepath, 'a');
 244
 245 if($_POST["1"] != "on")
 246 {
 247 $data = "ProcessLevel:all = ".$_POST["1"]."\n";
 248 fwrite($handle,$data);
 249 }
 250 if($_POST["2"] != "on")
 251 {
 252 $data = "ProcessLevel:resonanceDecays = ".$_POST["2"]."\n";
 253 fwrite($handle,$data);
 254 }
 255 if($_POST["3"] != "on")
 256 {
 257 $data = "PartonLevel:all = ".$_POST["3"]."\n";
 258 fwrite($handle,$data);
 259 }
 260 if($_POST["4"] != "on")
 261 {
 262 $data = "PartonLevel:MI = ".$_POST["4"]."\n";
 263 fwrite($handle,$data);
 264 }
 265 if($_POST["5"] != "on")
 266 {
 267 $data = "PartonLevel:ISR = ".$_POST["5"]."\n";
 268 fwrite($handle,$data);
 269 }
 270 if($_POST["6"] != "on")
 271 {
 272 $data = "PartonLevel:FSR = ".$_POST["6"]."\n";
 273 fwrite($handle,$data);
 274 }
 275 if($_POST["7"] != "on")
 276 {
 277 $data = "PartonLevel:FSRinProcess = ".$_POST["7"]."\n";
 278 fwrite($handle,$data);
 279 }
 280 if($_POST["8"] != "on")
 281 {
 282 $data = "PartonLevel:FSRinResonances = ".$_POST["8"]."\n";
 283 fwrite($handle,$data);
 284 }
 285 if($_POST["9"] != "on")
 286 {
 287 $data = "PartonLevel:Remnants = ".$_POST["9"]."\n";
 288 fwrite($handle,$data);
 289 }
 290 if($_POST["10"] != "on")
 291 {
 292 $data = "HadronLevel:all = ".$_POST["10"]."\n";
 293 fwrite($handle,$data);
 294 }
 295 if($_POST["11"] != "on")
 296 {
 297 $data = "HadronLevel:Hadronize = ".$_POST["11"]."\n";
 298 fwrite($handle,$data);
 299 }
 300 if($_POST["12"] != "on")
 301 {
 302 $data = "HadronLevel:Decay = ".$_POST["12"]."\n";
 303 fwrite($handle,$data);
 304 }
 305 if($_POST["13"] != "off")
 306 {
 307 $data = "HadronLevel:BoseEinstein = ".$_POST["13"]."\n";
 308 fwrite($handle,$data);
 309 }
 310 fclose($handle);
 311 }
 312
 313 ?>
 314 </body>
 315 </html>
 316
 317 <!-- Copyright (C) 2010 Torbjorn Sjostrand -->