ROI-based Fiber Tracking

ROI-based fiber tracking uses a combination of brain regions to filter fiber tracking results. Example protocol for different pathways can be found in the TrackEM project and recent TRACULA update

First, open the main window and click a button named [Step T3: Fiber Tracking] to select a FIB file generated from Step T1-T2. DSI Studio will bring up the tracking window.

Step T3a: Assign Regions


The upper left corner shows a region list under [Step T3a: Assign Regions]. A region is a set of voxels. It can serve as the no function type ..., or seed, ROI, ROA…etc. to facilitate fiber tracking.

There are several ways to assign regions:

Load Regions from NIFTI Files

If your FIB file is in the native space (i.e., reconstructed by DTI or GQI):

  1. If the image size of the NIFTI file matches the diffusion data, then no image resampling is applied. DSI Studio will load it directly.

  2. If the ROI file is originated from the subject’s own T1W or T2W (e.g. a FreeSurfer segmentation in T1-weighted or T2-weighted image space), then you need to first insert the original structural image (e.g. T1-weighted or T2-weighted images) by [Slices][Insert T1/T2]. DSI Studio will work out a background registration, which may take 5 minutes to converge. After the registration is stabilized, load the ROI file, and DSI Studio will automatically apply the registration from the previous structural image. The transformation matrix in the nifti header will not be used here.

  3. If the NIFTI file is in the MNI space, use [Region][Load MNI Region] to import the region. A background nonlinear registration will be conducted that allows wrapping the ROI to the subject space.

If your FIB file is in the template space (i.e., reconstructed by QSDR):

  1. If the dimension of the NIFTI file matches that of the raw diffusion data, DSI Studio will automatically warp the region to the QSDR space.

  2. If the NIFTI file was generated from T1W (e.g. manually drawing or from Freesurfer), the NIFTI file has to be converted to the original diffusion space. Then DSI Studio can load it and apply transformation automatically. DSI Studio can take the nifti file with multiple values as multiple ROIs. You can supply a label file with the nifti file. An example of the label file can be found under the “atlas” folder in the DSI Studio package.

Load Regions From Built-In Atlases

DSI Studio provides a list of atlases that can be added to the region list. Users can add anatomical landmarks by clicking on the image button in [Step T3a]. DSI Studio will perform a nonlinear registration to bring atlas to the subject space.

To use a customized atlas, please refer to the optional instructions at the bottom of this page.

Load Regions From Text Coordinate Files

DSI Studio can load ROIs from a text file of the ROI coordinates. The coordinates should be integers (floating point will be rounded up) because the coordinates indicate the “voxel” of the seeding regions. Users should be noted that the actual seeding points are uniformly distributed “within” the seeding region. The coordinates here may not necessarily match the exact seeding points in the tracking algorithm.

Specify Region Types


There are several region types available to control fiber tracking, including ROI, ROA, Seed, End, Terminative. Each of them is explained in the following sections.

Type Function
This region type is only used for visualization and parcellation. It has no effect on fiber tracking.
Seed DO NOT assign a seed region unless you want to speed up fiber tracking or refine tracking results. If no seed region is assigned, DSI Studio will use the whole brain region as the seed region. A common mistake is to assign cortical regions as seed regions. Consequently, DSI Studio will not initiate fiber tracking at the cortical region and resulting in poor tracking results.

The seed region are locations where the tracking algorithm will initiate fiber points. Ideally, it should be located in the white matter, and the algorithm will track in two opposite directions until reaching the cortex. The actual seeding points are ”uniformly distributed” within the seeding voxel. For example, a seed voxel placed at (53,87,68) can have a subvoxel seeding point located within (52.5 to 53.5, 86.5 to 87.5, 67.5 to 68.5). Within the voxel region (52.5 to 53.5, 86.5 to 87.5, 67.5 to 68.5), DSI Studio draws a point within the voxel range using a uniform distribution. The point is then used as the starting point within the selected voxel.

To refine tracking result, a new seed region can be created from the tracks by [Tracts][Tract to ROI] function. I would also enlarge this new seed region by [Regions][Modify Region][Dilation].

Users can specify a seeding point file to override the subvoxel seeding routine and guide the tracking algorithm to start at specific points. To do this, in the tracking parameter, assign “Voxel Center” to the “Seed Position” item and assign “Primary” to the “Seed Orientation”. A text file storing a list of point coordinates is needed. For example, to start racking at (53.42, 87.34, 68.43), (53.41, 87.32, 68.32), and (53.67, 87.21, 68.21), you need to have a text file with the following content:

  > 5342 8734 6843
