Linux instructions

This is tested on Ubuntu 16.04. If you have any issues, please report it here.

Install dependencies

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

sudo apt-get install cmake g++ git

2. Install OpenCL. This is done by downloading the latest display drivers: (https://www.amd.com/en/support) (if you have a AMD GPU) or CUDA Toolkit (if you have an NVIDIA GPU).

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
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".

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.