This file is indexed.

/usr/share/doc/pythia8-doc/html/QCDProcesses.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
<html>
<head>
<title>QCD Processes</title>
<link rel="stylesheet" type="text/css" href="pythia.css"/>
<link rel="shortcut icon" href="pythia32.gif"/>
</head>
<body>
 
<h2>QCD Processes</h2> 
 
This section is subdivided into soft and hard QCD processes, with 
open charm and bottom production set aside as a special part of the 
latter, and three-jet topologies as a special subset. Kindly note 
that there is a considerable amount of overlap between the soft and 
hard process classes, so that you are likely to double-count 
if you include both in a run. 
 
<h3>Soft QCD processes</h3> 
 
As a rule, the processes in this class should not be mixed with 
the simulation of other processes. All by themselves, they are 
intended to represent the total cross section of hadron collisions, 
with the exception of the "rare processes" that one wishes to study 
separately. In particular, jet physics at all scales occurs as part 
of the minimum-bias description. 
 
<p/> 
We here use the "minimum bias" expression as a shorthand for 
inelastic, nondiffractive events. Strictly speaking, "minimum bias" 
represents an experimental procedure of accepting "everything", with 
some non-universal cuts to exclude elastic and diffractive topologies. 
In practice, the experimental minimum-bias sample may then contain 
some contamination of what is in PYTHIA classified as diffractive, 
especially (high-mass) double diffractive. 
 
<p/> 
Some options to modify these cross sections are found on the 
<a href="TotalCrossSections.html" target="page">Total Cross Sections</a> page. 
 
<p/><code>flag&nbsp; </code><strong> SoftQCD:all &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Common switch for the group of all soft QCD processes, 
as listed separately in the following. 
   
 
<p/><code>flag&nbsp; </code><strong> SoftQCD:nonDiffractive &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
The inelastic nondiffrative part of the total cross section, i.e. 
what would often be called the "minimum-bias component". 
The formalism is based on an <a href="MultipartonInteractions.html" target="page"> 
eikonalized description</a> of all the hard QCD processes, so 
includes them in combination with low-<i>pT</i> events. 
Code 101.<br/> 
Since the current description is handled by the multiparton-interactions 
machinery as part of the parton-level processing, no hard process at 
all is defined at the process-level part of the event generation. 
Fortunately, in this case a special 
<code><a href="EventInformation.html" target="page">codeSub()</a></code> 
method provides information on the first, i.e. hardest, subprocess 
selected by the multiparton-interactions machinery. 
<br/><b>Note</b>: this flag was precviously named 
<code>SoftQCD:minBias</code>, since it is almost equivalent to 
the minimum-bias component of the total cross section. It has invited 
some confusion, however, since "minimum-bias" usually refers to the 
experimental procedure, while "(inelastic) non-diffractive" better 
relates to the way events are generated in the program code. 
(Although also what separates diffractive from nondiffractive physics 
can be a matter of definition.)  For backwards compatibility the 
<code>SoftQCD:minBias</code> name can be used as an alternative to 
<code>SoftQCD:nonDiffractive</code> for some time yet. 
   
 
<p/><code>flag&nbsp; </code><strong> SoftQCD:elastic &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Elastic scattering <i>A B &rarr; A B</i>. 
Code 102. It is possible to include <a href="TotalCrossSections.html" target="page"> 
Coulomb corrections</a>, but by default this is off. 
   
 
<p/><code>flag&nbsp; </code><strong> SoftQCD:singleDiffractive &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Single diffractive scattering <i>A B &rarr; X B</i> and 
<i>A B &rarr; A X</i>. See page on <a href="Diffraction.html" target="page"> 
Diffraction</a> for details. Codes 103 and 104. 
   
 
<p/><code>flag&nbsp; </code><strong> SoftQCD:doubleDiffractive &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Double diffractive scattering <i>A B &rarr; X_1 X_2</i>. 
See page on <a href="Diffraction.html" target="page">Diffraction</a> 
for details. Code 105. 
   
 
<p/><code>flag&nbsp; </code><strong> SoftQCD:centralDiffractive &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Central diffractive scattering <i>A B &rarr; A X B</i> 
(a.k.a. double-Pomeron exchange, DPE). See pages on 
<a href="TotalCrossSections.html" target="page">Total Cross Sections</a> 
and on <a href="Diffraction.html" target="page">Diffraction</a> for details. 
In particular note the <code>SigmaTotal:zeroAXB</code> flag, 
which is off in most tunes, and that therefore would need to 
be reset to on after the selection of a tune (even the default one). 
Code 106. 
   
 
<p/><code>flag&nbsp; </code><strong> SoftQCD:inelastic &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
All of the above processes, except for elastic. Codes 101, 
103, 104, 105 and 106. 
   
 
<h3>Hard QCD processes</h3> 
 
