In this tutorial you will learn how to install UsTK from source on Linux Fedora. These steps have been tested with Fedora 26 (64 bit) distribution, but should work with any other distribution as well.
To build and install UsTK there are two ways:
Build UsTK using installation script
Get the sources
First, create a workspace in $HOME/ustk-ws that will contain UsTK and ViSP sources, build and dataset:
$ export USTK_WS=$HOME/ustk-ws
$ mkdir -p $USTK_WS
Prior to build and install UsTK, you have to download the sources. To achieve this, run the following command:
Git will clone the UsTK source code in $USTK_WS/ustk folder.
Run installation script
Then you can run the installation script for fedora:
$ sh $USTK_WS/ustk/script/install-fedora.sh
This will download all third-parties and build the library (it will take some time). You will have to enter your password to install required packages, and confirm a few questions during the process.
Once build, you may now Build UsTK documentation.
Build UsTK using command line
We give hereafter all the instructions to build UsTK from source.
Install third-parties
UsTK has optional third-parties that you can install running:
- XML2: XML2 library is used by UsTK for I/O (ultrasound image or sequence of images settings). This 3rd party could be installed from existing packages.
$ sudo yum install libxml2-devel
- VTK with Qt4 or Qt5 support: VTK library is used by UsTK for visualization (GUI). This 3rd party could be installed from existing pre-build packages.
$ sudo yum install vtk-devel vtk-qt
- FFTW: FFTW library is used by RF to pre-scan converters. This 3rd party could be installed from existing pre-build packages.
- armadillo: armadillo library is used for elastography. This 3rd party could be installed from existing pre-build packages.
$ sudo yum install armadillo-devel
Build UsTK
- First, create a workspace in $HOME/ustk-ws that will contain UsTK and ViSP sources, build and dataset:
$ export USTK_WS=$HOME/ustk-ws
$ mkdir -p $USTK_WS
- Download ViSP and UsTK sources codes
$ git clone https:
$ git clone https:
- Make a build directory (where UsTK and ViSP will be compiled together)
$ mkdir $USTK_WS/ustk-build; cd $USTK_WS/ustk-build
- Configure the build setting UsTK as a ViSP external contrib module
$ cmake ../visp -DVISP_CONTRIB_MODULES_PATH=$USTK_WS/ustk
- Note that with the previous command, all ViSP modules will be build besides UsTK. Since ViSP modules related to AR, detection, computer vision or tracking are not used by UsTK, their build could be turned off in order to speed up UsTK build. This could be achieved using:
$ cmake ../visp -DVISP_CONTRIB_MODULES_PATH=$USTK_WS/ustk -DBUILD_MODULE_visp_ar=OFF -DBUILD_MODULE_visp_blob=OFF -DBUILD_MODULE_visp_detection=OFF -DBUILD_MODULE_visp_klt=OFF -DBUILD_MODULE_visp_mbt=OFF -DBUILD_MODULE_visp_me=OFF -DBUILD_MODULE_visp_tt=OFF -DBUILD_MODULE_visp_tt_mi=OFF -DBUILD_MODULE_visp_vision=OFF -DBUILD_MODULE_visp_visual_features=OFF -DBUILD_MODULE_visp_vs=OFF
- Now on unix-like OS build ViSP and UsTK using:
How to install UsTK dataset
Some examples or tutorials are working with ultrasound medical images. We propose a dataset that contains 2D or 3D ultrasound data in https://github.com/lagadic/ustk-dataset. To use this dataset you may set the USTK_DATASET_PATH environment variable like:
$ git clone https:
$ export USTK_DATASET_PATH=$USTK_WS/ustk-dataset
Build UsTK documentation
To build UsTK documentation as a stand alone documentation (i.e.. without all ViSP classes prefixed by "vp"):
$ cd $USTK_WS/ustk-build
$ make -j4 ustk_doc
Install UsTK
We don't recommend to install UsTK in /usr/local. If you want to do the installation anywa, run:
$ cd $USTK_WS/ustk-build
$ make -j4 install
Uninstall UsTK
To uninstall UsTK, run:
$ cd $USTK_WS/ustk-build
$ make -j4 uninstall
1.9.1