Linux instructions

These instructions are for building FAST on Ubuntu 18.04. If you only want to test and use FAST, please download a release instead.

Install dependencies

1. First, make sure you have all the tools necessary to download and compile the code:

sudo apt install cmake g++ git
sudo apt install '^libxcb.*-dev' libx11-xcb-dev libglu1-mesa-dev libxrender-dev libxi-dev libxkbcommon-dev libxkbcommon-x11-dev

2. Install OpenCL. Depending on which GPU/CPU you have and want to use install: NVIDIA CUDA Toolkit or AMD APP SDK or Intel OpenCL SDK.

3. FAST will download and build all other dependencies (Qt5, eigen, zlib, DCMTK) automatically. In order to get movie streaming to work with Qt, you need to install the following libraries:

sudo apt install libgstreamer1.0-dev libgstreamer-plugins-bad1.0-dev libgstreamer-plugins-base1.0-dev libgstreamer-plugins-good1.0-dev # Needed for movie streaming

By default, the WSI and realsense modules are enabled by default, these require the following packages:

sudo apt install libopenslide-dev # Needed for WSI module
sudo apt install pkgconf libusb-1.0 # Needed for realsense

Compile

Important: Don't put the FAST code in a path with spaces, this will currently break the build

git clone https://github.com/smistad/FAST.git
cd FAST
mkdir build
cd build
cmake ..
make -j8

Troubleshoot

When you run cmake, the system may not find the OpenCL library, and you have to set it manually using cmake (e.g. cmake .. -DOpenCL_LIBRARY=/path/to/libOpenCL.so). The library is usually located in /usr/local/cuda/lib64/ for NVIDIA and /opt/amd-gpupro/lib/x864-linux-gnu/ if you use the AMD GPUPRO driver.

If you get the error saying something like "qfontengine_ft_p.h:56:22: fatal error: ft2build.h: No such file or directory" you have to install the fontconfig library "libfontconfig1-dev".

If you get an error like "ERROR: Feature 'xcb' was enabled, but the pre-condition 'features.thread && features.xkbcommon && libs.xcb' failed." This means you forgot to install the xcb an xkb libraries needed:

sudo apt install '^libxcb.*-dev' libx11-xcb-dev libglu1-mesa-dev libxrender-dev libxi-dev libxkbcommon-dev 

Note that you for some reason have to delete the folder build_folder/external/qt5/ and rebuild qt5 for this to take effect.

Running the tests

Next, you should run the tests to make sure the framework is working properly on your system. Instructions on how to do this can be found here.