<chapter name="Tunes"> 
 
<h2>Tunes</h2> 
 
Since some physics aspects cannot be derived from first principles, 
this program contains many parameters that represent a true 
uncertainty in our understanding of nature. Particularly afflicted 
are the areas of hadronization and multiparton interactions, which both 
involve nonperturbative QCD physics. 
 
<p/> 
Technically, PYTHIA  parameters can be varied independently of each 
other, but the physical requirement of a sensible description of a set 
of data leads to correlations and anticorrelations between the 
parameters. Hence the need to produce tunes, not of one parameter at 
a time, but simultaneously for a group of them. A well-known (separate) 
such example is parton densities, where combined tunes to a wide range 
of data have been produced, that can then be obtained prepackaged. 
 
<p/> 
Given the many PYTHIA parameters to be tuned, it is convenient to 
divide the task into subtasks. Firstly, if we assume jet universality, 
hadronization and final-state parton showers should be tuned to 
<ei>e^+e^-</ei> annihilation data, notably from LEP1, since this 
offers the cleanest environment. Secondly, with such parameters fixed, 
hadron collider data should be studied to pin down multiparton interactions 
and other further aspects, such as initial-state radiation. Ideally this 
would be done separately for diffractive and non-diffractive events, 
although it is not possible to have a clean separation. (Thirdly 
would come anything else, such as physics with photon beams, which 
involve further parameters, but that is beyond the current scope.) 
 
<p/> 
The first step was taken, with a tune to LEP1 data by Hendrik Hoeth, 
using the Rivet + Professor framework. Starting with version 8.125 it 
defined the default values for hadronization parameters and timelike 
showers. 
 
<p/> 
The situation is more complicated for hadronic interactions in general 
and multiparton interactions in particular, where PYTHIA 8 is more 
different from PYTHIA 6, and therefore more work is needed. Specifically, 
it is <i>not</i> possible to "port" a PYTHIA 6 tune to PYTHIA 8. 
 
<p/> 
A first simple tune, appropriately called "Tune 1", became default 
starting with version 8.127. It was noted, in particular by Hendrik 
Hoeth, that this tune had a tension between parameters needed to 
describe minimum-bias and underlying-event activity. Therefore some 
further physics features were introduced in the code itself 
<ref>Cor10a</ref>, which were made default as of 8.140. This version 
also included two new tunes, 2C and 2M, based on the CTEQ 6L1 and the 
MRST LO** PDF sets, respectively. These have been made by hand, as a 
prequel to complete Professor-style tunings. 
 
<p/> 
The very first data to come out of the LHC showed a higher rapidity 
plateau than predicted for current PYTHIA 6 tunes, also for the lower 
energies. This may suggest some tension in the data. Two alternatives, 
3C and 3M, were produced by a few brute-force changes of 2C and 2M. 
These were introduced in 8.140, but discontinued in 8.145 in favour of 
the newer 4C tune, that is based on a more serious study of some early 
LHC data, see <ref>Cor10a</ref>. Following the comparative studies in 
<ref>Buc11</ref>, which independently confirmed a reasonable agreement 
with LHC data, tune 4C was made the default from 8.150. A variant is 
tune 4Cx, where the Gaussian matter profile has an <ei>x</ei>-dependent 
width <ref>Cor11</ref>. 
 
<p/> 
Tune 4C was the basis for many subsequent LHC tunes. Several ATLAS tunes 
have been included here, obtained with different PDFs and with different 
emphasis on minimum-bias and underlying-event data <ref>ATL12</ref>. 
These typically require LHAPDF to be linked, but this can be avoided 
in cases where the same PDF set is implemented internally. Also two CMS 
underlying-event tunes are implemented <ref>CMS14</ref>. The ATLAS AZ tune 
<ref>ATL14</ref> instead puts emphasis on the <ei>pT</ei> spectrum of 
the <ei>Z^/gamma^*0</ei> boson. 
 
