RunMC


Installation

Installation for Linux:

Installation under GNU/Linux PC requires X11, g++, g77 compilers and zip/unzip. To compile the package, you need first to install:

  1. ROOT C++ package;
  2. CERNLIB library;
  3. CLHEP class library;
  4. JAVA (JRE) virtual machine. Usually, it should be already installed. (check "java -version": you should see the version of java VM installed). The program can run only with the version 1.5 and above (not JRE 1.4.X!). If it is not installed, download it from SUN Web page
  5. Then download the current version of the RUNMC (version 4.0) This file also includes RMC modules.

    If you do not have CLHEP and ROOT installed, you should follow to this installation procedure.

    Below I describe only the procedure assuming that CLHEP and ROOT libraries are already installed.

    How to compile the RunMC package:

  • gunzip runmc<version>.tar.gz, where <version> specifies the current version (v4.0 etc);
  • tar -vxf runmc<version>.tar
  • cd RunMC<version>/build i.e. go to the directory containing the package's source code, and edit "install.sh" file:

    (a) specify the location of the CERNLIB fortran library (default is CERN_DIR = /cern/pro/lib);

    (b) specify the location of the CLHEP library, library itself and the include files; (default is CLHEP_DIR= /cern/CLHEP/lib and CLHEPINC= /cern/CLHEP/include );

  • RUNMC variable should be set to the RunMC<version> directory, such that <path> gives the location to the RunMC directory. Then add $RUNMC/bin to the enviromental variable PATH.


This can be done in .bashrc file:

sh family:

export RUNMC=<path>/RunMC
export PATH=$RUNMC/bin:$PATH


csh family:
setenv RUNMC <path>/RunMC
setenv PATH ${RUNMC}/bin:${PATH}

rehash

(replace <path> by the location of RunMC directory)

Type “echo $RUNMC” , to be sure that you set this variable properly. You should see the following directories: “bin”, “build”, “proj”, “main”, “doc”.

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 $RUNMC/build and type "./install.sh" to compile the package. After first compilation, next compilations should take significantly less time

  • You can remove the program binaries and object files from the source code directory by typing "make cleanall'. To remove only object files, do "make clean"; To remove Monte-Carlo-related files, type "make cleanmc"

  • Go to the $RUNMC/proj directory and type "runmc" to start the graphical user interface (JRunMC), i.e. just type "runmc" (or "jrunmc")

In case of installation problems

This could happen if the static CLHEP library (extention *.a) or ROOT libraries are not properly installed

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