The tube segmentation framework is a software for fast segmentation and centerline extraction of tubular structures (e.g. blood vessels and airways) from different modalities (e.g. CT, MR and US) and organs using GPUs and OpenCL.
For details about the implementation see the following publication:
GPU accelerated segmentation and centerline extraction of tubular structures in medical images
Erik Smistad, Anne C. Elster and Frank Lindseth
International Journal of Computer Assisted Radiology and Surgery
2013
If you use this software in any publications, please cite our article.
See the file LICENSE for license information.
- OpenCL. You need an OpenCL implementation installed on your system to use this software (AMD, NVIDIA, Intel or Apple)
- Boost iostreams. E.g. on Ubuntu linux use the following package: libboost-iostreams-dev
- The two submodules: SIPL and OpenCLUtilities
- GTK 2 for visualization (not required, used by the SIPL module). On Ubuntu linux use the following package: libgtk2.0-dev
To compile the software first make sure that all software dependencies are installed and set up correctly. Next, use cmake.
For instance on linux, do the following:
cmake .
make -j8To see the help message use the software with no arguments.
./tubeSegmentation
The first arguments is the dataset to process. This has to be a metadata (.mhd) file.
Some test data is available with the software. You can test the program with the following command:
./tubeSegmentation tests/data/synthetic/dataset_1/noisy.mhd --parameters Synthetic-Vascusynth --displayThis software has a lot of parameters and several parameter presets are available:
- Lung-Airways-CT
- Neuro-Vessels-USA
- Neuro-Vessels-MRA
- AAA-Vessels-CT
- Liver-Vessels-CT
- Synthetic-Vascusynth
The parameter preset is set with the program argument "--parameters ".
This software contains several tests written with Google Test.
Install Google Test and run cmake again to compile the tests.
Run the tests using the command ./tests/runTests