WhiteMatterAnalysis (WMA) provides fiber clustering and tractography analysis tools.
1. Install Python 3:
Miniconda is a nice option becuase it includes pip, setuptools, and all library dependencies (such as VTK and scipy).
- Download and install Miniconda (Python 3.7) from https://conda.io/miniconda.html
2. Install whitematteranalysis with pip:
The following command will use pip to install whitematteranalysis from this source repository and all library dependencies:
pip install git+https://github.com/SlicerDMRI/whitematteranalysis.git
(Note: On MacOS, to able to use pip, X-code needs to be installed using
wm_quality_control_tractography.py --help to test if the installation is successful.
Please see the following page for instructions of applying a pre-provided anatomically curated white matter atlas, along with the computation tools provided in whitematteranalysis, to perform subject-specific tractography parcellation.
WMA implements algorithms from publications listed here: http://projects.iq.harvard.edu/whitematteranalysis/publications
Please cite the following papers:
O'Donnell, LJ., and Westin, CF. Automatic tractography segmentation using a high-dimensional white matter atlas. Medical Imaging, IEEE Transactions on 26.11 (2007): 1562-1575. O’Donnell LJ, Wells III WM, Golby AJ, Westin CF. Unbiased groupwise registration of white matter tractography. In MICCAI, 2012, pp. 123-130. Zhang, F., Wu, Y., Norton, I., Rathi, Y., Makris, N., O'Donnell, LJ. An anatomically curated fiber clustering white matter atlas for consistent white matter tract parcellation across the lifespan. NeuroImage, 2018 (179): 429-447
For projects using Slicer and SlicerDMRI please also include the following text (or similar) and citations:
How to cite the Slicer platform
An example of how to cite SlicerDMRI (modify the first part of the sentence according to your use case):
"We performed diffusion MRI tractography and/or analysis and/or visualization in 3D Slicer (www.slicer.org) via the SlicerDMRI project (dmri.slicer.org) (Norton et al. 2017)."
- Isaiah Norton, Walid Ibn Essayed, Fan Zhang, Sonia Pujol, Alex Yarmarkovich, Alexandra J. Golby, Gordon Kindlmann, Demian Wassermann, Raul San Jose Estepar, Yogesh Rathi, Steve Pieper, Ron Kikinis, Hans J. Johnson, Carl-Fredrik Westin and Lauren J. O'Donnell. SlicerDMRI: Open Source Diffusion MRI Software for Brain Cancer Research. Cancer Research 77(21), e101-e103, 2017.