Skip to content

rat-pac/ratpac-two

Repository files navigation

Ratpac-two

Documentation Status

Build RatpacExperiment

clang-format Check

Build Docker Image

ratpac.readthedocs.io

Installation

Installation requires ROOT 6.25+, Geant4 11.0+, and cmake 3.22+

Install using cmake

$ cmake . -Bbuild
$ cmake --build build -- -j$(nproc)

If you want to install the code, just add

$ cmake --build build . --target install -j$(nproc)

A convenience Makefile exists to automate the above process.

Usage

Ratpac-two compiles as a library which can be extended for specific experiment use cases. The library can be accessed through CMake using find_package(Ratpac).

A stand-alone executable is included with the library that can be run on simple experimental geometries and test suites. The intent is for users to compile against the ratpac library, and any specific additions to the C++ framework should exist outside of the main repository.

About

Ratpac-two is a refactor of ratpac which makes the necessary changes to compile with modern versions of GCC and is compatible with the latest Geant4 and ROOT versions. This version of Ratpac is not backwards compatible with the previous version.

Ratpac is a simulation and analysis package built with GEANT4, ROOT, and C++, originally developed by S. Seibert for the Braidwood Collaboration. Versions of Ratpac are now being used and developed by several particle physics experiments.

Ratpac combines simulation and analysis into a single framework, which allows analysis code to trivially access the same detector geometry and physics parameters used in the detailed simulation.

Ratpac follows the "AMARA" principle: As Microphysical as Reasonably Achievable. Each and every photon is tracked through an arbitrarily detailed detector geometry, using standard GEANT4 or custom physics processes. PMTs are fully modeled, and detected photons may be propagated to a simulation of front-end electronics and DAQ.

This generic version is intended as a starting point for collaborations looking for an easy-to-learn, extensible detector simulation and analysis package that works out of the box. Once acquainted with Ratpac, it is easy to customize the geometry elements, physics details, data structure, analysis tools, etc., to suit your experiment's needs.