Skip to content

NIRALUser/DTIFiberTractStatistics

Repository files navigation

DTI Fiber Tract Statistics

What is it?

This is a software which allows the user to study the behavior of water diffusion (using DTI data) along the length of the white matter fiber-tracts. Various tract-oriented scalar diffusion measures obtained from DTI brain images, are treated as a continuous function of white matter fibers' arc-length. To analyze the trend along a given fiber tract, a command line tool performs kernel regression on this data. The idea is to try out different noise models and maximum likelihood estimates within kernel windows (along the tract), such that they best represent the data and are robust to noise and Partial Volume effect.

The package contains several command line based modules and an GUI based tool called DTIAtlasFiberAnalyzer to access most functions.

This package is also available as a 3D Slicer extension (http://www.slicer.org) called DTIAtlasFiberAnalyzer.

Some documentation about the features available in this package are available here: http://www.na-mic.org/Wiki/index.php/Projects:dtistatisticsfibers

Usage

GUI

	$ DTIAtlasFiberAnalyzer

CLI

Example

	$ DTIAtlasFiberAnalyzer --datafile <datafilename> --analysisfile <analysisfilename> --removeCleanFibers --removeNanFibers --numthreads 8 --nogui

Parameter file example

Datafile
Data parameters for DTIAtlasFiberAnalyzer : 
CSVFile : ../AtlasDIR/DTIAtlas_Result.csv
#Data/Case/Deformation Column --> index starts at 1
Data Column : 2
Deformation Field Column : 3
Field Type : displacement field
Case Column : 1
Output Folder : /outputDIR/
Analysisfile
Analysis parameters for DTIAtlasFiberAnalyzer : 
Atlas Fiber Folder : /FiberDIR/AutoTract/AllFinalCleanedFibers
#Selected Fibers in the Atlas--> give the name of the file without the path
Selected Fibers : ILF_L.vtk
Selected Planes : 
#Profile parameter --> choice between fa,md,fro,ad,l2,l3,ga,rd 
Profile parameter : fa
#What for col and row --> choice between 'Case' or 'Arc lenght' with after 'in row' or 'in column'/'in col'
Col and Row : Case in row

Dockerfile for developers

Use below command in source directory to build docker image (Currently having only CentOS7 image.)

$ docker build . -t <image-name>
$ docker run --rm -it -v $PWD/../:/work -w /work <image-name> 

Build comment

  • In OSX, Qt5_DIR environment variable needs to be set (e.g. /usr/local/opt/qt5/lib/cmake/Qt5)

Change Log:

v1.8.1 (09/17/2020)

  • Multithreading in fiberprocessing, dti-tract-stat.
  • RemoveNan Checkbox added to FiberProcess tab
  • Minor bug fixed
  • CLI bug fixed
  • ComputeAll bug fixed
  • GUI now can choose whether removeNanFibers in Fiberprocess tab.

v1.7.3c-beta (07/27/2020)

  • Merge Tab removed
  • Bandwidth parameter can be passed by UI
  • dtitractstat related computation bug fixed
  • Minor appearance changed (version, overwriting messages)

v1.7.3b (07/27/2020)

  • FADTTSter repository chaneged to master
  • Build script bug fixed for OSX

v1.7.3a (07/13/2020)

  • CSV Table is now able to remove a selection of table. (Previously available only line by line)
  • Tabs are now all enabled without having processed the previous step.
  • Build script fixed , users can build the tool suite with the standard environment described in Dockerfile. (CentOS7 only)

License

See License.txt

More information

Find the tool on NITRC

Building from source

Install Qt5

Building using Qt5 is recommended. This version has been build with Qt5.5.1 but it may work with newer version. You can download Qt5 from here

Clone this repository and build

  git clone https://github.com/NIRALUser/DTIFiberTractStatistics.git
  mkdir DTIFiberTractStatistics-build
  cd DTIFiberTractStatistics-build
  cmake -DUSE_QT4:BOOL=OFF -DQt5_DIR:PATH=/your/install/directory/Qt5.5.1/lib/cmake/Qt5 ../DTIFiberTractStatistics

If you want to build FADTTS you should use the following settings

  cmake -DUSE_QT4:BOOL=OFF -DBUILD_FADTTS:BOOL=ON -DQt5_DIR:PATH=/your/install/directory/Qt5.5.1/lib/cmake/Qt5 ../DTIFiberTractStatistics

About

This is a software which allows the user to study the behavior of water diffusion (using DTI data) along the length of the white matter fiber-tracts

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages