= WHIZARD Installation instructions =

Back to the [http://projects.hepforge.org/whizard/trac/wiki main page.]

Here we collect informations about the WHIZARD installation procedure. Most of this can be found as well in the [source:tags/release_2.0.2/INSTALL INSTALL file] as well
as in the [http://projects.hepforge.org/whizard/manual.pdf manual.]

We review here the installation of the tarball of the latest version of WHIZARD 2.
Technical details about the installation of the development version from the SVN trunk can be found in the [http://projects.hepforge.org/whizard/manual.pdf manual.]

The philosophy of WHIZARD 2 is that the program is installed centrally in a computer, e.g. in a directory {{{/usr/local/}}}, where all the binaries, libraries and necessary files are located, while the users run the program in workspaces in their home directories. (Working in batch mode can be handled, too.) The following
describes a system installation, but of course a user can install WHIZARD also in his/her home directory.

== Prerequisites ==

The general prerequisites for the installation are standard tools 
for software development like {{{make}}} etc., and two different compilers, a  
Fortran 2003 for the WHIZARD core and its corresponding
libraries as well as the O'Caml compiler for the O'Mega matrix
element generator. Details and links for the compilers can be found 
[http://projects.hepforge.org/whizard/compilers.html here.]

After you downloaded the most recent tarball from the main page,
unpack it, go to the WHIZARD directory, create a new {{{build}}}
directory and go there. In that directory, perform a
{{{../configure FC=<your FORTRAN compiler> --prefix=/usr/local}}}. 
Note that this is because the source and compile directories should be
different to avoid any problems during compilation and
installation. {{{../configure --help}}} shows you the options for the
configure process you have. The {{{FC}}} environment variable
allows you to specify your FORTRAN compiler of choice. Note that
WHIZARD 2 has been written in Fortran 2003 in a fully
object-oriented way. We highly recommend usage of the standard
{{{gfortran}}} compiler from version 4.5.0 on. You can access the
help menu of configure by {{{../configure --help}}}. 
{{{./configure -V}}} shows you the actual version of
your downloaded WHIZARD distribution. The possible environment
variables are:

{{{
  CC          C compiler command
  CFLAGS      C compiler flags
  LDFLAGS     linker flags, e.g. -L<lib dir> if you have libraries in a
              nonstandard directory <lib dir>
  LIBS        libraries to pass to the linker, e.g. -l<library>
  CPPFLAGS    C/C++/Objective C preprocessor flags, e.g. -I<include dir> if
              you have headers in a nonstandard directory <include dir>
  CPP         C preprocessor
  FC          Fortran compiler command
  FCFLAGS     Fortran compiler flags
  CXX         C++ compiler command
  CXXFLAGS    C++ compiler flags
  CXXCPP      C++ preprocessor
}}}


Back to the [http://projects.hepforge.org/whizard/trac/wiki main page.]