1. Welcome to PYTHIA - The Lund Monte Carlo!
  2. Documentation
  3. Authors
  4. Former authors
  5. Further contributions
  6. Contact
  7. Licence

Welcome to PYTHIA - The Lund Monte Carlo!

PYTHIA is a general-purpose event generator for high-energy particle collisions. PYTHIA 8 is the successor to PYTHIA 6, rewritten from scratch in C++. It includes many new features, but rests on the same historical physics base, including concepts such as soft and hard processes, parton showers, multiparton interactions and string fragmentation. With the current PYTHIA 8.3 version the step has been taken from C++98 to C++11, but the transition from 8.2 should largely be transparent to users. Also several new physics features are made available.


On these webpages you will find the manual for PYTHIA 8.3. The physics descriptions may in places still need to be updated, but the documentation of available settings and other practical details should be fully up-to-date. Use the left-hand index to navigate this documentation of program elements, especially of all possible program settings. All parameters are provided with sensible default values, however, so you need only change those of relevance to your particular study, such as choice of beams, processes and phase space cuts. The pages also contain a fairly extensive survey of all methods available to the user, e.g. to study the produced events. What is lacking on these webpages is an overview, on the one hand, and an in-depth physics description, on the other.

The overview can be found in the attached PDF file
An Introduction to PYTHIA 8.2
T. Sjöstrand et al, Comput. Phys.Commun. 191 (2015) 159 [arXiv:1410.3012 [hep-ph]].
You are strongly recommended to read this summary when you start out to learn how to use PYTHIA 8.2.

For the physics description we refer to the complete
PYTHIA 6.4 Physics and Manual
T. Sjöstrand, S. Mrenna and P. Skands, JHEP05 (2006) 026,
which in detail describes the physics (largely) implemented also in PYTHIA 8, and also provides a more extensive bibliography than found here. When you use PYTHIA 8.2, you should therefore cite both.

Furthermore, a separate
PYTHIA 8.2 Worksheet,
also an attached PDF file, offers a practical introduction to using the generator. It has been developed for and used at a few summer schools, with minor variations, but is also suited for self-study.


Christian Bierlich
Department of Astronomy and Theoretical Physics, Lund University, Sölvegatan 14A, SE-223 62 Lund, Sweden
and Niels Bohr Institute, University of Copenhagen, Copenhagen, Denmark

Nishita Desai
Department of Theoretical Physics, Tata Institute of Fundamental Research, Homi Bhabha Road, Mumbai 400005, India

Leif Gellersen
Department of Astronomy and Theoretical Physics, Lund University, Sölvegatan 14A, SE-223 62 Lund, Sweden

Ilkka Helenius
Department of Physics, University of Jyväskylä, P.O. Box 35, FI-40014 University of Jyväskylä, Finland

Philip Ilten
Department of Physics, University of Cincinnati, Cincinnati, OH 45221, USA

Leif Lönnblad
Department of Astronomy and Theoretical Physics, Lund University, Sölvegatan 14A, SE-223 62 Lund, Sweden

Stephen Mrenna
Computing Division, Simulations Group, Fermi National Accelerator Laboratory, MS 234, Batavia, IL 60510, USA

Stefan Prestel
Department of Astronomy and Theoretical Physics, Lund University, Sölvegatan 14A, SE-223 62 Lund, Sweden

Christian Preuss
School of Physics and Astronomy, Monash University, PO Box 27, 3800 Melbourne, Australia

Torbjörn Sjöstrand
Department of Astronomy and Theoretical Physics, Lund University, Sölvegatan 14A, SE-223 62 Lund, Sweden

Peter Skands
School of Physics and Astronomy, Monash University, PO Box 27, 3800 Melbourne, Australia

Marius Utheim
Department of Astronomy and Theoretical Physics, Lund University, Sölvegatan 14A, SE-223 62 Lund, Sweden

Rob Verheyen
Department of Physics and Astronomy, University College London, Gower St, Bloomsbury, London WC1E 6BT, UK

Former authors

Stefan Ask

Jesper Roy Christiansen

Richard Corke

Nadine Fischer

Christine O. Rasmussen

Further contributions

