Difference between revisions of "Projects:RegistrationLibrary:RegLib C29"

From NAMIC Wiki
Jump to: navigation, search
m (Text replacement - "http://www.slicer.org/slicerWiki/index.php/" to "https://www.slicer.org/wiki/")
 
(18 intermediate revisions by one other user not shown)
Line 3: Line 3:
 
[[Projects:RegistrationDocumentation:UseCaseInventory|Back to Registration Use-case Inventory]] <br>
 
[[Projects:RegistrationDocumentation:UseCaseInventory|Back to Registration Use-case Inventory]] <br>
  
= <small>v3.6.1</small> [[Image:Slicer3-6Announcement-v1.png‎|150px]] Slicer Registration Library Case #29: Intra-subject Brain DTI =
+
= <small>updated for '''v4.1'''</small> [[Image:Slicer4_RegLibLogo.png|150px]] <br> Slicer Registration Library Case #29: Intra-subject Brain DTI =
 
=== Input ===
 
=== Input ===
 
{| style="color:#bbbbbb; " cellpadding="10" cellspacing="0" border="0"
 
{| style="color:#bbbbbb; " cellpadding="10" cellspacing="0" border="0"
Line 21: Line 21:
 
|}
 
|}
  
=== Modules ===
+
=== Slicer4 Modules used ===
*'''Slicer 3.6.1 recommended modules: [http://www.slicer.org/slicerWiki/index.php/Modules:BRAINSFit BrainsFit]'''
+
* [http://wiki.slicer.org/slicerWiki/index.php/Documentation/4.1/Modules/DiffusionTensorEstimation Diffusion Tensor Estimation module]
 +
* [http://wiki.slicer.org/slicerWiki/index.php/Documentation/4.1/Modules/BRAINSFit General Registration (BRAINS) module]
 +
* [http://wiki.slicer.org/slicerWiki/index.php/Documentation/4.1/Modules/ResampleDTI Resample DTI Volume module]
  
 
===Objective / Background ===
 
===Objective / Background ===
Line 29: Line 31:
 
=== Download ===
 
=== Download ===
 
*DATA
 
*DATA
**[[Media:RegLib_C29_DATA.zip‎|'''Registration Library Case 29 (full set)  <small> (Data & Solution Xforms, incl. DTI + DWI + resampled DTI, zip file 140 MB) </small>]]
+
**[[Media:RegLib_C29_Data.zip‎|'''Registration Library Case 29 '''<small> (Data & Solution Xforms, incl. DTI + DWI + resampled DTI, zip file 160 MB) </small>]]
**[[Media:RegLib_C29_DATA-MRI.zip‎|'''Registration Library Case 29 (small set) <small> (excl. DWI and resampled DTI images, use if interested in registration portion only, zip file 44 MB) </small>]]
+
 
**[[Media:RegLib_C29_DATA-DWI.zip‎|'''Registration Library Case 29 (suppl. set) <small> (DWI and resampled DTI images only, use if interested in DWI-DTI conversion, zip file 95 MB) </small>]]
+
*TUTORIALS (note the tutorials are for '''Slicer version 3.6'''; for [http://na-mic.org/Wiki/index.php/Projects:RegistrationLibrary:RegLib_C29#Procedures Slicer4 use the step-by-step instructions below]):  
*PRESETS:
 
**[[Media:RegLib_C29_Presets.mrml‎|'''Registration Library Case 29:  Parameter Presets <small> (presets for registration and resampling) 16kB, load via ''ImportScene..'') </small>]]
 
*TUTORIALS:  
 
 
**[[Media:RegLib_C29_DTI.ppt| Powerpoint Tutorial (.ppt PowerPoint file, 1.5 MB)]]
 
**[[Media:RegLib_C29_DTI.ppt| Powerpoint Tutorial (.ppt PowerPoint file, 1.5 MB)]]
 
**[[Media:RegLib_C29_DTI.pdf| Powerpoint Tutorial as PDF (PDF file 2.1 MB)]]
 
**[[Media:RegLib_C29_DTI.pdf| Powerpoint Tutorial as PDF (PDF file 2.1 MB)]]
Line 48: Line 47:
  
 
===Registration Challenges===
 
===Registration Challenges===
*The DTI sequence (EPI) contains string distortions we seek to correct via non-rigid alignment
+
*The DWI sequence (EPI) contains strong distortions we seek to correct via non-rigid alignment
 +
*The DWI sequence also contains strong intensity inhomogeneity (coil bias)
 
*the DTI baseline is similar in contrast to a T2, albeit at much lower resolution
 
*the DTI baseline is similar in contrast to a T2, albeit at much lower resolution
 
*we have different amounts of voxel-anisotropy
 
*we have different amounts of voxel-anisotropy
Line 54: Line 54:
  
 
===Key Strategies===
 
===Key Strategies===
*'''Slicer 3.6.1 recommended modules:  [http://www.slicer.org/slicerWiki/index.php/Modules:BRAINSFit BrainsFit]
+
*'''Slicer 4 recommended modules:  [https://www.slicer.org/wiki/Modules:BRAINSFit BrainsFit]
 
*to align the DTI with the T1 we need 2 registration steps: 1.align the T2 with the T1 and 2. align the DTI with the T2. The DTI baseline scan has contrast most similar to the T2 and hence is best registered against the T2. However the structural reference scan with highest resolution and tissue contrast is the T1.
 
*to align the DTI with the T1 we need 2 registration steps: 1.align the T2 with the T1 and 2. align the DTI with the T2. The DTI baseline scan has contrast most similar to the T2 and hence is best registered against the T2. However the structural reference scan with highest resolution and tissue contrast is the T1.
 
*we therefore use the following approach: 1) we first co-register the T2 with the SPGR T1.  2) we register the DTI baseline to the  registered/resampled T2;  3) resample the DTI volume with the new transform
 
