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
   export FAIRSHIPRUN=$SHIPSOFT/FairShipRun

   or for the csh:

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

3. Install FairSoft

   mkdir $SHIPSOFT
   cd $SHIPSOFT
   git clone -b dev https://github.com/ShipSoft/FairSoft.git
   cd FairSoft
   cat DEPENDENCIES
   # Make sure all the required dependencies are installed
   # On SLC6 do: export FC=gfortran
   ./configure.sh
   # 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 -DCMAKE_BUILD_TYPE=RELEASE
   ( 
    on some platforms eventually use: 
    cmake .. -DCMAKE_INSTALL_PREFIX=$FAIRROOTPATH -DCMAKE_BUILD_TYPE=RELEASE -DUSE_DIFFERENT_COMPILER=TRUE
   )
   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
   ( 
    on some platforms eventually use: 
    cmake ../FairShip -DUSE_DIFFERENT_COMPILER=TRUE
   )
   make
   . config.sh    [or source config.csh]

6. Now you can for example simulate some events, run reconstruction and analysis:

   python $FAIRSHIP/macro/run_simScript.py --display
   >> Macro finished succesfully.
   >> Output file is  ship.10.0.Pythia8-TGeant4_D.root
   
   python $FAIRSHIP/macro/ShipReco.py -f ship.10.0.Pythia8-TGeant4_D.root 
   >> finishing pyExit
   
   python $FAIRSHIP/macro/ShipAna.py -f ship.10.0.Pythia8-TGeant4_D_rec.root
   >> finished making plots

   Run the event 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

7. Retrieving tagged versions:

   mkdir $SHIPSOFT/v1
   cd $SHIPSOFT/v1
   git clone -b dev https://github.com/ShipSoft/FairSoft.git
   cd $SHIPSOFT/v1/FairSoft
   git checkout -b v1-00 v1-00
   // installation procedure as above
   cd $SHIPSOFT/v1
   git clone -b dev https://github.com/ShipSoft/FairRoot.git
   cd $SHIPSOFT/v1/FairRoot
   git checkout -b v1-00 v1-00
   // installation procedure as above
   cd $SHIPSOFT/v1
   git clone https://github.com/ShipSoft/FairShip.git
   cd FairShip
   git checkout -b v1-00 v1-00
   // installation procedure as above