<p/> 
The Monash 2013 tune <ref>Ska14</ref> is based on a larger set of LHC 
distributions. It starts out from a more careful comparison with and 
tuning to LEP data, and so involves several parameter changes. The PDF 
used is the NNPDF2.3 QCD+QED LO one with <ei>alpha_s(M_Z) = 0.130</ei>, 
which includes more recent data than used in the previous default, and 
opens up for processes with incoming photons to the hard process. 
It is the default starting from 8.200. 
 
<p/> 
Recent tunes by the LHC collaborations are based on the Monash 2013 one. 
This includes the CMS tune MonashStar, or formally CUETP8M1-NNPDF2.3LO 
(currently unpublished). More significantly, ATLAS has produced and 
published a whole family for underlying-event tunes based on a major 
effort, including simultaneous fits of ten parameters <ref>ATL14a</ref>. 
This includes four central tunes, with four different PDF sets, and 
ten variations around the NNPDF2.3 QCD+QED LO central tune, grouped in 
five pairs of variations up and down. The publication <ref>ATL14a</ref> 
should be consulted for further details, like with what additional 
settings various processes have been generated, which should be respected 
to reap full benefit of the tunes. 
 
<p/> 
Central diffraction is a recent addition to the "soft QCD" process palette, 
and is thus not yet included in tunes; indeed its cross section is actively 
zeroed. You can switch it back on <i>after</i> you have selected your tune, 
with <code>SigmaTotal:zeroAXB = off</code>. But note that, since the 
total cross section is assumed unchanged, the nondiffractive cross section 
is reduced and thus also the MPI machinery affected, even if effects 
should not be big (for a small central diffractive cross section). 
 
<p/> 
Note that comparisons with data also require that other aspects agree, 
such as that decay chains are stopped at an agreed-on level. For instance, 
in the ATLAS tunes all particles with a lifetime above 10 mm 
are considered stable, <code>ParticleDecays:limitTau0 = on</code>, 
<code>ParticleDecays:tau0Max = 10</code>. We have chosen not to 
include this as part of the tune settings itself, since the tune as 
such could still be used with any other choice of stable and 
unstable particles. 
 
<p/> 
Further comparisons have been posted on the 
<a href="http://mcplots.cern.ch/">MCPLOTS</a> pages. 
They have been produced with help of the 
<a href="https://rivet.hepforge.org/">Rivet</a> package 
<ref>Buc10</ref>. 
 
<p/> 
To simplify comparisons for the user, we propose to collect some of 
the tunes here, in a prepackaged form. Of course, in all cases it is 
a matter of setting values for parameters already defined elsewhere, 
so the tunes offer no new functionality, only a more convenient setup. 
 
<p/> 
You should be aware that the evolution of the program will not guarantee 
complete backwards compatibility between versions. Most obviously this 
concerns bug fixes. But also for some other major changes, like the 
introduction of the new diffractive machinery, the default behaviour 
of old tunes has been changed retroactively. (Which should be fine for 
diffraction, since previous tunes were not based on data strongly 
influenced by diffraction.) 
 
