File: UpdateHistory.html

package info (click to toggle)
pythia8 8.1.65-1
  • links: PTS, VCS
  • area: main
  • in suites: wheezy
  • size: 22,660 kB
  • sloc: cpp: 59,593; xml: 30,509; php: 6,649; sh: 796; makefile: 353; ansic: 33
file content (1840 lines) | stat: -rw-r--r-- 83,131 bytes parent folder | download
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
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
1660
1661
1662
1663
1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679
1680
1681
1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
1703
1704
1705
1706
1707
1708
1709
1710
1711
1712
1713
1714
1715
1716
1717
1718
1719
1720
1721
1722
1723
1724
1725
1726
1727
1728
1729
1730
1731
1732
1733
1734
1735
1736
1737
1738
1739
1740
1741
1742
1743
1744
1745
1746
1747
1748
1749
1750
1751
1752
1753
1754
1755
1756
1757
1758
1759
1760
1761
1762
1763
1764
1765
1766
1767
1768
1769
1770
1771
1772
1773
1774
1775
1776
1777
1778
1779
1780
1781
1782
1783
1784
1785
1786
1787
1788
1789
1790
1791
1792
1793
1794
1795
1796
1797
1798
1799
1800
1801
1802
1803
1804
1805
1806
1807
1808
1809
1810
1811
1812
1813
1814
1815
1816
1817
1818
1819
1820
1821
1822
1823
1824
1825
1826
1827
1828
1829
1830
1831
1832
1833
1834
1835
1836
1837
1838
1839
1840
<html>
<head>
<title>Update History</title>
<link rel="stylesheet" type="text/css" href="pythia.css"/>
<link rel="shortcut icon" href="pythia32.gif"/>
</head>
<body>

<h2>Update History</h2>

These update notes describe major updates relative to the baseline 
PYTHIA 8.100 version. However, they are less extensive than the 
corresponding update notes for PYTHIA 6. On the other hand,
whereas the PYTHIA 6 manual is a static document, the PYTHIA 8
html/php pages are kept up to date for each subversion. 

<br/><br/>
<b>Important note:</b>version 8.160 does introduce some elements of 
backwards incompatibility. Specifically, "multiple interactions", 
abbreviated MI, haa been renamed "multiparton interactions", MPI. 
This affects many parts of the code and documentation. Also some 
features are deprecated, although remaining until the end of the 
8.1xx version series.


<h3>Main news by version</h3>

<ul>

<li>8.105: 24 February 2008
<ul>

<li>New option to initialize with arbitrary beam directions<br/>
<code>pythia.init( idA, idB, pxA, pyA, pzA, pxB, pyB, pzB)</code></li>

<li>Added capability to set <a href="BeamParameters.html" target="page">beam energy spread 
and beam vertex</a>.
<br/>
<b>Warning:</b> as a consequence, the old <code>Beams</code> group of 
settings has been moved to <code>BeamRemnants</code>, and 
<code>Beams</code> is now instead used for machine beam parameters. 
Therefore also some <code>Main</code> settings of this character have been 
regrouped, as follows:
<table cellspacing="5">
<tr> <td>8.100 setting  </td> <td>has been moved to </td> </tr>
<tr> <td><code>Main:idA          </code></td>
     <td><code>Beams:idA         </code></td> </tr>
<tr> <td><code>Main:idB          </code></td>
     <td><code>Beams:idB         </code></td> </tr>
<tr> <td><code>Main:inCMframe    </code></td>
     <td>(<code>Beams:frameType</code>) </td> </tr>
<tr> <td><code>Main:eCM          </code></td>
     <td><code>Beams:eCM         </code></td> </tr>
<tr> <td><code>Main:eA           </code></td>
     <td><code>Beams:eA          </code></td> </tr>
<tr> <td><code>Main:eB           </code></td>
     <td><code>Beams:eB          </code></td> </tr>
<tr> <td><code>Main:LHEF         </code></td>
     <td><code>Beams:LHEF        </code></td> </tr>
</table></li>

<li>The <code>forceHadronLevel()</code> method introduced for standalone 
hadronization.</li>

<li><code>main15.cc</code> illustrated how either full hadronization or 
only decays of some particles can be looped over for the rest of the 
event retained.</li>

<li>The <code>LHAevnt</code> and <code>LHAinit</code> classes have been 
joined into a new <code>LHAup</code> one, with new options that allow 
the writing of a Les Houches Event File.</li>

<li>The <code>SusyLesHouches</code> class updated to handle 
SLHA version 2.</li>

<li>Updated HepMC conversion routine.</li>

<li>The static <code>ErrorMsg</code> class has been removed and 
its functionality moved into the non-static <code>Info</code> class,
in the renamed Info file.</li>

<li>Further reduction of the use of static, with related code changes.
This should allow to have several almost independent <code>Pythia</code> 
instances. Some static classes still remain, however, notably for
random number generation and particle properties.</li>

<li>Limited capability to use two different <code>Pythia</code> instances 
for signal + pileup event generation, see <code>main19.cc</code> for an 
example.</li> 

<li>In the <code>Event</code> class the <code>=</code> and 
<code>=+</code> methods have been overloaded to allow the copying 
or appending of event records. Illustrated in <code>main19.cc</code>.</li>

<li>The html and php page formatting improved with 
cascading style sheets.</li>

<li>Several minor improvements and new options, including updated configure 
scripts.</li>

</ul>
</li>

<li>8.108: 1 May 2008
<ul>

<li>Correction in the event record, so that the beam particles in line 
1 and 2 do not have any mother according to the <code>motherList</code>
method. Previously the "system" entry in line 0 was counted as their 
mother, which gave rise to an unexpected extra vertex in the conversion 
to the HepMC format.</li>

<li>Support for HepMC version 1 is removed, to simplify the code and 
reflect the evolution of the field.</li>

<li>Status codes are stored in HepMC only as 1 for existing and 2 for
decayed or fragmented particles (whereas previously the original PYTHIA
codes were used for the latter).</li>

<li>Parton densities are stored in HepMC as <i>xf(x,Q^2)</i> 
rather than the <i>f(x,Q^2)</i> used in (some) previous versions.</li>

<li>The SusyLesHouches class has ben updated so that reading is fully
compatible with the SLHA2 standard. </li>

<li>Improved handling of the Higgs width, relevant for massive and thereby
broad resonance shapes.</li>

<li>The matrix elements for neutralino pair production have now been
completed and checked.</li>

<li>Ensure that <i>alpha_strong</i> does not blow up, by introducing 
a minimal scale somewhat above <i>Lambda_3</i> (roughly where
<i>alpha_strong = 10</i>).</li>

<li>New methods <code>isValence1()</code> and <code>isValence2()</code> 
in the <code>Info</code> class.</li>

<li>Protection against division by zero in calculation of decay vertex
(for zero-mass gluons with zero lifetime, where there should be no
displacement).</li>

<li>A new compilation option <code>-Wshadow</code> is introduced and 
code is rewritten at all places where this option gave warnings.</li>

<li>Minor library correction to allow compilation with gcc 4.3.0.</li>

</ul>
</li>

<li>8.114: 22 October 2008
<ul>

<li>New rescattering description operational (but still experimental) 
for the case that FSR is not interleaved, but saved until after MPI, 
ISR and beam remnants have been handled. This involves much new code
in several classes.</li>

<li>A new class <code>PartonSystems</code> is introduced to 
keep track of which partons in the event record belong to which 
subcollision system, plus some further information on each subsystem.
It takes over functionality previously found as part of the 
<code>Event</code> class, but leaves room for future growth.</li>

<li>Add optional model, wherein an increased <i>pT0</i> turnoff scale 
for MPI and ISR is used for above-average active events, i.e. events that 
already have several MPI's or ISR emissions.</li>

<li>Freeze GRV 94L distribution at small <i>Q^2</i> to avoid blowup.</li>

<li>The <code>pythia.readFile(...)</code> method can now alternatively take 
an <code>istream</code> as argument instead of a <code>filename</code>.</li>

<li>Minor bug correction in <code>PartonLevel.cc</code>; the bug could 
(rarely) give a segmentation fault.</li>

</ul>
</li>

<li>8.120: 10 March 2009
<ul>

<li>New rescattering description further developed, but not yet
recommended for normal usage.</li>

<li>Include new processes for Large Extra Dimensions and Unparticles,
contributed by Stefan Ask. New test program <code>main28.cc</code> 
illustrates.</li>

<li>Include further SUSY processes: neutralino-chargino and 
chargino-chargino pairs. The processes should be valid also 
in the case of non-minimal flavour violation and/or CP violation.
Expanded machinery to keep track of SUSY parameters.</li>

<li>Include backwards evolution of incoming photon as part of the
<code>SpaceShower</code> initial-state radiation description. This
allows you to simulate hard collisions where one of the incoming
partons is a photon. New test program <code>main43.cc</code> 
illustrates.</li>

<li>Allow separate mass and transverse momentum cuts when two hard 
subprocesses are generated in the same event.</li>

<li>The default value for the border between short- and long-lived
paticles has been changed from 1 mm to 10 mm, to better conform with 
LHC standards, see  <a href="ParticleDecays.html" target="page">here</a>.
The default is still to let all unstable particles decay.</li>

<li>New ISR matrix-element correction to <i>f -&gt; f gamma</i> 
in single <i>W</i> production.</li>

<li>New method <code>Event::statusHepMC</code> returns the status 
code according to the HepMC conventions agreed in February 2009.
The interface to HepMC now writes out status according to this 
convention.</li>

<li>Add capability to link to FastJet, with expanded configure script 
and Makefile, and with <code>main61.cc</code> as new example.</li>

<li>Update of <code>Makefile.msc</code>, with added support for latest 
Visual C++ Express edition and use of regexp to check nmake version.</li>

<li>Update of <code>LHAFortran.h</code> and 
<code>Pythia6Interface.h</code>, to make the interface to Fortran 
routines work also under Windows. (Thanks to Anton Karneyeu.)

<li>Updated and expanded worksheet.</li>

<li>The manual pages in the <code>xmldoc</code> directory, and thereby
also those of the <code>htmldoc</code> and <code>phpdoc</code>
directories, have been significantly updated and expanded. In particular, 
in many places the class of each method is explicitly shown, as well as 
the type of the return value and of the arguments. This upgrade is not 
yet completed, but already covers the more relevant sections. </li>

