Skip to main content

Research Repository

Advanced Search

Rivet user manual

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


Andy Buckley

Jonathan Butterworth

Leif Lonnblad

David Grellscheid

Hendrik Hoeth

Leif Lönnblad

James Monk

Holger Schulz

Frank Siegert


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.


Buckley, A., Butterworth, J., Lonnblad, L., Grellscheid, D., Hoeth, H., Lönnblad, L., …Siegert, F. (2013). Rivet user manual. Computer Physics Communications, 184(12), 2803-2819.

Journal Article Type Article
Publication Date Dec 1, 2013
Deposit Date Feb 6, 2014
Publicly Available Date Dec 12, 2014
Journal Computer Physics Communications
Print ISSN 0010-4655
Publisher Elsevier
Peer Reviewed Peer Reviewed
Volume 184
Issue 12
Pages 2803-2819
Keywords Event generator, Simulation, Validation, Tuning, QCD.


You might also like

Downloadable Citations