Makefiles, configure scripts and HepMC interface by Mikhail Kirsanov.
Conversion of XML files to PHP ones by Ben Lloyd.
Simple Makefile for Win32/NMAKE by Bertrand Bellenot.
Extended Higgs sector partly implemented by Marc Montull.
Parts of charm and bottom decay tables courtesy DELPHI and LHCb collaborations.
Tunes and comparisons with data, based on Rivet and Professor, by Hendrik Hoeth.
Text and code on the use of ROOT in conjunction with PYTHIA by Rene Brun, Andreas Morsch and Axel Naumann.
Code and data for MRST/MSTW PDFs by Robert Thorne and Graeme Watt.
Code and data for the CTEQ/CT PDFs by Joey Huston and colleagues.
Help with implementing new proton PDFs by Tomas Kasemets.
Code and data for Pomeron PDFs by H1 collaboration and especially Paul Newman.
Help with implementing new Pomeron fluxes and PDFs by Sparsh Navin.
The new Hidden Valley code developed together with Lisa Carloni.
Code for a Kaluza-Klein electroweak gauge boson provided by Noam Hod and Mark Sutton.
Code for equivalent photon flux around an unresolved proton by Oystein Alvestad.
The MBR diffractive model and central diffraction by Robert Ciesielski.
2012 branching ratios for most light hadrons, and the tau lepton, by Anil Pratap Singh.
The pythia8-config script has been contributed by Andy Buckley, along with many other helpful suggestions.
Code and data for several of the NNPDF2.3 QCD+QED sets, and further later ones, provided by Juan Rojo and Stefano Carrazza.
The fjcore code from FastJet provided by Matteo Cacciari, Gavin Salam and Gregory Soyez.
The initial-final dipole approach has been developed and implemented by Baptiste Cabouat.
The MixMax random number generator has been contributed by Konstantin Savvidy and George Savvidy.
Space-time hadronic production points in string fragmentation have been studied and implemented by Silvia Ferreres-Solé.
The code for deuteron production was tested by Sophie Baker.
C++ interface to MG5 matrix elements by V. Hirschi with additional work by O. Mattelaer.
Mass corrections and initial-state showers in Vincia by M. Ritzmann.
Final-state sector showers in Vincia by J. Lopez-Villarejo.
Helicity-dependence in Vincia by A. Larkoski.
Interleaved resonance showers and work on sector merging and QED+EW showers in Vincia by H. Brooks.

Note: in several cases modifications have been made to the original code, in order to integrate it with PYTHIA. In these cases the blame for any mistakes has to rest with the regular authors.


New version alerts

If you want to be alerted whenever a new public version is released, you can subscribe on pythia8-announce. Expect a handful of such messages per year. There is no fixed schedule; new versions can appear either because a sufficient amount of changes have been accumulated over time, or because some crucial new feature or bug fix prompts action.

Bug reports and physics questions

No code is perfect, and we rely on PYTHIA users to report suspect behaviour to us. We are starting to collect common questions and problems with our issue tracker. Please check this resource first for answered questions. New questions and issues can be either opened with a freely available account or emailing us at where no account is required. To help us in the subsequent debugging efforts, however, it is helpful if you can present your case in as clear terms as possible. A convenient path is the following.

Note, the email should always be used when contacting the authors as it allows us to coordinate replies. You may also include the individual addresses of authors that are relevant for a specific issue. Never contact several persons independently on the same topic, thereby potentially leading to doublework. Abuse will have consequences.

When responding to emails from us at, reply directly to the email, which has a unique return address of the form incoming+<hash>, and not Please consider allowing your correspondence to be made publicly available to other users via our issue tracker, by replying at any point with your express permission, e.g. "this correspondence can be made public".

Do note that the major collaborations, such as ATLAS and CMS, have their own Monte Carlo support groups, with a lot of experience in solving typical issues, many of which are related to the setups and interfaces created inside the collaborations. If you are a member of a major collaboration you please turn to these groups in the first place, and only turn to us when it has been confirmed as a true problem going beyond the local installation.


PYTHIA 8 is licensed under the GNU General Public Licence version 2 or later.
Please respect the MCnet Guidelines for Event Generator Authors and Users.

The program and the documentation is Copyright © 2019 Torbjörn Sjöstrand