3
<title>Master Switches</title>
4
<link rel="stylesheet" type="text/css" href="pythia.css"/>
5
<link rel="shortcut icon" href="pythia32.gif"/>
9
<h2>Master Switches</h2>
11
Sometimes it may be convenient to omit certain aspects of the event
12
generation chain. This cannot be motivated in a full-blown production
13
run, but can often be convenient for own understanding and for
14
debug purposes. The flags on this page allow just that.
17
The event generation is subdivided into three levels: the process
18
level, the parton level and the hadron level, and flags are grouped
21
<h3>Process Level</h3>
23
The <code>ProcessLevel</code> class administrates the initial step of
24
the event generation, wherein the basic process is selected. Currently
25
this is done either using some of the internal processes, or with
26
Les Houches Accord input.
29
There could not be a complete event without an initial process, so
30
it would not be a normal action to switch off this step. Furthermore,
31
without a process set, it is also not possible to carry out the tasks
32
on the parton level. It is still possible, however, to hadronize
33
a parton-level configuration provided by some external program.
35
<p/><code>flag </code><strong> ProcessLevel:all </strong>
36
(<code>default = <strong>on</strong></code>)<br/>
37
If off, do not attempt to carry out any generation at all on the
38
process level. For the parton level only final-state radiation
39
is possible, using the <code>Pythia::forceTimeShower(...)</code> method.
40
Do allow parton configurations stored in the event record to hadronize
41
and hadrons to decay, however, as set by the <code>HadronLevel</code>
42
switches. Further details are found
43
<a href="HadronLevelStandalone.html" target="page">here</a>.
47
For <code>ProcessLevel:all = on</code> one part of the event generation
48
on this level may be switched off individually:
50
<p/><code>flag </code><strong> ProcessLevel:resonanceDecays </strong>
51
(<code>default = <strong>on</strong></code>)<br/>
52
Master switch to allow resonance decays; on/off = true/false.
53
Normal hadrons and leptons do not count as resonances, so this is
54
aimed specifically towards <i>Z^0, W^+-, t, h^0</i> and similar
55
objects beyond the Standard Model. Do not use this option if you
56
may produce coloured resonances and intend to allow hadronization,
57
since currently the program would not know how to handle this.
61
It is possible to stop the generation immediately after the basic
62
process has been selected, see <code>PartonLevel:all</code> below.
66
The <code>PartonLevel</code> class administrates the middle step of the
67
event generation, i.e. the evolution from an input (hard) process from
68
<code>ProcessLevel</code>, containing a few partons only, to a complete
69
parton-level configuration to be handed on to <code>HadronLevel</code>.
70
This step involves the application of initial- and final-state radiation,
71
multiparton interactions and the structure of beam remnants.
73
<p/><code>flag </code><strong> PartonLevel:all </strong>
74
(<code>default = <strong>on</strong></code>)<br/>
75
If off then stop the generation after the hard process has been
76
generated, but before the parton-level and hadron-level steps.
77
The <code>process</code> record is filled, but the <code>event</code>
82
For <code>PartonLevel:all = on</code> some parts of the event generation
83
on this level may be switched off individually:
85
<p/><code>flag </code><strong> PartonLevel:MPI </strong>
86
(<code>default = <strong>on</strong></code>)<br/>
87
Master switch for multiparton interactions; on/off = true/false.
88
Further options are found <a href="MultipartonInteractions.html" target="page">here</a>.
91
<p/><code>flag </code><strong> PartonLevel:ISR </strong>
92
(<code>default = <strong>on</strong></code>)<br/>
93
Master switch for initial-state radiation; on/off = true/false.
94
Further options are found <a href="SpacelikeShowers.html" target="page">here</a>.
97
<p/><code>flag </code><strong> PartonLevel:FSR </strong>
98
(<code>default = <strong>on</strong></code>)<br/>
99
Master switch for initial-state radiation; on/off = true/false.
100
Further options are found <a href="TimelikeShowers.html" target="page">here</a>.
101
If you leave this switch on, the following two switches allow
102
more detailed control to switch off only parts of the showers.
105
<p/><code>flag </code><strong> PartonLevel:FSRinProcess </strong>
106
(<code>default = <strong>on</strong></code>)<br/>
107
Switch for final-state radiation in association with the hard process
108
itself; on/off = true/false. In addition <code>PartonLevel:FSR</code>
109
must be on for these emissions to occur.
112
<p/><code>flag </code><strong> PartonLevel:FSRinResonances </strong>
113
(<code>default = <strong>on</strong></code>)<br/>
114
Master switch for final-state radiation in any resonance decays
115
subsequent to the hard process itself; on/off = true/false. In addition
116
<code>PartonLevel:FSR</code> must be on for these emissions to occur.
120
Switching off all the above MPI/ISR/FSR switches is <b>not</b> equivalent
121
to setting <code>PartonLevel:all = off</code>. In the former case a
122
minimal skeleton of parton-level operations are carried out, such as
123
tying together the scattered partons with the beam remnants into colour
124
singlets, and storing this information in the <code>event</code> record.
125
It is therefore possible to go on and hadronize the event, if desired.
126
In the latter case <b>no</b> operations at all are carried out on the
127
parton level, and therefore it is also not possible to go on to the
130
<p/><code>flag </code><strong> PartonLevel:Remnants </strong>
131
(<code>default = <strong>on</strong></code>)<br/>
132
Master switch for addition of beam remnants; on/off = true/false.
133
Only intended for very special applications, and cannot be used to
134
generate complete events. Specifically, unlike the other switches above,
135
the program will complain and possibly crash unlike you also set
136
<code>HadronLevel:all = off</code> and <code>Check:event = off</code>.
140
It is possible to stop the generation immediately after the parton level
141
has been set up, see <code>HadronLevel:all</code> below.
145
The <code>HadronLevel</code> class administrates the final step of the
146
event generation, wherein the partonic configuration from
147
<code>PartonLevel</code> is hadronized, including string fragmentation
148
and secondary decays.
151
Most of the code in this class itself deals with subdividing the partonic
152
content of the event into separate colour singlets, that can be
153
treated individually by the string fragmentation machinery. When a
154
junction and an antijunction are directly connected, it also breaks
155
the string between the two, so that the topology can be reduced back
156
to two separate one-junction systems, while still preserving the
157
expected particle flow in the junction-junction string region(s).
159
<p/><code>flag </code><strong> HadronLevel:all </strong>
160
(<code>default = <strong>on</strong></code>)<br/>
161
If off then stop the generation after the hard process and
162
parton-level activity has been generated, but before the
167
For <code>HadronLevel:all = on</code> some parts of the event generation
168
on this level may be switched off individually:
170
<p/><code>flag </code><strong> HadronLevel:Hadronize </strong>
171
(<code>default = <strong>on</strong></code>)<br/>
172
Master switch for hadronization; on/off = true/false.
173
Further options are found <a href="Fragmentation.html" target="page">here</a>.
176
<p/><code>flag </code><strong> HadronLevel:Decay </strong>
177
(<code>default = <strong>on</strong></code>)<br/>
178
Master switch for decays; on/off = true/false.
179
Further options are found <a href="ParticleDecays.html" target="page">here</a>.
182
<p/><code>flag </code><strong> HadronLevel:BoseEinstein </strong>
183
(<code>default = <strong>off</strong></code>)<br/>
184
Master switch for the simulation of Bose-Einstein effects;
185
on/off = true/false. Further options are found
186
<a href="BoseEinsteinEffects.html" target="page">here</a>.
194
<!-- Copyright (C) 2012 Torbjorn Sjostrand -->
added
removed
htmldoc/MasterSwitches.html
