Compile DSI Studio on Windows

1. Download Qt MinGW

Download qt-opensource-windows-x86-1.6.0-8-online.exe at https://www.qt.io/download-open-source/ and install [Qt 5.4][msvc2013 64-bit OpenGL] and [Qt 5.4][msvc2013 32-bit OpenGL] as well as [Tools][Qt Creator]

Xcode can be downloaded from https://developer.apple.com/downloads/index.action

Once should note that if you compile it on an older version of Mac, e.g. 10.5. Leopard. You may need to figure out the right version of Xcode for your system. Xcode 3.1.4 is the latest version that runs on 10.5 Leopard. If you already have that on your system DVDs, then you don't need to download it. Otherwise there are a fair number of bug fixes, so you may find 3.1.4 valuable.

Download Qt installer at https://www.qt.io/download-open-source/ and install it. 

Download Qt creator from qt-project.org. 

Open Qt creator, load the dsi_studio.pro file and turns to the projects page->manage Kits. Under Qt version tab, you need to add in the complied qmake, which can be found in the Qt installation folder (under QTDIR/bin). Then under Kits tab, manually add a new make tool, select GCC X86_64 (use GCC X86_32 for 32-bit) for compiler, and the Qt version is the one that is just built.

Change build configuration to "Release". Run build all. it should build DSI Studio

Compile DSI Studio on Linux

Installation instructions by: Max Novelli 09/19/2012. This how-to was written while installing DSI Studio on an Ubuntu 12.04 64bit system with nVidia drivers downloaded directly from nvidia site. 

The source code requires g++ > 4.9. You need to configure compiler option to include -std=c++11 or -std=gnu++11 

In Ubuntu, gcc-4.9 must be used. However, the Ubuntu system may report gcc-4.8 as the most current, i.e. apt-get does not show it. This is because the OS only shipped with 4.8 and the “updates” are only for that version.

To get 4.9:

sudo add-apt-repository ppa:ubuntu-toolchain-r/test

sudo apt-get update

sudo apt-get install g++-4.9

Install Qt

1) If you are using standard nVidia drivers that comes with your Ubuntu distribution, you can use standard qmake and qt libraries coming with ubuntu.

1.1) install qmake, qt tools and libraries

> sudo apt-get install qt5-qmake qt5-dev-tools

This should install all the needed dependencies

1.2) skip to step 3

2) If you are using custom installed nvidia drivers downloaded directly from nvidia website, we need to custom compile qt and link it to the nvidia libraries that are installed by the nvidia package. If you use the standard qt package, qt will be linked to the standard libraries and dsi studio will through an error, most likely at compilation time, because version of the open-gl libraries that it expects and the one available are different. 2.1) Prepare system to install qt libraries. We need to install some dependencies for qt to be able to compile (please refer to the following URL for more info: - http://www.qtforum.org/article/27401/debian-xlib-test-failed-after-configure.html)

        

> sudo apt-get build-dep qt5-qmake

2.2) visit qt page to figure out the latest version of qt (version 5.4 at the time of this writing):

- http://qt.nokia.com/downloads/linux-x11-cpp

2.3) download tar file:

> wget http://releases.qt-project.org/qt5/source/qt-everywhere-opensource-src-5.4.tar.gz

2.4) expand and get ready to compile

> tar xvzf qt-everywhere-opensource-src-5.4.tar.gz           
> cd qt-everywhere-opensource-src-5.4

2.5) configure step. We place all our custom compiled package under /usr/local/pkg. You can change the location anyway you like, as long as you change the qmake alias path accordingly. Webkit has been excluded because, apparently, does not play well with Ubuntu 12.04 and the version of gcc coming with it.

> ./configure --prefix=/usr/local/pkg/qt/5.4 -no-webkit

2.6) compile

> make

2.7) install

> sudo make install

2.8) create qmake alias

> alias qmake=”/usr/local/pkg/qt/5.4/bin/qmake”

Compile DSI Studio and dependencies

3) install dependencies for dsi-studio

> sudo apt-get install git

> sudo apt-get install libboost-all-dev

> sudo apt-get install zlib1g zlib1g-dev

4) create working folder

> mkdir dsistudio

> cd dsistudio

5) download source code from git

> git clone -b master git://github.com/frankyeh/DSI-Studio.git src

6) you need to download additional libraries and place them into the right directories. Here are the links to their main repositories

- Image: https://github.com/frankyeh/TIPL/archive/master.zip

put it under ../src/image

7) create build folder

> mkdir build

> cd build

8) configure step

> qmake ../src

9) compile step

> make

Install DSI Studio

10) install step

> sudo mkdir /usr/local/pkg/dsistudio/20120919

> sudo cp dsi_studio /usr/local/pkg/dsistudio/20120919/dsi_studio

11) atlas files. DSI Studio needs a template image file called HCP842_QA.nii.gz and a mask file named brain_mask.nii.gz. The other atlas files are optional. If included, they should be placed under a subfolder named atlas. You may find these files at https://www.dropbox.com/s/rq5khgmoyiye0op/dsi_studio_other_files.zip?dl=0

Additional instruction for Linux Fedora

To install DSI-Studio on your Debian system;

If you are using the squeeze (aka stable) distribution, add the 3 lines below to your /etc/apt/sources.list

# For DSI-Studio

deb http://s.kalou.net/apt wheezy main
deb-src http://s.kalou.net/apt wheezy main

Then, perform

sudo apt-get update
sudo apt-get install dsi-studio


If you are using the wheezy (aka testing) distribution, add the 3 lines below to your /etc/apt/sources.list

# DSI Studio and boost backports
deb http://s.kalou.net/apt squeeze main
deb-src http://s.kalou.net/apt squeeze main

Then, perform

sudo apt-get update
sudo apt-get install dsi-studio