Category:Documentation/Nightly/Modules/Registration - Revision history

Meier: /* Alternative/Specialized Registration Modules */

2014-08-29T22:15:52Z

Alternative/Specialized Registration Modules

Meier: /* Alternative/Specialized Registration Modules */

2014-08-29T22:15:05Z

Alternative/Specialized Registration Modules

Meier: /* Alternative/Specialized Registration Modules */

2014-08-29T22:13:05Z

Alternative/Specialized Registration Modules

Meier: /* Default Registration Modules */

2013-09-13T20:16:57Z

Default Registration Modules

Meier: /* Default Registration Modules */

2013-09-13T20:13:57Z

Default Registration Modules

Meier at 20:06, 13 September 2013

2013-09-13T20:06:29Z

Meier: /* Default Registration Modules */

2013-09-13T20:05:54Z

Default Registration Modules

Meier: /* Default Registration Modules */

2013-09-13T20:05:36Z

Default Registration Modules

Meier: /* Default Registration Modules */

2013-09-13T20:04:04Z

Default Registration Modules

Meier at 18:31, 13 September 2013

2013-09-13T18:31:25Z

@@ Line 32: / Line 32: @@
 |align="center" |[[Image:Registration_BRAINSdemonwarp.png|95px|link=Documentation/{{documentation/version}}/Modules/BRAINSDemonWarp]]
 |-
-|The [[Documentation/{{documentation/version}}/Modules/FiducialRegistration|'''Fiducial Registration''']] module will align images based on pairs of manually selected fiducial points (rigid and affine). Two sets of fiducials (fiducial lists) are required, forming matching pairs to be aligned.  This module is in the '''Registration/Specialized/Fiducial Registration''' menu.<br>An alternative landmark registration tool is also available in the [[Documentation/{{documentation/version}}/Extensions/SlicerIGT|Slicer IGT extension]] as "Fiducial Registration Wizard".
+|The [[Documentation/{{documentation/version}}/Modules/FiducialRegistration|'''Fiducial Registration''']] module will align images based on pairs of manually selected fiducial points (rigid and affine). Two sets of fiducials (fiducial lists) are required, forming matching pairs to be aligned.  This module is in the '''Registration/Specialized/Fiducial Registration''' menu.<br>An alternative landmark registration tool is also available in the [[Documentation/{{documentation/version}}/Extensions/SlicerIGT|'''Slicer IGT extension''']] as "Fiducial Registration Wizard".
 |The [[Documentation/{{documentation/version}}/Modules/ACPCTransform|'''ACPC Transform''']] module is used to orient '''brain''' images along predefined anatomical landmarks: (manually defined)  fiducials for the inter-hemispheral midline, anterior- and posterior commissure are used to align an image such that these landmarks become vertical and horizontal, respectively.  This module is in the '''Registration/Specialized/ACPC Transform''' menu.
 |The [[Documentation/{{documentation/version}}/Modules/BRAINSDemonWarp|'''BRAINSDemonWarp''' ]] Module performs automated image warping based on an optic flow mechanism. Deformations here are significantly more "fluid" (i.e. have more DOF and are less constrained) than for the nonrigid BSpline method provided in the general (BRAINS) registration above.  This module is in the '''Registration/Specialized/Demon Registration (BRAINS)''' menu.
 |}
 </small>

@@ Line 32: / Line 32: @@
 |align="center" |[[Image:Registration_BRAINSdemonwarp.png|95px|link=Documentation/{{documentation/version}}/Modules/BRAINSDemonWarp]]
 |-