<li>The unary minus operator in the <code>Vec4()</code> returns a 
reference to a four-vector with all components negated, but leaves 
the original four-vector unchanged. Previously the four-vector itself
was flipped.</li>

<li>The <code>pPlus()</code> and <code>pMinus()</code> methods of a
four-vector and an event-record particle are renamed <code>pPos()</code> 
and <code>pNeg()</code>, respectively.</li>

<li>Include a further loop in <code>ProcessLevel</code>, so that a new
process is generated in case of failures of a less severe nature.</li>

<li>Introduce warning message for unexpected <code>meMode</code> in
<code>ResonanceWidths</code>.</li>

<li>Les Houches event reading framework has been rearranged for
more flexibility. Some bugs corrected. Specifically, when scale 
is not set (<code>scale = -1.</code> in the Les Houches standard),
PYTHIA did not attempt to set this scale itself, which typically 
lead to there not being any ISR or FSR. Now the 
<a href="CouplingsAndScales.html" target="page">rules for normal 
1-, 2- and 3-body final states</a> are applied, with a trivial
extension of the 3-body rules for higher multiplicities.</li>

<li>Correct bug in the handling of parton densities, whereby it was
not possible to switch to a new set, once a first initialization
had been done.</li>

<li>Correct bugs when several <code>Pythia::init</code> initialization
calls are made in the same run, specifically in the case that pointers
to external processes have been handed in.

<li>Changes in <code>main03.cmnd</code> and <code>main04.cmnd</code> 
so that some nonstandard options are commented ou rather than active. 
Related comments inserted also in some other <code>.cmnd</code> files, 
but there without any change in program execution.</li>

<li>A few further minor bug fixes.</li>

<li>Update year to 2009.</li>

</ul>
</li>

<li>8.125: 16 June 2009
<ul>

<li>Hadronization and timlike-shower parameter default values updated 
according to a tune to LEP1 data by Hendrik Hoeth, using the 
Rivet + Professor framework.</li>

<li>Many further SUSY production processes. SLHA readin expanded to cover 
also masses and decay modes. Example <code>main22.cc</code> updated, while 
<code>main33.cc</code> now superfluous and removed. </li>

<li>Also further processes for extra dimensions.</li>

<li>Stefan Ask joins as coauthor.</li>

<li>The <code>TimeShower::shower(...)</code> method has gained 
a new argument, that forces the shower evolution to stop after
a given number of branchings. A new method 
<code>TimeShower::pTLastInShower()</code> permits the last evolution
<i>pT</i> to be read out. These extensions can be useful 
for matching studies.
</li>

<li>New optional argument <code>isInterleaved</code> added to 
<code>TimeShower::branch(...)</code>. Is false by default, but
true when called from the parton level for interleaved evolution
of several parton systems, optionally also with ISR and MPI.</li>

<li>New methods <code>UserHooks::canSetResonanceScale()</code>
and <code>UserHooks:scaleResonance(...)</code> allows an optional 
user choice of the maximum shower scale in resonance decays.</li>

<li>A new method <code>SpaceShower::doRestart()</code> has been 
added, to help distinguish cases when a
<code>SpaceShower::branch(...)</code> failure forces a complete
restart of the evolution from ones where only the intended
current branching has been vetoed.

<li>When multiparton interactions are initialized, it is now 
possible to reduce both <i>pT0</i> and <i>pTmin</i>
if necessary to find a valid solution where 
<i>sigma_jet &gt; sigma_nondiffractive</i>. Previously
only the former would be reduced, which could lead to 
infinite loops if too large a <i>pTmin</i> was used.
Thanks to Sami Kama for pointing out the problem.
</li>

<li>The rescattering machinery is now essentially completed, and can
be used also by others than the authors. For now, however, it can only
be recommended for dedicated studies, not e.g. for generic tunes.
</li>

<li>Timelike and spacelike showers, and beam remnant handling, 
are modified to handle rescattering partons. Specifically, a new machinery 
is introduced to trace the recoils from the combination of rescattering 
with showers and primordial <i>kT</i>. Can assign space- or timelike 
virtualities to intermediate particles to have energy and momentum 
conserved locally. This affects the <code>PartonLevel</code>, 
<code>MultipartonInteractions</code>, <code>TimeShower</code>, 
<code>SpaceShowe</code>r and <code>BeamRemnants</code> classes. 
Further details to appear in the upcoming article on rescattering. 
(Another change is a reversal to pre-8.114 order for non-interleaved FSR,
wherein also FSR is treated before beam remnants are attached.)
</li>

<li>Four new status codes introduced, as part of the rescattering 
description:
<br/>45 : incoming rescattered parton, with changed kinematics owing
to ISR in the mother system (cf. status 34);
<br/>46 : incoming copy of recoiler when this is a rescattered parton
(cf. status 42);
<br/>54 : copy of a recoiler, when in the initial state of a different 
system from the radiator;
<br/>55 : copy of a recoiler, when in the final state of a different 
system from the radiator.
</li>

<li>New method <code>Info::tooLowPTmin()</code> can tell whether the 
<i>pTmin</i> scales for showers or multiparton interactions are too low. 
</li>

<li>Pion beams allowed, both <i>pi^+</i>, <i>pi^-</i> and 
<i>pi^0</i>. New machinery for the latter, where the valence 
flavour content is chosen to be either <i>d dbar</i> or 
<i>u ubar</i> for each new event. One internal pion PDF 
implemented, with others from LHAPDF.</li>

<li>Treatment of Pomeron-proton collisions begun.</li>

<li>Phase-space handling of hard processes and multiparton interactions
slightly expanded to better allow for harder PDF's than proton ones,
e.g. for Pomerons.</li>

<li>The program documentation has been expanded with an
alphabetical index of all methods that are described on the 
webpages, see the <a href="ProgramMethods.html" target="page">Program Methods</a> 
page. Also other sections of the documentation have been
updated and expanded, including the worksheet.</li>

<li>Several <code>list</code> methods have been made 
<code>const</code>. For the listing of events two new methods
have been added, <code>Event::list()</code> and 
<code>Event::list(bool showScaleAndVertex, 
bool showMothersAndDaughters = false)</code>,
that correspond to special cases of the general method.</li>

<li>A new method <code>Pythia::LHAeventSkip(int nSkip)</code>
permits a skip-ahead of the reading of external Les Houches 
Events, without the necessity to generate the intervening 
<code>nSkip</code> events in full. Makes use of the new 
<code>LHAup::skipEvent(int nSkip)</code> method to perform 
the operations. Mainly intended for debug purposes.

<li>The <code>ClusterJet</code> jet finder now saves the last
five clustering scales. Also a minor bug fix. Thanks to Nils 
Lavesson for this contribution.</li>

<li>The <code>Particle::m2()</code> method now returns a negative 
number when the stored mass <i>m</i> is negative, as used to 
indicate spacelike virtualities. Also the 
<code>Particle::eCalc()</code>, <code>Particle::mT()</code> and
<code>Particle::mT2()</code> methods have been modified.
</li>

<li>The <code>&lt;&lt;</code> method to print our a four-vector has 
been expanded with a fifth number, the invariant length, with a minus
sign for spacelike vectors, and provided within brackets to allow
a simple visual distinction.</li>

<li>New methods <code>Rndm::dumpState(string fileName)</code> and
<code>Rndm::readState(string fileName)</code> allows to write or
read the state of the random number generator to or from a binary file.
</li>

<li>New method <code>double GammaReal(double x)</code> returns the 
value of the <i>Gamma</i> function for arbitrary real argument.
Some cross sections for extra-dimensional processes rewritten to
make use of it.
</li>

<li>New example program <code>main29.cc</code> shows how 
to set up a fictitious process of a heavy system decaying
to two particles or partons, with decays traced to stable
particles, as relevant for astroparticle applications.</li>

<li>Main programs that illustrate the HepMC interface have
been updated to use version 2.04, including units and excluding
deprecated output formats.</li>

<li>The <code>main32.cc</code> example extended also to handle 
Les Houches Event Files.</li>

<li>The Makefile has been modified so that "make clean" only
removes the current compilation and library fles, while 
"make distclean" gives a more extensive reset and cleanup.
Thanks to Nils Lavesson for this contribution. Some other
minor Makefile corrections.</li>

<li>Several main programs that use the 
<code>Main:timesToShow</code> mode have been corrected so as 
not to crash if this is set to zero. Also some other cosmetics
changes in main programs that do not affect the running.</li>

<li>Bug correction, in that previously a veto with user hooks 
was not propagated from parton showers inside resonance decays.
</li>

<li>Minor bug fix in <code>TimeShower</code> for kinematics with 
unequal beam-particle masses.</li>

<li>Bug fix so that <code>PartonLevel:MPI = off</code> also works for 
minimum-bias events.</li>

<li>Minor bug fix in the impact-parameter selection of multiparton 
interactions. Thanks to Sami Kama for pointing it out.</li>

<li>String fragmentation for junction topology protected against 
numerical instability in boost.</li>

<li>Bug correction in the handling of particle decays to partons,
where the scale of the partons was set before the partons had been
added to some arrays, leading to indexation out of bounds. 
Thanks to Vladislav Burylov for discovering this bug.
</li>

<li>Bug correction in the handling of particles with inhibited decay, 
where the decay vertex would be too far displaced, which could lead to
infinite loop. Thanks to Sami Kama for debugging this. </li>

<li>Check to avoid infinite loop in matrix-element handling of 
two-body decays.</li>

<li>Bug correction to avoid infinite loops in Dalitz decay treatment.
Some changes in the decay handling logic to allow a new try when the 
decay of a particle fails.</li>

<li>Minor correction, so the pointer to the <code>Info</code> class
is set also for user-written classes derived from <code>LHAup</code>. 
</li>

<li>Correction for typo in the matrix element of the
<code>Sigma3ff2HchgchgfftWW</code> class, for doubly charged Higgs
production. Thanks to Merlin Kole for spotting it.</li>

<li>Updated colour bookkeeping in junction-antijunction annihilation 
avoids later problems in <code>Pythia::check()</code>. </li>

