Welcome to PYTHIA
PYTHIA is a program for the generation of high-energy physics collision events, i.e. for the description of collisions at high energies between electrons, protons, photons and heavy nuclei. It contains theory and models for a number of physics aspects, including hard and soft interactions, parton distributions, initial- and final-state parton showers, multiparton interactions, fragmentation and decay. It is largely based on original research, but also borrows many formulae and other knowledge from the literature. As such it is categorized as a general purpose Monte Carlo event generator.
Download and install PYTHIA 8.306
The current version is PYTHIA 8.306.
To get going with the program, do the following (on a Linux or Mac OS X system):
Download the file pythia8306.tgz to a suitable location.
Unzip and expand it with
tar xvfz pythia8306.tgz.
Move to the thus created
READMEfile in it for installation instructions, and apply them. (If you are not going to link any external libraries, or have any other special demands, you only need to type
Move to the
examplessubdirectory and read the
READMEfile there for instructions how to do some test runs. (Again, if you do not link to external libraries, you only need to type
make mainNNfollowed by
./mainNN > mainNN.log, where
NNis a two-digit number in the range 01 - 30.)
Documentation for PYTHIA 8.306
All necessary information how to run the program is available in subdirectories of the
pythia8306 directory you unpacked above. You can find a complete overview of documentation for the latest, and previous, versions of PYTHIA on the documentation page.
Links to relevant documentation for the most recent version is linked here:
Work is underway towards a dedicated PYTHIA 8.3 article, but meanwhile you can study An Introduction to PYTHIA 8.2, available in
pythia8306/share/Pythia8/pdfdoc/pythia8200.pdf, for an overview. This article, in arXiv:1410.3012 [hep-ph], has been published in Comput. Phys.Commun. 191 (2015) 159.
The current online HTML manual can be accessed if you open the
pythia8306/share/Pythia8/htmldoc/Welcome.htmlfile in a web browser.
The Update History forms an integral part of the manual.
So does the description of existing main programs, which offers many hints how to address various programming issues.
A Doxygen representation of the code is available. It offers a quick way to look up classes and methods, but is not a replacement for the manual. The Doxygen representation for PYTHIA 8.306 can be found here, previous versions are linked on the documentation page.
The distribution also comes with a PYTHIA 8.2 Worksheet, primarily intended for summer schools, but also suitable for self-study, to get going. It is slightly out of date, but still useful. For the merging study the option exists to download larger LHE files than come with the standard PYTHIA distribution:
Several presentations on the status and development of PYTHIA can be found on the talks page.
In addition, the complete PYTHIA 6.4 Physics and Manual is still relevant for much of the physics in 8.2, and A Brief Introduction to PYTHIA 8.1 may also contain some useful material, although some of it is superseded by An Introduction to PYTHIA 8.2.