Skip to content

Latest commit

 

History

History
117 lines (85 loc) · 4.65 KB

README.md

File metadata and controls

117 lines (85 loc) · 4.65 KB
Raw

FRS-R3B Software license DOI

static analysis CI-CD

The FRS-R3B Framework

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.

License

FRS is distributed under the terms of the GNU Lesser General Public Licence version 3 (GPLv3).

Discussion Forum

For the software-related user support you can post a new topic on our forum.

Release Information

Please see releases

Download

git clone dev https://github.com/R3BRootGroup/frs.git
cd frs

Step by Step Installation

Required Softwares

First, you will need to install FairSoft, FairRoot and R3BRoot. For more details:

  1. Install FairSoft

  2. Install FairRoot

  3. Install R3BRoot

Installation of UCESB

Checkout the most recent version of ucesb from the git repository:

git clone http://fy.chalmers.se/~f96hajo/ucesb/ucesb.git

And also checkout the git repository with experiment unpackers:

git clone https://github.com/jose-luis-rs/frsexp.git

Check that

which root

points to your FAIRROOT installation directory!

Compile the empty ucesb unpacker using the same version of ROOT as you used for FAIRROOT.

make empty/empty

After compilation finished, make sure that the file

hbook/ext_data_clnt.o

exists. Set the environment variable UCESB_DIR to the 'unpacker' directory, e.g.

export UCESB_DIR=/u/$USER/path/to/unpacker

Put 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 -j8

Installation of FRS as part of R3BRoot

export 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 -j8

Data Analysis

Data analysis is included inside the frs directory, where you can find the next subdirectories:

frsdata

This directory contains all the classes for the different data levels of the detectors: mapped, cal, hit and analysis.

frssource

This directory contains all the readers needed to analize the data obained from the FRS detectors.

frsdetectors

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!

macros

This contains all the macros needed for the unpacking and analysis of data.

More Information