This file is indexed.

/usr/share/doc/pythia8-doc/html/SUSYProcesses.html is in pythia8-doc-html 8.1.86-1.2.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
<html>
<head>
<title>SUSY Processes</title>
<link rel="stylesheet" type="text/css" href="pythia.css"/>
<link rel="shortcut icon" href="pythia32.gif"/>
</head>
<body>
 
<h2>SUSY</h2> 
<p> 
Here is collected processes involving supersymmetric particle 
production, with the exception of the (extended) Higgs sector. 
Since the number of separate but closely related processes is so big, 
there will not be switches for each separate process but only for a 
reasonable set of subgroups. However, the general switches 
<code>SUSY:idA</code> and <code>SUSY:idB</code>,valternatively 
vectors <code>SUSY:idVecA</code> and <code>SUSY:idVecB</code>, 
may be used in conjunction with any of these groups to provide 
some additional flexibility to concentrate on processes involving 
only specific (s)particle final states, see below. 
</p> 
 
<p> 
Most of the SUSY implementation in PYTHIA 8 has been written by 
N. Desai and is documented in [<a href="Bibliography.html" target="page">Des11</a>]. Please give due 
credit to external contributions to PYTHIA 8, such as this one, by 
including the original work in your list of references when using this 
implementation. The cross section formulae are mostly taken from 
[<a href="Bibliography.html" target="page">Boz07</a>] and [<a href="Bibliography.html" target="page">Fuk11</a>]. 
</p> 
 
<p>Since the implementation of SUSY processes was only recently 
completed [<a href="Bibliography.html" target="page">Des11</a>], case-by-case validations against other codes 
are still recommended. A set of default validations have 
already been carried out by the authors, comparing to 
the PYTHIA 6 SUSY implementation and to the XSUSY code, 
using an sps1a spectrum. Explicit 
validations of the non-trivial SLHA2-specific extensions have 
generally not been carried out yet, with the exception of the R-parity 
violating single-sparticle production cross sections. Please report 
the results of any user validations you may carry out to the authors. 
</p> 
 
<br/><b>Important Note on SLHA:</b> 
In order to simulate SUSY processes it is required to read in the 
couplings and masses relevant for the scenario to be studied. This 
is done with the help of the SUSY Les Houches Accord (SLHA), including 
the SLHA2 extensions and generalizations. (Internally, the SLHA2 
conventions are used. SLHA1 spectra are automatically translated into 
SLHA2 notation during initialization.) The 
reading of a relevant SLHA file <b>must</b> be set up, as described 
on <a href="SUSYLesHouchesAccord.html" target="page">the SLHA page</a>. 
Attempting to generate SUSY processes without a properly initialized 
SLHA spectrum is strongly discouraged and may lead to unexpected 
results. Always check for warnings and errors reported by the SLHA 
reader during the initialization stage. 
 
<h3>SUSY Processes</h3> 
 
<br/><b>Note 1:</b> Decays of SUSY particles are described 
separately <a href="#decays">below</a>. 
 
<br/><b>Note 2:</b> One special possibility is that the gluino or 
some squark(s) are sufficiently long-lived to hadronize. See 
<a href="RHadrons.html" target="page">the R-hadrons page</a> for further details. 
 
<br/><b>Note 3:</b> lepton- and photon-initial states are not yet available. 
Only quark/gluon-initiated <i>2 &rarr; 2</i> and <i>2 &rarr; 1</i> (RPV) 
processes have been implemented. 
 
<br/><b>Note 4:</b> cross sections will be correctly folded with open 
branching fractions of cascade decays, but at present any difference between 
particle and antiparticle decay tables is not taken into account. This 
possibility will be included in a future update. 
 
<p/><code>flag&nbsp; </code><strong> SUSY:all &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Common switch for production of supersymmetric particles, i.e. 
particles with R-parity -1. 
   
 
<p/><code>mode&nbsp; </code><strong> SUSY:idA &nbsp;</strong> 
 (<code>default = <strong>0</strong></code>; <code>minimum = 0</code>)<br/>
Option to limit the sum over possible outgoing states in SUSY 
<i>2 &rarr; 2</i> processes to ones including a specific particle 
identity code. The default corresponds to summing over all possible 
indices. A non-zero value of <code>SUSY:idA</code> selects only processes 
that contain the state corresponding to that particular particle identity 
code in the fundamental <i>2 &rarr; 2</i> scattering process (summed 
over particle/antiparticle). It is the user's responsibility to ensure 
that (a subset of) the processes to be simulated actually include this 
particle at the <i>2 &rarr; 2</i> level; thus, asking for the lightest 
neutralino (code 1000021) to be present in a squark-squark production 
process will give no match. 
   
 
<p/><code>mode&nbsp; </code><strong> SUSY:idB &nbsp;</strong> 
 (<code>default = <strong>0</strong></code>; <code>minimum = 0</code>)<br/>
