This is an old revision of the document!
Table of Contents
Part 3: Tractography
Diffusion weighted imaging is an important development in MRI that gave clinicians and researchers the ability to identify and measure white matter non-invasively. But it also just happens to be one of the most visually beautiful types of scientific imaging (IMHO). The rest of this lab is aimed at getting you more comfortable with visualizing white matter tracts, but also to just have fun and create some awesome looking images.
In order to simplify things and move you through this lab a bit quicker, we will skip the “Single Subject” section of the lab.
Skip ahead to the Population Template section of the lab.
Visualizing Tracts with DSI Studio: Single Subject
The sample data for this section are located in ~/Desktop/input/dti-sample
. The files include:
data.nii.gz
- DWI data (the preprocessing applied to these data is summarized below)bvals
andbvecs
- 60 directions, b1000T1_brain.nii.gz
- Extracted T1-weighted brain
Preprocessing
- Denoising
- Gibbs ringing artifact
- Susceptibility artifact
- Eddy current distortions
- Subject motion
In this section we will use DSI-Studio program to visualize white matter tracts.
It is best to not use the macos “dark mode” setting when using DSI-Studio. If you never changed this setting, then you have nothing to worry about. If you did set your computer to use Dark mode, then you should set it back to Light mode for the rest of this lab.
Getting Started
1. Open DSI-Studio
by clicking on the icon in your dock.
- If a license agreement pops up, select
Accept and Sign-In
If you don't see the icon in your dock, you can open it from your Applications
directory.
Preparing a single subject
1. Click on the Tools tab.
2. Select R1: Linear Registration
- Select the
T1_brain.nii.gz
file - Then select the
data.nii.gz
file
3. Check the quality of the registration by using the sliders to move through slices, and using the Click to switch views
button.
- Unless something look horribly wrong, select
OK
4. Select the Tractography tab.
5. Select Step T1: NIFTI to SRC …
- Select the
data.nii.gz
- The
bvec
andbval
values will load automatically. - Click
Ok
in the popup window indicatingSRC file created
6. Select Step T2: Reconstruction …
- Select the
data.sz
file - Select Run Reconstruction in the bottom-right corner of the window that opens up.
- Click
Ok
in the popup window indicatingFIB file created
- Close the reconstruction window
7. Select Step T2: Fiber Tracking
- Select the
data.dti.fz
file
Viewing a single subject
A new DTI viewing window will open (see below). There is a lot going on in this window and it will take you some time to get it figured out. There are way too many options for us to review in this lab, so I will highlight just a few, but you should mess around, press buttons, see what things do. You'll discover cool stuff. If you really lose your way, you can always close the program, reopen it, and jump to step #7 above.
There are five windows:
- The main viewing window (yellow box)
- The three sliders at the bottom will move you through the x, y, and z dimensions.
- To the right of the sliders is an option to zoom in or out.
- This brain can also be rotated in 3D by click-hold-drag.
T3a Assign Regions
(red box)- Here we will add regions to filter and select the tracts we want to view.
T3b Draw Regions
(blue box)- This is a fractional anisotropy map color coded by the principle diffusion direction.
- In the upper corner of this window is a zoom window (just below the little
x
. Adjust that number to zoom in. If you zoom in a lot, you will see the different orientations of the principle diffusion directions. - By default, this is mirrored with the brain in the main window. Adjusting the slider will move through the slices of both brains.
- The little icons to the right of the slider let you choose axial, sagittal, coronal, or multi-view perspectives.
- Among other things, you can hand draw regions of interest (ROI)
T3c Options
(cyan box)- A million different options for all of the windows
T3d Tracts
(purple box)- Here you will generate and control which tracts are displayed.
1. Choose the coronal view by selecting the appropriate button underneath the T3b
window (hint: it's the second one to the right fo the slider)
2. In the main window set the y-slider to 65
(from left to right, the three sliders are x
, y
, and z
)
In the main window you should see two prominent, vertical, white-matter tracts. You should also see a prominent horizontal tract that seems to connect the two vertical tracts about two-thirds of the way up.
In window T3b
you'll see that the two vertical tracts are primarily blue, whereas the horizontal tract is primarily red. Zoom in close and you'll see the length and orientation within each voxel. The two vertical tracts are the right and left corticospinal tract and the horizontal tract is the corpus callosum.
3. Click Autotrack in the T3d
window.
4. Click Fiber Tracking in the T3d
window.
- Pretty cool, right!?
- Spend some time playing around with the brain, rotate to see all the pretty colors and fibers. Adjust the sliders, zoom, view, options in
T3c
, etc. We'll be doing some more specific things in a bit, so it's good to get as familiar with the interface as you can by just messing around.
The tracts are overlaid onto a fractional anisotropy (FA) map. You might prefer to see them overlaid on a T1-weighted hi-resolution brain. To do so, on the top menubar select Slices
–> Insert Other Images…
and select the T1_brain.nii.gz
.
In the upper left of the main window is dropdown menu that you can now use to switch between fa
and T1_brain
Visualizing Tracts with DSI Studio: Population Template
DSI description of the template data:
A group-average template was constructed from a total of 1065 scans. A multishell diffusion scheme was used, and the b-values were 1000, 2000, and 3000 s/mm2. The number of diffusion sampling directions were 90, 90, and 90, respectively. The in-plane resolution was 1.25 mm. The slice thickness was 1.25 mm. The diffusion data were reconstructed in the MNI space using q-space diffeomorphic reconstruction (Yeh et al., Neuroimage, 58(1):91-9, 2011) to obtain the spin distribution function (Yeh et al., IEEE TMI, ;29(9):1626-35, 2010). A diffusion sampling length ratio of 1.7 was used. The output resolution in diffeomorphic reconstruction was 1 mm isotropic. The restricted diffusion was quantified using restricted diffusion imaging (Yeh et al., MRM, 77:603–612 (2017)).
Getting Started
1. Open DSI-Studio
by clicking on the icon in your dock.
- If a license agreement pops up, select
Accept and Sign-In
If you don't see the icon in your dock, you can open it from your Applications
directory.
2. Select the FIB Template & Tractography Atlas tab.
In the Population-averaged FIB templates
box you will see a list of seven different templates.
- Select
human
(Note: by default,Human human_neonate
is highlighted, but that's not what you want. Be sure to selecthuman
at the top of the list.) - Press
Load
We won't be using any of them for this lab, but how awesome is it that you can play with the white matter of babies, and chimpanzees, and monkeys, and rodents?! I encourage you to play around with them at some point.
(the correct answer is “Very awesome!”)
A new DTI viewing window will open (see below). There is a lot going on in this window and it will take you some time to get it figured out. There are way too many options for us to review in this lab, so I will highlight just a few, but you should mess around, press buttons, see what things do. You'll discover cool stuff. If you really lose your way, you can always close the program, reopen it, and jump to step #7 above.
There are five windows:
- The main viewing window (yellow box)
- The three sliders at the bottom will move you through the x, y, and z dimensions.
- To the right of the sliders is an option to zoom in or out.
- This brain can also be rotated in 3D by click-hold-drag.
T3a Assign Regions
(red box)- Here we will add regions to filter and select the tracts we want to view.
T3b Draw Regions
(blue box)- This is a fractional anisotropy map color coded by the principle diffusion direction.
- In the upper corner of this window is a zoom window (just below the little
x
. Adjust that number to zoom in. If you zoom in a lot, you will see the different orientations of the principle diffusion directions. - By default, this is mirrored with the brain in the main window. Adjusting the slider will move through the slices of both brains.
- The little icons to the right of the slider let you choose axial, sagittal, coronal, or multi-view perspectives.
- Among other things, you can hand draw regions of interest (ROI)
T3c Options
(cyan box)- A million different options for all of the windows
T3d Tracts
(purple box)- Here you will generate and control which tracts are displayed.
Plotting tracts
Let's start by plotting a couple of major white-matter tracts.
1. In the main viewing window change the brain image from qa
to t1w_template
2. Switch to a coronal view by selecting the appropriate button underneath the T3b
window (hint: it's the second one to the right of the slider)
2. In the main window set the y-slider to 65
(from left to right, the three sliders are x
, y
, and z
)
In the main window you should see two prominent, vertical, white-matter tracts. You should also see a prominent horizontal tract that seems to connect the two vertical tracts about two-thirds of the way up.
In window T3b
you'll see that the two vertical tracts are primarily blue, whereas the horizontal tract is primarily red. Zoom in close and you'll see the length and orientation within each voxel. The two vertical tracts are the right and left corticospinal tract and the horizontal tract is the corpus callosum.
3. Click Autotrack in the T3d
window.
4. Click Fiber Tracking in the T3d
window.
- Pretty cool, right!?
- Spend some time playing around with the brain, rotate to see all the pretty colors and fibers. Adjust the sliders, zoom, view, options in
T3c
, etc. We'll be doing some more specific things in a bit, so it's good to get as familiar with the interface as you can by just messing around.
The tracts are overlaid onto a fractional anisotropy (FA) map. You might prefer to see them overlaid on a T1-weighted hi-resolution brain. To do so, on the top menubar select Slices
–> Insert Other Images…
and select the T1_brain.nii.gz
.
In the upper left of the main window is dropdown menu that you can now use to switch between fa
and T1_brain
1. In T3a
click on the Atlas button.
2. In the popup window that opens select HCP842_tractography
from the drop down menu. This is a set of fiber tracts derived from a sample of 842 participants.
3. Choose the Cortico_Striatal_Pathway_L and click Add
old
TrackVis
has tons of options. We will explicitly cover a few below. For a fuller description of the options you can refer to the TrackVis website here http://www.trackvis.org/. The website offers some brief tutorial movies that can be viewed in your browser that illustrate the use of the program. These are very helpful in quickly learning the interface. You can find a list of these movies here.
Before proceeding, watch the TrackVis movies. At minimum, watch the first and second movies to quickly get familiar with the interface. Each movie runs for about 90 sec (although you must click at certain points to move the movie forward).
The main value of TrackVis is to isolate particular fiber tracks by use of TrackGroups, Slices, Regions of Interests, Balls/Spheres, etc. You can toggle different TrackGroups on and off, for example
- if you right click on Track 1 in the upper-right
Objects
panel, you can hide this track view, or delete it. - In the lower-right
Property
pane, you can double-click on most properties of the selected TrackGroup and change them. For example, you can change the way the current slice looks, which axis it is drawn along, how dense the fibers are drawn, etc.
Play with the controls to get a sense of how you can navigate through space, rotate the brain, adjust which fiber tracts are displayed, etc.
It'll take a little bit of time playing around before you get the hang of it. Your goal isn't to become an expert user, but you should get a feel for the basic image/track manipulation options. And if things go totally off the rails, you can always close and reopen the program to start fresh. Try to …
- Only view the long tracks and then only view the short tracks
- Click on
Track
in theProperty Window
- Adjust the
Length Threshold
settings
- Play around with the
Slice Filters
, which will only show fibers that travel through the selected slice.- Activate the check box next to the
X
,Y
, orZ
Sliced Filter
- Click on the slice number to the right of the checkbox and move the slider
- Adjust the
Thickness
- Hint: If you turn on the X slice filter, and change the
Operator
toNot
then you will only see fiber tracks that do not pass through your slice. Change theOperator
toAnd
and you'll only see fibers that do pass through your slice. You can add additional slice filters and set the operators such that you'll only see fibers that pass through both your slices, none of your slices, one of your slices, etc.
Creating an ROI Sphere
Let's create a ball-shaped region of interest (ROI) to select some tracts. This will help us identify only the tracks that run through areas we're interested in (our ROI)
To clear your workspace, you might consider turning off, or hiding, the current slice-based view. To do so, right-click on Track1
in the Objects
box and select Hide
1. Select TrackGroup ⇒ New Track Group from Sphere
A small ball will show up at the cross-hairs of your 3 orthogonal views. You can make this ball bigger or small by manipulating its properties.
2. Let's make the ball a little bigger.
- Click on the
ROI
tab in the lower-rightProperty
window. - Double-click on the
2
next toRadius
and set this value to3
You can drag the ball around within your three orthogonal slice windows along the bottom of the screen.
3. If your three orthogonal slices are not moving as you move your sphere around, click on the Sync Slice to ROI center
button. (this button is in the Image
window. It is the button that looks like a window-pane with a ball in the middle of it)
4 You can add a second ROI sphere by simply repeating steps 1-3.
You can similarly create a TrackGroup based upon a hand-traced ROI like in the linked video.
Find Some Tracts
Use these methods, or others you discover, to isolate the following tracts.
- minor forceps
- major forceps
- corticospinal tract
- cingulum
LAB REPORT Part 3
LAB REPORT Part 3
- Include screenshots showing the paths of at least three major brain tracts (you can use any of the those above, or any three others of interest, or from the JHU atlases).
- In your write up, identify the tracts and briefly explain their functional-anatomical role (i.e., what anatomical regions do they connect, and what information might they carry).
Take your time with this part of the lab. With a little effort and creativity you can create some really striking images! And if you can't have fun creating images in TrackVis…well…I just…I just don't know what to say.
THIS PAGE IS STILL UNDER CONSTRUCTION!
Feel free to poke around, but do not start the lab as things might change!