*we therefore use the following approach: 1) we first co-register the T2 with the SPGR T1.  2) we register the DTI baseline to the  registered/resampled T2;  3) resample the DTI volume with the new transform
Line 65: Line 65:
 
:#repeat Affine+BSpline align of DTI_base to T2r, WITH masks
 
:#repeat Affine+BSpline align of DTI_base to T2r, WITH masks
 
:#resample DTI with result Affine+BSpline transform
 
:#resample DTI with result Affine+BSpline transform
 
 
=== Procedures ===
 
=== Procedures ===
*'''Phase I: LOAD DATA'''
+
*'''Phase I: Preprocessing: Build DWI mask + baseline'''
#download example dataset
+
#open the [http://wiki.slicer.org/slicerWiki/index.php/Documentation/4.1/Modules/DiffusionWeightedMasking ''Modules:Diffusion:DiffusionWeightedImages:DiffusionWeightedVolumeMasking'' ] module
#load into 3DSlicer 3.6.1 (Load Scene)
+
##''Input DWI Volume'': "DWI"
#To convert the DWI into a DTI: use the ''Converters / DICOM to NRRD Converter'' module
+
##''Output Baseline Volume''''Create New Volume'', rename to "DWI_baseline"
*'''Phase II: Register T2 to SPGR'''
+
##''Output Threshold Mask'': ''Create New Volume'', rename to "DWI_mask"
#open Registration : ''BrainsFit'' module
+
##Leave other settings at default; click ''Apply''
##Registration Phases:  
+
*'''Phase II: Preprocessing: Convert DWI -> DTI'''
##select/check ''Include Rigid registration phase''
+
#open [http://wiki.slicer.org/slicerWiki/index.php/Documentation/4.1/Modules/DiffusionTensorEstimation "Diffusion Tensor Estimation" module] (menu: Diffusion:DiffusionWeightedImages: DiffusionTensorEstimation)
##select/check ''Include Affine registration phase''
+
##''Input DWI Volume'': DWI_iso,  
##select a new transform ''Output Transform''
+
##''Output DTI Volume'': create new, rename to "DTI_iso"
#Registration Parameters: increase ''Number Of Samples'' to 200,000
+
##''Output Baseline Volume'': create new, rename to "DWI_iso_baseline"
#Leave all other settings at default
+
#Click: Apply
#click apply; runtime ca. 1-2 min.
+
*'''Phase III: register T2 to T1'''
#Resample T2 into T1 space
+
#open the [http://wiki.slicer.org/slicerWiki/index.php/Documentation/4.1/Modules/BRAINSFit General Registration (BRAINS) module]
##Open ''Resample Scalar/Vector/DWI Volume'' module (Filtering menu)
+
##''Fixed Image Volume'': T1
##Input Volume: T2, Reference Volume: T1
+
##''Moving Image Volume'': T2
##Output Volume: create new volume, rename to "T2_Xf1"
 