This group contains the processes for QCD jet production above 
some minimum <i>pT</i> threshold. The <i>pT_min</i> cut cannot be put 
too low, or else unreasonably large jet cross sections will be obtained. 
This is because the divergent perturbative QCD cross section is used 
in this process group, without any regularization modifications. 
An eikonalized description, intended to be valid at all <i>pT</i>, 
is instead included as part of the multiparton-interactions framework, 
specifically in <code>SoftQCD:nonDiffractive</code> above. 
<br/><b>Warning 1</b>: you <b>must</b> remember to set the 
<code>PhaseSpace:pTHatMin</code> value if you use any of these 
processes; there is no sensible default. 
<br/><b>Warning 2</b>: you <b>must not</b> mix processes from the 
<code>SoftQCD</code> and <code>HardQCD</code> process groups, since 
this is likely to lead to double-counting. 
   
<p/><code>flag&nbsp; </code><strong> HardQCD:all &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Common switch for the group of all hard QCD processes, 
as listed separately in the following. 
   
 
<p/><code>flag&nbsp; </code><strong> HardQCD:gg2gg &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Scatterings <i>g g &rarr; g g</i>. 
Code 111. 
   
 
<p/><code>flag&nbsp; </code><strong> HardQCD:gg2qqbar &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Scatterings <i>g g &rarr; q qbar</i>, where <i>q</i> by default 
is a light quark (<i>u, d, s</i>) (see below). 
Code 112. 
   
 
<p/><code>flag&nbsp; </code><strong> HardQCD:qg2qg &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Scatterings <i>q g &rarr; q g</i> and <i>qbar g &rarr; qbar g</i>. 
Code 113. 
   
 
<p/><code>flag&nbsp; </code><strong> HardQCD:qq2qq &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Scatterings <i>q q' &rarr; q q'</i>, <i>q qbar' &rarr; q qbar'</i>, 
<i>qbar qbar' &rarr; qbar qbar'</i>, where <i>q'</i> and <i>q</i> 
may agree, but the outgoing flavours equals the incoming ones 
Code 114. 
   
 
<p/><code>flag&nbsp; </code><strong> HardQCD:qqbar2gg &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Scatterings <i>q qbar &rarr; g g</i>. 
Code 115. 
   
 
<p/><code>flag&nbsp; </code><strong> HardQCD:qqbar2qqbarNew &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Scatterings <i>q qbar &rarr; q' qbar'</i>, where <i>q'</i> 
by default is a light quark (<i>u, d, s</i>) (see below). 
Code 116. 
   
 
<p/><code>mode&nbsp; </code><strong> HardQCD:nQuarkNew &nbsp;</strong> 
 (<code>default = <strong>3</strong></code>; <code>minimum = 0</code>; <code>maximum = 5</code>)<br/>
Number of allowed outgoing new quark flavours in the above 
<i>g g &rarr; q qbar</i> and <i>q qbar &rarr; q' qbar'</i> processes, 
where quarks are treated as massless in the matrix-element expressions 
(but correctly in the phase space). It is thus assumed that <i>c cbar</i> 
and <i>b bbar</i> are added separately with masses taken into account, 
using the processes below. A change to 4 would also include <i>c cbar</i> 
in the massless approximation, etc. In order to avoid double-counting 
the processes below should then not be used simultaneously. 
   
 
<h3>Hard QCD processes: heavy-flavour subset</h3> 
 
These processes form a natural part of the above class, but can 
also be generated separately. Formally the heavy-quark mass makes 
these matrix elements finite in the <i>pT &rarr; 0</i> limit, but at 
high energies one may still question the validity of the expressions 
at low <i>pT</i> values, like for the other hard-QCD processes. 
Also as above, an eikonalized description, intended to be valid at all 
<i>pT</i>, is included as part of the multiparton-interactions framework. 
<br/>Note that the processes below only represent the "tip of the iceberg" 
of charm and bottom production at high energies, where flavour excitation 
and shower branchings provide major additional sources. All these sources 
come together in the descriptions offered by 
<code>SoftQCD:nonDiffractive</code> and <code>HardQCD:all</code>. 
 