<li>Minor updates of the <code>Makefile.msc</code> file to work with 
Visual Studio 2008. Thanks to David Bailey for these modifications.</li>

<li>Ensure that <code>nInit</code> in the <code>BeamParticle</code>
class is set also for unresolved lepton beams.</li>

<li>The <code>VetoEvolution</code> class, derived from 
<code>UserHooks</code>, is obsolete and has been removed.</li>

</ul>
</li>

<li>8.130: 15 September 2009
<ul>

<li>New machinery that allows multiparton interactions inside diffractive 
systems. Also new optional Pomeron flux factors and Pomeron PDFs.
New page on <a href="Diffraction.html" target="page">diffraction</a> added, where
further details are collected. Still not tuned, so to be used with 
caution.</li>

<li>Make Peter Skands' "Tune 1" parameters for ISR and MPI default.
The older simpler tune is still available as an option, see
<code><a href="Tunes.html" target="page">Tune:pp</a></code>. 
</li>

<li>New possible choices for a second hard process: charmonium,
bottomonium, top pair and single top.</li>

<li>New code for pair production of generic colour-triplet scalar, 
fermion or vector. Largely written by Johan Bijnens, partly recycling 
existing code.</li>

<li>Add user hooks possibility to veto event after a given number
of multiparton interactions.</li>

<li>Add instructions how PYTHIA 8 can be used from inside ROOT.
Thanks to Andreas Morsch for providing the text and Rene Brun 
for a simple example.</li>

<li>The <code>main21.cc</code> example extended with an option
for a single-particle gun.</li>

<li>Improvements and bug fixes in rescattering framework.</li>

<li>New method <code>Hist::table(string fileName)</code> provides a
more direct way to print a two-column table of histogram contents
into a file than the current <code>Hist::table(ostream& os = cout)</code>.
 </li>

<li>Modify reading of external files so that a line only consisting of
control characters counts as empty, the same way as a line only consisting
of blanks already did. This includes carriage return, tabs and a few more, 
the ones represented by <code>\n \t \v \b \r \f \a</code>. Applies to 
Les Houches Event files, settings files and particle data files. </li>

<li>Fix it so that the read-in of a Les Houches Event File for the 
hardest process can be combined with the faciliy to select a specified
second hard process.</li>

<li>New empty base class method <code>LHAup::fileFound()</code> 
allows the derived class <code>LHAupLHEF</code> to signal more
clearly that a failed initialization is caused by a failure to open
the desired file. </li>

<li>Check that a pointer to an <code>LHAup</code> object has been set
in <code>Pythia::LHAeventList()</code> and
<code>Pythia::LHAeventSkip(...)</code> calls.</li>

<li>Updated configure and Makefile, e.g. to build shared libraries 
on Mac OS X.</li>

<li>The options with a direct link to hard-process generation
in PYTHIA 6 has been removed. It is hardly ever used but 
complicates the build structure. (Owing to its usefulness for some 
debug work, it was reinstated in a limited form in version 8.135.
Thus <code>main51.cc</code> now contains the complete interface, 
previously in separate files, and commented-out lines in 
<code>examples/Makefile</code> suggest how PYTHIA 6 could be linked.) 
</li>

<li>New argument to <code>Info::errorMsg(...)</code> allows to 
show all error messages of a specific kind rather than only the 
first one, e.g. for initialization.</li>

<li>Correction in decay table of righthanded Majorana neutrinos.
Thanks to Arnaud Ferrari and Vladimir Savinov.</li>

<li>Correction in expressions in the manual for <i>H^+-</i> couplings 
to an <i>h^0</i>, <i>H^0</i> or <i>A^0</i> and a <i>W^+-</i>.
Thanks to Rikard Enberg.</li>

<li>Fix for accessing uninitialized memory, caused by accessing the 
daughters of the incoming beams before these daughters actually existed.
Thanks to David Bailey and Sami Kama.
</li>

<li>Uninitialized photon PDF inside the proton could give crazy results
for processes with incoming photons. Thanks to Adam Davison.</li>

<li>Bug fix such that finite lifetimes can be set also for particles
produced in the hard process. To exemplify, the bug affected 
<i>tau</i> leptons produced in <i>Z^0</i> and <i>W^+-</i> 
decays. Thanks to Troels Petersen.</li>

<li>Bug fix in <code>TimeShower</code>, that <code>beamOffset</code>
could remain uninitialized. Thanks to Sami Kama.</li>

<li>Minor correction to resonance decays: fail if the allowed mass
range of a Breit-Wigner resonance is a small fraction of the total
area under the resonance curve.</li>

<li>Correction when all three valence quarks were kicked out from a 
proton and could give false messages that beam momentum had been 
used up.</li>

<li>Clarify status codes needed for hadron-level standalone runs in
order to avoid error messages, and modify the <code>main21.cc</code>
example accordingly. </li>

<li>Minor corrections in the processes for extra dimensions.</li>

<li>Some other minor additions to existing facilities
and minor bug fixes.</li>

</ul>
</li>

<li>8.135: 10 January 2010
<ul>

<li>All usage of static member methods inside Pythia8 has now been
eliminated. This simplifies for you to have several simultaneous 
<code>Pythia</code> instances that are run with different conditions.
The three main classes affected by this are the <code>Settings</code> 
and <code>ParticleData</code> databases and the <code>Rndm</code> 
random-number generator. You can no longer address the methods of these
classes directly, but have to address them via the <code>settings</code>,
<code>particleData</code> and <code>rndm</code> instances in the 
respective <code>Pythia</code> object. Also some other smaller pieces
of code are affected, e.g. Standard Model and SUSY couplings 
(the latter in new files). 
<br/><b>Note 1</b>: The documentation has been updated accordingly
on these webpages, but the "A Brief Introduction to PYTHIA 8.1"
still refers to the old behaviour of version 8.100.
<br/><b>Note 2</b>: the interface to the external LHAPDF library remains
static, since LHAPDF is written in Fortran and thus by definition
static.
<br/><b>Note 3:</b> if you want to have momentum smearing in 
<code>CellJet</code> you now need to send in a pointer to a 
random-number generator.  
</li>

<li>Ten new proton PDF sets are made available internally:
MRST LO* (2007), MRST LO** (2008), MSTW 2008 LO (central member),
MSTW 2008 NLO (central member), CTEQ6L, CTEQ6L1, CTEQ6.6 (NLO,
central member), CT09MC1, CT09MC2, and CT09MCS, see 
<a href="PDFSelection.html" target="page">PDF Selection</a>. The Pomeron PDF data 
files have been renamed for consistency. Thanks to Tomas Kasemets 
for help with this [<a href="Bibliography.html" target="page">Kas10</a>].
</li>

<li>New parameters <code>TimeShower:pTmaxFudgeMPI</code> and 
<code>SpaceShower:pTmaxFudgeMPI</code> introduced, to give the same
functionality for multiparton interactions that 
<code>TimeShower:pTmaxFudge</code> and <code>SpaceShower:pTmaxFudge</code>  
do for the hardest.</li>

<li>A few extensions of the <code>UserHooks</code> framework.
New methods <code>UserHooks:canVetoISREmission()</code> and
<code>UserHooks::doVetoISREmission(...)</code> allows the latest
initial-state emission to be studied before being finalized, 
with the possibility to veto it. 
Similarly <code>Userhooks:canVetoFSREmission()</code> and
<code>UserHooks::doVetoFSREmission(...)</code> can be used to
veto the latest final-state emission.</li>

<li>A number of loop counters have been introduced in the 
<code>Info</code> class, that offers some further information on
the progress of the event generation, for use e.g. in conjunction
with the <code>UserHooks</code> facility.</li>

<li>The <code>Pythia::initTunes(...)</code> method is made public, so that
it can be called before the normal call from <code>Pythia::init(...)</code>.
That way it is possible to start out from a given tune and change a few
of the parameters.
</li>

<li>Bug corrected in <code>LHAFortran.h</code> for hard-process input
from Fortran commonblock. This did not work properly when the input
was used in combination with a second hard process generated internally.
Thanks to Mikhail Kirsanov and Roberto Chierici.

<li>Insertion of missing initialization of <code>isInit</code> in the
<code>Settings</code> and <code>ParticleData</code> constructors, and 
<code>nInit</code> for <code>BeamParticle</code>.
Thanks to Leif L&ouml;nnblad.</li>

<li>Updated <code>Makefile.msc</code> for Windows users.</li>

<li>Fix of some non-optimal use of booleans, that give warnings on
a Windows compiler. Thanks to Anton Karneyeu.</li>

<li>New options for the <a href="SUSYLesHouchesAccord.html" target="page">
SUSY Les Houches Accord</a> such that, by default,
particle and decay data are not overwritten for known Standard Model 
particles (including <i>Z^0</i>, <i>W^+-</i> and <i>t</i>,
but excluding the Higgs).</li>

<li>Bug fix in <code>SusyLesHouches</code>, where the reading of SLHA
information embedded in an LHEF would not stop at the end of the header
section.</li> 
 
<li>Bug correction for undefined secondary widths where decay products 
together are heavier than the mother. Also unit default secondary width 
values in the <code>DecayChannel</code> constructor.</li>
 
<li>Documentation updated, including change of current year to 2010.</li>

</ul>
</li>

<li>8.140: 16 July 2010
<ul>

<li>Four new draft <a href="Tunes.html" target="page">tunes</a> available.</li>

<li>Introduction of a new scenario for production of Hidden-Valley
particles, and interleaved showering in the QCD and HV sectors, see
the new <a href="HiddenValleyProcesses.html" target="page">Hidden Valleys</a> 
description. A longer physics writeup is available [<a href="Bibliography.html" target="page">Car10</a>].
</li>

<li>Implementation of <i>2 -> 3</i> phase space selection intended 
for QCD processes with massless partons. A new set of matching 
<a href="PhaseSpaceCuts.html" target="page">phase space cut parameters</a>. 
The <a href="QCDProcesses.html" target="page">ten different QCD <i>2 -> 3</i> 
processes</a> have been implemented making use of this new 
possibility, so far without a complete handling of possible colour 
flows, however.</li> 