As for <code>SUSY:idA</code>, but requires an additional particle 
with PDG code <code>SUSY:idB</code> to be present in the <i>2 &rarr; 2</i> 
process. Thus, using  <code>SUSY:idA</code> and  <code>SUSY:idB</code> 
a specific subprocess can be selected. Again only the absolute sign is 
used, i.e. the summation over particle and antiparticle is retained. 
Also the order of <code>SUSY:idA</code> and <code>SUSY:idB</code> is 
irrelevant; since both possible orderings are checked for a match 
with the two outgoing particles. (Although not recommended, should 
<code>SUSY:idA</code> be zero and <code>SUSY:idB</code> nonzero 
a match is searched for just like in the normal case with 
<code>SUSY:idA</code> nonzero and <code>SUSY:idB</code> zero.) 
   
 
<p/><code>mvec&nbsp; </code><strong> SUSY:idVecA &nbsp;</strong> 
 (<code>default = <strong>0</strong></code>; <code>minimum = 0</code>)<br/>
As for <code>SUSY:idA</code>, but as a vector of PDG codes. 
(Character-string input of such vectors should be as a 
comma-separated list, without any blanks.) Thus, it selects only 
processes that have a final-state particle corresponding to one 
of the identity codes in this vector. Note that, to activate this, 
<code>SUSY:idA</code> must be equal to zero; if not then the match 
to <code>SUSY:idA</code> takes precedence. 
   
 
<p/><code>mvec&nbsp; </code><strong> SUSY:idVecB &nbsp;</strong> 
 (<code>default = <strong>0</strong></code>; <code>minimum = 0</code>)<br/>
As for <code>SUSY:idB</code>, but as a vector of PDG codes. 
(Character-string input of such vectors should be as a 
comma-separated list, without any blanks.) As above, to activate this, 
<code>SUSY:idB</code> must be equal to zero; if not then the match to 
<code>SUSY:idB</code> takes precedence. For the matching, either of 
<code>SUSY:idA</code> and <code>SUSY:idVecA</code> may be combined with 
either of <code>SUSY:idB</code> and <code>SUSY:idVecB</code>. 
As above one of the two outgoing SUSY particles must match one of the 
particles in <code>SUSY:id(Vec)A</code> and the other one of the 
particles in <code>SUSY:id(Vec)B</code> when both are nonzero. 
   
 
<p/><code>mode&nbsp; </code><strong> SUSY:sin2thetaWMode &nbsp;</strong> 
 (<code>default = <strong>2</strong></code>; <code>minimum = 1</code>; <code>maximum = 3</code>)<br/>
The value of <i>sin2(thetaW)</i> should be taken from 
<br/><code>option </code><strong> 1</strong> : SM value, defined at <i>M_Z</i>, taken from 
PYTHIA's <code>StandardModel:sin2thetaW</code> parameter.   
<br/><code>option </code><strong> 2</strong> : SUSY value, defined at <i>M_SUSY</i>, derived from the 
running gauge couplings in <code>BLOCK GAUGE</code> in the SLHA 
file. Note: if no such block is present in the input file, this option 
will default back to option 1 above, i.e., the SM value.   
<br/><code>option </code><strong> 3</strong> : Pole value, defined by <i>1 - M_W^2/M_Z^2</i>, 
using the pole masses stored in the SLHA <code>BLOCK MASS</code>, or, 
alternatively, PYTHIA's internal pole masses if no such block is 
present.   
   
 
<h4>Gluino Pair Production</h4> 
 
<p/><code>flag&nbsp; </code><strong> SUSY:gg2gluinogluino &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Pair production of gluinos by gluon-gluon initial states. 
   
 
<p/><code>flag&nbsp; </code><strong> SUSY:qqbar2gluinogluino &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Pair production of gluinos by quark-antiquark annihilation and 
<i>t</i>-channel squark exchange.  The cross section 
expression follows [<a href="Bibliography.html" target="page">Fuk11</a>] and include the possibility 
of non-minimal flavour violation through misalignment of quarks with 
squarks. Only the MFV case has been explicitly validated. 
   
 
<h4>Associated Squark-Gluino Production</h4> 
 