##Interpolation Type: select ''ws'' (windowed sinc)
 
##Click Apply.
 
##Upon completion, go to ''Volumes'' module to adjust window & level
 
##Active Volume: select T2_Xf1
 
##Open Display tab and adjust window & level, e.g. 1300/700
 
*'''Phase III:REGISTER DTI TO T2_Xf1'''
 
#open Registration : ''BrainsFit'' module
 
##Registration Phases:
 
##set T2_Xf1 as fixed and DTI_baseline as moving image
 
###select/check ''Include Rigid registration phase''
 
###select/check ''Include Affine registration phase''
 
###select/check ''Include BSpline registration phase''
 
###select ''Initialize with CenterofHeadAlign''
 
###select ''Include Rigid registration phase''
 
###select ''Include Affine registration phase''
 
 
##Output Settings:  
 
##Output Settings:  
###select a new transform "Slicer BSpline Transform", rename to "Xf2_DTI-T1''
+
###''Slicer BSpline Transform": none
###select a new volume "Output Image Volume''
+
###''Slicer Linear Transform'': create new transform, rename to "Xf1_T2-T1"
##Registration Parameters: increase ''Number Of Samples'' to 200,000
+
###''Output Image Volume'': create new volume,  rename to "T2_Xf1"
 +
##''Registration Phases'': check boxes for ''Rigid'' and ''Affine''
 +
##''Main Parameters'':
 +
###''Number Of Samples'': 200,000
 
##Leave all other settings at default
 
##Leave all other settings at default
##click apply; runtime ca. 3 min.
+
##click: Apply; runtime < 10 sec (MacPro QuadCore 2.4GHz)
*'''Phase IV: Resample DTI'''
+
*'''Phase IV: Register DTI (masked)'''
#Load the combined transform (''Add Data'')
+
#open the [http://wiki.slicer.org/slicerWiki/index.php/Documentation/4.1/Modules/BRAINSFit General Registration (BRAINS) module]
#Open the ''Resample DTI Volume'' module (found under: All Modules)
+
##''Fixed Image Volume'': FLAIR_Xf1
##Input Volume: select DTI
+
##''Moving Image Volume'': DWI_iso_baseline
##Output Volume: select ''New DTI Volume'', rename to ''DTI_Xf2''
+
##Output Settings:
##Reference Volume: select ''T1''
+
###''Slicer BSpline Transform": create new transform, rename to "Xf2_DTI-T1"
##Transform Parameters: select transform "Xf2_DTI-T1''
+
###''Slicer Linear Transform'': none
##check box: ''output-to-input''
+
###''Output Image Volume'': create new volume, rename to DWI_baseline_Xf2
##Leave all other settings at defaults
+
##''Regstration Phases'': check boxes for ''Rigid'',  ''Affine'' and ''BSpline''
##Click Apply; runtime ca. 3-4 min.
+
##''Main Parameters'':
#Go to the ''Volumes'' module, select the newly produced ''DTI_Xf2'' volume
+
###''Number Of Samples'': 300,000
#under the ''Display'' tab, select ''Color Orientation'' from the ''Scalar Mode'' menu
+
###''B-Spline Grid Size'': 7,7,5
#set ''T1'' as background and new  ''DTI_Xf2'' volume as foreground
+
##''Mask Option'': select ''ROIAUTO'' button
#Set fade slider to see DTI overlay onto the SPGR image
+
###''(ROIAUTO) Output fixed mask'': create new volume
 