<p/><code>flag&nbsp; </code><strong> HardQCD:gg2ccbar &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Scatterings <i>g g &rarr; c cbar</i>. 
Code 121. 
   
 
<p/><code>flag&nbsp; </code><strong> HardQCD:qqbar2ccbar &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Scatterings <i>q qbar &rarr; c cbar</i>. 
Code 122. 
   
 
<p/><code>flag&nbsp; </code><strong> HardQCD:hardccbar &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Sum of the previous two event types. 
Codes 121 and 122. 
   
 
<p/><code>flag&nbsp; </code><strong> HardQCD:gg2bbbar &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Scatterings <i>g g &rarr; b bbar</i>. 
Code 123. 
   
 
<p/><code>flag&nbsp; </code><strong> HardQCD:qqbar2bbbar &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Scatterings <i>q qbar &rarr; b bbar</i>. 
Code 124. 
   
 
<p/><code>flag&nbsp; </code><strong> HardQCD:hardbbbar &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Sum of the previous two event types. 
Codes 123 and 124. 
   
 
<h3>Hard QCD three-parton processes</h3> 
 
Three-parton final states are generated by showers off two-parton 
processes. Topologies then cannot be specified beforehand, beyond 
what is provided by the two-parton hard process. For some checks 
it may be convenient to have access to the dedicated three-parton 
final states, which is what this set of processes allows. 
Cross sections have been taken from [<a href="Bibliography.html" target="page">Ber81</a>]. 
<br/>Note that the processes in this section are  <it>not</it> 
affected by the <code>HardQCD:all</code> switch. In fact, it would 
be double-counting to include both the <code>HardQCD:all</code> and 
the <code>HardQCD:3parton</code> processes in a run or study. 
<br/><b>Warning:</b> this section is still incomplete, e.g. the 
selection of colour flow is very simple, and so it should only 
be used with caution. 
   
<p/><code>flag&nbsp; </code><strong> HardQCD:3parton &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Common switch for the group of all hard QCD processes with three 
partons in the final state, as listed separately in the following. 
   
 
<p/><code>flag&nbsp; </code><strong> HardQCD:gg2ggg &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Scatterings <i>g g &rarr; g g g</i>. 
Code 131. 
   
 
<p/><code>flag&nbsp; </code><strong> HardQCD:qqbar2ggg &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Scatterings <i>q qbar &rarr; g g g</i>. 
Code 132. 
   
 
<p/><code>flag&nbsp; </code><strong> HardQCD:qg2qgg &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Scatterings <i>q g &rarr; q g g</i> and <i>qbar g &rarr; qbar g g</i>. 
Code 133. 
   
 
<p/><code>flag&nbsp; </code><strong> HardQCD:qq2qqgDiff &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Scatterings <i>q q' &rarr; q q' g</i>, <i>q qbar' &rarr; q qbar' g</i>, 
and <i>qbar qbar' &rarr; qbar qbar' g</i>. 
Code 134. 
   
 
<p/><code>flag&nbsp; </code><strong> HardQCD:qq2qqgSame &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Scatterings <i>q q &rarr; q q g</i> and 
<i>qbar qbar &rarr; qbar qbar g</i> 
(<i>q qbar &rarr; q qbar g</i> scatterings are considered separately 
below, see <code>HardQCD:qqbar2qqbargSame</code>). 
Code 135. 
   
 
<p/><code>flag&nbsp; </code><strong> HardQCD:qqbar2qqbargDiff &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Scatterings <i>q qbar &rarr; q' qbar' g</i>, where <i>q'</i> 
by default is a light quark (<i>u, d, s</i>) 
(see <code>HardQCD:nQuarkNew</code> above). 
Code 136. 
   
 
<p/><code>flag&nbsp; </code><strong> HardQCD:qqbar2qqbargSame &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Scatterings <i>q qbar &rarr; q qbar g</i>. 
Code 137. 
   
 
<p/><code>flag&nbsp; </code><strong> HardQCD:gg2qqbarg &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Scatterings <i>g g &rarr; q qbar g</i>, where <i>q</i> by 
default is a light quark (<i>u, d, s</i>) 
(see <code>HardQCD:nQuarkNew</code> above). 
Code 138. 
   
 
<p/><code>flag&nbsp; </code><strong> HardQCD:qg2qqqbarDiff &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Scatterings <i>q g &rarr; q q' qbar'</i> and 
<i>qbar g &rarr; qbar qbar' q'</i>, where <i>q'</i> 
by default is a light quark (<i>u, d, s</i>) 
(see <code>HardQCD:nQuarkNew</code> above). 
Code 139. 
   
 
<p/><code>flag&nbsp; </code><strong> HardQCD:qg2qqqbarSame &nbsp;</strong> 
 (<code>default = <strong>off</strong></code>)<br/>
Scatterings <i>q g &rarr; q q qbar</i> and 
<i>qbar g &rarr; qbar qbar q</i>. 
Code 140. 
   
 
 
</body>
</html>
 
<!-- Copyright (C) 2014 Torbjorn Sjostrand -->