> 5341 8732 6832
> 5367 8721 6821
> 100 -1 -1

Here the coordinates are scaled by 100. The largest number accepted is 32767. The number of points will determine the number of tracks generated (In tracking parameters, please make sure that “Terminat if” has a number larger than your point count).
ROI The region-of-interest (ROI) is used to filter tracks. It is NOT the starting point of the fiber tracking algorithm.
If there are two ROIs, they will function together. The final track will have to pass both of them.
ROA The region-of-interest (ROA) is used used to select the tracks that pass through the region. It is NOT the starting point of the fiber tracking algorithm.

  A thin-slice ROA may have the leap-across problem. Fiber tracking can jump across a ROA slice if the step size is large. If this happens, enlarge the ROA.
End DO NOT assign an End region unless you have tried assigning it as ROI.

An “End” region selects tracts that are ended (not passing) in the “end” region. It is much more restrictive than ROI and often generates no results.

If one ending region is assigned, then only the tracks ended within the regions are preserved. 
If two end regions are assigned, then the tracks ended in both regions are preserved.  

Please note that the “end” region, unlike the terminative region, does not affect the termination of the tracking algorithm. It simply selects the tracts that end in it.
Terminative A terminative region will intercept fiber tracking by terminating any tracts as soon as they enter it. It changes the behavior of a tracking algorithm and forces tracking to terminate. A terminative region is useful if one is to study the tracts that project to a nucleus or a specific cortical area. A terminative region does not allow a tract to pass through it, which is very different from an “end” region.
A terminative region can be used to terminate a track if the anisotropy level is greater than a threshold. The steps are the following:

1. In the options window, set the anisotropy threshold to the maximum value
2. Click on [Region][Whole Brain seeding]. This creates a region with FA greater than the threshold.
3. Change the region type to “terminative”
4. Setting the Fanisotropy threshold back to the minimum value
5. Start fiber tracking.
NotEnd Similar to ROA but only excludes tracts that end in the region (allows passing).


Step T2b: Draw Regions


Tip: check out shortcuts at the bottom of this page.

You can manually draw or edit a region at the window to the left-bottom widget, where a toolbar on its top shows different drawing tools.

To draw a region in the region window, left-click and drag to create a new region. Any further click will add voxels to the existing region. To remove part of a region, right-click to assign the region to be erased.

The function of each tool is detailed as follows:

Tool Function
image draws a rectangular region.
image draws a shape using the cursor trajectory.
image draws a polygon region.
image draws a ball in the 3D space.
image draws a cubic in the 3D space.
image allows for dragging a region, or the slices.
image can be used to estimate the distance in mm.

Step T3d: Tracts

Click on the [Fiber Tracking] button to start fiber tracking. Only the checked regions will affect tracking results.

(Optional) Modifying Regions

You can modify a region using [Regions Misc][Modify Regions] and [Move Regions]. The modification includes shitting the region in x, y, or z-direction. Flip x, flip y, or flip z correct the orientation problem. There is also an expansion function that expands the current region. Other functions include erosion, smoothing, negating, and defragment.

[All Exclude First] will erase the location of the first region from all other regions. [First Excludes All] will erase other regions from the first region. [All Intercept First] will intercept all other regions with the first region.

(Optional) Region-Based Analysis

DSI Studio can export metrics associated with a region (e.g. size, location, FA, ADC, …etc). [Regions][Statistics]. The exported information is a text file including the coordinates and the corresponding values for the indices.

(Optional) ROI files to FSL

The ROI saved by DSI Studio may not align perfectly in FSLeyes because of the different translocation matrix in the NIFTI headers.

The following steps will convert DSI Studio ROIs to FSL space.

  1. Prepare an FSL-generated mask or ROI file (e.g., nodif_brain_mask.nii.gz)
  2. Click on [Tools][O6: Linear Registration Toolbox]
  3. Select the DSI Studio ROI file
  4. Select the FSL mask or ROI file
  5. In the registration window, click on the [File] button on the left bottom corner and select [Save Transformed Image]
  6. Save converted ROI as a NIFTI file.

(Optional) Add a new template

template is a population-average image volume (e.g. T1W, FA…etc.) that defines a standard space. The template has its imaging modality, such as T1W, T2W, anisotropy map.

DSI Studio can include a new anisotropy template for different animal species or different subject populations (e.g., neonatal, elder…etc.).