<li>New processes have been added for 
<a href="CompositenessProcesses.html" target="page">contact interactions</a> in 
<i>q q -> q q</i> and <i>q qbar -> q qbar</i> scattering.</li>

<li>A process has been added for TeV^-1 Sized 
<a href="ExtraDimensionalProcesses.html" target="page">Extra Dimensions</a>, which 
involves the electroweak KK gauge bosons, i.e. <i>gamma_{KK}/Z_{KK}</i>,
in one TeV^-1 sized extra dimension; see <code>main30.cc</code> for 
an example. This scenario is described in [<a href="Bibliography.html" target="page">Bel10</a>]. Thanks to 
Noam Hod and coworkers for contributing this code.</li>

<li>In the Randall-Sundrum extra-dimensional scenario a new option has 
been added where SM fields can exist in the bulk rather than only on
a brane. (Still under development.) Furthermore production of a 
Kaluza-Klein gluon state has been added, and the <code> main28.cc</code> 
test program extended.</li> 

<li>The scenario for monojets in Large Extra Dimensions has been expanded
with an alternative for scalar graviton exchange instead of tensor one.
</li> 

<li>New parameters for maximum scale of 
<a href="TimelikeShowers.html" target="page">timelike showers</a>,
<code>TimeShower:pTmaxMatch</code>, and the dampening of hard radiation,
<code>TimeShower:pTdampMatch</code> and <code>TimeShower:pTdampFudge</code>,
by analogy with corresponding ones for spacelike showers. Also new method
<code>TimeShower:limitPTmax(...)</code> to implement alternative procedures.
For dipoles stretched to the beam the new switch 
<code>TimeShower:dampenBeamRecoil</code> allows to dampen radiation
close to the beam direction, with a changed default behaviour.</li>  

<li>Azimuthal anisotropies from coherence arguments have been introduced 
for the spacelike parton showers, see <code>SpaceShower:phiIntAsym</code>
and <code>SpaceShower:strengthIntAsym</code>.
Also azimuthal anisotropies from gluon polarization have been introduced 
for the spacelike parton showers, see <code>SpaceShower:phiPolAsym</code>,
and updated for timelike parton showers, see 
<code>TimeShower:phiPolAsym</code>.</li>

<li>Improvements for the matching to POWHEG LHEF-style input illustrated
by the new <code>main71.cc</code> example. See also [<a href="Bibliography.html" target="page">Cor10</a>].</li>

<li>A set of new processes <i>gamma gamma -> f fbar</i>, with <i>f</i>
quarks or leptons. Code for equivalent photon flux around an unresolved 
proton, with more to come. Thanks to Oystein Alvestad.
</li>

<li>A new option has been included to dampen the growth of the diffractive
cross sections, see <a href="TotalCrossSections.html" target="page">Total Cross 
Sections</a>.</li>

<li>A new method <code>virtual int SigmaProcess::idSChannel()</code>
has been introduced. If overloaded to return a nonzero value then a 
<i>2 -> n</i> process will appear listed as a <i>2 -> 1 -> n</i> one.
That is, an intermediate resonance with the requested identity will be 
inserted in the event record, even without appearing in the calculation 
of the matrix element proper. Thanks to Noam Hod for idea and code.</li> 

<li>A new method <code>SigmaProcess::convertM2()</code> has been introduced
to optionally allow the <code>SigmaProcess::sigmaHat()</code> to return
the squared matrix element rather than <i>d(sigmaHat)/d(tHat)</i> for
<i> 2 -> 2 </i> processes. Furthermore kinematics is stored in the new
<code>mME</code> and <code>pME</code> vectors for alternative cross
section encodings.</li> 

<li>Different encoding of the <i>f fbar -> Z W</i> cross section,
contributed by Merlin Kole, based on the cross section of
Brown, Sahdev and Mikaelian. Gives a distinctly different cross section
than the previous based on EHLQ (including their bug fix).
In particular the problem with negative cross sections is now fixed.</li>

<li>Minor updates: pass <code>xmlPath</code> to new MSTW and CTEQ PDFs;
reset beams earlier to give cleaner documentation.</li>

<li>The H1 Fit B LO parametrization to the Pomeron PDF has been included, 
and made new default for Pomerons. Thanks to Paul Newman for providing 
the data files.</li>

<li>Three changes, in principle unrelated, but with the common objective
to make the generation of a given event depend only on the values
determined during the initialization stage and on the state of the 
random-number generator when the event is begun. The new default 
should ensure a reproducible stop-and-restart behaviour, convenient 
for debug purposes. Thanks to Michael Schmelling for stressing the 
desire for such a behaviour.
<br/>(i) Introduction of a new option <code><a href="PhaseSpaceCuts.html" target="page">
PhaseSpace:increaseMaximum</a></code> that allows to switch between
two strategies for handling the (hopefully rare) cases when the 
assumed maximum of the cross section function is exceeded during the
event generation, with a changed default behaviour. In the old 
default the maximum could be increased if it was exceeded during the run,
thereby introducing a memory of the previously generated events.
<br/>(ii) Updated handling of random numbers with Gaussian distributions.
The <code>gauss()</code> method now only generates one value at a time.
Instead the new <code>gauss2()</code> method returns a pair of Gauss
numbers, with related time savings. In the old approach one Gaussian 
number could be buffered, which introduced a memory.
<br/>(iii) Minor bug fix in <code>MiniStringFragmentation</code>, where 
the popcorn baryon state was not reset for each new system, again
giving a (flawed) memory.</li> 

<li>New directory <code>rootexample</code> with a simple code example
how to use ROOT for histogramming in PYTHIA runs. See
<a href="ROOTusage.html" target="page">ROOT Usage</a> for details. Thanks to Rene Brun.
</li>

<li>In the <code>HepMCinterface</code> the checks for unhadronized
quarks and gluons are not performed if hadronization has been switched 
off.</li>

<li>The <code>UserHooks::initPtr(...)</code> has been expanded so that
pointers to more classes (beam particles, random number, couplings, etc.)
are sent in, thereby increasing the scope of possible user-written code.
Also, the <code>UserHooks::doVetoProcessLevel(Event& process)</code>
now allows the <code>process</code> event record to be modified, 
even if it is not recommended. The new <code>Info::pTnow()</code>
method returns the current <i>pT</i> scale of the combined MPI, ISR 
and FSR evolution, which can be useful for some user hooks decisions.
</li>

<li>Histograms of the <code>Hist</code> class can now be booked 
with up to 1000 bins, instead of the previous maximum 100. All bins
can be written to file, but the line-printer style printing will join
nearby bins so at most 100 are printed, as before.  </li>

<li>Updated <code>configure</code> and <code>Makefile</code> 
to allow 64-bit compilation and more options. Thanks to Mikhail Kirsanov,
Rene Brun and Fons Rademakers.</li>

<li>Bug fix in <code>ProcessLevel</code> for colour flow checks of 
junctions. Enables the decay of a neutralino to three quarks, e.g.
Thanks to Nils-Erik Bomark.</li>

<li>Bug fixes in <code>TimeShower</code>, where recoil partners in resonance
decays of coloured particles, and recoil partners in QED dipoles when beams
are not allowed to take a recoil, might not be correctly identified. </li>

<li>Bug fix in <code>SpaceShower</code>: when used with a fixed 
<i>alpha_strong</i>, the threshold enhancement factor of 
<i>g -> Q Qbar</i> became undefined. Thanks to Stefan Prestel.</li>

<li>Bug fix in initialization of resonance widths, where the 
<code>minWidth</code> parameter could be used uninitialized,
occasionally resulting in strange initialization problems when
kinematics needs to force at least one resonance to be off-shell.</li>

<li>Minor updates of <code>main06.cc</code>, <code>main10.cc</code>
and <code>main23.cc</code>.</li>

<li>Bug fix in mother pointer of multiparton interactions in 
diffractive systems.</li>

</ul>
</li>

<li>8.142: 15 August 2010
<ul>

<li>The strategy for setting up tune values has been changed.
Previously the <code>Tune:ee</code> and <code>Tune:pp</code>
settings were only interpreted during the 
<code>Pythia::init(...)</code> stage. Now they are interpreted
as soon as they are read. Specifically this means that it is 
possible to override any of the tune parameters by putting new
commands below <code>Tune:ee</code> and <code>Tune:pp</code>
in the <code>Pythia::readFile(...)</code> configuration file 
or in the list of <code>Pythia::readString(...)</code> commands.
<br/>As a consequence of this change, the public 
<code>Pythia::initTunes(...)</code> method has been replaced by
two private <code>Settings::initTuneEE(...)</code> and
<code>Settings::initTunePP(...)</code> methods. 
<br/>If <code>Tune:ee</code> or <code>Tune:pp</code> are
nonvanishing by default, then the corresponding tune variables
are set also from the <code>Pythia</code> constructor, before any
user changes are possible. Currently this is not relevant.
</li>

<li>Bug fix in the setup of the <code>Tune:pp = 5</code> and 
<code>= 6</code> options, which meant that diffractive cross 
sections were not reduced as advertised.</li>

<li>The default value of <code>MultipartonInteractions:pT0Ref</code>
has been slightly reduced so as to give a somewhat improved
default description. It is not intended as a replacement for the 
specific tunes, however.</li>

<li>Some comparisons between tunes and data, obtained with the 
Rivet package, have been posted on
<a href="http://home.thep.lu.se/~richard/pythia81/">   
http://home.thep.lu.se/~richard/pythia81/</a>.
Further improvements can be expected from future Professor-based
tunes. The current set of 2C, 2M, 3C and 3M "draft tunes" have
deliberately been chosen different also to explore a range of 
possibilities. One not visible in the plots is the fraction
of single and double diffractive events in the inelastic cross 
section. This is 32% in 2C and 2M, while it was reduced to
21% in 3C and 3M, and a recent ATLAS study (ATLAS-CONF-2010-048)
would suggest 28+-4%.</li>

<li>Minor changes in <code>TimeShower</code> and
<code>SpaceShower</code>, as protection if the <i>c</i> or
<i>b</i> masses are set small.</li>

<li>Bug fix in <code>SpaceShower</code>, for case when <i>phi</i> 
angle selection is biased to take into account interference effects.
</li>