-|The [[Documentation/{{documentation/version}}/Modules/FiducialRegistration|'''Fiducial Registration''']] module will align images based on pairs of manually selected fiducial points (rigid and affine). Two sets of fiducials (fiducial lists) are required, forming matching pairs to be aligned.  This module is in the '''Registration/Specialized/Fiducial Registration''' menu.<br>An alternative landmark registration tool is also available in the [[Documentation/{{documentation/version}}/Modules/Extensions/SlicerIGT|Slicer IGT extension]] as "Fiducial Registration Wizard".
+|The [[Documentation/{{documentation/version}}/Modules/FiducialRegistration|'''Fiducial Registration''']] module will align images based on pairs of manually selected fiducial points (rigid and affine). Two sets of fiducials (fiducial lists) are required, forming matching pairs to be aligned.  This module is in the '''Registration/Specialized/Fiducial Registration''' menu.<br>An alternative landmark registration tool is also available in the [[Documentation/{{documentation/version}}/Extensions/SlicerIGT|Slicer IGT extension]] as "Fiducial Registration Wizard".
 |The [[Documentation/{{documentation/version}}/Modules/ACPCTransform|'''ACPC Transform''']] module is used to orient '''brain''' images along predefined anatomical landmarks: (manually defined)  fiducials for the inter-hemispheral midline, anterior- and posterior commissure are used to align an image such that these landmarks become vertical and horizontal, respectively.  This module is in the '''Registration/Specialized/ACPC Transform''' menu.
 |The [[Documentation/{{documentation/version}}/Modules/BRAINSDemonWarp|'''BRAINSDemonWarp''' ]] Module performs automated image warping based on an optic flow mechanism. Deformations here are significantly more "fluid" (i.e. have more DOF and are less constrained) than for the nonrigid BSpline method provided in the general (BRAINS) registration above.  This module is in the '''Registration/Specialized/Demon Registration (BRAINS)''' menu.
 |}
 </small>

@@ Line 32: / Line 32: @@
 |align="center" |[[Image:Registration_BRAINSdemonwarp.png|95px|link=Documentation/{{documentation/version}}/Modules/BRAINSDemonWarp]]
 |-
-|The [[Documentation/{{documentation/version}}/Modules/FiducialRegistration|'''Fiducial Registration''']] module will align images based on pairs of manually selected fiducial points (rigid and affine). Two sets of fiducials (fiducial lists) are required, forming matching pairs to be aligned.  This module is in the '''Registration/Specialized/Fiducial Registration''' menu.
+|The [[Documentation/{{documentation/version}}/Modules/FiducialRegistration|'''Fiducial Registration''']] module will align images based on pairs of manually selected fiducial points (rigid and affine). Two sets of fiducials (fiducial lists) are required, forming matching pairs to be aligned.  This module is in the '''Registration/Specialized/Fiducial Registration''' menu.<br>An alternative landmark registration tool is also available in the [[Documentation/{{documentation/version}}/Modules/Extensions/SlicerIGT|Slicer IGT extension]] as "Fiducial Registration Wizard".
 |The [[Documentation/{{documentation/version}}/Modules/ACPCTransform|'''ACPC Transform''']] module is used to orient '''brain''' images along predefined anatomical landmarks: (manually defined)  fiducials for the inter-hemispheral midline, anterior- and posterior commissure are used to align an image such that these landmarks become vertical and horizontal, respectively.  This module is in the '''Registration/Specialized/ACPC Transform''' menu.
 |The [[Documentation/{{documentation/version}}/Modules/BRAINSDemonWarp|'''BRAINSDemonWarp''' ]] Module performs automated image warping based on an optic flow mechanism. Deformations here are significantly more "fluid" (i.e. have more DOF and are less constrained) than for the nonrigid BSpline method provided in the general (BRAINS) registration above.  This module is in the '''Registration/Specialized/Demon Registration (BRAINS)''' menu.
 |}
 </small>

@@ Line 21: / Line 21: @@
 |align="center" |[[Image:Registration_Resample_icon.png| 135px |link=Documentation/{{documentation/version}}/Modules/BRAINSResample]]
 |-