To add a template, first, create a folder under the /atlas folder (e.g. /atlas/NAME_OF_TEMPLATE) and then copy the anisotropy map to the folder and name it NAME_OF_TEMPLATE.QA.nii.gz

DSI Studio also needs an “ISO” map to utilize dual-modality normalization. The file should also be placed under /atlas/NAME_OF_TEMPLATE and should be saved as NAME_OF_TEMPLATE.ISO.nii.gz

An ISO map is optional, but having an ISO template with the QA template will greatly increase the normalization accuracy.

If you only have a T1W template (e.g. child or elder population), then you can warp ICBM152 QA and ISO template to your template space using the following procedure:

  1. [O6: Linear registration box] select “\atlas\ICBM152\ICBM152.QA.nii.gz” as the subject image and “\mni_icbm152_t1_tal_nlin_asym_09c.nii.gz” (provided in DSI Studio package, windows version) as the reference image. 

  2. Click on [Save Warped Image] and save it as a new file. Let’s name it new.QA.nii.gz

  3. Repeat steps 1 and 2 but select “\atlas\ICBM152\ICBM152.ISO.nii.gz” to create new.ISO.nii.gz

  4. [07: Nonlinear registration box], [Open Subject]->”\mni_icbm152_t1_tal_nlin_asym_09c.nii.gz” and [Open Reference]->your new t1w template. I would suggest using smoothness=1.0 or higher to avoid over-distorted results. Click [Run]. You may experiment with different smoothness values to get the best result.

  5. After registration, select the top menu [File][Apply Warpping]->new.QA.nii.gz and overwrite it.

  6. Repeat 5 but select new.ISO.nii.gz and overwrite it.

  7. Now you have new QA and ISO templates in your T1W template space. After adding them to \atlas\NAME_OF_TEMPLATE, restart DSI Studio to see the template added to the menu.

(Optional) Add a new atlas

An atlas is an integer-valued parcellations that record the location of each brain region. It usually has a corresponding value-name list in the text format.

  1. Prepare the atlas in NIFTI: For other formats, please convert them to the NIFTI format as .nii.gz.
  2. A .txt text file records the labels: An example of the text can be find here. Each line has a value-name pair separated by a tab or space. The file name should match the atlas (e.g. HCP-MMP.nii.gz and HCP-MMP.txt)
  3. Locate the target template folder: A list of template space can be found here, including ICBM152 (human young adult), neuonate, CIVM_mouse,…etc. You will find the same folders in the DSI Studio package. In windows, they are in under the \dsi_studio_64\atlas folder. In Mac, those folders are stored in the app package (Right-click on to open the DSI Studio package /Content/MacOS/atlas).
  4. Convert atlas to the target template space: click on [Tools][R1: Linear Registration Toolbox], first select the atlas file (from step 1) and then select the [TEMPLATE NAME].QA.nii.gz in the template folder (identified in Step 3). Once the two volume matches, save the atlas using [Files][Save Transformed Image]
  5. Copy atlas and its text labels to the template folder: For human atlas, please copy the .nii.gz and correponding .txt files to the template folder (e.g., \atlas\ICBM152 in the dsi studio package). For animal atlas, please find the corresponding folder, such as the one for mouse, rat, marmoset, or rhesus.

After copying a new atlas to the template space folder, restart DSI Studio to see the new atlas added to the ICBM152 menu.


Location Shortcut Function
3D window left button drag to rotate view
3D window right button drag to zoom
3D window middle button drag to move
3D window wheel zoom in or zoom out
3D window double left-clicks on a region select it in the region list
3D window Ctrl+A drag a slice or a region in the 3D window.
3D window Alt+1, Alt+2,…etc remember the current viewport and slice position to memory slot 1
3D window “1”, “2”,…etc. return to the viewport and slice position recorded in memory slot 1
ROI window right double click  move slices to the pointed location.
ROI window middle button drag a slice or a region in the ROI window to the left.
ROI window wheel zoom in or zoom out
Any “Q” and “A” move sagittal slide
Any “W” and “S” move coronal slide
Any “E” and “D” move axial slide
Any “Z” switch to sagittal view
Any “X” switch to coronal view
Any “C” switch to axial view

example: 3D eraser region

  1. Create a new cubic region as an “eraser” and move it to the top
  2. In the 3D window, use Ctrl+A to drag the eraser region to regions to be erased
  3. Use [Regions][Modified Checked Regions][All Excludes First] or Ctrl+Shift+2 to apply the erasing effect