Skip to content

Installation

Jump to bottom
Liam P. Gaffney edited this page Jan 25, 2024 · 2 revisions

Pre-requisites

ISSSort is designed to run on UNIX operating systems and has been tested on many flavours of Linux (Ubuntu, CentOS, AlmaLinux, RHEL, Debian) and a wide variety of macOS versions (from 10.14 up to 14.3). Windows is not currently supported.

You must have a working version of ROOT v5 or v6. The compiler used to build ROOT must support C++14 standard as a minimum. GCC (v6+) and Clang (v5+) have been tested, but other compilers may well work. ROOT must be built with GSL library support, otherwise known as MathMore. To check this is true, you can type: root-config --has-mathmore and hope the response is yes. If it isn't, you will need to install the GSL libraries and reconfigure/rebuild ROOT.

If you identify any issues with the compatibility to different ROOT versions or operating systems, please raise an issue on the GitHub page.

Download

git clone https://github.com/ISOLDESolenoidalSpectrometer/ISSSort

Compile

cd ISSSort
make clean
make

Execute

iss_sort

if you add the ISSSort/bin to your PATH variable. You can also add ISSSort/lib to your (DY)LD_LIBRARY_PATH too.

or

./bin/iss_sort

If you start the code without any flags, it will launch the GUI. To run in batch mode, simple pass at least one file to the programme with the -i flag.

The input options are described below.

use iss_sort with following flags:
        [-i           <vector<string>>: List of input files]
        [-o           <string        >: Output file for histogram file]
        [-s           <string        >: Settings file]
        [-c           <string        >: Calibration file]
        [-r           <string        >: Reaction file]
        [-nptool                      : Flag for NPTool simulation input]
        [-pace4                       : Flag for PACE4 particle input]
        [-f                           : Flag to force new ROOT conversion]
        [-e                           : Flag to force new event builder (new calibration)]
        [-source                      : Flag to define an source only run]
        [-autocal                     : Flag to perform automatic calibration of alpha source data]
        [-autocalfile <string        >: Alpha source fit control file]
        [-spy                         : Flag to run the DataSpy]
        [-m           <int           >: Monitor input file every X seconds]
        [-p           <int           >: Port number for web server (default 8030)]
        [-d           <string        >: Output directory for sorted files]
        [-g                           : Launch the GUI]
        [-h                           : Print this help]

Clone this wiki locally