-|The [[Documentation/{{documentation/version}}/Modules/BRAINSResample|'''Resample Image (BRAINS)''']] module is used to apply a given transform to a volume, with specific interpolation settings (linear, nearest neighbor, sinc etc).It also permits to add a grid to the image that shows the effects of the transform, particularly useful for visualizing the deformation in nonrigid registration. The  [[Documentation/{{documentation/version}}/Modules/ResampleScalarVectorDWI|'''Resample ScalarVectorDWI''']] module (under ''AllModules'') also provides resampling functionality.
+|The [[Documentation/{{documentation/version}}/Modules/BRAINSResample|'''Resample Image (BRAINS)''']] module is used to apply a given transform to a volume, with specific interpolation settings (linear, nearest neighbor, sinc etc).It also permits to add a grid to the image that shows the effects of the transform, particularly useful for visualizing the deformation in nonrigid registration. The  [[Documentation/{{documentation/version}}/Modules/ResampleScalarVectorDWIVolume|'''Resample ScalarVectorDWI''']] module (under ''AllModules'') also provides resampling functionality. Note that to resample '''tensor''' images (e.g.DTI) a special  [[Documentation/{{documentation/version}}/Modules/ResampleDTIVolume |'''ResampleDTI''']]  module must be used to correctly apply a transform.
 |}

@@ Line 21: / Line 21: @@
 |align="center" |[[Image:Registration_Resample_icon.png| 135px |link=Documentation/{{documentation/version}}/Modules/BRAINSResample]]
 |-
-|The [[Documentation/{{documentation/version}}/Modules/BRAINSResample|'''Resample Image (BRAINS)''']] module is used to apply a given transform to a volume, with specific interpolation settings (linear, nearest neighbor, sinc etc).It also permits to add a grid to the image that shows the effects of the transform, particularly useful for visualizing the deformation in nonrigid registration.
+|The [[Documentation/{{documentation/version}}/Modules/BRAINSResample|'''Resample Image (BRAINS)''']] module is used to apply a given transform to a volume, with specific interpolation settings (linear, nearest neighbor, sinc etc).It also permits to add a grid to the image that shows the effects of the transform, particularly useful for visualizing the deformation in nonrigid registration. The  [[Documentation/{{documentation/version}}/Modules/ResampleScalarVectorDWI|'''Resample ScalarVectorDWI''']] module (under ''AllModules'') also provides resampling functionality.
 |}

@@ Line 9: / Line 9: @@
 The main modules/tools are listed/explained below, to help you find the right tool for the task:
 == Default Registration Modules==
-<small>
 {| cellpadding="2" cellspacing="2"  width="1250"
 |align="center" |[[Image:Registration_Manual_icon.png| 135px |link=Documentation/{{documentation/version}}/Modules/Transforms]]
@@ Line 23: / Line 23: @@
 |The [[Documentation/{{documentation/version}}/Modules/BRAINSResample|'''Resample Image (BRAINS)''']] module is used to apply a given transform to a volume, with specific interpolation settings (linear, nearest neighbor, sinc etc).It also permits to add a grid to the image that shows the effects of the transform, particularly useful for visualizing the deformation in nonrigid registration.
 |}
 == Alternative/Specialized  Registration Modules ==

@@ Line 18: / Line 18: @@
 |The [[Documentation/{{documentation/version}}/Modules/BRAINSFit| '''BRAINSfit''']] Module performs  automated intensity-based image alignment via rigid to affine to nonrigid transforms, with many options such as automated initialization, masking support, resampling. Advanced options allow to control the degree of freedom in sequence from 6 to 12 and beyond. You can find it under the '''Registration/General Registration (BRAINS)''' menu.
 |Nonrigid registration is also provided by the  [[Documentation/{{documentation/version}}/Modules/BRAINSFit| '''BRAINSfit''']] module.  Deformation is controlled via a BSpline control grid of custom size. This can be combined with linear/affine registration steps. Found under '''Registration/General Registration (BRAINS)''' menu. An alternative module (found under ''"All Modules"'') is  [[Documentation/{{documentation/version}}/Modules/BSplineDeformableRegistration| '''BSpline Deformable Registration''']], an older but efficient module with less control but also some options not avail. in BRAINSfit (histogram bins and warp field output).
-|}
+|-
 </small>
 == Alternative/Specialized  Registration Modules ==

