Installation

AZURE2 requires several external packages. The program is built using the CMake toolkit and the graphical interface is written using the Qt framework.

Dependencies

Required:

Optional:

  • Qt5 – graphical user interface framework

  • QWT – plotting library for the built-in Plot tab (libqwt-qt5-dev, libqt5svg5-dev)

  • Readline – enhanced command-line input

Building from Source

  1. Unpack the AZURE2 archive in your directory of choice:

    tar zxvf azure2_v1.tar.gz
    
  2. Create a build directory:

    cd AZURE2
    mkdir build
    cd build
    
  3. Run CMake to generate the Makefile:

    cmake ..
    
  4. Build and install:

    make && make install
    

CMake Options

The following options can be passed to CMake using -D[OPTION]=[VALUE]:

Option

Default

Description

BUILD_GUI

ON

Build the graphical setup utility (recommended)

USE_QWT

OFF

Enable built-in plotting tab (requires QWT libraries)

USE_STAT

ON

Use stat() function for directory checking (disable for Windows)

USE_READLINE

ON

Enable readline library for CLI input

BUILD_LIBRARY

OFF

Build as a library instead of an executable

CODE_COVERAGE

ON

Enable coverage reporting

MINUIT_PATH

(auto)

Custom path for Minuit2 libraries

GSL_PATH

(auto)

Custom path for GSL libraries

Example with QWT plotting enabled:

cmake .. -DUSE_QWT=ON

Docker

AZURE2 supports Docker containerization for easy deployment:

# Build Docker container
source scripts/build.sh

# Run GUI container
source scripts/run_gui.sh

For HPC environments, the Docker image can be converted to Singularity/Apptainer:

sudo apptainer build AZURE2.sif docker-daemon://azure2:latest