Documentation‎ > ‎

Create a connectometry database

This documentation introduces the steps to create a connectometry database. A connectometry database contains information of the subjects' diffusion profile that allows further connectometry analysis.

STEP1: Reconstruct data in the MNI space

The following steps reconstruct all subjects' diffusion data in the MNI space. 

STEP1a: Arrange the folder structure

    Store the image files using the following tree structure. The image data of each subject should be stored by a folder named by his/her subject ID, and all the folders are placed under a common study folder.

[study x]   -> the study folder storing all the study files
     |-[001]    -> the subject folder storing the image file of subject 001
     |-[002]    -> the subject folder storing the image file of subject 002

     The name of the image files should following the look-up rule details here.     

*I would recommend to preprocess nii files using FSL' TOPUP and eddy before proceeding to STEP2.  

STEP1b: Batch create the SRC files

Click on [Tools: Batch Processing][Create SRC files] and select the study folder. DSI Studio will generate an SRC within each subject's folder.

* You may also use [STEP2 Reconstruction] to reconstruct the SRC files. In the reconstruction window, you may need to specify [QSDR] as the method and check "Output ODF" in the advanced setting. The output resolution should be either 1mm or 2mm.

*If DSI Studio fails to create SRC file for your data, please contact Frank.

STEP1c: Check SRC files

as described here, discard problematic data set.

STEP1d: Reconstruct all image data 

If you would like to use built-in template (human adults), click [Diffusion MRI Connectometry][Reconstruct SRC files for connectometry] and select the study folder. DSI Studio will generate an FIB file within each subject's folder.

If you would like to use study specific FA template or T1W template (animal, neonatal...etc.), then you may need to reconstruct each SRC file by QSDR in [STEP2 Reconstruction]. Please check "output ODF" in the advanced option, and assign your study specific template under the QSDR reconstruction tab.

STEP1e: Post-reconstruction quality check

Get a list of the FIB files generated in the subjects' folders (search *.fib.gz file). Each FIB file generated from the previous step will has a file name such as *.odf8.f5rec.cdm.qsdr.1.25.2mm.R67.fib.gz. The R67 indicates that the R-sqaured value between the subject and the template's QA map is 0.67. 

**An R-squared value lower than 0.5 may require further inspection to confirm whether it is due to registration error**.

The most common cause for a low R2 is an inverse order of the axial slices, which can be corrected in the reconstruction step to flip the image volume at the Z direction. The second common cause is a prominent artifact in the background, which may be handled by introducing a brain mask and use [Edit][Trim Image] in the reconstruction step to clean up the background. 

If you still cannot solve the low R2 value problem, please feel free to send the data to me (uploaded provided in the webpage of the Discussion forum), and I will figure out a solution for you.

STEP2: Create a connectometry database

A connectometry database requires the ODF-containing fib files for all subjects and an atlas that serves as the sampling skeleton.

1) In the connectometry toolbox, click "Step 1: create connectometry database".

This brings up the following dialog.

2) Click the [Search in Directory] and select the study folder. You may also use the "Add" button to select individual FIB file. You can change the order of the files by the "up", "down", "sort" button. You can save/load a list of the SRC files.

*If you are going to study the change in a longitudinal study, make sure that you place baseline and followup scans of the same subject together (e.g. base of s#1, followup of #1, base of s#2, followup of s#2...etc.)

3) Assign the atlas file (skip if a default file is assigned). I recommend using the latest HCP 842 atlas, which is available at Atlas and sample images. The latest version of DSI Studio has it shipped with the package and will load it as the default. Using the default HCP842 template meaning that the HCP subjects (young aged adult) can be representative to your subject pool. If this is not true, you should consider create your own atlas. The choice depends entirely on your study and subject pool. 

4) Assign "Index of interest" (skip if using SDF as the default): You can also study other diffusion measures such as FA, AD, RD, MD, RDI, NRDI (see here for explanation for each index) using connectometry. If you only see SDF in the selection, please update DSI Studio and re-run STEP1d of this page to reconstruct SRC files again. (or feel free to contact me if still not solved).

4) Specify the output file name.

    Please assign the file extension as *.db.fib.gz

5) Click the "Create Database" button to create the connectometry database as a db.fib.gz file. You can add or remove subjects from the database using [Diffusion MRI Connectometry][Edit Connectometry Database]

6) Once you have the connectometry database, you can run group connectometry.