<p/><code>flag&nbsp; </code><strong> SUSY:qg2squarkgluino &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Associated production of a squark with a gluino. The cross section 
expression follows [<a href="Bibliography.html" target="page">Fuk11</a>] and include the possibility 
of non-minimal flavour violation through misalignment of quarks with 
squarks. Only the MFV case has been explicitly validated. 
   
 
<h4>Squark Pair Production</h4> 
 
<p/><code>flag&nbsp; </code><strong> SUSY:gg2squarkantisquark &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Pair production of a scalar quark together with a scalar antiquark by 
gluon annihilation via <i>s</i>-channel gluon exchange, <i>t</i>- and 
<i>u</i>-channel squark exchange, and the direct 4-point coupling. 
The cross section expression follows [<a href="Bibliography.html" target="page">Boz07</a>]. 
Only the MFV case has been explicitly validated. 
   
 
<p/><code>flag&nbsp; </code><strong> SUSY:qqbar2squarkantisquark &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Pair production of a scalar quark together with a scalar antiquark 
by quark-antiquark annihilation. 
For same-isospin <i>~q~q*</i> production (i.e., <i>~u~u*</i>, 
<i>~u~c*</i>, ...), the <i>s</i>-channel gluon, photon, and 
<i>Z</i> and <i>t</i>-channel gluino contributions have so far 
been implemented (i.e., the <i>t</i>-channel neutralino contributions 
are neglected). For opposite-isospin <i>~q~q*</i> production 
(<i>~u~d*</i>, <i>~u~s*</i>, ...), the <i>s</i>-channel <i>W</i> 
and <i>t</i>-channel gluino contributions have been implemented 
(i.e., the <i>t</i>-channel neutralino contributions are neglected). 
The cross section expressions follow [<a href="Bibliography.html" target="page">Boz07</a>]. 
Only the MFV case has been explicitly validated. 
(Note to PYTHIA 6 users: 
in older PYTHIA 6 versions, a bug caused the <i>~t1~t2*</i> cross to be 
overcounted by a factor of 2. Starting from version 6.4.24, that 
generator now agrees with the implementation here.) 
   
 
<p/><code>flag&nbsp; </code><strong> SUSY:qqbar2squarkantisquark:onlyQCD &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
When switched <code>on</code> this flag switches off all but the 
<i>s</i>-channel gluon contribution in the 
calculation of same-isospin squark-antisquark production cross 
sections. Intended for reference only. For the most 
accurate physics simulation, leave this flag in the <code>off</code> 
position. 
   
 
<p/><code>flag&nbsp; </code><strong> SUSY:qq2squarksquark &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Pair production of scalar quarks (squark-squark and its charge 
conjugate process; for squark-antisquark production see above) 
by <i>t</i>- and <i>u</i>-channel gluino, neutralino, and 
chargino exchange. The cross section expressions follow [<a href="Bibliography.html" target="page">Boz07</a>]. 
Only the MFV case has been explicitly validated. 
(Note to PYTHIA 6 users: PYTHIA 6 only included the gluino exchange 
contribution, which typically dominates due to the size of the strong 
coupling; for counterchecks, 
the flag <code>SUSY:qq2squarksquark:onlyQCD</code> 
below can be switched on to eliminate the chargino and neutralino 
contributions.) 
   
 
<p/><code>flag&nbsp; </code><strong> SUSY:qq2squarksquark:onlyQCD &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
When switched <code>on</code> this flag causes the <i>t</i>- or 
<i>u</i>-channel neutralino and chargino contributions to be 
ignored in the calculation of squark pair production cross sections. 
Intended for reference only. For the most accurate physics simulation, 
leave this flag in the <code>off</code> position. 
   
 
<h4>Neutralino and Chargino Pair Production</h4> 
 
<p/><code>flag&nbsp; </code><strong> SUSY:qqbar2chi0chi0 &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Pair production of neutralinos by quark-antiquark annihilation. With 
four neutralino species this gives ten separate processes, codes 
1201 - 1210. The cross section expressions follow [<a href="Bibliography.html" target="page">Boz07</a>]. 
Only the MFV case has been explicitly validated. 
   
 
<p/><code>flag&nbsp; </code><strong> SUSY:qqbar2chi+-chi0 &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Associated chargino-neutralino production by quark-antiquark 
annihilation. With four neutralino species, two chargino ones, and 
maintaining charge conjugate processes separate, this gives 16 
separate processes, codes 1221 - 1236. The cross section expressions 
follow [<a href="Bibliography.html" target="page">Boz07</a>]. 
Only the MFV case has been explicitly validated. 
   
 
<p/><code>flag&nbsp; </code><strong> SUSY:qqbar2chi+chi- &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Pair production of charginos by quark-antiquark annihilation. With 
two chargino species and maintaining mutually charge conjugate 
processes separate, this gives four separate processes, codes 
1241 - 1244. The cross section expressions follow [<a href="Bibliography.html" target="page">Boz07</a>]. 
Only the MFV case has been explicitly validated. 
   
 
<h4>Associated Neutralino/Chargino + Squark/Gluino Production</h4> 
 
