The FRS-R3B directory within R3BRoot contains the software for the FRS (Fragment Separator) detectors that are utilized in the FRS-R3B experiments. The FRS is a pivotal instrument for investigating nuclear reactions with relativistic radioactive beams, enabling high-precision studies of exotic nuclei and nuclear structure at the limits of stability. This software is built upon the FairRoot framework, which provides the tools necessary for both Monte Carlo simulations and data analysis of experimental results. The R3B experimental program is part of the broader nuclear physics research efforts at the FAIR (Facility for Antiproton and Ion Research), a cutting-edge international research facility that utilizes heavy-ion and antiproton beams to explore fundamental questions in nuclear physics, with a particular focus on the production and behavior of rare isotopes under extreme conditions. The FRS-R3B software package is a source distribution with recurring releases for macOS and Linux.
FRS is distributed under the terms of the GNU Lesser General Public Licence version 3 (GPLv3).
For the software-related user support you can post a new topic on our forum.
Please see releases
git clone dev https://github.com/R3BRootGroup/frs.git
cd frsFirst, you will need to install FairSoft, FairRoot and R3BRoot. For more details:
Checkout the most recent version of ucesb from the git repository:
git clone http://fy.chalmers.se/~f96hajo/ucesb/ucesb.gitAnd also checkout the git repository with experiment unpackers:
git clone https://github.com/jose-luis-rs/frsexp.gitCheck that
which rootpoints to your FAIRROOT installation directory!
Compile the empty ucesb unpacker using the same version of ROOT as you used for FAIRROOT.
make empty/emptyAfter compilation finished, make sure that the file
hbook/ext_data_clnt.oexists. Set the environment variable UCESB_DIR to the 'unpacker' directory, e.g.
export UCESB_DIR=/u/$USER/path/to/unpackerPut this in your .bashrc to make it permanent. R3BRoot will look for ucesb at this location.
Compile then your experiment specific unpacker (also use the same ROOT version here).
cd frsexp/name_of_experiment
make -j8export SIMPATH=%PATH_TO_FAIRSOFT%
export FAIRROOTPATH=%PATH_TO_FAIRROOT%
git clone dev https://github.com/R3BRootGroup/R3BRoot.git
cd R3BRoot
git clone dev https://github.com/R3BRootGroup/macros.git
git clone dev https://github.com/R3BRootGroup/frs.git
cd ..
mkdir build
cd build
cmake ../R3BRoot/
. config.sh
make -j8Data analysis is included inside the frs directory, where you can find the next subdirectories:
This directory contains all the classes for the different data levels of the detectors: mapped, cal, hit and analysis.
This directory contains all the readers needed to analize the data obained from the FRS detectors.
This directory contains all the classes for the mapping, calibration, and hit reconstructions of physical events as well as some classes for the analysis of the FRS experiments (S0 to S4). The identification from S0 to S8 is ongoing!
This contains all the macros needed for the unpacking and analysis of data.