Source Code
DTI-TK is an open source project. The source code repository is currently hosted on NITRC. This page describes how you can gain access to the repository, download the source code, and compile DTI-TK yourself.
Access the repository
To access the source code,
- join NITRC, if you are not already a NITRC user
- send a request to join NITRC DTI-TK project. Your request will usually be approved in a day or two. Alert: The system does NOT send the approved users a confirmation message. Instead, you can check if your name now appears on the list of users on the NITRC DTI-TK summary page.
Download the source code
To download the source code, you need a CVS client software installed on your computer. On a Linux machine, you will need to have the Development Tools installed; on a MacOSX machine, you will need to install the fink. These softwares will be required for compiling the source code.
You can check if CVS is installed by running, in a command line interface,
If CVS is installed and in your path, you should get a response like
(The exact output depends on your setup.)
Once CVS is installed, you can download the source code with the following commands:
- Create a directory of your choice to house the source code. The commands below use the setup I have on my machine.
mkdir /Users/huiz/devel/DTI-TK
cd /Users/huiz/devel/DTI-TK
- Retrieve the source code with CVS
export CVS_RSH=ssh
cvs -d :ext:developername@www.nitrc.org:/cvsroot/dtitk checkout dtitk
NOTE: You need to
- substitute developername with your own NITRC user name
- make sure a ssh client is installed on your machine.
- make sure you have a live internet connection.
- provide your NITRC password when prompted
If everything goes okay, you should see the following
cvs checkout: Updating dtitk
U dtitk/CMakeLists.txt
U dtitk/CPackOptions.cmake.in
U dtitk/CPackSetup.cmake
U dtitk/CTestConfig.cmake
....
Compile the source code
DTI-TK can be compiled from source with the following steps:
NOTE: The command examples use the setup on my machine. So remember to adapt according to your local setup.
- Make sure that you have the following softwares installed on your system:
- CMake
- ITK (Version 4 series only and set ITKV3_COMPATIBILITY to ON with
ccmake)
- VTK
ITK and VTK will need to be compiled from source with cmake. If you don't have experience with doing this, please refer to the ccmake instructions below (as a guide only, since details differ).
- Change to the directory where you have downloaded the DTI-TK source
cd /Users/huiz/devel/DTI-TK
- Create and change to a new directory called
rel.build
mkdir rel.build
cd rel.build
- Create the required makefile with
ccmake, which is an interactive cmake client, in rel.build.
The steps involved here are:
- Press
'c' to initiate the configuration process.
- Set the buid type (CMAKE_BUILD_TYPE) to RELEASE. (You can navigate to a different variable with the up/down arrow and press the return key to toggle the editting mode)
- If ITK installation directory (ITK_DIR) is not found (NOT FOUND), set the variable to the correct directory.
- Do the same for VTK installation directory (VTK_DIR).
- Set the installation directory (CMAKE_INSTALL_PREFIX) to
/usr/local/dtitk. (To set this variable, you may need to reveal the advanced option by pressing 't') If this is a shared workstation, you may not have the write permission to this directory. In this case, you need to set it to a different directory.
- Press
'c' again, if you have made any changes.
- Press
'g' to generate the makefile required. If you do not see 'g' as an available key to press (listed at the bottom of the ccmake interface), one or more required variables may not be set or set correctly.
- Compile the source code now with
make
- Install the resulting binary to the target installation directory
make install
- The installation directory is set above with
ccmake.
- Make sure you have the write permission to the installation directory. You may be able to gain access with
sudo make install if it is your own machine. Otherwise ask your system administrator for help, or change the installation directory to one that you have the write permission (need to re-run ccmake).
What next?
Don't forget that you still need to follow the installation tutorial after this, although just from the step 3 and onward.
