RunMC

RunMC installation together with CLHEP and ROOT

Installation under GNU/Linux PC requires X11, g++, g77 compilers and zip/unzip. You should have about 500M of free disk space.

How to compile the RunMC package together with CLHEP and ROOT:

• Download the current version of the RUNMC (version 4.0) for Linux.
• Download additional package which contains CLHEP (1.8.2) and ROOT (5.04).
• Do "gunzip runmc-[version].tar.gz; tar -vxf runmc-[version].tar", where [version] specifies the current RunMC version (v4.0 etc).
• Copy the file "packages-[version].tar.gz" to the RunMCv[version] directory and go inside of this directory, i.e "cd RunMCv[version]".
• Do "gunzip packages-[version].tar.gz; tar -vxf packages-[version].tar".
  You should see a new directory "packages" inside the main RunMCv[version]" directory.
• cd RunMCv[version]/packages and edit "install.sh" file.
  You need only to specify the location of the CERNLIB fortran library (default is CERN_DIR = /cern/pro/lib) and the name of PDF library;

• You should now set the environmental variables in order to have an access to ROOT, CLHEP and RunMC. The RUNMC variable should be set to the RunMCv[version] directory, such that <path> gives the location to the RunMCv[version] directory. Then add $RUNMC/bin to the environmental variable PATH:

This can be done in .bashrc file:

sh family:
export RUNMC=<path>/RunMCv[version]
export PATH=$RUNMC/bin:$PATH
export ROOTSYS=$RUNMC/packages/root
export PATH=$ROOTSYS/bin:$PATH
export LD_LIBRARY_PATH=$ROOTSYS/lib:$LD_LIBRARY_PATH
export CLHEP_PATH=$RUNMC/packages/clhep

then do: "source .bashrc" or open a new terminal.

or for the "csh" shell family (file .cshrc):
setenv RUNMC <path>/RunMCv[version]
setenv PATH ${RUNMC}/bin:${PATH}
setenv ROOTSYS $RUNMC/packages/root
setenv PATH ${ROOTSYS}/bin:${PATH}
setenv LD_LIBRARY_PATH ${ROOTSYS}/lib:${LD_LIBRARY_PATH}
setenv CLHEP_PATH $RUNMC/packages/clhep

rehash

(replace <path> by the location of RunMCv[version] directory, do not modify anything else)

Type “echo $RUNMC” , to be sure that you set this variable properly. You should see the following directories: “packages”, “build”, “proj”, “main”, “bin” etc. Make sure that ROOT is installed, i.e. type "root" and you should see a splash window. Exit it using ".q".

It is also useful to check your ROOT installation. Do “cd $ROOTSYS/test” and type “make”. If the ROOT is correctly installed, all examples should be compiled without problems.

Then, go to the directory $RUNMC/packages and type "./install.sh" to compile the CLHEP and ROOT packages.

When it's done, remove unnecessary object files using "clean_obj.sh" script.

Then, when the installation is finished, go to the directory $RUNMC/build and type "./install_full.sh" to compile the RunMC program. Note that you may need still to adjust the location of CERNLIB library, however, the locations of CLHEP and ROOT should be already set correctly.

In case of installation problems

1) Test ROOT installation as : cd $RUNMC/build/test; ./check_root.sh
2) Test CLHEP installation as : cd $RUNMC/build/test; ./check_clhep.sh

In case of error messages, reinstall these libraries. Note that I cannot provide the support in case of ROOT/CLHEP problems, so please study the original web pages of ROOT and CLHEP class library;

How to install RunMC under Windows:

Read the instruction on this web page

S.Chekanov chekanov@mail.desy.de