Please refer to Intel(R) oneAPI installation guide: https://software.intel.com/content/www/us/en/develop/articles/installation-guide-for-intel-oneapi-toolkits.html

OS: Ubuntu 18.04 or Ubuntu 20.04

Hardware: Intel CPU with Gen9 or Intel Tigerlake Iris Xe GPU.

This project was tested on Intel(R) i7-8700K CPU with Intel(R) UHD Graphics 630 , please refer https://ark.intel.com/content/www/us/en/ark/products/126684/intel-core-i7-8700k-processor-12m-cache-up-to-4-70-ghz.html

This project was tested on Intel(R) i7-1185G7E CPU with Intel(R) Iris Xe GPU, please refer https://ark.intel.com/content/www/us/en/ark/products/208076/intel-core-i7-1185g7e-processor-12m-cache-up-to-4-40-ghz.html

The patch 0001-* describes the Intel(R) DPC++ Compatibility Tool migrates CUDA file to DPC++ file. Apply patch 0001-*, you will see a oneapi/ folder which contains migrated DPC++ files and related header files.
The patch 0002-* describes modification to the DPC++ files. Apply patch 0001-* and 0002-*, you can build and run SUPRA successfully.
The patch 0003-* describes optimization to BeamformingNode and HilbertEnvelopeNode. Apply patch 0003-*, the BeamformingNode and HilbertEnvelopeNode performance will improve.
The patch 0004-* do code clean, using sycl in file name and variable name.

There are 2 ways you can build and run our project. the jupyter notebook provides simple and quick method to enable SUPRA. if you want to know complete build process, you can follow the Linux terminal method to compile and run, which also won't take too long.

Clone this repo to your local machine, go to supra-jupyter/ folder, launch your jupyter notebook and open supra-jupyter.ipynb in your jupyter notebook. Follow the hints, you will enable SUPRA with just few clicks.

Install 3rd libraries in your machine:

apt-get install cmake cmake-gui qt5-default libtbb-dev libopenigtlink-dev git

Download this repo to your machine:

git clone https://github.com/intel/supra-on-oneapi.git

Download SUPRA form github:

git clone https://github.com/IFL-CAMP/supra.git

Enter supra folder:

cd supra

Check supra commit log:

git log

Find this commit message:

Reset the supra commit HEAD, use

git reset --hard 73c930a08a7b1087f5be588863876a648a1add99

Apply patches to SUPRA:

git am ../supra-on-oneapi/*.patch

Build and Run supra demo, in supra directory:

mkdir build

cd build

Setup eviroment:

source /opt/intel/oneapi/setvars.sh

For Intel(R) oneAPI Base Toolkit beta07 version, you need change the $PATH, follow this two steps:

echo $PATH

it will print:

copy the whole PATH value except the contents in Red Rectangle.

Reset PATH variable value with before copied content use this command:

export PATH=

it should like this:

(use your machine to print PATH content, don't copy from here)

Configure project:

CC=clang CXX=dpcpp CXXFLAGS="-L${TBBROOT}/lib/intel64/gcc4.8" cmake ..

Build:

make -j4

Download sample data, in build directory create data folder:

mkdir data

cd data

wget http://campar.in.tum.de/files/goeblr/mockData_linearProbe.zip

unzip the sample data:

unzip mockData_linearProbe.zip

Copy config file to data folder:

cp ../../config/configDemo.xml .

Run the SUPRA GUI, in build folder:

src/GraphicInterface/SUPRA_GUI -c data/configDemo.xml -a

the SUPRA GUI show like this:

Check the performance, open supra.log in the build directory:

cat supra.log

it will show every node performance performance in Millisecond.