<li>The <code>SigmaProcess::convertM2()</code> method now has
been implemented also for <i>2 -> 1</i> processes, so that it is
possible to provide the squared matrix element instead of
<i>sigmaHat</i> for semi-internal processes. A fixed-width 
Breit-Wigner is also inserted, since the matrix element is supposed 
not to include it.</li> 

<li>New method <code>SigmaProcess::setupForME()</code> does an
extended conversion from the internal kinematics to an almost
equivalent one, better adapted to the mass conventions of matrix-element 
caclulation programs, such as massive incoming <i>b</i> quarks.
New flags allow to determine whether the <i>c</i>, <i>b</i>, 
<i>mu</i> and <i>tau</i> should be considered massless or not 
in the calculations.</li>

<li>Two new friend methods <code>table</code> of the <code>Hist</code> 
class allow to print a table with three columns, the first for the 
(common!) <i>x</i> values and the other two for the respective 
histogram values. A new method <code>takeSqrt</code> for the square
root of histogram bin contents. 
</li>

</ul>
</li>

<li>8.145: 10 November 2010
<ul>

<li><code>Couplings</code> is defined in <code>StandardModel.h</code>
as a derived class of <code>coupSM</code> and has only one extra flag: 
<code>isSUSY</code> to check presence of extra couplings.Changed all 
pointers <code>CoupSM*</code> to <code>Couplings*</code> and removed 
explicit references to <code>CoupSUSY*</code>. The <code>coupSUSY</code>
object is only initialised if SUSY couplings are present. The new pointer 
<code>couplingsPtr</code> points either to only SM couplings or SM+SUSY 
couplings based on SLHA data.</li>

<li>New files <code>SusyResonanceWidths.h/cc</code> contains the 
<code>SusyResonanceWidths</code> class, which inherits from
<code>ResonanceWidths</code> but typecasts the <code>couplingsPtr</code> 
to <code>(CoupSUSY*) coupSUSYPtr</code>.  This is the base class for 
all SUSY resonances. It contains the <code>ResonanceSquark</code> class 
for all squark decays. A new flag <code>SLHA:useDecayTable</code> 
to check if internal widths should be overwritten by those read in 
via SLHA.</li>

<li>Added new functionality to <code>SusyLesHouches</code> for read-in 
of generic user blocks in the SLHA format, along with methods to 
extract parameters from them with typecasting controlled by the user. 
Intended for use with user-written semi-internal processes.</li>

<li>Added <code>Sigma1qq2antisquark</code> cross section.</li>

<li>Some new flags and modes in the <code>SUSY</code> and 
<code>SLHA</code> series offer further functionality.</li>

<li>Several further changes as a consequence of the upgrade of the SUSY
machinery.</li> 

<li>Bug/typo fixes in rotation matrices for SUSY couplings and for the
processes <code>qqbar2squarkantisquark</code>,
<code>qq2squarksquark</code> and more.</li>

<li>Improved handling of colour junctions. Added new example program 
<code>main72.cc</code>, to illustrate read-in of color junction 
structures via LHEF (<code>main72.lhe</code>). The example used is SUSY 
with RPV.</li>

<li>New Tune 4C introduced as <code>Tune:pp = 5</code>. The more crude
(non-)tunes 3C and 3M are removed.</li>

<li>New methods <code>Settings::getFlagMap(...)</code>,
<code>Settings::getModeMap(...)</code>, 
<code>Settings::getParmMap(...)</code> and
<code>Settings::getWordMap(...)</code> allows to return a map of all
settings of the respective type that contain a specific string 
in its name.
</li>

<li>Improved description of excited <i>g^*/KK-gluon^*</i> production
in the <code>Sigma1qqbar2KKgluonStar</code> and
<code>ResonanceKKgluon</code> classes.</li>

<li>Possibility added to let Hidden-Valley <i>gamma_v</i> have 
a nonero mass and decay by mixing with the ordinary photon. 
Still experimental.</li>

<li>Minor bug fix in handling of three-body phase space.</li>

<li>Minor correction in <code>Sigma2ffbar2TEVffbar</code> class.</li>

<li>Bug fix for decays of <i>W'</i> to a pair of heavy fermions when 
<i>gV != gA</i>. Thanks to M. Chizhov, see arXiv:0705.3944. </li>

<li>Restore the older EHLQ-based encoding of the <i>f fbar -> Z W</i> 
cross section, which was changed in version 8.140, since comparisons 
with Madgraph gives much better agreement with it than with the 
expression of Brown, Sahdev and Mikaelian.</li>

<li>The <code>HepMCInterface</code> now also stores colour flow 
information for coloured particles.</li>

<li>Pointer to <code>Couplings</code> made available for particle 
decays.</li>

<li>Minor update in <code>main61.cc</code> for more elegant usage 
of FastJet, as suggested by Gregory Soyez.</li>

</ul>
</li>

<li>8.150: 20 April 2011
<ul>

<li>Tune 4C is made default. It is based on first comparisons with
LHC data [<a href="Bibliography.html" target="page">Cor10a</a>], and has also been checked independently
[<a href="Bibliography.html" target="page">Buc11</a>] to give reasonable agreement with many distributions.
</li>

<li>The description of <i>tau</i> lepton decays has been significantly 
enhanced, to include helicity information related to the production 
process and hadronic currents fitted to data. A complete writeup is 
in preparation [<a href="Bibliography.html" target="page">Ilt11</a>]. A new flag is introduced to revert
to the old behaviour, for cross-checks, see 
<a href="ParticleDecays.html" target="page">Particle Decays</a>.
The new tau decay machinery is on by default.
</li>

<li>A new option <code>MultipartonInteractions:bProfile = 4</code> has 
been introduced for the impact-parameter profile of protons in the 
<a href="MultipartonInteractions.html" target="page">Multiparton Interactions</a> 
framework, wherein low-<i>x</i> partons are spread over a larger area 
than high-<i>x</i> ones, see [<a href="Bibliography.html" target="page">Cor11</a>]. A new method 
<code>Info::eMPI(i)</code> gives back the enhancement factor related to 
the <code>i</code>'th interaction. The impact-parameter profile can now 
be selected separately for <a href="Diffraction.html" target="page">diffraction</a>, 
but without a <code>bProfile = 4</code> option.
</li>

<li>The possibility of "hadronization" in the 
<a href="HiddenValleyProcesses.html" target="page">Hidden Valley</a> sector
has been added as a new option <code>HiddenValley:fragment = on</code>.
This is based on a copy of the standard string fragmentation framework, 
but with the option of a completely separate "flavour" sector, and 
separately tunable longitudinal fragmentation functions and transverse 
momenta. For now only a simple flavour scenario is provided, where
flavour-diagonal mesons can decay back into the normal visible sector
while off-diagonal ones remain hidden. A writeup of the model is in 
preparation [<a href="Bibliography.html" target="page">Car11</a>]. Also some further Hidden Valley options
have been added.</li> 

<li>Included possibility in <code>TimeShower</code> for QCD dipoles to
have an adjustible normalization factor, via the new
<code>bool isFlexible</code> and <code>double flexFactor</code>
properties of <code>class TimeDipoleEnd</code>. This flexibility is used
to treat radiation off colour topologies with epsilon tensors, in
particular colour junctions which have all their partons in the
final state. (An example is the BNV-SUSY decay ~chi0&rarr;uds.) For
such topologies, the new treatment in PYTHIA 8 is that a
half-strength dipole is spanned between all combinations of
final-state quarks. For junctions with an incoming (anti)colour line (such
as in the BNV-SUSY decay ~t*&rarr;cb), a full-strength dipole is
instead spanned between the two daughters, with no radiation from the
decaying object (in its CM). As will be described in a fortcoming
paper with N. Desai, this should give the
closest possible correspondence to the radiation patterns exhibited
by higher-order matrix elements for this type of process.</li>

<li>Corrected harmless bugs in <code>ProcessLevel::findJunctions</code>
which caused junctions of types 3 and 4 (i.e., junctions with 1
incoming color tag) to sometimes be incorrectly classified as types
1 and 2 (with all color tags outgoing), respectively.
Since the parity (even/odd) of the junction kind was still correct,
however, this did not cause any problems at the hadronization
stage.</li>

<li>The junction-finder in <code>ProcessLevel::findJunctions</code>
has been made more stable, and the following ordering of the color
tags returned by <code>Event::endColJunction(iJun, iLeg)</code>  is
now enforced: for junction kinds 3 and 4 (one tag
incoming), <code>iLeg = 0</code> will return the
incoming tag, while for kinds 5 and 6 (two tags incoming),
<code>iLeg = 0</code> and <code>iLeg = 1</code> will return the
incoming tags. Apart from this ordering, the color tags are
ordered in ascending color tag number.</li>

<li>Declarations of friend functions moved to sit outside the class
it befriends. Thanks to Axel Naumann for pointing out the incorrect
previous construction.</li>

<li>The <code>rootexample</code> subdirectory becomes 
<code>rootexamples</code> as the old example is split into two,
with improved documentation to clarify usage. Thanks to Axel Naumann
and Bernhard Meirose for the new code.</li>

<li>In the Les Houches Event File machinery, input type has been 
changed from <code>ifstream</code> to <code>istream</code> for more 
flexibility.</li>

<li>R-hadron  handling is largely implemented, see the
<a href="RHadrons.html" target="page">R-hadrons</a> page, although some aspects
still need polishing. A new class <code>RHadrons</code> takes 
care of the hadronization and decay. Particle data have been added
for R-hadrons containing a gluino, stop or sbottom, but could 
alternatively be used for other long-lived coloured particles. 
Thanks to Bernhard Meirose for support.
</li>

<li>Calculations of SUSY decay widths included by
  N. Desai, contained in the new source 
files <code>SusyResonanceWidth.cc</code>
  and </code>.h</code>. Validation and addition of more modes is still in
  progress, so this implementation should be considered preliminary
  for now. For a list of available modes, see
  the <a href="SUSYProcesses.html" target="page">SUSY Processes</a> page. 
</li>

<li>A first implementation of the SLHA-based QNUMBERS interface for
  defining new exotic particles has been
  included. See [<a href="Bibliography.html" target="page">Alw07</a>] and
  the <a href="SUSYLesHouchesAccord.html" target="page">SUSY Les Houches Accord</a>
  page. </li>

