AsyEOS Software

The AsyEOS Framework

The AsyEOS (Asymmetric-matter Equation-Of-State) directory within the R3BRoot framework provides the full detector definitions, Monte Carlo simulation tools, and digitization algorithms for the detectors used in the AsyEOS/R3B (Reactions with Relativistic Radioactive Beams) experimental campaign at the GSI/FAIR (Facility for Antiproton and Ion Research) facility. AsyEOS-R3BRoot, developed on top of the FairRoot framework, is a versatile toolkit for performing Monte Carlo simulations and processing experimental data to measure the flows of neutrons and light charged particles produced in Nucleus-Nucleus collisions in order to investigate symmetry energy of the nuclear equation of state at densities above the saturation one. The AsyEOS software package is a source distribution with recurring releases for macOS and Linux.

License

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

Release Information

Please see releases

Discussion Forum

For the software-related user support you can post a new topic on our forum or you could use the GitHub issues.

Contributing

Please ask your questions, request features, and report issues by creating a github issue.

Code Formatting

The AsyEOS project (as part of R3BRoot) uses clang-format-15 to ensure a common code formatting. The script "apply-format.sh" can be used for this purpose:

bash apply-format.sh

Step by Step Installation

Required Software

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

1. Install FairSoft, required version Nov22p1 or later

2. Install FairRoot, required version 18.2.1 or later

3. Install R3BRoot, required version jun24 or later

Installation of AsyEOS as part of R3BRoot

export SIMPATH=%PATH_TO_FAIRSOFT%
export FAIRROOTPATH=%PATH_TO_FAIRROOT%
git clone https://github.com/R3BRootGroup/R3BRoot.git
cd R3BRoot
git clone https://github.com/R3BRootGroup/macros.git
git clone https://github.com/R3BRootGroup/asyeos.git
cd ..
mkdir build
cd build
cmake ../R3BRoot/
. config.sh
make -j8

Some Details of the AsyEOS Setup

• Chimera: COMPLETE DESCRIPTION

• KRATA: COMPLETE DESCRIPTION

Simulations (ongoing work)

Some simulations will be included inside the asyeos directory. You can find the subdirectories:

geometry

This directory contains all the detector geometries generated from the macros located at ./asyeos/macros/geo. The existing geometries are:

asyeos/macros/

This directory contains the macros to simulate the asyeos experiment.

cd %BUILD_DIRECTORY_FOR_R3BROOT%
. ./config.sh
cd ./asyeos/macros/
root -l 
.L runsim.C
runsim(100)

where 100 is the number of events.

This will create an output file sim.root with the simulation results and a parameter file par.root with geometry and magnetic field parameters.

After the simulation :

1. To start an event display:

root -l eventDisplay.C

2. To perform a quick analysis with GUI :

root -l sim.root
[] evt->StartViewer();

After the simulation :

1. To start an event display :

root -l eventDisplay.C

2. To perform a quick analysis with GUI :

root -l sim.root
[] evt->StartViewer();

Data Analysis (ongoing work)

Data analysis is included inside the asyeos directory. You can find the subdirectories :

asyeosdata

This directory contains all the data TCloneArray structures for the different levels of the detection system.

asyeossource

This directory contains all the readers related to asyeos detectors :

• R3BChimeraReader for the Chimera detector

and UCESB data structures are located at asyeossource/ext :

• ext_h101_chimera.h

this allows to get data at mapped level (raw data of each detector).

chimera

This directory contains all the classes to analyse the single chimera data and move the raw data into cal and hit data levels.

asyeosonline

This directory contains all the online analysis classes to correlate the data collected by the AsyEOS detectors.

asyeosana

This directory contains all the analysis classes to correlate the data collected by the asyeos detectors.

macros/

This directory contains all the macros for online and offline analysis.

macros/online

This directory contains the online analysis macro. Execute it as:

root -b main_online.C

after defining the stream data server and the port number for data visualization.

macros/unpack

This directory contains the offline macros for the experiment analysis. There are two macros:

• unpack_offline.C for producing a root file with the mapped/raw data of all the detectors
• cal_offline.C for producing a root file with the cal and hit data levels of all the detectors

After defining the paths to the input files of each macro, one can execute it as follows:

1) If all the parameters are right by default
   root -l unpack_offline.C
2) If one wants to select a RunId, for instance 'RunId = 273'
   root -l 'unpack_offline.C(273)'
3) If one wants to select a RunId and max number of events, for instance 'RunId = 273' and 'nev = 200'
   root -l 'unpack_offline.C(273,200)'

or

1) If all the parameters are right by default
   root -l cal_offline.C
2) If one wants to select a RunId, for instance 'RunId = 273'
   root -l 'cal_offline.C(273)'
3) If one wants to select a RunId and max number of events, for instance 'RunId = 273' and 'nev = 200'
   root -l 'cal_offline.C(273,200)'

More Information

• Static analyzer using Clang-tidy
• CMake build system for R3BRoot/asyeos
• How to use an unmerged pull request