GET libraries compilation and OS environment

Operating system requirements

Only Linux OS are supported (currently, I could install the libraries on Scientific Linux, CentOS, Fedora, Ubuntu).

In order to build and use the GET library, the following libraries must be installed:

• Linux system libraries:
  • the ROOT / CERN package (environment variable ROOTSYS must be defined):
  • the Xerces-c library (check if environment variable XERCESCROOT exists and define XERCESC_INC and XERCESC_LIB environment variables) for XML configuration files parsing
• GANIL/GET libraries
  • the MFM library for Meta Frames (L. Legeard, GANIL)
    http://www.cenbg.in2p3.fr/AnalyseActar/GETdoc/MFM_15_10_22c/html/index.html
  • the TinyXML library (needed by MFM library)
• J.G. libraries (contact giovi.nosp@m.naz@.nosp@m.cenbg.nosp@m..in2.nosp@m.p3.fr): the environment variable SYSTEM must be defined for compilation identification (it is used for the following libraries - see specific documentations):
  • the GCpp library (C++ general purpose library)
    http://www.cenbg.in2p3.fr/AnalyseActar/JGlibs/GCpp

    Version

    /html/index.html

  • the GRootTools library (useful functions and classes to be used within ROOT environment - requires to define the ROOT_VERSION environment variable)
    http://www.cenbg.in2p3.fr/AnalyseActar/JGlibs/GRootTools6.0/html/index.html
  • (the GFFT library is now part of the GCpp and GRootTools libraries)
    For a full step-by-step installation of all packages, refer to the page GETFullInstallationGuide.txt.

All the required packages can be found there: Libraries download page

Warning

• only ROOT version up to 5.34 are supported
• scripts for compilation options and configuration defined only for csh / tcsh.

Before compilation, be sure the required libraries are properly installed and corresponding environment variables are defined.

After compilation, the configuration files for OS environment must be called (see below how to set configuration in the shell configuration script).

Extraction of the archive file in the required directory

The archive file must be extracted in the required directory, noted <base_dir>, in a shell:

*  [shell] cp <GETx.x>_<archive_date>.tgz <base_dir>
*  [shell] cd <base_dir>
*  [shell] tar zxvf <GETx.x>_<archive_date>.tgz
*  

A subdirectory <GETx.x> is created (where x.x is the library version).

Compilation of the main library

*  [shell] cd <base_dir>/<GETx.x>/src
*  [shell] make
*  

The compilation also creates shell scripts in order to easily get the options for compilation of programs with the library, and a shell script to define environment variables.

This shell configuration script may be called in the shell configuration script.

For csh / tcsh, add the following line (exact command is printed out at the end of compilation) to the $HOME/.cshrc file:

*  # define environment variables and scripts for use of GET library
*    source <base_dir>/<GETx.x>/bin/${SYSTEM}_r${ROOT_VERSION}/get_config.csh
*  

Compilation of the additional library for specific ROOT analysis

Before compiling the additional library for ROOT analysis, the shell must be updated to take into account the GET environment variables:

For csh / tcsh:

*  [shell] source $HOME/.cshrc
*  

Then compile the library

*  [shell] cd <base_dir>/<GETx.x>/root/src
*  [shell] make
*  

Here also, the configuration script should be added to the shell configuration file.

For csh / tcsh ($HOME/.cshrc file):

*  # define environment vfor use of GET additional library for ROOT
*    source <base_dir>/<GETx.x>/bin/${SYSTEM}_r${ROOT_VERSION}/get_root_config.csh
*  

Finally, the shell configuration must be updated:

*  [shell] source $HOME/.cshrc
*  

Compilation of the ACTAR TPC reader library and program

The Event Analysis library must be installed in order to compile the ACTAR TPC data reader class and program. Then, the library can be build from the GETActarEventReader class and the default program GETActarRead is compiled. The library is stored with the main GET library, and the program is stored in the GET library associated executable files (bin directory).

*  [shell] cd <base_dir>/<GETx.x>/tools/GETActarReader
*  [shell] make
*