<li>Read-in of LHEF events containing Baryon Number Violating vertices
  has been included, using colour junctions, see
  the <a href="EventRecord.html" target="page">Event Record</a> page. The advanced
  shower model taking into account the full colour structure of such
  events, developed by N. Desai and described above, 
  is turned on by default in such events. 
  Several test cases were used to
  validate this implementation, but it is possible that problems could
  still exist for some cases. Feedback is welcome. Thanks to 
  the MadGraph authors for providing several test cases.</li>

<li>Some first steps taken to allow events containing colour sextets,
  e.g., from semi-internal processes or LHEF interfaces, and/or from
  SLHA <code>DECAY</code> tables. New
  <code>colType</code> codes 3 and -3 are introduced to describe
  sextets and antisextets, respectively. The state of the current
  implementation is that hard processes containing such states can be 
  read in and decays generated (via <code>DECAY</code> tables). Parton
  showers can be added, but the sextets themselves do not, as yet,
  shower, and any undecayed sextets remaining at the hadronization
  stage would lead to unpredictable problems if hadronization is
  switched on. Thanks to J. Alwall for help with testing 
  this implementation. 
</li>

<li>The functionality of the SLHA SUSY/BSM interface (see
  the <a href="SUSYLesHouches.html" target="page">SUSY Les Houches</a> page) has been
  extended so that copies of all <code>BLOCK</code>s are now stored 
  internally as
  strings, regardless of whether they correspond to "official" SLHA
  blocks or not. Their contents can subsequently be queried by a set
  of new templated member functions of the
  class <code>SusyLesHouches</code>. Available query functions so far
  include 
  <br/><code>template &lt;class T&gt; bool getEntry(string, T&);</code>, 
  <br/><code>template &lt;class T&gt; bool getEntry(string, int, T&);</code>, 
  <br/><code>template &lt;class T&gt; bool getEntry(string, int, int, T&);
  </code>, and 
  <br/><code>template &lt;class T&gt; bool getEntry(string, int, 
  int, int, T&);</code>, 
  <br/>where the type of
  the argument used in the call determines how to read the block
  entries. Thus, if an LHEF, SLHA, or other card file is read in by
  PYTHIA, the contents of any <code>BLOCK</code> in that file can
  subsequently be queried run-time using these functions. This is
  used, e.g., in the new interface between MADGRAPH 5 and PYTHIA
  8. Thanks to the MADGRAPH team, and to J. Alwall in particular, for
  help and debug on this new implementation.
</li>

</ul>
</li>

<li>8.153: 10 August 2011
<ul>

<li>The setup of tunes has been modified, see the 
<a href="Tunes.html" target="page">Tunes</a> page for details. Specifically
the <code>Tune:ee</code> and <code>Tune:pp</code> modes have
acquired a new option <code>-1</code> for a forced restore to the
default values of all settings used in the respective kind of 
tunes.</li>

<li>The code for handling multiparton interactions in the scenario with
an <i>x</i>-dependent width of the Gaussian matter profile 
[<a href="Bibliography.html" target="page">Cor11</a>], has been improved and updated. Tune 4Cx, which 
is based on this option, has been added as a further tune option.</li>

<li>A possibility to bias the phase-space selection has been added,
whereby some phase space regions can be oversampled, which is
compensated by assigning a weight to each event.
A new set of methods have been added to the <code>UserHooks</code>
class to allow users to program how to bias the selection.</li>

<li>New options added so that matrix-element corrections can be 
switched off after the first branching in ISR or FSR.</li>

<li>Some new <code>Info</code> methods have been added to store
information on latest ISR branching.  The <code>SpaceShower</code>
class has also been corrected so that the latest <i>z = 1/2</i>
when not defined by history. This avoids undefined values for
azimuthal asymmetries. Thanks to Stefan Prestel for finding and
sorting out this problem.</li>

<li>The <code>Pythia::forceHadronLevel()</code> method now takes 
an argument that optionally means that existing junction information
is not overwritten. Thanks to Leif L&ouml;nnblad for pointing out
the usefulness of this.</li>

<li>For particle decays to a varying number of hadrons the multiplicity
increase with mass has been somewhat reduced, and especially for 
<code>meMode = 23</code> a separate even slower increase has been 
introduced.</li>

<li>New possibility to force the tau polarization.</li>

<li>Bug fix for the special case in which events containing SUSY 
particles are generated without proper initialization of SUSY decays. 
This can happen, e.g., if events containing SUSY particles are read 
in via external LHEF files, if those files do not contain readable 
SLHA spectra in their headers. In this case, a failed attempt to 
generate sparticle decays with ill-defined couplings previously 
led to crashes. The program now reverts to the old behaviour, 
based on static decay tables, in such cases, with the default 
being to decay all sparticles to gravitino + particle. An error 
message stating that the full SUSY treatment has been switched 
off and why is also issued. Thanks to N. Desai for this fix.</li>

<li>The R-hadron machinery has been completed.</li>

<li>Minor change in timelike showers: gluons which fall below the 
<i>pTmin</i> cutoff by the correction for mass effects are now
eliminated, while previously they were kept. This reduces the
number of gluons somewhat, but has no significant effects on the
hadronic final state. (Prompted by R-hadron studies, where big mass
effects else give bothersome low-energy gluons.)</li>

<li>Corrected typos in two of the Upsilon wave function matrix 
elements, <code>Bottomonium:OUpsilon3P08</code> and 
<code>Bottomonium:Ochib03P01</code>. Thanks to Beate Heinemann for
pointing it out.</li>

<li>Implemented <i>f*</i> decay angle in <i>f f -> f f*</i> processes,
and fixed some bugs for the same process. Thanks to Piyali Banerjee
for tests.</li>

<li>Introduce possibility to separate production channels for 
TeV-sized extra dimensions, and a small code correction. Thanks to 
Noam Hod for code contribution.</li>

<li>Bug fix for neutrino beams: since neutrinos are always lefthanded
there should be a factor 2 in the cross section, relative to charged
leptons, from the non-need to average over incoming spin states. This 
is now fixed by introducing a new PDF class <code>NeutrinoPoint</code> 
for (unresolved) neutrinos, with normalization 2 rather than 1 for 
charged leptons. Thanks to Ryosuke Sato.</li>

<li>Bug fix for some (rarely used) particle settings, which could not 
be changed by users because they were read too early. Thanks to
Andrew Altheimer and Gustaaf Brooijmans.</li>

<li>Bug fix in handling of <code>tau</code> decays, where setting of
decay vertices could write outside memory. Thanks to Steven Schramm.</li>

<li>Minor expansion of the <code>BeamParticle</code> constructor.</li>

<li>Minor bug fix in CTEQ 6L for uninitialized variables.</li>

<li>Minor bug fix in fragmentation flavour combination to hadron.</li>

<li>Some updates of the documentation, including new pages on 
MadGraph 5 as a generator for semi-internal processes (thanks to 
Johan Alwall) and on RIVET interfacing.</li> 
 
<li>Minor improvements of ROOT- and HepMC-related code and documentation.</li>

<li>Some cleanup of code.</li>

</ul>
</li>

<li>8.157: 10 November 2011
<ul>

<ii>StefanPrestel joins as new member of the PYTHIA author team.
He is mainly working on matching/merging issues, and has contributed
the CKKW-L machinery mentioned below.</li>

<li>Merging capabilities according to the CKKW-L scheme [<a href="Bibliography.html" target="page">Lon11</a>]
have been added, see the new 
<a href="MatrixElementMerging.html" target="page">Matrix Element Merging</a>
page. It involves new classes to reconstruct and select how a 
matrix-element-generated partonic configuration could have been obtained 
by the PYTHIA evolution, and to perform trial showers (using a new
copy of the normal parton-level machinery) that introduce the appropriate
Sudakov suppression factors. New examples to illustrate various 
common tasks are found in <code>main81.cc</code>, <code>main82.cc</code>,
<code>main83.cc</code> and <code>main84.cc</code>.</li>  

<li>The <code>main71.cc</code> program is now generalised for reading 
in arbitrary POWHEG LHE files, to implement a smooth matching between NLO 
matrix elements and the PYTHIA parton showers. Cuts are made on both 
ISR and FSR emissions, while previously only ISR was covered. The key 
assumptions are the <i>pT</i> definitions used for ISR and FSR, but several 
further options are available, as documented in the <code>main71.cmnd</code> 
file. Work is still ongoing to pick the best default options. </li>

<li>Several expansions of the <code>UserHooks</code> class.
For both <code>doVetoFSREmission</code> and <code>doVetoISREmission</code>
a new argument <code>iSys</code> labels the system within which the 
radiation occurs. For <code>doVetoFSREmission</code> a further argument
<code>inResonance</code> distinguishes FSR in resonance 
decays from that in the hard process itself. New methods 
<code>canVetoMPIEmission</code> and <code>doVetoMPIEmission</code>
have been added to veto multiparton interactions in the same way as
FSR and ISR. In <code>biasSelectionBy</code> at times incorrect values
for <code>inEvent</code> has been corrected. Also some systematization 
of the use of <code>const</code>.</li>  

<li>A new model for hadron scattering is introduced, still at an early
stage and therefore more intended for internal development than for the
normal user. The basic idea is that a high-energy <i>pp</i> collision
involves the fragmentation of multiparton strings that overlap in space
(and time). Also the produced hadrons therefore initially overlap, and 
there is a strong likelihood that hadrons can scatter against each other 
until the system has expanded sufficiently. This can e.g. increase the 
transverse momentum of heavier hadrons at the expense of lighter ones.
</li>

<li>A new jet finder <code>SlowJet</code> offers simple access to the 
inclusive <i>kT</i>, anti-<i>kT</i>, and Cambridge/Aachen
algorithms in a cylindrical coordinate frame. The jet reconstruction 
is then based on sequential recombination with progressive removal, 
using the <i>E</i> recombination scheme. The minimalistic 
<code>SlowJet</code> code is much slower than <code>FastJet</code> 
[<a href="Bibliography.html" target="page">Cac06</a>], and contains less options, but reconstructs the same
jets if run under identical conditions. For details see the 
<a href="EventAnalysis.html" target="page">Event Analysis</a> page.</li>

