Herwig++ Installation

Dependencies

Herwig++ uses the underlying ThePEG library extensively. If ThePEG is already installed on your system, you can go straight to section Herwig++.

Please read through the sections before typing any commands.

The installation steps were tested with gcc series 3.4, 4.0, 4.1, 4.2, 4.3 and 4.4 on i686 and 64bit Linux machines, and the library versions mentioned below.

Additional instructions for Mac OS X users.

ThePEG

Download

You can get the lastest version of ThePEG from the Herwig++ download page. For Herwig++ 2.4.2, you'll need ThePEG 1.6.1.

GNU scientific library

Make sure you have the GSL library and headers installed on your system. They are required to build ThePEG.

Prepare source directory

After downloading the tarball, do

$ tar xjvf ThePEG-1.6.1.tar.bz2
$ cd ThePEG-1.6.1

Installation

Now, you can run

$ ./configure --prefix=(thepeg-install-dir)
$ make
$ make check

as usual. Replace (thepeg-install-dir) with the path to the directory where you want ThePEG to be installed. The default is /usr/local, other possibilities could be $HOME or, if you want to keep everything ThePEG-related neatly in one place, /opt/ThePEG or $HOME/opt/ThePEG. The make commands will build and check ThePEG. If there are no errors, run

$ make install

For this step, you will need write permission on (thepeg-install-dir).

After the installation, the source directory is not required anymore. Delete it if you're short on space.

Herwig++

Download

The 2.4.2 release is available at the Herwig++ download page.

Prepare the source directory

Once you have downloaded the tarball, do

$ tar xjvf Herwig++-2.4.2.tar.bz2
$ cd Herwig++-2.4.2

Installation

Now, you can run

$ ./configure --prefix=(hw-install-dir)  --with-thepeg=(thepeg-install-dir)
$ make
$ make check

as usual. The installation directory can be the same as before, but doesn't need to be. These commands will build and check Herwig++. If there are no errors, run

$ make install

After you are convinced that your installation works, you won't need the source directories anymore to run Herwig++.

FirstRun will take you through a simple e+e- generator run, using the LEP setup that comes with the installation.