Installation

From qitwiki
Jump to: navigation, search

This page provides instructions for installing QIT. This has been tested on Mac, Windows, and Debian and Ubuntu GNU/Linux, but your mileage may vary, based on the specific version of the OS.

Installation for Windows

You can download the latest version of QIT for Windows here:

Once the archive has been expanded, you can move the QIT directory to your preferred installation location. The program files are located in the bin subdirectory. You can open the viewer by double-clicking qitview.bat. If you want to process data on the command line, it is recommended that you install cygwin and run the qit.

Installation for Mac or Linux

You can download the latest version of QIT for Mac and Linux here:

Once the archive has been expanded, you can move the QIT directory to your preferred installation location. The program files are located in the bin subdirectory. On Mac and Linux, you can open the viewer by running qitview. If you want to process data on the command line, you can run qit.

'Note: If you plan to use QIT on the command line, you can also add the bin directory to your shell path variable, e.g. by adding this to your .bashrc file: export PATH=$PATH:/path/to/qit-1.0b2/bin

Dependencies for Mac and Linux

On Mac and Linux, QIT requires Java version 1.8 and Python version 2.7+ to be installed (higher version will probably work too). These may already be installed on your system (e.g. some versions of macOS), and you can check by running these commands on the command line:

  • java -version
  • python -version

If the versions are too old or those commands produce an error, you'll have to install things from here:

To download Java, the download page requires that you select the "Accept License Agreement" radio button before downloading. You have to find your operating system in the list under "Java SE Development Kit 8uXYZ", where XYZ is the latest build number. If you're using Windows or GNU/Linux Linux, the 64-bit version labeled "x64" is recommended. The 32-bit (x86) version will only work with small datasets.

Advanced Dependencies

The following instructions are optional, but if you would like to integrate QIT with other neuroimaging software packages or use QIT automated workflows, please read on.

Some modules in QIT are integrated with 3rd party software pacakages. The documentation for those modules should indicate whether it has this kind of dependency. Here is a list of all the software that you might need and their homepages:

For QIT to use these packages, the associated programs have to be on your system path. That means that you can run them on the command line without specifying the full path. For example, you should be able to execute Freesurfer's mri_convert from any working directory. Each package should have instructions for adding its programs to the path, so please check their documentation pages. After that, you should be good to go!

Comparing Versions

At some point, you may need to check the version of QIT that you are using. For example, if you are reporting a bug, it can be very helpful to know the build information. It can also help you figure out if you have the latest version or not. You can retrieve the build information from the following file:

$ cat qit-latest/doc/build.properties
# This file is automatically generated to document the build
#Fri, 17 Nov 2017 11:21:11 -0800

time=11/17/2017 02\:21 PM
revision=944\:946M
builder=cabeen
version=1.0
system=Darwin plume.local 16.5.0 Darwin Kernel Version 16.5.0\: Fri Mar  3 16\:52\:33 PST 2017; root\:xnu-3789.51.2~3/RELEASE_X86_64 x86_64