<li>Starting in gcc 4.6, it is possible to switch off specific warnings 
around specific blocks of code. Although version 4.6 is some way off 
from being commonly found, this option has now been introduced to switch 
off <code>-Wshadow</code> warnings in <code>HepMCInterface.cc</code>. 
For other compilers, or earlier versions of gcc, the old behaviour 
is retained.</li> 

<li>Support for reading in gzipped LHEFs has been added in the 
<code>LesHouches</code> and <code>SusyLesHouches</code> classes.
This also affects <code>configure</code> and <code>Makefile</code>s.
Unless explicitly enabled, it should not affect anything.
If enabled, it relies on the Boost and zlib libraries to function,
so paths to these must be set appropriately, see the 
<code>README</code> file for details. The Boost header files can 
give very many shadow warnings, so <code>-Wshadow</code> is disabled 
if gzip support is enabled, as described above.</li> 

<li>Introduce use of the <code>HEPMC_HAS_UNITS</code> environment 
variable in the <code>HepMCInterface.cc</code> and <code>main32.cc</code> 
codes to automatically check whether GeV and mm can be set as relevant 
units. If yes, then it is set in <code>main32.cc</code>. If no, 
a conversion from GeV to MeV is done explicitly in 
<code>HepMCInterface.cc</code>. Note that, for early HepMC versions,
this means a change of behaviour. Thanks to Andy Buckley.</li>

<li>A new method <code>Info::lhaStrategy()</code> returns the 
Les Houches event weighting strategy where relevant, and 0 where not.
For the strategies <i>+-4</i> the event weight and sum,
<code>Info::weight()</code> and <code>Info::weightSum()</code>,
is now in units of pb at output, as it should be at input.
(While internally mb is used.)</li>

<li>New flag <code>Check:abortIfVeto</code> allows the user to 
resume control over execution in case of a veto in the event
generation process.</li>

<li>New method <code>Event::at(i)</code> returns reference to 
<code>i</code>'th particle in the event record.</li>

<li>Introduce the Fermi constant as one of the Standard Model 
parameters.</li>

<li>Included automatic pre-initialization of SLHA blocks MASS and
SMINPUTS using PYTHIA's SM parameters and particle data table
values.</li>

<li>SUSY: added sleptons (and sneutrinos) as resonances.
Corrected 2-body decay widths of gluinos, squarks and gauginos. 
Added sleptonic decay modes to gaugino decays. 
Implemented 2-body decays of sleptons (and sneutrinos)
into sleptons/leptons/gauginos. Corrected slepton couplings (they
now look exactly like squark couplings, using a 6x6 slepton mixing
matrix).</li>

<li>New parameter <code>Diffraction:probMaxPert</code> introduce to
give more flexibility in transition from a nonperturbative to a
perturbative description of a diffractive system.</li>

<li>Bug corrected in <code>SigmaEW.cc</code>, for the process 
<code>WeakSingleBoson:ffbar2ffbar(s:gm)</code>. Previously, all outgoing 
quark flavours in this process were erroneously assigned ID code 5 
(b quarks). This has now been corrected so the proper ratios are 
obtained, with <i>u : c : d : s : b = 4 : 4 : 1 : 1 : 1</i>, 
according to the squared quark charges.</li>
  
<li>Changes in <code>FragmentationSystems</code> and 
<code>StringFragmentation</code> to reject systems with three or more 
interconnected junctions. This may happen in baryon-number-violating 
scenarios in pp collisions, if both of the beam baryon junctions are 
resolved and get connected via an antijunction created by a 
hard-process BNV vertex. In principle, this could be addressed by an 
extension of the existing junction fragmentation framework. However, 
since it happens rarely, for the time being an error message is printed 
and the fragmentation restarted.
</li>

<li>Change in <code>Event::copy</code> to safeguard against attempting 
to copy out-of-range entries. An attempt to copy a non-existing entry 
will now return -1.</li>

<li>Bug fix in the machinery for the user to force the setting of 
tau polarization.</li>

<li>Bug fix in the initial search for a maximum of the process 
cross section (only affecting rare cases).</li>

<li>Corrected angular decay distributions for two compositeness 
processes, <code>Sigma2qq2qStarq</code> and 
<code>Sigma2qqbar2lStarlbar</code>.</li>  
   
<li>Extra check in <code>HiddenValleyFragmentation</code> to make sure 
that pointers which have not been assigned with <code>new</code> are not 
deleted.</li>

<li>Some further minor changes.</li>

</ul>
</li>

<li>8.160: 23 January 2012
<ul>

<li>The older term "multiple interactions" has been replaced by the
new standard "multiparton interactions" one, and correspondingly the
abbreviation MI by MPI. This affects everything: settings, class and
method names, documentation, etc. It therefore becomes necessary to
rewrite user code. However, so as to keep the immediate effort at a 
reasonable level, the old settings names are kept as aliases. Thus
<code>PartonLevel:MI</code> and <code>PartonLevel:MPI</code> are 
equivalent, and similarly <code>MultipleInteractions:pT0Ref</code> 
and <code>MultipartonInteractions:pT0Ref</code>. Should you be using 
methods such as <code>double Info::pTMI(int i)</code> you need to 
edit the code, however. All the <code>example/main*</code> files
have been uopdated accordingly.</li>

<li>A new option <code>Beams:frameType = 5</code> has been added 
for the case where an external generator should provide LHA process
information. The new <code>Pythia::setLHAupPtr(...)</code> method
should then be used to link in this generator. The new switch 
<code>Beams:newLHEFsameInit</code> can be used to tell that a new
LHEF should be used, but without the need for a new initialization.
With these two changes, all the different ways of initializing 
can be covered by the <code>Pythia::init()</code> call with no 
arguments. The various <code>init(...)</code>options with arguments 
are deprecated and will be removed for PYTHIA 8.2.</li>

<li> The <code>Pythia::stat()</code> method, with no arguments, 
replaces <code>Pythia::statistics(...)</code>, although the latter 
remains as a deprecated alternative.</li>

<li>New settings <code>Init:...</code>, <code>Next:...</code>,
and <code>Stat:...</code> can be used to steer some details of 
the operation of the <code>Pythia::init()</code>,  
<code>Pythia::next()</code> and  <code>Pythia::stat()</code>,
respectively. In particular it affects the amount of printout 
at the various stages of operation. See 
<a href="MainProgramSettings.html" target="page">here</a> for further details.
This change involves several code changes, but in documentation 
rather than physics. Most of the <code>Main:...</code> settings 
are deprecated as a consequence.</li>

<li>The sample main programs in the <code>examples</code> subdirectory 
have been updated. This includes a change to the new favoured 
methods and settings outlined above, plus some update of the 
physics contents. Some of the examples have been combined,
some others have been added (e.g. for R-hadroms), and as a consequence
some renumbering has been made. See the modified list of
<a href="SampleMainPrograms.html" target="page">sample main programs</a> for 
the new status. In particular note that (the new) <code>main61.cc</code>
allows streamlined input and output in HepMC, like <code>main42.cc</code>
(previously <code>main32.cc</code>), but additionally links to LHAPDF. </li>

<li>The <code>examples/configure</code> script has new optional argument
<code>--with-pythia8</code>. It can be used to set the new
<code>PYTHIA8LOCATION</code> environment variable, which then is used 
in <code>examples/Makefile</code> to give the path to the PYTHIA 
library. Thereby it becomes possible to relocate (parts of) the 
<code>examples</code> directory and still obtain the correct path.
Thanks to Mikhail Kirsanov.</li>

<li>Polarization information has been included as a new 
<code>Particle</code> property, that can be set by 
<code>void pol(double polIn)</code> and obtained by 
<code>double pol()</code>. Default value is <code>9.</code>,
in agreement with the Les Houches standard. Event listings have
been expanded to optionally display this information. Currently 
polarization is not used internally.</li>

<li>The matrix element merging machinery has been modified as follows.
<br/>- Improved handling of the hard process, so that MadGraph5-produced 
LHE files do not produce problems (sometimes, the choices of MG4 on what 
to put into a LHEF have changed in MG5).
<br/>- Improved handling of colour for easier handling of states with 
many quarks (the code has been tested for states with up to 5 
<i>q qbar</i> pairs and some gluons).
<br/>- Improved checking which clusterings are allowed. Now, clusterings 
should immediately be rejected if they lead to unphysical states, 
without the need to explicitly construct these states. This was needed 
to get <i>t tbar</i> production, VBF and some simple SUSY processes 
running with reasonable generality.
<br/>- Improved handling of incomplete histories. Now there is an 
additional switch allowing code to try to swap some colours when fewer 
clusterings than requested have been found.
</li>

<li>Updates in the handling of graviton resonances in scenarios with
extra dimensions.
<br/>- Now all G decays have correct angular distribution, which was not 
the case before for W/Z decays.
<br/>- Added the possibility for G to only couple to longitudinal 
W/Z bosons, which affects both the width and angular distributions.
<br/>- Added decays to Higgs pairs, <i>G -> hh</i>.
</li>

<li>Bug fix in the <code>findJunctions()</code> function in
<code>ProcessLevel.cc</code>. Changes introduced in version
8.145 (to allow for junctions in baryon-number-violating
processes) did not correctly handle the remapping of color
tags that can be applied when adding beam remnants to events with 
multiparton interactions. A simpler and more stable algorithm is 
now applied for the simplest cases, with the more complex one only 
invoked for cases such as BNV, which are normally considered before 
remnants are added, hence avoiding this particular problem. Also some
other changes in the handling of junction, including a safeguard to
reject systems with three or more interconnected junctions.</li>

<li>Bug fix and updates to the SLHA interface. Possibility of infinite 
loop during <code>ProcessLevel::initSLHA</code> corrected. Modifications
to <code>SusyLesHouches</code> to allow interpretation of SLHA1 spectra 
with R-parity violation. Rather than reject spectra that do not conform 
fully to the SLHA2 standard for RPV, the interface will now first look 
for SLHA1 mixing matrices and attempt to translate those into SLHA2 ones
if possible. In this case, warnings that the expected SLHA2 blocks were 
not found will be printed. It is up to the user to check that the 
derived SLHA2 information is correct. Corresponding additions to 
<code>SusyCouplings.cc</code> to extract mixing-matrix information 
from the relevant SLHA2 RPV blocks when RPV is switched on.</li>

