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. If you will use JAVA-based GUI (command "jrunmc"), you should have JAVA virtual machine installed (check "java -version": you should see the version of java VM installed). If you will use C++ GUI (command "runmc"), you do not need to install anything. However, you may install Source-Navigator (this is an optional package which is normally included to most linux PC's, test this by typing "snavigator"). The RunMC will be functional without it.

    Then download the current version of the RUNMC (version 3.3.1)
    This file also includes RMC modules.

    How to compile the RunMC package:

  • gunzip runmc<version>.tar.gz, where <version> specifies the current version (v3.3 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 PATH and $RUNMC/main/ws/lib to LD_LIBRARY_PATH.


This can be done in .bashrc file:

sh family:

export RUNMC=<path>/RunMC
export PATH=$RUNMC/bin:$PATH
export LD_LIBRARY_PATH=$RUNMC/main/ws/lib:$LD_LIBRARY_PATH

csh family:
setenv RUNMC <path>/RunMC
setenv PATH ${RUNMC}/bin:${PATH}
setenv LD_LIBRARY_PATH ${RUNMC}/main/ws/lib:${LD_LIBRARY_PATH}

rehash

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

Type “echo $RUNMC” , to be sure that you set this variable properly. Also, it is 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 GUI-related files, do "make cleangui"; To remove Monte-Carlo-related files, type "make cleanmc"

  • Go to the $RUNMC/proj directory and type "runmc" to start the GUI user interface. As long as you set $RUNMC, you can execute "runmc" (or "jrunmc") from any directory.

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

How to install RunMC under Windows:

Read the instruction on this web page

S.Chekanov chekanov@mail.desy.de