InstallOnUbuntu18

Back to Installation guides

Installation of ANTS2 on Ubuntu 18.04 (Bionic Beaver) is a fairly straightforward process. The dependencies are either installed from repositories (Qt, Eigen3, FLANN, FANN, QtPython) or by unpacking from a single tarball (ROOT). The following instructions should also work for other distros based on 18.04, including Mint 19

Configuration

Base system

Ubuntu 18.04.1 LTS x86-64 (64-bit)
Qt 5.9.5
ROOT 6.14.04
ANTS2 from Dev branch

Optional

FLANN (kNN reconstruction and filtering)
FANN (Neural networks)
QtPython (Python 3 scripying)

Coming soon

CUDA
NCrystal (neutron simulation package)

Walkthrough for the base system install

In the following text

lines like this one

indicate commands to be entered in a terminal

First update your system. Either from a terminal

sudo apt update

or using Software updater application

Install necessary development tools and libraries

sudo apt install git wget build-essential # set up development environment
sudo apt install qt5-default libqt5websockets5-dev qtscript5-dev # install Qt5 libraries 
sudo apt install libeigen3-dev libtbb-dev x11-apps libgl2ps-dev # install libraries required for ANTS2 compilation

Install ROOT

Download ROOT 6.14.04 binary for Ubuntu 18 gcc7.3 from this page or from direct link
Unpack it to /opt/root
Add line . /opt/root/bin/thisroot.sh to ~/.profile
Restart desktop environment (log out and log back in)

Install ANTS2

Clone the development branch (more recent, potentially less stable):

git clone -b Dev https://github.com/andrmor/ANTS2.git

or the master branch (older but more stable):

git clone -b master https://github.com/andrmor/ANTS2.git

Now configure and compile ANTS2. From the same folder where you run git clone do:

cd ANTS2
mkdir build
cd build
make clean
qmake ../src/ants2.pro
make

Running ANTS2

To function correctly, ANTS2 should be started from its build folder created in the previous step.

cd <build folder>
./ants2

Installing optional packages

sudo apt install libflann-dev # FLANN
sudo apt install libfann-dev liblz4-dev # FANN
sudo apt install python3-dev libpythonqt-qt5-python3-dev # Python scripting

Now from the ANTS2 build folder

make clean
qmake "CONFIG += ants2_docker" ../src/ants2.pro
make