rivet is hosted by Hepforge, IPPP Durham
close Warning: Can't synchronize with repository "(default)" (Repository path '/hepforge/hg/rivet/public/rivet' does not exist.). Look in the Trac log for more information.

Version 18 (modified by David Voong, 14 years ago) (diff)


Getting started with Rivet/Rivetgun?

James: Tommy and I found the following to work, at least as far as building Rivet:

download "./configure" "make" and "make install" these external packages using automake 1.9 and autoconf 2.59

  • HepMC 2.0.x
  • HepPDT 2.02.02 from here
  • log4cpp 0.3.5rc3 from here

In addition, we also installed out own copy of libtool in ~/Cedar/local to make sure we had the correct version (also had our own autotools and autoconf there, but probably unnecessary). exported the paths to autotools etc

  export AUTOCONF = $HOME/Cedar/local/bin/autoconf
  export AUTOMAKE = $HOME/Cedar/local/bin/automake
  export LIBTOOL = $HOME/Cedar/local/bin/libtool
  export ACLOCAL = $HOME/Cedar/local/bin/aclocal

and just for good measure made sure that $HOME/Cedar/local/bin was also at the front of $PATH

Having installed all that lot, we found that Rivet itself would build.

Running Rivet

To run RivetGun, you'll also need at least one generator package, e.g.

  • Herwig 6.5.10
  • LHAPDF 5.x

Build RivetGun with the normal ./configure (--prefix=...), make, make install mantra. This should detect that you've got Rivet, Herwig and LHAPDF installed and build test applications based on that. The most useful test binaries will be located in .../src/Test/, with names like testFHerwig6510 and testFHerwig6510WithRivet. All these executables are built from the testGenerator.cc source file, by using different build arguments --- see src/Test/Makefile.am. Feel free to add your own Analysis to the list --- see the Rivet Doxygen pages for the API guide.

Some Problems and Solutions

David: Here are some problems and soulutions I've encountered.

log4cpp 0.3.5rc3 from here

problem: when running make check, 1 of the tests fails.

solution: not sure if this really is a problem but to be safe I installed the older version log4cpp 0.2.8

log4cpp 0.2.8

problem: here is a problem I encountered on my home computer. Does not support type long long (I'll post the exact error later).

soulution: not the best solution but I edited the header file (from which the error stemmed) from type long long to type long. No problems... yet, probably a much better idea would be to install the dependency.


problem: when running make there were errors due to missing AIDA header files.

In file included from /home/voong/cedar/local/include/Rivet/RivetHandler.hh:10,
                 from testGenerator.cc:17:
AIDA/IAnalysisFactory.h: No such file or directory

solution: Copy the AIDA folder (which is downloaded along with rivet) to the apropriate include folder (determined by where rivet and rivetgun are installed (./configure --prefix=/path/to)).


For my setup rivet was downloaded (using svn) to ~/install/rivet and configured using, ./configure --prefix = ~/cedar/local. For a setup like this copy AIDA folder from

~/install/rivetgun/trunk/include/ to ~/cedar/local/include/