R3BRoot Installation

Distribution

R3BRoot can be obtained from the central git repository. To clone it from GitHub:


Refer also to the Update page in order to keep your working copy up-to-date.


Installation procedure

Linking with UCESB (optional)

In case you want to run R3BRoot as analysis tool in combination with UCESB, you need to set UCESB_DIR environment variable (prior to execution of cmake in next section):

export UCESB_DIR=PATH_TO_UCESB_DIRECTORY


If the configuration was successful, you should see following string in the cmake output:
"-- Looking for ucesb... - found ucesb".
For details on how to obtain and install UCESB, you can refer to this readme.

On GSI Linux computer (with access to /cvmfs directory)

Two versions of Debian Linux are officially supported: wheezy and jessie. In order to find out the version of operating system on machine you are currently logged in, run following and inspect output:

lsb_release -a

Debian 8 jessie

After checking out the source code from git (do NOT enter the new R3BRoot directory created by the git clone):

  1. mkdir build
  2. cd build
  3. export SIMPATH=/cvmfs/fairroot.gsi.de/fairsoft/mar17_root6
  4. export FAIRROOTPATH=/cvmfs/fairroot.gsi.de/fairroot/v-17.03_fairsoft-mar17_root6
  5. cmake ../R3BRoot
  6. make

Note: Do an 'ls /cvmfs/fairroot.gsi.de/fairsoft/' and 'ls /cvmfs/fairroot.gsi.de/fairroot/' to find the latest versions and use these.

It is strongly recommended to use FairSoft build with ROOT version 6. Support for old version 5 will be dropped soon.


Debian 7 wheezy

First, you will need to load newer version of the gcc compiler:

module use /cvmfs/it.gsi.de/modulefiles/
module load compiler/gcc/4.8.4
export CC=gcc
export CXX=g++


After checking out the source code from git (do NOT enter the new R3BRoot directory created by the git clone):

  1. mkdir build
  2. cd build
  3. export SIMPATH=/cvmfs/fairroot.gsi.de/gcc_4.8.4/fairsoft/may16_root6
  4. export FAIRROOTPATH=/cvmfs/fairroot.gsi.de/gcc_4.8.4/fairroot/v-16.06a_fairsoft-may16_root6
  5. cmake -DUSE_PATH_INFO=true ../R3BRoot
  6. make

Note: Do an 'ls /cvmfs/fairroot.gsi.de/gcc_4.8.4/fairsoft/' and 'ls /cvmfs/fairroot.gsi.de/gcc_4.8.4/fairroot/' to find the latest versions and use these.

It is strongly recommended to use FairSoft build with ROOT version 6. Support for old version 5 will be dropped soon.


External computer

After installing FairSoft and FairRoot, and checking out the source code from svn, following steps are needed to compile R3BRoot:

  1. mkdir build
  2. cd build
  3. export SIMPATH=YOUR_PREFIX/FairSoft/build-FAIRSOFT_VERSION
  4. export FAIRROOTPATH=YOU_PREFIX/FairRoot/install-FAIRROOT_VERSION
  5. cmake ../R3BRoot
  6. make


Login script

In order to run the simulation / analysis macros of R3BRoot, each Terminal session has to be configured by running the script from the build directory:

cd YOUR_PREFIX/build
. ./config.sh


This will automatically check, whether the same system version was used during the compilation and execution and will set all necessary environment variables.