Differences between revisions 18 and 19
Deletions are marked like this. Additions are marked like this.
Line 8: Line 8:
All necessary preprocessing of the diffusion-weighted images and reconstruction of the pathways is done by the trac-all script. Several options for this analysis stream can be set by the user in a configuration file (''dmrirc'' file), which is passed as an argument to trac-all. For more information, see: All necessary preprocessing of the diffusion-weighted images and reconstruction of the pathways is done by the '''trac-all''' script. Several options for this analysis stream can be set by the user in a configuration file ('''dmrirc''' file), which is passed as an argument to trac-all. For more information, see:
Line 12: Line 12:
Trac-all is used to preprocess raw diffusion data (correcting for eddy current distortion and B0 field inhomogenities), register them to common spaces, model and reconstruct major white matter pathways (included in the atlas) without any manual intervention. trac-all may be used to execute all the above steps or parts of it depending on the dataset and user's preference for analyzing diffusion data. Alternatively, scripts exist to execute chunks of each processing pipeline, and individual commands may be run to execute a single processing step. The trac-all script can be used to:
 * Preprocess the diffusion-weighted images, applying standard methods for mitigating image distortions due to eddy currents and B0 field inhomogeneities
 * Register the individual's diffusion-weighted and structural images to each other and to a common (atlas) space
 * Reconstruct volumetric distributions of 18 major white-matter pathways included in the atlas
 * Extract statistics on standard diffusion measures (FA, MD, etc.) for each of the reconstructed pathways
Different [[trac-all|trac-all command-line options]] allow the user to run all the above processing steps sequentially or only a single step.

The final output of TRACULA, the concatenation of the volumetric distributions of all reconstructed pathways, is a file called merged_*.mgz (the actual name depends on processing options), which can be visualized with [[FreeviewGuide|freeview]]'s --tv option. This displays isosurfaces of the volumetric distributions of the pathways, like the ones seen in the image above.

TRACULA: TRActs Contrained by UnderLying Anatomy

TRACULA is a tool for automatic reconstruction of a set of major white-matter pathways from diffusion-weighted MR images. It uses global probabilistic tractography with anatomical priors. Prior distributions on the neighboring anatomical structures of each pathway are derived from an atlas and combined with the FreeSurfer cortical parcellation and subcortical segmentation of the subject that is being analyzed to constrain the tractography solutions. This obviates the need for user interaction, e.g., to draw ROIs manually or to set thresholds on path angle and length, and thus automates the application of tractography to large datasets.

tracula.jpg

Documentation

All necessary preprocessing of the diffusion-weighted images and reconstruction of the pathways is done by the trac-all script. Several options for this analysis stream can be set by the user in a configuration file (dmrirc file), which is passed as an argument to trac-all. For more information, see:

The trac-all script can be used to:

  • Preprocess the diffusion-weighted images, applying standard methods for mitigating image distortions due to eddy currents and B0 field inhomogeneities
  • Register the individual's diffusion-weighted and structural images to each other and to a common (atlas) space
  • Reconstruct volumetric distributions of 18 major white-matter pathways included in the atlas
  • Extract statistics on standard diffusion measures (FA, MD, etc.) for each of the reconstructed pathways

Different trac-all command-line options allow the user to run all the above processing steps sequentially or only a single step.

The final output of TRACULA, the concatenation of the volumetric distributions of all reconstructed pathways, is a file called merged_*.mgz (the actual name depends on processing options), which can be visualized with freeview's --tv option. This displays isosurfaces of the volumetric distributions of the pathways, like the ones seen in the image above.

Note that, because TRACULA relies on the underlying anatomy as derived from the FreeSurfer cortical parcellation and subcortical segmentation, these need to be generated before running trac-all. This means that before running trac-all you will have to analyze your subjects' structural images with recon-all and make sure that they have a good-quality mri/aparc+aseg.mgz.

Tutorials

For step by step instruction on how to set up and run TRACULA, please refer to the relevant tutorials from the FreeSurfer training workshops:

Reference

Automated probabilistic reconstruction of white-matter pathways in health and disease using an atlas of the underlying anatomy. Yendiki A, Panneck P, Srinivasan P, Stevens A, Zöllei L, Augustinack J, Wang R, Salat D, Ehrlich S, Behrens T, Jbabdi S, Gollub R and Fischl B (2011). Front. Neuroinform. 5:23. doi: 10.3389/fninf.2011.00023

Tracula (last edited 2023-07-17 03:04:26 by AnastasiaYendiki)