@@ Line 1: / Line 1: @@
-This is an introduction to the registration technology which is available in Slicer 4. This page is intended to help you choose the right tool. For detailed information on using a particular module please follow the links to the module's reference page.
+This is an introduction to the registration technology which is available in Slicer 4. This page is intended to help you choose the right tool. For detailed information on using a particular module please follow the links to the module's reference page. Much of the registration functionality has been streamlined into a [[Documentation/{{documentation/version}}/Modules/BRAINSFit|main module (BRAINSfit)]] and specialized modules.
-You  will find the most commonly used registration tools in the ''Modules'' menu under ''Registration''. Some more specialized and legacy versions you will find only in the ''"All Modules"'' submenu.
+Additional specialized and legacy modules you will find only in the ''"All Modules"'' submenu.
 In the Registration menu you will find the default registration tool as ''General Registration (BRAINS)'' and all other forms under ''Specialized''.
-Conceptually it also important to distinguish between the transform and the resampled image. The result of any registration is always at least one of the two, often both.
+The basic functionality can be understood as two parts: 1) determine a transform to align one image to another 2) apply this transform to the data. The [[Documentation/{{documentation/version}}/Modules/BRAINSFit|main module (BRAINSfit)]]  does both, but often you may prefer to separate the two steps to have better control over your workflow. Step 1 always produces a '''Transform''', which is visible in the [[Documentation/{{documentation/version}}/Modules/Data|Data module]] and (in the case of linear transforms) can be inspected and edited in the  [[Documentation/{{documentation/version}}/Modules/Transforms|Transforms]] module. Step 2 often, but not always, involves generating a new image by some form of resampling. The exception is the application of linear transforms to images via the ''Harden Transform'' option in the [[Documentation/{{documentation/version}}/Modules/Data|Data module]], which applies the transform by storing it as new orientation info in the image header. <br>
-The main resources for help on registration are:
+*The [[Documentation/{{documentation/version}}/Registration/RegistrationLibrary|'''Slicer Registration Library''']] is a collection of example cases including solutions and step-by-step instructions that demonstrate the use of the Slicer registration tools, strategies and methods for particular image types and registration needs. For examples using older versions of Slicer (3.6 to 4.1) [http://na-mic.org/Wiki/index.php/Projects:RegistrationDocumentation:RegLibTable click here].
 *[[Documentation/{{documentation/version}}/FAQ|'''Slicer Registration FAQ''']]: answers to the most common questions/problems, including cookbook recipes for common registration steps.
-*[[Documentation/{{documentation/version}}/RegistrationVideoTutorials|'''Slicer Registration Training Videos''']]: brief videos/screencasts showing  step-by-step approaches to the most common tasks
+*[[Documentation/{{documentation/version}}/RegistrationVideoTutorials|'''Slicer Registration Training Videos''']]: brief videos/screencasts showing  step-by-step approaches to the most common tasks. Most cases in the  [[Documentation/{{documentation/version}}/Registration/RegistrationLibrary|Registration Library]] contain screencast videos that show the procedure start-to-finish.
 *[[Documentation/{{documentation/version}}/Modules/Resampling|'''Slicer Resampling Overview''']] a summary of how 3DSlicer handles transforms and how image resampling is performed.]]
 The main modules/tools are listed/explained below, to help you find the right tool for the task:
@@ Line 32: / Line 31: @@
 |The [[Documentation/{{documentation/version}}/Modules/ACPCTransform|'''ACPC Transform''']] module is used to orient '''brain''' images along predefined anatomical landmarks: (manually defined)  fiducials for the inter-hemispheral midline, anterior- and posterior commissure are used to align an image such that these landmarks become vertical and horizontal, respectively.  This module is in the '''Registration/Specialized/ACPC Transform''' menu.
 |The [[Documentation/{{documentation/version}}/Modules/BRAINSDemonWarp|'''BRAINSDemonWarp''' ]] Module performs automated image warping based on an optic flow mechanism. Deformations here are significantly more "fluid" (i.e. have more DOF and are less constrained) than for the nonrigid BSpline method provided in the general (BRAINS) registration above.  This module is in the '''Registration/Specialized/Demon Registration (BRAINS)''' menu.
 |}
 </small>