+
###''(ROIAUTO) Output moving mask'': create new volume
for more details see the tutorial(s) under Downloads
+
##Leave all other settings at default
 +
##click: Apply; runtime 1-2 min (MacPro QuadCore 2.4GHz)
 +
*'''Phase V: Resample DTI'''
 +
#Open the [http://wiki.slicer.org/slicerWiki/index.php/Documentation/4.1/Modules/ResampleDTI ''Resample DTI Volume'' module]  (under ''All Modules'' menu; note this is distinct from the ResampleScalarVectorDWIVolume used above)
 +
##''Input Volume'': DTI
 +
##''Output Volume'': create new DTI Volume, rename to ''DTI_Xf2''
 +
##''Reference Volume'': T2_Xf1
 +
##''Transform Node'': select "Xf2_DTI-T1'' created above
 +
##check box: ''displacement''
 +
#leave all other settings at defaults
 +
#Click Apply; runtime ~ 3 min.
 +
#set T1 or FLAIR as background and the new  ''DTI_Xf2'' volume as foreground
 +
#Move fade slider to see DTI overlay onto the structural image
  
 
=== Registration Results===
 
=== Registration Results===
[[Image:RegLib_C29_AGif_full.gif|500px|Registered DTI superimposed on SPGR and T2]] registered (cycles show T1 and T2 and color DTI overlay)<br>
+
[[Image:RegLib_C29_registered.gif|500px|Registered DTI superimposed on SPGR and T2]] registered (cycles show T1 and T2 and color DTI overlay)<br>
 
<br>
 
<br>

Latest revision as of 17:40, 10 July 2017

Home < Projects:RegistrationLibrary:RegLib C29

Back to ARRA main page
Back to Registration main page
Back to Registration Use-case Inventory

updated for v4.1 Slicer4 RegLibLogo.png
Slicer Registration Library Case #29: Intra-subject Brain DTI

Input

this is the fixed reference image. All images are aligned into this space lleft this is the T2 reference image, serves as target to the DTI baseline, but is itself aligned to the SPGR lleft this is the DTI Baseline scan, to be registered with the T2 this is the DTI tensor image, in the same orientation as the DTI Baseline
fixed image/target
T1 SPGR
moving image 1
T2
moving image 2a
DTI baseline
moving image 2b
DTI tensor

Slicer4 Modules used

Objective / Background

This is a classic case of a multi-sequence MRI exam we wish to spatially align to the anatomical reference scan (T1-SPGR). The scan of interest is the DTI image to be aligned for surgical planning/reference.

Download

Keywords

MRI, brain, head, intra-subject, DTI, T1, T2, non-rigid, tumor, surgical planning

Input Data

  • reference/fixed : T1 SPGR , 0.5x0.5x1 mm voxel size, 512 x 512 x 176
  • moving 1: T2 0.5x0.5x1.5 mm voxel size, 512 x 512 x 92
  • moving 2a: DTI baseline: 1 x 1 x 3 mm, 256 x 256 x 41
  • moving 2b: 1 x 1 x 3 mm, 256 x 256 x 41 x 9 (tensor), original: DWI 256 x 256 x 41 x 32 directions

Registration Challenges

  • The DWI sequence (EPI) contains strong distortions we seek to correct via non-rigid alignment
  • The DWI sequence also contains strong intensity inhomogeneity (coil bias)
  • the DTI baseline is similar in contrast to a T2, albeit at much lower resolution
  • we have different amounts of voxel-anisotropy
  • a direct registration of the DTI_baseline to the SPGR will fail, hence a 2-step approach is required

