Difference between revisions of "Documentation:Nightly:Registration:RegistrationLibrary:RegLib C15"

From Slicer Wiki
Jump to: navigation, search
 
(7 intermediate revisions by the same user not shown)
Line 5: Line 5:
 
|[[Image:RegLib_C15_Thumb1.png|150px|lleft|this is the target orientation in which is AC-PC line is horizontal and the inter-hemispheral midline is vertical]]  
 
|[[Image:RegLib_C15_Thumb1.png|150px|lleft|this is the target orientation in which is AC-PC line is horizontal and the inter-hemispheral midline is vertical]]  
 
|[[Image:RegArrow_Rigid.png|100px|lleft]]  
 
|[[Image:RegArrow_Rigid.png|100px|lleft]]  
|[[Image:RegLib_C15_Thumb2.png|150px|lleft|this is the PET scan, to be aligned with the MRI]]
+
|[[Image:RegLib_C15_Thumb2.png|150px|lleft|this is the MRI image in the original position.]]
 
|-
 
|-
 
|target POS<br>MRI
 
|target POS<br>MRI
Line 12: Line 12:
 
|}
 
|}
  
 +
== Description ==
 +
This example shows the use of the AC-PC alignment volume. Aligning a brain image along the anterior- (AC) posterior commissure is a standard procedure in many analyses. <br>
 +
'''Approach''': we create two sets of Annotations containing fiducial points that define the inter-hemispheral midline and the anterior and posterior commissure, respectively. This is then used as input to the ACPC module.
 
== Modules used ==
 
== Modules used ==
*[[Documentation/Nightly/Modules/BRAINSFit| ''General Registration (BRAINS)'']]
+
*[[Documentation/Nightly/Modules/ACPCTransform|''ACPC Transform'' module]]
 +
*[[Documentation/Nightly/Modules/Annotations|''Annotations'' module]]
  
 
== Download (from NAMIC MIDAS) ==
 
== Download (from NAMIC MIDAS) ==
 
<small>''Why 2 sets of files?  The "input data" mrb includes only the unregistered data to try the method yourself from start to finish. The full dataset includes intermediate files and results (transforms, resampled images etc.). If you use the full dataset we recommend to choose different names for the images/results you create yourself to distinguish the old data from the new one you generated yourself. ''</small>
 
