TubeTK/Build Instructions
Overview
TubeTK has been tested on Windows, OS X, and Linux.
- Process
- Install dependencies
- Download source
- Configure using CMake
- Build
Dependencies
Minimum Requirements
- CMake
- Git
- Insight Segmentation and Registration Toolkit (ITK)
- JsonCpp
- Slicer Execution Model
- Subversion
- 3D Slicer fork of the Visualization Toolkit (VTK)
See the Dependencies page on GitHub for minimum versions and a complete list.
Using Binary Packages
- Fedora:
sudo yum install cmake git gcc-c++ jsoncpp-devel subversion
- Red Hat Enterprise Linux:
sudo yum install devtoolset-1.1-gcc-c++ git subversion
- Ubuntu:
sudo apt-get install cmake git make g++ libjsoncpp-dev subversion
Download, Configure, and Build
You have two options:
1. Have CTest do all of the remaining work
This is the recommended approach for people who will be using and developing in TubeTK. It not only builds and tests TubeTK with minimal effort, but it also submits your build as an "experimental" on the TubeTK dashboard - this allows us to more easily help you debug errors during the build process:
- Download a ctest configuration file for TubeTK
- Edit it to match your environment
- Only the variables in the first portion of the file should be edited. They are clearly marked and self explanatory. Additional details are at TubeTK/Dashboard Scripts.
- Run ctest and submit an experimental dashboard
ctest -S <name_of_your_script_file.cmake>
- This will download the source code, configure it, build it, test it, and then submit the results to the TubeTK Dashboard
2. Download, configure, and build manually
2a. Download and manage your Git repository
git clone https://github.com/TubeTK/TubeTK
2b. Configure
Windows
mkdir %HOMEPATH%/TubeTK-Release cd %HOMEPATH%/TubeTK-Release cmake -DCMAKE_BUILD_TYPE=Release ../TubeTK
Linux and OS X
mkdir $HOME/TubeTK-Release cd $HOME/TubeTK-Release cmake -G"Unix Makefiles" -DCMAKE_BUILD_TYPE=Release ../TubeTK
2c. Build
Windows
Microsoft Visual Studio
- Load the TubeTK solution file
- Select File -> Open -> Project/Solution -> open TubeTK-Release/TubeTK.sln
- Perform the initial build using your compiler at the top-level of TubeTK-Release. This will update and build the libraries that TubeTK depends on (ex. VTK, ITK), and then build TubeTK.
- Right click on the "ALL_BUILD" project and select "Build".
- Subsequent builds should be initiated in the subdir TubeTK-Release/TubeTK-build to save time. This will build TubeTK only. You may have to periodically build from the top-level of TubeTK-Release to get updates to the libraries that TubeTK depends on.
- Right click on the "TubeTK" project and select "Build".
Linux and OS X
- Perform the initial build using your compiler at the top-level of TubeTK-Release. This will update and build the libraries that TubeTK depends on (ex. VTK, ITK), and then build TubeTK.
cd $HOME/TubeTK-Release make
- Subsequent builds should be initiated in the subdir TubeTK-Release/TubeTK-build to save time. This will build TubeTK only. You may have to periodically build from the top-level of TubeTK-Release to get updates to the libraries that TubeTK depends on.
cd $HOME/TubeTK-Release/TubeTK-build make
Advanced
Using KWStyle
For introductory information, see: http://public.kitware.com/KWStyle/.
git clone http://public.kitware.com/KWStyle.git mkdir $HOME/KWStyle-Release cd $HOME/KWStyle-Release cmake -DCMAKE_BUILD_TYPE=Release ../KWStyle make sudo make install
cd $HOME/TubeTK-Release cmake -DTubeTK_USE_KWSTYLE=ON -DKWSTYLE_EXECUTABLE=/usr/local/bin/KWStyle . make make StyleCheck
Using a pre-existing ITK, JsonCpp, or VTK installation
You can also configure CMake variables to use an existing JsonCpp installation instead of an embedded version.
cd $HOME/TubeTK-Release cmake -DUSE_SYSTEM_JSONCPP .
You can also configure CMake variables to use an existing ITK or VTK installation instead of an embedded versions. This is not recommended, because of inter-dependencies that require specific version of these libraries, and built using specific options, to be used.
- USE_SYSTEM_ITK: OFF
- If "ON", then you can tell TubeTK to use an ITK build that is already present on your system (using the CMake variable ITK_DIR).
- USE_SYSTEM_VTK: OFF
- If "ON", then you can tell TubeTK to use a VTK build that is already present on your system (using the CMake variable VTK_DIR). See the warning below.
- Dependency on VTK version and build options
- Note that TubeTK relies on VTK from 3D Slicer (https://github.com/Slicer/VTK)
- The 3D Slicer fork of VTK contains enhancements that have not yet made it into the VTK repository itself.