<p/><code>flag&nbsp; </code><strong> SUSY:qg2chi0squark &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Pair production of neutralinos from quark-gluon initial states. 
The cross section expressions follow [<a href="Bibliography.html" target="page">Boz07</a>]. 
Only the MFV case has been explicitly validated. 
   
 
<p/><code>flag&nbsp; </code><strong> SUSY:qg2chi+-squark &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Associated chargino-squark production from quark-gluon initial states. 
annihilation. The cross section expressions 
follow [<a href="Bibliography.html" target="page">Boz07</a>]. 
Only the MFV case has been explicitly validated. 
   
 
<p/><code>flag&nbsp; </code><strong> SUSY:qqbar2chi0gluino &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Associated neutralino-gluino production by quark-antiquark 
annihilation. 
The cross section expressions follow 
[<a href="Bibliography.html" target="page">Fuk11</a>]. Only the MFV case has been explicitly validated. 
   
 
<p/><code>flag&nbsp; </code><strong> SUSY:qqbar2chi+-gluino &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Associated chargino-gluino production by quark-antiquark 
annihilation. The cross section expressions follow 
[<a href="Bibliography.html" target="page">Fuk11</a>]. Only the MFV case has been explicitly 
validated. (Note to PYTHIA 6 users: small differences between 
this implementation and PYTHIA 6 arise due 
to slightly different treatments of the weak mixing angle, 
which is fixed in PYTHIA 6, while it is computed from the SLHA input 
in PYTHIA 8; see <code>SUSY:sin2thetaWMode</code> above.) 
   
 
<h4>Slepton Production</h4> 
<p/><code>flag&nbsp; </code><strong> SUSY:qqbar2sleptonantislepton &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Pair production of slepton-antislepton via s-channel W, Z and gamma 
exchange.  Includes both charged sleptons and sneutrinos but right 
handed sneutrinos currently not supported. 
   
 
 
<h4>R-parity violating squark production</h4> 
 
<p/><code>flag&nbsp; </code><strong> SUSY:qq2antisquark &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Resonant squark production via R-parity violating UDD couplings. The 
couplings must be input using the SLHA2 structure. 
   
 
<a name="decays"></a> 
<h3>Decays of SUSY Particles</h3> 
 
Based on the parameters read in from the SLHA, PYTHIA 8 will normally 
compute the decay modes of SUSY particles automatically, using the 
<code>SusyResonanceDecays</code> class(es). Essentially all tree-level 
2-body decays in the MSSM 
have been implemented this way, excepting so far only those involving 
Higgs bosons (either in the in- or out-state) or gravitinos. 
Available channels so far include: 
<ul> 
<li>~q &rarr; q + ~chi</li> 
<li>~q &rarr; ~q + W/Z</li> 
<li>~q &rarr; q + q (RPV UDD)</li> 
<li>~q &rarr; l + q (RPV LQD)</li> 
<li>~g &rarr; ~q + q</li> 
<li>~chi &rarr; ~chi + Z/W</li> 
<li>~chi &rarr; ~q + q</li> 
<li>~chi &rarr; ~l/~nu + l/nu</li> 
<li>~chi0 &rarr; q + q + q (RPV UDD)</li> 
<li>~l/~nu &rarr; l/nu + ~chi</li> 
<li>~l/~nu &rarr; ~l/~nu + W/Z</li> 
</ul> 
All channels are still undergoing validation, so this 
implementation should be considered preliminary. 
Still missing but to be included in a forthcoming update 
are: 3-body decays of charginos (via RPV), and 2-body decays of squarks and 
gauginos with Higgs as one of the decay products. 
 
Some 3-body decays have been implemented with Matrix Element weighting. 
In particular, those for a neutralino to a lighter neutralino and a 
fermion pair can be enabled. 
 
<p/><code>flag&nbsp; </code><strong> SUSYResonance:3BodyMatrixElement &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
When "on", the spin-averaged, squared matrix element is used 
to sample the phase space for resonance decay.  Currently, only 
possible for a heavy neutralino decay to a light neutralino 
and a fermion-antifermion pair. 
   
 
 
</body>
</html>
 
<!-- Copyright (C) 2014 Torbjorn Sjostrand -->