Key Strategies

  • Slicer 4 recommended modules: BrainsFit
  • to align the DTI with the T1 we need 2 registration steps: 1.align the T2 with the T1 and 2. align the DTI with the T2. The DTI baseline scan has contrast most similar to the T2 and hence is best registered against the T2. However the structural reference scan with highest resolution and tissue contrast is the T1.
  • we therefore use the following approach: 1) we first co-register the T2 with the SPGR T1. 2) we register the DTI baseline to the registered/resampled T2; 3) resample the DTI volume with the new transform
  • the DTI-T2 registration includes non-rigid deformation to correct for the strong distortions from the EPI acquisition. Because of the nonrigid component a mask of the brain parenchyma helps greatly in obtaining a meaningful transform.
  • The DTI estimation provides an automated mask for the DTI_baseline scan, but we have no mask for the T2. We can either obtain one through separate segmentation or by sending the DTI_mask through an additional registration step. In this example we show the latter.
  • thus the full pipeline is this:
  1. Affine align T2-T1, incl. resampled T2 volume = T2r
  2. Affine+BSpline align of DTI_baseline to T2r (unmasked)
  3. Resample DTI_mask with above BSpline -> mask for the T2r
  4. repeat Affine+BSpline align of DTI_base to T2r, WITH masks
  5. resample DTI with result Affine+BSpline transform

Procedures

  • Phase I: Preprocessing: Build DWI mask + baseline
  1. open the Modules:Diffusion:DiffusionWeightedImages:DiffusionWeightedVolumeMasking module
    1. Input DWI Volume: "DWI"
    2. Output Baseline Volume: Create New Volume, rename to "DWI_baseline"
    3. Output Threshold Mask: Create New Volume, rename to "DWI_mask"
    4. Leave other settings at default; click Apply
  • Phase II: Preprocessing: Convert DWI -> DTI
  1. open "Diffusion Tensor Estimation" module (menu: Diffusion:DiffusionWeightedImages: DiffusionTensorEstimation)
    1. Input DWI Volume: DWI_iso,
    2. Output DTI Volume: create new, rename to "DTI_iso"
    3. Output Baseline Volume: create new, rename to "DWI_iso_baseline"
  2. Click: Apply
  • Phase III: register T2 to T1
  1. open the General Registration (BRAINS) module
    1. Fixed Image Volume: T1
    2. Moving Image Volume: T2
    3. Output Settings:
      1. Slicer BSpline Transform": none
      2. Slicer Linear Transform: create new transform, rename to "Xf1_T2-T1"
      3. Output Image Volume: create new volume, rename to "T2_Xf1"
    4. Registration Phases: check boxes for Rigid and Affine
    5. Main Parameters:
      1. Number Of Samples: 200,000
    6. Leave all other settings at default
    7. click: Apply; runtime < 10 sec (MacPro QuadCore 2.4GHz)
  • Phase IV: Register DTI (masked)
  1. open the General Registration (BRAINS) module
    1. Fixed Image Volume: FLAIR_Xf1
    2. Moving Image Volume: DWI_iso_baseline
    3. Output Settings:
      1. Slicer BSpline Transform": create new transform, rename to "Xf2_DTI-T1"
      2. Slicer Linear Transform: none
      3. Output Image Volume: create new volume, rename to DWI_baseline_Xf2
    4. Regstration Phases: check boxes for Rigid, Affine and BSpline
    5. Main Parameters:
      1. Number Of Samples: 300,000
      2. B-Spline Grid Size: 7,7,5
    6. Mask Option: select ROIAUTO button
      1. (ROIAUTO) Output fixed mask: create new volume
      2. (ROIAUTO) Output moving mask: create new volume
    7. Leave all other settings at default
    8. click: Apply; runtime 1-2 min (MacPro QuadCore 2.4GHz)
  • Phase V: Resample DTI
  1. Open the Resample DTI Volume module (under All Modules menu; note this is distinct from the ResampleScalarVectorDWIVolume used above)
    1. Input Volume: DTI
    2. Output Volume: create new DTI Volume, rename to DTI_Xf2
    3. Reference Volume: T2_Xf1
    4. Transform Node: select "Xf2_DTI-T1 created above
    5. check box: displacement
  2. leave all other settings at defaults
  3. Click Apply; runtime ~ 3 min.
  4. set T1 or FLAIR as background and the new DTI_Xf2 volume as foreground
  5. Move fade slider to see DTI overlay onto the structural image

Registration Results

Registered DTI superimposed on SPGR and T2 registered (cycles show T1 and T2 and color DTI overlay)