SIDSRoot

Single Ion Decay Spectroscopy package for the online/offline data analysis of the SIDS experiments.

Step by Step installation

1. Install FairSoft

   we use here "fair_install" as a directory name, you can use what you went!

   mkdir ~/fair_install
   cd ~/fair_install
   #git clone https://github.com/FairRootGroup/FairSoft.git
   git clone -b dev https://github.com/FairRootGroup/FairSoft.git
   cd FairSoft
   ./configure.sh
   # 1) gcc (on Linux) 5) Clang (on OSX)
   # 1) No Debug Info
   # 2) Internet (install G4 files from internet)
   # path: ~/fair_install/FairSoftInst

Or alternatively (e.g. on the PCs used for the SIDS experiments) if you have access to /cvmfs/ use the fairsoft installation at /cvmfs/fairroot.gsi.de/fairsoft/jul14p2

2. Install FairRoot

   # Set the shell variable SIMPATH to the installation directory
   export SIMPATH=~/fair_install/FairSoftInst
   [setenv SIMPATH ~/fair_install/FairSoftInst]
    (or export SIMPATH=/cvmfs/fairroot.gsi.de/fairsoft/jul14p2)
   
   cd ~/fair_install
   git clone -b dev https://github.com/FairRootGroup/FairRoot.git
   cd FairRoot
   mkdir build
   cd build
   cmake -DCMAKE_CXX_FLAGS="c++11FLAG" -DCMAKE_INSTALL_PREFIX="~/fair_install/FairRootInst" ..
   # where c++11FLAG depends on the compiler e.g. 
   #-std=gnu++0x 
   # or -std=c++11 or -std=gnu++11 for GCC 4.7 and later.
   # for CLANG on mac OS X use the flag -std=c++11 -stdlib=libc++
   make
   make install

   To run the tests do:

   # To run test: make new shell, do not define SIMPATH
   cd ~/fair_install/FairRoot/build
   make test

3. Install optionally BAT and Cuba libraries.

These libraries are required to enable the Bayesian analyses. Follow the installation instructions found on the BAT and Cuba webpages and install the libraries in standard locations via make install. (for now the cmake find modules for BAT and Cuba are searching the libraries in the following paths: /usr/local/lib /usr/local/include/BAT /opt/local/lib /opt/local/include/BAT).

4. Install SIDSRoot

Set the shell variable FAIRROOTPATH to the FairRoot installation directory. e.g. :

export FAIRROOTPATH=~/fair_install/FairRootInst
[setenv FAIRROOTPATH ~/fair_install/FairRootInst]

choose the location of the installation e.g. :

cd ~/fair_install
mkdir exp
git clone https://github.com/NicolasWinckler/SIDSRoot.git
cd SIDSRoot
mkdir build
cd build
cmake -DCMAKE_CXX_FLAGS="c++11FLAG" ..
# where c++11FLAG depends on the compiler e.g. 
#-std=gnu++0x 
# or -std=c++11 or -std=gnu++11 for GCC 4.7 and later.
# for CLANG on mac OS X use the flag -std=c++11 -stdlib=libc++
make
# or e.g. make -jn for n cores
. config.sh    
# or source config.csh

Using the GUI for the SIDS experiment

By default the script for the visual analysis is found in :

/path/to/SIDSRoot/build/bin/startVisualAnalysis.sh

Copy this file in the directory in which you want to do the analysis, and then do:

./startVisualAnalysis.sh UserName InputFile

By default the output file of the analysis is found :

/path/to/SIDSRoot/AnalysisOutput/Osc/Online/VisualAnalysis/SIDSDecayData.root

During experiment, we want the outputfile on hera, therefore the outputFile field in the script has to be modified to e.g. :

outputFile="/SAT/hera/sids/decayresults/SIDSDecayData.root"

Other parameter of interest:

  binDistancePDfreq="52"    # distance in bin between parent and daughter freq
  binPWindow="10"           # half projection window (parent)
  binDWindow="10"           # half projection window (daughter)
  binningTraces="20"        # Rebinning of parent and daughter traces
  binningFreq2dHisto="2"    # Rebinning w.r.t freq of the 2D histogram
  binSigmaPeak="4.0"        # sigma (in bin) of peaks
  thresholdPeak="0.2"       # threshold for peak detection
  detectorID="RSA51"        # "RSA51", "RSA52", or "RSA30"

The rest of the parameters should not be changed

Todo list