DTIQuery

This is the DTIQuery 1.10 README. We will transform it for the wiki over time and with experience. We will also put in some screen shots.

The code has been developed by Dave Akers and A. Sherbondy. Dave Akers and Doug Hamilton have now taken it over.

Query's home page

This document describes mouse and keyboard shortcuts for using DTI-Query,and a short revision history. To learn how to use DTI-Query, please see our Visualization 2004 paper (and the related video illustrating its use):

Mouse operations

 Left mouse - rotate
 Right mouse - zoom
 Shift + Left mouse - pan
 Ctrl + Left mouse - drag current VOI on current tomogram

Keyboard commands/shortcuts

Note that all menu options also have keyboard shortcuts -- these are not listed here:

 's', 'c', and 'a': select sagittal, coronal, or axial tomogram
 ',' and '.': slide the current tomogram back and forth
 'b': cycle background color
 'k': toggle anti-aliasing
 '[': cycle between camera positions
 'w': toggle line widths
 't': toggle all VOI labels on/off

Revision History

DTI-Query 1.0 (August 17, 2005):

• Initial version released.

DTI-Query 1.01 (September 20, 2005):

• Fixed a bug in tensor interpolation code (DTIUtil/DTIVolume.cpp, lines

95-102). New sample data, binaries and code released. New data uses an FA termination threshold of 0.15, as in our two published papers. (The original release accidentally used a threshold of 0.1.)

DTI-Query 1.1 Beta (March 17, 2007):

• Improved support for tensor data formats. (Now supports 5D tensor files,

  and arbitrary assignment of tensor indices.) Has been tested with tensor 
  image files output by the AFNI tools.

• Support for MacOS X (Carbon)
• Binaries released for Windows, Linux (32- and 64-bit), and MacOS X (PPC

  and Intel)

• Added choice of integration method (Euler's method, Runge Kutta 2nd

  order, Runge Kutta 4th order) for STT tracking.

• Improved support for reading NIFTI background images (correctly handles

  q-form/s-form matrices).

• Can now save visible pathways (as a binary format, or as a NIFTI mask image).
• Many minor GUI enhancements and bug-fixes.

DTI-Query 1.1 (November 30, 2007):

• Pathways are now stored in voxel space (untransformed). On loading, they

are transformed by the matrix stored in the header. On saving, they are transformed by the inverse of this matrix.

• Fixed inconsistencies in data storage across multiple platforms, which

was making it impossible to transfer datasets computed on one platform to another. NOTE that DTI-Query 1.1 beta cannot read the new 1.1 format, nor can DTI-Query 1.1 read the old format. Apologies for the transition.

• In precomputation, added the ability to specify an "output label,"

avoiding hard-coding the names of the output files (fa.nii.gz and precomputed.pdb). This should make it easier to experiment with different algorithm settings.

• Fixed several bugs in lookup tables (would cause some background images

to appear completely black or white).

• Added the ability to cycle backwards through images (Ctrl-Shift-B).
• When loading new background images, can now append to the current set of

images, or replace the existing set. (Previously, loading always appended.)

• Added a display of the name of the current background image (in the

lower left hand corner of the window).

• Added the ability to specify an arbitrary "output prefix" (allows for

outputting multiple .pdb files in the same directory with different algorithm settings).