<li>Updated SLHA example <code>main24.cmnd</code> to use new example
spectrum, <code>cmssm.spc</code>, corresponding to CMSSM point
10.1.1, obtained with SOFTSUSY 3.3.0. Thanks to B. Allanach for
providing the new spectrum file.</li>

<li>A new <code>include/FastJet3.h</code> header file simplifies 
interfacing of FastJet to Pythia. For details see documentation in
the file itself. Thanks to Gavin Salam for this contribution.</li>

<li>The handling of diffraction has been made more flexible. 
Specifically the "total" Pomeron-proton cross section can now be made
to depend on the mass of the diffractive system. This does not affect 
the diffractive cross section in pp collisions, which is set separately,
but is used in the MPI machinery to affect the average number of
interactions per Pomeron-proton collision. Furthermore, the allowed
range for some parameters has been expanded. Thanks to Robert 
Ciesielski.</li> 

<li>New method <code>Pythia::forceTimeShower(...)</code> can be used to
generate a single final-state cascade from a set of partons, without
any knowledge of prior history. This is mainly intended for toy studies.
The meaning of the <code>ProcessLevel:all</code> switch has been modified
so that this parton-level function is available, but not any others
at this level.
</li>

<li>ATLAS tune A2 now included. Thanks to Deepak Kar for 
providing it.</li>

<li>Change in the handling of recoils of timelike showers in resonance
decays, in cases of coloured resonances such as <i>t -> b W</i>. In 
the first step the <i>W</i> always acts as recoiler to the <i>b</i>, 
but in subsequent step previously the <i>W</i> remained as recoiler to 
one dipole, while now all QCD-radiating partons recoil against another 
coloured parton. The old behaviour could give a (small) unphysical spike 
of radition collinear with the colourless recoiler in the subsequent 
emissions (while the pattern of the first was and remains correct). 
The old behaviour can be recovered for checks, see
<code>TimeShower:recoilToColoured</code>.
Thanks to Yevgeny Kats for pointing out this issue (previously noted 
for Pythia 6 by several persons). 
</li>

<li>Bug fixes for <code>rootexamples/Makefile</code> and restoration
of some deleted information in <code>rootexamples/README</code>.
Thanks to Axel Naumann and Bernhard Meirose.</li>

<li>Bug fix, so that displaced vertices are possible in resonance
decay chains. Thanks to Daniel Blackburn and Andy Buckley for
pointing this out.</li>

<li>Bug fix for <code>Info</code> counter 2.</li>

<li>Bug fix so that sextet quarks now are read in correctly from
Les Houches Event files; previously the (anti)colours were set 
to 0.</li>

<li>Year updated to 2012 in copyright statements etc.</li>

<li>Reformatting to reduce the number of code lines with more 
than 79 characters.</li>

<li><code>Pythia::initSLHA()</code> moved from <code>public</code>
to <code>private</code>. 
</li>

<li>Remove warning message when tau polarization is set by hand.</li>

<li>Several minor changes to reduce the number of warnings issued
by the clang compiler. The origin of some warnings remains unclear
so those remain to track down (could also be compiler bugs; note that
we discuss warnings, not errors). Thanks to Randy MacLeod for bringing
this up.</li>

<li>The worksheet has been updated to be in step with Pythia 8.160.</li>

<li>Several other minor corrections in the code and documentation.</li>

</ul>
</li>

<li>8.162: 12 March 2012
<ul>

<li>A new option allows for several partons to share the recoil in
final-state radiation, see<a href="TimelikeShowers.html" target="page">Timelike
Showers</a>. It is mainly intended to be used in the context of
matching to matrix elements, and so only to be used in the first
few branchings.</li>

<li>Several new processes for LED dijet production, see
<a href="ExtraDimensionalProcesses.html" target="page">Extra Dimensions</a>.</li>

<li>Small update of the <code>Sigma2ffbar2LEDllbar</code> and 
<code>Sigma2ffbar2LEDgammagamma</code> LED processes.</li>

<li>New <code>Sigma2QCffbar2llbar</code> 
<a href="CompositenessProcesses.html" target="page">contact interaction</a> 
process.</li>

<li>Inclusion of a new method in the 
<a href="MatrixElementMerging.html" target="page">matrix-element merging</a> 
framework to influence the construction of histories, e.g. to already 
in the construction of histories disallow paths that fail the 
<i>2 -> 2</i> cuts.</li>

<li>Further minor updates of the matrix-element merging code,
mainly for improved clarity.</li>

<li>Minor bug fix in the handling of beam and event information fed
in from an <code>LHAup</code> instance.</li>

<li>Minor bug fix for potential crashes from uninitialized variables 
for the merging machinery when merging is not used.</li>

<li>Updated History class for matrix element merging, 
also avoiding some compiler warnings.</li>

<li>Bug fixes in the handling of correlated mass choices in resonance
decays, such as <i>H -> Z^*0 Z^*0</i>.</li>

<li>Bug fix when the process-level execution is switched off,
where <code>Info::isResolved()</code> could be called before its 
value was initialized. Thanks to Christian Pulvermacher 
for finding this.</li>

<li>Corrected matrix-element expression for mass selection in
<i>A^0 -> Z^*0 Z^*0</i> and <i>A^0 -> W^*+ W^*-</i>.</li>

<li>SM Higgs mass updated to 125 GeV and default width and branching 
ratios modified accordingly. Minor technical improvements of width
calculation.</li>

<li>The usage of nested classes has been removed from 
<code>SusyLesHouches</code>, since it could give compilation errors 
on some platforms. The new class names begin with <code>LH</code>
and all classes have been put inside the <code>Pythia8</code> 
namespace.</li>

<li>Minor Makefile updates. Thanks to Mikhail Kirsanov.</li>

<li>Minor changes to avoid some clang compiler warnings on the 
Mac OS X platform.</li>

</ul>
</li>

<li>8.163: 27 March 2012
<ul>

<li>New methods in the 
<a href="EventInformation.html" target="page"><code>Info</code></a> class, 
<code>id1pdf()</code>, <code>id2pdf()</code>, <code>x1pdf()</code> 
and <code>x2pdf()</code>, to denote the partons for which parton 
distribution values have been defined. Previously this was assumed 
to agree with the incoming partons to the hard process, the same 
methods without the <code>pdf</code> qualifier. However, now the 
POWHEG approach offers a counterexample. Also the reading and 
handling of Les Houches (and other) events, and the interface 
to HepMC, has been modified accordingly. 
</li>

<li>The decay of Higgs and top resonances read in from Les Houches 
Event files is now performed with angular correlations as for 
internal processes. LHE files should normally contain all process-specific
resonance decay chains and, if not, decays are made isotropic. 
The <i>H -> WW/ZZ -> f fbar f' fbar'</i> and 
<i>t -> b W -> b f fbar</i> correlations are process-independent,
however, and thus can be handled internally. If part of the decay
chain has already been set, e.g. <i>H -> WW/Z></i> or <i>t -> b W</i>,
then the subsequent decays are still isotropic.</li>

<li>Updated instructions how to link to HepMC, 
in <code>README.HepMC</code>.</li>

<li>Bug fix in the turn-on of resolved diffraction for low
CM energies. Thanks to Erwin Visser.</li>

<li>Bug fix in the handling of string junctions at very high energies,
caused by numerical errors. Thanks to Erwin Visser.</li>

<li>Some other small changes, mainly aesthetics.</li>

</ul>
</li>

<li>8.165: 8 May 2012
<ul>

<li>The MBR (Minimum Bias Rockefeller) model for single, double and 
central diffraction [<a href="Bibliography.html" target="page">Cie12</a>] is included as new option 
<a href="Diffraction.html" target="page"><code>Diffraction:PomFlux = 5</code></a>. 
It is specifically intended for <i>p p</i> and <i>pbar p</i>
interactions, and is currently the only option that also supports 
central diffraction. Thus the basic machinery for Central Diffraction 
(a.k.a. Double Pomeron Exchange) has now been implemented. 
See <code>examples/main04.cc</code> for an example.
Thanks to Robert Ciesielski for contributing the new code.
</li>

<li>For a <i>tau</i> lepton in an external process, by default the 
SPINUP number in the Les Houches Accord now is interpreted as giving 
the <i>tau</i> helicity, and is used for its decay.</li> 

<li>A <i>tau</i> coming from a <i>W</i> now defaults to being purely
lefthanded when neither of the existing matrix elements apply.</li>

<li>Decay mode <i>t -> H+ b</i> included as an option.</li>

<li>Four ATLAS tunes have been implemented as options for 
<code>Tune:pp</code>: A2-minbias-mstw2008lo, AU2-cteq6l1, AU2-mstw2008lo,
and AU2-ct10. The new flag <code>Tune:preferLHAPDF</code> can be used
to switch between the LHAPDF and the internal implementation of a 
PDF set, in cases where both are available.</li>

<li>Reorder libraries in <code>examples/Makefile</code>, specifically
move <code>LIBGZIP</code> so that it is properly linked when used.
Thanks to Erik Schnetter.</li>

<li>Minor modification so that LHAPDF can be used for PDFs in the hard 
process, with one of the built-in PDFs for the rest, even if LHAPDF is 
compiled so as to handle only one concurrent PDF set.</Li>

<li>Bug fix, that <code>ParticleDecays:mixB = off</code> did not 
switch off <i>B0 - B0bar</i> and <i>Bs0 - Bs0bar</i> mixing.
Thanks to James Catmore.</li>

<li>Bug fix for the handling of gluon polarization of initial-state
radiation, where an anisotropic azimuthal distribution was inadvertently
generated in some <i>2 -> 1</i> processes. The update also includes
always setting the second daughter zero for the two partons coming in to 
a hard <i>2 -> 1</i> process. Thanks to Antonio Policicchio.</li>

<li>Bug fix, that the setting of the number of user hooks MPI steps did 
not use <code>UserHooks::canVetoMPIStep()</code> properly.</li>

<li>Some other small changes, mainly documentation and aesthetics.</li>

</ul>
</li>
</ul>

</body>
</html>

<!-- Copyright (C) 2012 Torbjorn Sjostrand -->