Your browser has javascript turned off or blocked. This will lead to some parts of our website to not work properly or at all. Turn on javascript for best performance.

The browser you are using is not supported by this website. All versions of Internet Explorer are no longer supported, either by us or Microsoft (read more here:

Please use a modern browser to fully experience our website, such as the newest versions of Edge, Chrome, Firefox or Safari etc.

Profile picture of Leif Lönnblad. Photo.

Leif Lönnblad

Professor of Theoretical Physics

Profile picture of Leif Lönnblad. Photo.

Rivet user manual


  • Andy Buckley
  • Jonathan Butterworth
  • David Grellscheid
  • Hendrik Hoeth
  • Leif Lönnblad
  • James Monk
  • Holger Schulz
  • Frank Siegert

Summary, in English

This is the manual and user guide for the Rivet system for the validation and tuning of Monte Carlo event generators. As well as the core Rivet library, this manual describes the usage of the rivet program and the AGILe generator interface library. The depth and level of description is chosen for users of the system, starting with the basics of using validation code written by others, and then covering sufficient details to write new Rivet analyses and calculational components. Program summary Program title: Rivet Catalogue identifier: AEPS_v1_0 Program summary URL: Program obtainable from: CPC Program Library, Queen's University, Belfast, N. Ireland Licensing provisions: Standard CPC licence, No. of lines in distributed program, including test data, etc.: 571126 No. of bytes in distributed program, including test data, etc.: 4717522 Distribution format: tar.gz Programming language: C++, Python. Computer: PC running Linux, Mac. Operating system: Linux, Mac OS. RAM: 20 MB Classification: 11.9, 11.2. External routines: HepMC (, GSL (, FastJet (, Python (, Swig (, Boost (, YAML ( Nature of problem: Experimental measurements from high-energy particle colliders should be defined and stored in a general framework such that it is simple to compare theory predictions to them. Rivet is such a framework, and contains at the same time a large collection of existing measurements. Solution method: Rivet is based on HepMC events, a standardised output format provided by many theory simulation tools. Events are processed by Rivet to generate histograms for the requested list of analyses, incorporating all experimental phase space cuts and histogram definitions. Restrictions: Cannot calculate statistical errors for correlated events as they appear in NLO calculations. Unusual features: It is possible for the user to implement and use their own custom analysis as a module without having to modify the main Rivet code/installation. Running time: Depends on the number and complexity of analyses being applied, but typically a few hundred events per second. (C) 2013 Elsevier B.V. All rights reserved.


  • Theoretical Particle Physics

Publishing year







Computer Physics Communications





Document type

Journal article




  • Subatomic Physics


  • Event generator
  • Simulation
  • Validation
  • Tuning
  • QCD




  • ISSN: 0010-4655