Skip to content

Download and install

Download and Installation#

Prerequisites#

Operating systems#

Linux (Ubuntu, Scientific Linux, CentOS, Debian, ...) and MacOS X operating systems are supported. No support for Windows.

Basic software#

You will need :

Getting the sources#

The different softwares developped for the AGATA collaboration can be installed using a python script. The first step is to insall this script:

mkdir gammaSoftware
cd gammaSoftware
git clone https://gitlab.in2p3.fr/IPNL_GAMMA/scripts.git

The way to use this script is the following:

python3 scripts/gRaySoftware.py --cmake="OPTIONS" --soft=branch mode

where:

  • "OPTION" are cmake options, like "-- -jN" to compile with N threads
  • branch is the branch name that needs to be use (if not specified, the production branch is used)
  • mode represents the configuration steps that we want to use in:
    • load: download package (equivalent to the cmake step)
    • conf: configuration of the package (equivalent to the cmake step)
    • compile: compilation of the package (equivalent to cmake --build.)
    • install: installation of the package (equivalent to the cmake --build. --target install)
    • all: combination of the three above steps

ADF#

python3 scripts/gRaySoftware.py --adf= load conf
python3 scripts/gRaySoftware.py --cmake=" -- -j8" --adf= compile install

Prisma (needed for the LNL campaign)#

python3 scripts/gRaySoftware.py --prisma= load conf
python3 scripts/gRaySoftware.py --cmake=" -- -j8" --prisma= compile install

AGAPRO (including FEMUL)#

  • Prerequisites: ADF (ROOT if TreeBuilder needed)
python3 scripts/gRaySoftware.py --agapro= load conf
python3 scripts/gRaySoftware.py --cmake=" -- -j8" --agapro= compile install

Sourcing the environment#

To load the global environment variables, use the command (this can be added to the .bashrc):

source scripts/add2path.sh ${PWD} /lib /bin
export ADF_CONF_PATH=${PWD}/agapro/femul

If all went successfully, you should have the following outuput, using the femul -k command

...
************************************************************
************************  CONSUMERS  ***********************
************************************************************


KEYWORDS ACCEPTED BY TreeBuilder
ActualClass       str          name of daughter class
SaveDataDir       str str str  Save root file dir (SaveDir, NamePatern, TreeName)
MergerMode        bool         If the EventMerger is used (first trigger will be done on event:data frames)
AddDetector       str str i32  Add a detector in the Tree (DetName, ADF key, Mode [-1: Must NOT be present, 0: Can be present, 1: Must be present]), accepted detectors: AGATA_PSA,AGATA_BUILDER, AGATA_TRACKING, NEDA, DIAMANT, VAMOS, PRISMA, SPIDER, EUCLIDES, DANTE, LABR
InputInGlobFrame  bool         To set if the input data are aloready in the global frame
MaxNbTrackHits    i32          Max number of tracked hits to be stored, default 2
MaxRootFileSize   ui32         Max size in MB of the root file before a split

KEYWORDS ACCEPTED BY TB_PRISMA
ConfPath          str   Path to Prisma configuration files
LUTFile           str   LUT file name (default is : lutPRISMA.txt)
ManagerFile       str   Manager file name (default is : manager.conf)
WriteRawTree      bool  Store the raw data in the output Tree (default 1)
WriteAnaTree      bool  Store the analyzed data in the output Tree (default 1)
DoPrismaAnalysis  bool  Ignore the input analyzed data (if present) and process the prisma lib on the raw data (default 0)
Verbose           bool  Print warnings in the processing