<small>''Why 2 sets of files?  The "input data" mrb includes only the unregistered data to try the method yourself from start to finish. The full dataset includes intermediate files and results (transforms, resampled images etc.). If you use the full dataset we recommend to choose different names for the images/results you create yourself to distinguish the old data from the new one you generated yourself. ''</small>
*[http://slicer.kitware.com/midas3/download/?items=103751 '''RegLib_C15.mrb''': input data only (incl. fiducials), use this to run the tutorial from the start <small>(Slicer mrb file. 22 MB). </small>]
+
*[http://slicer.kitware.com/midas3/download/?items=103755 '''RegLib_C15.mrb''': input data only (incl. fiducials), use this to run the tutorial from the start <small>(Slicer mrb file. 22 MB). </small>]
*[http://slicer.kitware.com/midas3/download/?items=103750 '''RegLib_C15_full.mrb''': includes raw data + all solutions and intermediate files, use to browse/verify <small>(Slicer mrb file. 22 MB). </small>]
+
*[http://slicer.kitware.com/midas3/download/?items=103754 '''RegLib_C15_full.mrb''': includes raw data + all solutions and intermediate files, use to browse/verify <small>(Slicer mrb file. 22 MB). </small>]
  
 
== Keywords ==
 
== Keywords ==
Line 27: Line 31:
  
 
== Procedure ==
 
== Procedure ==
#'''Create Fiducial Landmarks''': open the [[Documentation/Nightly/Modules/Annotations|''Annotations'' module]]
+
#'''Create Fiducial Landmarks''': open the [[Documentation/Nightly/Modules/Annotations|''Annotations'' module]]. We will create 2 annotation lists, one containing the anterior and posterior commissure, and one containing midline points.
 
##in a slice view, locate the anterior commissure (sagittal view recommended).  
 
##in a slice view, locate the anterior commissure (sagittal view recommended).  
 
##Click on the Fiducial placement button in the toolbar. This declares the next left mouseclick to be a fiducial selection.
 
##Click on the Fiducial placement button in the toolbar. This declares the next left mouseclick to be a fiducial selection.
Line 37: Line 41:
 
##n the ''Fiducial'' module, make sure the above created midline landmarks are all in the same '"Midline" hierarchy.
 
##n the ''Fiducial'' module, make sure the above created midline landmarks are all in the same '"Midline" hierarchy.
 
##The "AC-PC" hierarchy should only contain 2 landmarks for AC and PC, respectively
 
##The "AC-PC" hierarchy should only contain 2 landmarks for AC and PC, respectively
##The "Midline" hierarchy should only contain 4 or more landmarks defining the interhemispheral midline
+
##The "Midline'' hierarchy should only contain 4 or more landmarks defining the interhemispheral midline
#Open the  [[Documentation/Nightly/Modules/ACPCTransform|''ACPC Transform'' module]]
+
#'''Calculate the transform''': Open the  [[Documentation/Nightly/Modules/ACPCTransform|''ACPC Transform'' module]]
 
##''ACPC Line'': select the fiducial list created above, named "AC-PC"
 
##''ACPC Line'': select the fiducial list created above, named "AC-PC"
##''Midline:" select the fiducial list created above, named "Midline"
+
##''Midline:'' select the fiducial list created above, named "Midline"
 
##''Output transform'':  create new & rename: rename to "Xf1_ACPC" or similar
 
##''Output transform'':  create new & rename: rename to "Xf1_ACPC" or similar
 
##click: ''Apply''; runtime ~ 1 second.
 
##click: ''Apply''; runtime ~ 1 second.
#'''Apply transform:''' We have now computed the registration transform, but we still need to apply this transform to the MRI image. The preferred way to do this is without resampling the image, i.e. by applying the linear transform to the spatial orientation information in the image header.
+
#'''Apply the transform:''' We have now computed the registration transform, but we still need to apply this transform to the MRI image. The preferred way to do this is without resampling the image, i.e. by applying the linear transform to the spatial orientation information in the image header.
 
##Go to the [[Documentation/Nightly/Modules/Data|''Data'']] module  
 
##Go to the [[Documentation/Nightly/Modules/Data|''Data'']] module  
 
###Find the original image, labeled as "MRI"
 
###Find the original image, labeled as "MRI"
 
###drag the "MRI" node '''onto''' the transform node, labeled "Xf1_ACPC". You should see a small + appear next to the transform node. When you click it you should see the image now residing inside the transform. If you have the Slice views, it should show you now the aligned position of the MRI image.
 
###drag the "MRI" node '''onto''' the transform node, labeled "Xf1_ACPC". You should see a small + appear next to the transform node. When you click it you should see the image now residing inside the transform. If you have the Slice views, it should show you now the aligned position of the MRI image.
 
###apply the transform: right click on the "MRI" image and from the pop-up menu, select ''Harden Transform''. This will apply the transform '''without resampling''' and move it back to the main hierarchy level.  
 
###apply the transform: right click on the "MRI" image and from the pop-up menu, select ''Harden Transform''. This will apply the transform '''without resampling''' and move it back to the main hierarchy level.  
###double click on the PET node and rename it to something like "MRI_ACPCAligned" or similar, to document that this image has now a transform applied to it.
+
###double click on the MRI node and rename it to something like "MRI_ACPCAligned" or similar, to document that this image has now a transform applied to it.
 
##Click on the Save icon and save the new image under a new name.
 
##Click on the Save icon and save the new image under a new name.
  
Line 54: Line 58:
  
 
{|cellpadding="10" cellspacing="0" border="0"
 
{|cellpadding="10" cellspacing="0" border="0"
|[[Image:RegLib_C14_unregistered.png|300px]] ||MRI and PET before registration (click to enlarge)
+
|[[Image:RegLib_C15_registered.gif|300px]]||MRI and PET after registration (click to enlarge)
|-
 
|[[Image:RegLib_C14_registered.gif|300px]]||MRI and PET after registration (click to enlarge)
 
 
|}
 
|}
  
  
 
=== Acknowledgments ===
 
=== Acknowledgments ===

Latest revision as of 18:48, 28 August 2013

Home < Documentation:Nightly:Registration:RegistrationLibrary:RegLib C15

Back to Registration Library

Slicer Registration Library Case #15: Align brain MRI along anatomical AC-PC line

Input

this is the target orientation in which is AC-PC line is horizontal and the inter-hemispheral midline is vertical lleft this is the MRI image in the original position.
target POS
MRI
moving image
MRI

Description

This example shows the use of the AC-PC alignment volume. Aligning a brain image along the anterior- (AC) posterior commissure is a standard procedure in many analyses.
Approach: we create two sets of Annotations containing fiducial points that define the inter-hemispheral midline and the anterior and posterior commissure, respectively. This is then used as input to the ACPC module.

Modules used

Download (from NAMIC MIDAS)

Why 2 sets of files? The "input data" mrb includes only the unregistered data to try the method yourself from start to finish. The full dataset includes intermediate files and results (transforms, resampled images etc.). If you use the full dataset we recommend to choose different names for the images/results you create yourself to distinguish the old data from the new one you generated yourself.

Keywords

MRI, brain, head, AC-PC, landmark, registration

Video Screencasts

  1. Movie/screencast showing registration for Case #15, incl. selection of fiducial landmarks

Procedure

  1. Create Fiducial Landmarks: open the Annotations module. We will create 2 annotation lists, one containing the anterior and posterior commissure, and one containing midline points.
    1. in a slice view, locate the anterior commissure (sagittal view recommended).
    2. Click on the Fiducial placement button in the toolbar. This declares the next left mouseclick to be a fiducial selection.
    3. click (left mouse button) in the image to place the fiducial. You should see an annotation being placed at the location.
    4. Locate the prosterior commissure and repeat fiducial placement above.
    5. In the Fiducial module, make sure the two created landmarks are in the same hierarchy. Rename the hierarchy "AC-PC" or similar
    6. Create a new fiducial hierarchy. Rename to "Midline"
    7. in the axial view, place 4-5 landmarks along the interhemispheral midline (same as above)
    8. n the Fiducial module, make sure the above created midline landmarks are all in the same '"Midline" hierarchy.
    9. The "AC-PC" hierarchy should only contain 2 landmarks for AC and PC, respectively
    10. The "Midline hierarchy should only contain 4 or more landmarks defining the interhemispheral midline
  2. Calculate the transform: Open the ACPC Transform module
    1. ACPC Line: select the fiducial list created above, named "AC-PC"
    2. Midline: select the fiducial list created above, named "Midline"
    3. Output transform: create new & rename: rename to "Xf1_ACPC" or similar
    4. click: Apply; runtime ~ 1 second.
  3. Apply the transform: We have now computed the registration transform, but we still need to apply this transform to the MRI image. The preferred way to do this is without resampling the image, i.e. by applying the linear transform to the spatial orientation information in the image header.
    1. Go to the Data module
      1. Find the original image, labeled as "MRI"
      2. drag the "MRI" node onto the transform node, labeled "Xf1_ACPC". You should see a small + appear next to the transform node. When you click it you should see the image now residing inside the transform. If you have the Slice views, it should show you now the aligned position of the MRI image.
      3. apply the transform: right click on the "MRI" image and from the pop-up menu, select Harden Transform. This will apply the transform without resampling and move it back to the main hierarchy level.
      4. double click on the MRI node and rename it to something like "MRI_ACPCAligned" or similar, to document that this image has now a transform applied to it.
    2. Click on the Save icon and save the new image under a new name.

Registration Results

RegLib C15 registered.gif MRI and PET after registration (click to enlarge)


Acknowledgments