fuhlig1 / fairship

SHiP experiment framework based on FairRoot

FairShip is the software framework for the SHiP experiment which is based on FairRoot. To use this software you need to install three packages: FairSoft, FairRoot and FairShip. The first two pacakges are quite stable and you don't have to modify them. They will be updated infrequently only when the FairRoot team releases a new version. In such a case you will be warned and you have to rebuild them. All packages are managed in Git and GitHub. Please read the Git tutorial for SHiP first, even if you already know Git as it explains how development is done on GitHub.

Let get started:

1. In case you use SLC6 where the GitHub cert is missing, first do (only once):

   mkdir ~/certs
   curl http://curl.haxx.se/ca/cacert.pem -o ~/certs/cacert.pem
   git config --global http.sslcainfo ~/certs/cacert.pem

2. Set several required shell variables, needed during the installation and running of the different software packages. Put these in your shell's rc file (~/.bashrc or ~/.cshrc). For bash:

   export SHIPSOFT=~/ShipSoft
   export SIMPATH=$SHIPSOFT/FairSoftInst
   export FAIRROOTPATH=$SHIPSOFT/FairRootInst
   export FAIRSHIP=$SHIPSOFT/FairShip

   or for the csh:

   setenv SHIPSOFT ~/ShipSoft
   setenv SIMPATH ${SHIPSOFT}/FairSoftInst
   setenv FAIRROOTPATH ${SHIPSOFT}/FairRootInst
   setenv FAIRSHIP ${SHIPSOFT}/FairShip

3. Install FairSoft

   mkdir $SHIPSOFT
   cd $SHIPSOFT
   git clone -b dev https://github.com/ShipSoft/FairSoft.git
   cd FairSoft
   # On SLC6 do: export FC=gfortran
   ./configure.sh
   # 1) custom installation ...
   # 1) gcc (on Linux) 5) Clang (on OSX)
   # 3) Optimization
   # 1) Yes (install Simulation)
   # 2) Internet (install G4 files from internet)
   # 1) Yes (install python bindings)
   # path: $SHIPSOFT/FairSoftInst [$SIMPATH is set in script]

4. Install FairRoot

   cd $SHIPSOFT
   git clone -b dev https://github.com/ShipSoft/FairRoot.git
   cd FairRoot
   mkdir build
   cd build
   cmake -DCMAKE_INSTALL_PREFIX=$FAIRROOTPATH ..
   make
   make install

   To run the tests do:

   cd $SHIPSOFT/FairRoot/build
   make test

5. Install the SHIP software:

   cd $SHIPSOFT (or at any other place XXX, assuming environment variable FAIRSHIP set to XXX/FairShip
   git clone https://github.com/ShipSoft/FairShip.git
   mkdir FairShipRun
   cd FairShipRun
   cmake ../FairShip
   make
   . config.sh    [or source config.csh]

6. Now you can for example simulate some events and run the event display:

   python $FAIRSHIP/macro/run_simScript.py --display
   python -i $FAIRSHIP/macro/eventDisplay.py
   // Click on "FairEventManager" (in the top-left pane)
   // Click on the "Info" tab (on top of the bottom-left pane)
   // Increase the "Current Event" to >0 to see the events
   Use quit() or Ctrl-D (i.e. EOF) to exit