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 94 (modified by jmonk, 12 years ago) (diff)

--

Getting started with Rivet

Note, we plan a release in Jan 2008. These instructions are being modified to reflect installing the new version. So they should work on the svn HEAD, but beware, things will be unstable until the release. Sorry for the inconvenience.

These instructions are aimed at users who want to install and run a release of Rivet. GettingStartedForDevelopers has some additional or replacement steps for people wishing to check out the development version from the repository and build from there.

Rivet installation instructions

Create a directory (e.g. named $HOME/cedar/local) to contain the created libraries.

First install the related packages. If they are installed already on your system, you can use them as long as you tell the Rivet configuration where they are. We recommend using the latest available version of each package. The versions given below represent the latest version we have tested. Older versions may work too, but why use them when they probably have bugs which are fixed in later versions...

  1. All CLHEP dependency has been removed from the svn head version of Rivet as of 10.01.2008 and will not be present in future releases. Earlier releases required CLHEP 2.0.3.1 (or later) from http://proj-clhep.web.cern.ch/proj-clhep/ .
  1. HepMC version 2.00.03 (or later) from http://lcgapp.cern.ch/project/simu/HepMC/download/ then do:
           tar xvzf HepMC-2.00.03.tar.gz
           cd HepMC-2.00.03
           ./configure --prefix=[path_to_my_local_directory]
           make
           make install  
           cd ..
    
  2. HepPDT version 2.04.01 (or later) from http://lcgapp.cern.ch/project/simu/HepPDT/download/ then do:
           tar xvzf HepPDT-2.04.01.tar.gz
           cd HepPDT-2.04.01
           ./configure --prefix=[path_to_my_local_directory]
           make
           make install
           cd ..
    
  3. KtJet version 1.8 from http://www.hepforge.org/downloads/ktjet then do:
           tar xvzf KtJet-1.08.tar.gz
           cd KtJet-1.08
           ./configure --prefix=[path_to_my_local_directory]
           make
           make install
           cd ..
    

Notes:

  1. KtJet dependency will be removed in the Jan 08 release.
  1. Optional: If you want to output root histograms or trees, you'll need to install the root headers and libraries and set the ROOTSYS and LD_LIBRARY_PATH variables as outlined in the root installation instructions (see http://root.cern.ch). You should then add the flag --with-root to the ./configure command below.
  1. fastjet from http://www.lpthe.jussieu.fr/~salam/fastjet/ then do:
           tar xvzf fastjet-2.3-beta0
           cd fastjet-2.3-beta0
           ./configure --prefix=[path_to_my_local_directory]
           make
           make install
           cd ..
    

Notes:

  1. Currently we are using the beta release of fastjet. (Last tried with v2.3-beta0, 3 Dec '07).
  2. You may have to add -fPIC to the CXXFLAGS (seems to be needed on 64 bit machines. Not sure why).
  1. Optional. If you want to use the RivetGun main program and the CEDAR generator interfaces, you need to get the latest AGILe tarball from http://www.hepforge.org/downloads/agile (see notes below)
           tar xvfz AGILe-{version}.tar.gz
           cd AGILe-{version}
           ./configure --prefix=[path_to_my_local_directory] 
           make
           make install
           cd ..
    

Notes:

  1. Until the release, you'll have to use svn checkout instead.
  2. See agile/trac/wiki/GettingStarted for more help on installing AGILe.
  1. Some Linux distributions do not include the GNU Scientific Library (GSL). In these cases it will be necessary to download and install GSL from http://www.gnu.org/software/gsl/
  1. Rivet latest tarball from http://www.hepforge.org/downloads/rivet (see note below)
           tar xvfz Rivet-{version}.tar.gz
           cd Rivet-{version}
           ./configure --prefix=[path_to_my_local_directory] 
           make
           make install
           cd ..
    

Notes:

  1. Until the release you need to get the svn HEAD version.
  2. For running on 64 bit machines, you (at least at present) have to select the version of libgsl explcitly. See #128.

Running Rivet

To run Rivet, you'll need to link to a main program. Within CEDAR we use RivetGun; to see how to get started with this, follow these instructions.