<p/> 
The setup of the tunes is special, in that the choice of a tune forces 
the change of several different flags, modes and parameters. Furthermore 
a design principle has been that it should be possible to start out 
from a tune and then change a few of its settings. This gives power 
and flexibility at the expense of requiring a more careful ordering 
of commands. We therefore here sketch the order in which operations 
are carried out. 
<ol> 
<li>The constructor of a <code>Pythia</code> instance will read in 
all settings, and initialize them with their default values. 
</li> 
<li>At the end of this operation, the <code>Tune:ee</code> and 
<code>Tune:pp</code> modes (see further below) are checked. If either 
of them are positive the methods <code>Settings::initTuneEE(...)</code> 
and <code>Settings::initTunePP(...)</code>, respectively, are called 
to overwrite the whole collection of settings in the relevant tune. 
Zero (or negative) means that nothing will be done. 
Since most <ei>pp/ppbar</ei> tunes have been made in the context 
of an <ei>e^+e^-</ei> one, <code>initTunePP(...)</code> usually 
calls <code>initTuneEE(...)</code> to provide this synchronization. 
</li> 
<li>After the <code>Pythia</code> constructor all the relevant values 
for the default tune(s) have thus been set up. 
</li> 
<li>You as a user can now start to overwrite the values at will, 
using <code>Pythia::readFile(...)</code> to read a configuration file, 
or a list of <code>Pythia::readString(...)</code> commands, 
or the lower-level <code>Settings</code> methods. All changes 
are made in the order in which the commands are encountered during 
the execution. A given variable can be changed multiple times, 
but it is the latest change that sets the current value. 
</li> 
<li>The two <code>Tune:ee</code> and <code>Tune:pp</code> modes can also 
be changed in exactly the same way as described for all other settings 
above. Unique for them, however, is that when one of them is encountered 
it also initiates a call to the <code>initTuneEE(...)</code> or 
<code>initTunePP(...)</code> method, respectively. In such cases all 
settings affected by the <ei>e^+e^-</ei> or <ei>pp/ppbar</ei> tune 
are first reset to the default values (the <code>-1</code> options) 
and thereafter the relevant tune is set up. 
Recall that <code>initTunePP(...)</code> in its turn is allowed to call 
<code>initTuneEE(...)</code>. 
</li> 
<li>It is possible to mix commands of type 4 and 5 in any order; it 
is always the last change that counts. That is, any changes you have 
made to variables of a tune <i>before</i> a <code>Tune:ee</code> or 
<code>Tune:pp</code> command are overwritten by it, while variables 
you set <i>after</i> will overwrite the tune values. Further, 
the <code>Tune:pp</code> command usually implies an <ei>e^+e^-</ei> 
tune as well. Therefore <code>Tune:ee</code> would rarely be used for 
LHC applications. As a rule, instead, you want to begin with the 
<code>Tune:pp</code> choice, and thereafter modify only a small part 
of its settings. 
</li> 
<li>Needless to say, the flexibility can lead to unwanted setups if 
you do not exercise some discipline. It is therefore recommended that 
you always check the listing obtained with 
<code>Pythia::settings.listChanged()</code> to confirm that the 
final set of changes is the intended one. 
</li> 
</ol> 
 
<modepick name="Tune:ee" default="7" min="-1" max="7"> 
Choice of tune to <ei>e^+e^-</ei> data, mainly for the hadronization 
and timelike-showering aspects of PYTHIA. In the following options the 
settings file used to load the tune is provided after the tune 
number. Every tune here can then be equivalently loaded with the 
command <code>include = tunes/settings.cmnd</code> where 
<code>settings.cmnd</code> is the corresponding settings file. In the 
future the <code>Tune:ee</code> setting will be removed in favor of 
the <code>include</code> syntax. 
<option value="-1">(<code>tunes/Reset-ee.cmnd</code>) reset all values 
that are affected by any of the <ei>e^+e^-</ei> tunes to the default 
values. 
</option> 
<option value="0">no values are overwritten during the initial setup, 
step 2 above. Note that changing to <code>0</code> in the user code 
has no effect; if you want to restore the individual settings you 
should instead use <code>-1</code>. 
</option> 
<option value="1">(<code>tunes/OldJETSET.cmnd</code>) the original 
PYTHIA 8 parameter set, based on some very old flavour studies (with 
JETSET around 1990) and a simple tune <ei>of alpha_strong</ei> to 
three-jet shapes to the new <ei>pT</ei>-ordered shower. These were the 
default values before version 8.125. 
</option> 
<option value="2">(<code>tunes/Montull2007.cmnd</code>) a tune by Marc 
Montull to the LEP 1 particle composition, as published in the RPP 
(August 2007). No related (re)tune to event shapes has been performed, 
however. 
</option> 
<option value="3">(<code>tunes/Hoeth2009.cmnd</code>) a tune to a wide 
selection of LEP1 data by Hendrik Hoeth within the Rivet + Professor 
framework, both to hadronization and timelike-shower parameters (June 
2009). These were the default values starting from version 8.125. 
</option> 
<option value="4">(<code>tunes/Skands2013.cmnd</code>) a tune to LEP 
data by Peter Skands, by hand, both to hadronization and 
timelike-shower parameters (September 2013).  Note the use of the CMW 
convention for the shower <ei>alpha_s</ei> scale. 
</option> 
<option value="5">(<code>tunes/Fischer2013-1.cmnd</code>) first tune to 
LEP data by Nadine Fischer (September 2013), based on the default 
flavour-composition parameters. Input is event shapes (ALEPH and 
DELPHI), identified particle spectra (ALEPH), multiplicities (PDG), 
and B hadron fragmentation functions (ALEPH). 
</option> 
<option value="6">(<code>tunes/Fischer2013-2.cmnd</code>) second tune 
to LEP data by Nadine Fischer (September 2013). Similar to the first 
one, but event shapes are weighted up significantly, and multiplicites 
not included. 
</option> 
<option value="7">(<code>tunes/Monash2013-ee.cmnd</code>) the Monash 
2013 tune by Peter Skands at al. <ref>Ska14</ref>, to both 
<ei>e^+e^-</ei> and <ei>pp/pbarp</ei> data. 
</option> 
</modepick> 
 
<modepick name="Tune:preferLHAPDF" default="0" min="0" max="3"> 
Tunes made by experimental collaborations typically use the LHAPDF 
package to obtain their PDF values, and so PYTHIA must be built 
accordingly. See the <aloc href="PDFSelection">PDF 
documentation</aloc> for more information. For PDFs implemented 
natively in PYTHIA it is possible to use the respective tunes, without 
having to use LHAPDF, if you set <code>Tune:preferLHAPDF = 
0</code>. Alternatively, setting <code>Tune:preferLHAPDF = 3</code> 
will use the internal PYTHIA interpolation of LHAPDF6 PDF grids, so 
while the LHAPDF6 library is not needed, the PDF grid is. 
<option value="0"> Use the internal PYTHIA PDFs. 
</option> 
<option value="1"> Use LHAPDF5 PDFs. 
</option> 
<option value="2"> Use LHAPDF6 PDFs. 
</option> 
<option value="3"> Use LHAPDF6 PDF grids with the internal PYTHIA 
interpolation rather than the LHAPDF6 library. 
</option> 
</modepick> 
 
<modepick name="Tune:pp" default="14" min="-1" max="33"> 
Choice of tune to <ei>pp/ppbar</ei> data, mainly for the 
initial-state-radiation, multiparton-interactions and beam-remnants 
aspects of PYTHIA. Note that all early tunes, including those done by 
the LHC collaborations based on tune 4C, use the <ei>e^+e^-</ei> tune 
<code>tunes/Hoeth2009.cmnd</code> (<code>Tune:ee = 3</code>), while the 
Monash 2013 tune and the further tunes based on it use 
<code>Monash2013-ee.cmnd</code> (<code>Tune:ee = 7</code>). All the 
tune configurations provided also load their corresponding 
<ei>e^+e^-</ei>. If this is not the wanted behaviour, then these 
<ei>e^+e^-</ei> settings must be changed after setting the 
<ei>pp/ppbar</ei> tune. In the following options the settings file 
used to load the tune is provided after the tune number. Every tune 
here can then be equivalently loaded with the command <code>include = 
tunes/settings.cmnd</code> where <code>settings.cmnd</code> is the 
corresponding settings file. In the future the <code>Tune:pp</code> 
setting will be removed in favor of the <code>include</code> syntax. 
<option value="-1">(<code>tunes/Reset-pp.cmnd</code>) reset all values 
that are affected by any of the <ei>pp/ppbar</ei> tunes to the default 
values. 
</option> 
<option value="0">no values are overwritten during the initial setup, 
step 2 above. Note that changing to <code>0</code> in the user code 
has no effect; if you want to restore the individual settings you 
should instead use <code>-1</code>. 
</option> 
<option value="1">(<code>tunes/OldIsrMpi.cmnd</code>) default used up 
to version 8.126, based on some early and primitive comparisons with 
data. 
</option> 
<option value="2">(<code>tunes/Skands2009.cmnd</code>) "Tune 1", 
default in 8.127 - 8.139, based on some data comparisons by Peter 
Skands. Largely but not wholly overlaps with the default option 0. 
</option> 
<option value="3">(<code>tunes/Tune2C.cmnd</code>) "Tune 2C", 
introduced with 8.140 <ref>Cor10a</ref>.  It uses the CTEQ 6L1 PDF, 
and is intended to give good agreement with much of the published CDF 
data. 
</option> 
<option value="4">(<code>tunes/Tune2M.cmnd</code>) "Tune 2M", 
introduced with 8.140 <ref>Cor10a</ref>.  It is uses the MRST LO** 
PDF, which has a momentum sum somewhat above unity, which is 
compensated by a smaller <ei>alpha_s</ei> than in the previous 
tune. Again it is intended to give good agreement with much of the 
published CDF data. 
</option> 
<option value="5">(<code>tunes/Tune4C.cmnd</code>) "Tune 4C", newer 
tune, introduced with 8.145 <ref>Cor10a</ref>. Starts out from tune 
2C, but with a reduced cross section for diffraction, plus modified 
multiparton interactions parameters to give a higher and more rapidly 
increasing charged pseudorapidity plateau, for better agreement with 
some early key LHC numbers.  See also the comparative study in 
<ref>Buc11</ref>.  The starting point for many later tunes. 
</option> 
<option value="6">(<code>tunes/Tune4Cx.cmnd</code>) "Tune 4Cx", based 
on tune 4C, but using the x-dependent matter profile, 
<code>MultipartonInteractions:bProfile = 4</code> and an increased 
<code>MultipartonInteractions:pT0Ref</code> <ref>Cor11</ref>. 
</option> 
<option value="7">(<code>tunes/ATLAS-MB-A2-CTEQ6L1.cmnd</code>) "ATLAS 
MB Tune A2-CTEQ6L1", a minimum-bias tune based on tune 4Cx, but 
without rapidity-ordered spacelike emissions <ref>ATL12</ref>. Uses 
CTEQ 6L1, by default from LHAPDF. 
</option> 
<option value="8">(<code>tunes/ATLAS-MB-A2-MSTW2008LO.cmnd</code>) 
"ATLAS MB Tune A2-MSTW2008LO", as above, but uses MSTW 2008 LO, by 
default from LHAPDF. 
</option> 
<option value="9">(<code>tunes/ATLAS-UE-AU2-CTEQ6L1.cmnd</code>) "ATLAS 
UE Tune AU2-CTEQ6L1", an underlying-event tune based on tune 4Cx, but 
without rapidity-ordered spacelike emissions <ref>ATL12</ref>. Uses 
CTEQ 6L1, by default from LHAPDF. 
</option> 
<option value="10">(<code>tunes/ATLAS-UE-AU2-MSTW2008LO.cmnd</code>) 
"ATLAS UE Tune AU2-MSTW2008LO", as above, but uses MSTW 2008 LO, by 
default from LHAPDF. 
</option> 
<option value="11">(<code>tunes/ATLAS-UE-AU2-CT10.cmnd</code>) "ATLAS 
UE Tune AU2-CT10", as above, but uses CT 10, which is not currently 
implemented in PYTHIA, so you must link LHAPDF. 
</option> 
<option value="12">(<code>tunes/ATLAS-UE-AU2-MRST2007LOx.cmnd</code>) 
"ATLAS UE Tune AU2-MRST2007LO*", as above, but uses MRST 2007 LO*, by 
default from LHAPDF. 
</option> 
<option value="13">(<code>tunes/ATLAS-UE-AU2-MRST2007LOxx.cmnd</code>) 
"ATLAS UE Tune AU2-MRST2007LO**", as above, but uses MRST 2007 LO**, 
by default from LHAPDF. 
</option> 
<option value="14">(<code>tunes/Monash2013.cmnd</code>) the Monash 2013 
tune by Peter Skands at al. <ref>Ska14</ref>, to both <ei>e^+e^-</ei> 
and <ei>pp/pbarp</ei> data. The starting point for many later tunes. 
</option> 
<option value="15">(<code>tunes/CMS-CUETP8S1-CTEQ6L1.cmnd</code>) "CMS 
UE Tune CUETP8S1-CTEQ6L1", an underlying-event tune based on tune 4C 
<ref>CMS14</ref>. Uses CTEQ 6L1, by default from LHAPDF. 
</option> 
<option value="16">(<code>tunes/CMS-CUETP8S1-HERAPDF1.cmnd</code>) "CMS 
UE Tune CUETP8S1-HERAPDF1.5LO", an underlying-event tune based on tune 
4C <ref>CMS14</ref>. Uses HERAPDF1.5LO, which is not currently 
implemented in PYTHIA, so you must link LHAPDF. 
</option> 
<option value="17">(<code>tunes/ATLAS-AZ.cmnd</code>) "ATLAS Tune AZ", 
is tuned to the <ei>pT</ei> spectrum of the <ei>Z^/gamma^*0</ei> boson 
in a set of rapidity bins <ref>ATL14</ref>. 
</option> 
<option value="18">(<code>tunes/CMS-CUETP8M1-NNPDF23LO.cmnd</code>) 
"CMS Tune MonashStar", alias CUETP8M1-NNPDF2.3LO, an underlying-event 
tune based on the Monash 2013 tune. 
</option> 
<option value="19">(<code>tunes/ATLAS-A14-CTEQL1.cmnd</code>) "ATLAS 
A14 central tune with CTEQL1", a full-scale tune to most ATLAS jet and 
underlying-event observables <ref>ATL14a</ref>, starting out from the 
Monash 2013 tune. The following tunes 20 - 32 belong to the same 
group. 
</option> 
<option value="20">(<code>tunes/ATLAS-A14-MSTW2008LO.cmnd</code>) 
"ATLAS A14 central tune with MSTW2008LO", see above tune 19. 
</option> 
<option value="21">(<code>tunes/ATLAS-A14-NNPDF32LO.cmnd</code>) "ATLAS 
A14 central tune with NNPDF2.3LO", see above tune 19. Defines the 
center of the 23 - 32 variations, so would be a good choice if you 
only want to study one tune from the A14 family. 
</option> 
<option value="22">(<code>tunes/ATLAS-A14-HERAPDF15LO.cmnd</code>) 
"ATLAS A14 central tune with HERAPDF1.5LO", see above tune 19. Uses 
HERAPDF1.5LO, which is not currently implemented in PYTHIA, so you 
must link LHAPDF. 
</option> 
<option value="23">(<code>tunes/ATLAS-A14-v+1.cmnd</code>) "ATLAS A14 
variation 1+" of tune 21. 
</option> 
<option value="24">(<code>tunes/ATLAS-A14-v-1.cmnd</code>) "ATLAS A14 
variation 1-" of tune 21. 
</option> 
<option value="25">(<code>tunes/ATLAS-A14-v+2.cmnd</code>) "ATLAS A14 
variation 2+" of tune 21. 
</option> 
<option value="26">(<code>tunes/ATLAS-A14-v-2.cmnd</code>) "ATLAS A14 
variation 2-" of tune 21. 
</option> 
<option value="27">(<code>tunes/ATLAS-A14-v+3a.cmnd</code>) "ATLAS A14 
variation 3a+" of tune 21. 
</option> 
<option value="28">(<code>tunes/ATLAS-A14-v-3a.cmnd</code>) "ATLAS A14 
variation 3a-" of tune 21. 
</option> 
<option value="29">(<code>tunes/ATLAS-A14-v+3b.cmnd</code>) "ATLAS A14 
variation 3b+" of tune 21. 
</option> 
<option value="30">(<code>tunes/ATLAS-A14-v-3b.cmnd</code>) "ATLAS A14 
variation 3b-" of tune 21. 
</option> 
<option value="31">(<code>tunes/ATLAS-A14-v+3c.cmnd</code>) "ATLAS A14 
variation 3c+" of tune 21. 
</option> 
<option value="32">(<code>tunes/ATLAS-A14-v-3c.cmnd</code>) "ATLAS A14 
variation 3c-" of tune 21. 
</option> 
<option value="33">(<code>tunes/Detroit.cmnd</code>) 
the Detroit tune (2021), a UE+MB tune to RHIC and Tevatron data. Uses the 
NNPDF 3.1 LO PDF set. See <ref>Agu22</ref>. 
</option> 
</modepick> 
 
</chapter> 
 
<!-- Copyright (C) 2026 Torbjorn Sjostrand --> 
