Documentation/4.1/Modules/Resampling - Revision history

Unknown user: Text replacement - "slicerWiki/index.php" to "wiki"

2019-11-21T17:05:12Z

Text replacement - "slicerWiki/index.php" to "wiki"

UpdateBot: Prepend documentation/versioncheck template. See http://na-mic.org/Mantis/view.php?id=2887

2013-06-14T07:26:23Z

Prepend documentation/versioncheck template. See http://na-mic.org/Mantis/view.php?id=2887

Meier: /* Transforms and how they are displayed in 3DSlicer */

2012-04-26T16:39:43Z

Transforms and how they are displayed in 3DSlicer

Meier: /* Transforms and how they are displayed in 3DSlicer */

2012-04-26T16:37:42Z

Transforms and how they are displayed in 3DSlicer

Meier at 16:37, 26 April 2012

2012-04-26T16:37:05Z

Meier: /* Transforms and how they are displayed in 3DSlicer */

2012-04-26T16:30:27Z

Transforms and how they are displayed in 3DSlicer

Meier at 15:30, 26 April 2012

2012-04-26T15:30:57Z

Meier at 17:07, 20 April 2012

2012-04-20T17:07:39Z

Meier at 17:07, 20 April 2012

2012-04-20T17:07:25Z

Meier at 17:06, 20 April 2012

2012-04-20T17:06:44Z

@@ Line 1: / Line 1: @@
 <noinclude>{{documentation/versioncheck}}</noinclude>
-This page discusses Resampling of image and model data. [http://wiki.slicer.org/slicerWiki/index.php/Category:Documentation/4.1/Modules/Registration '''See here for an overview of registration methods'''].
+This page discusses Resampling of image and model data. [http://wiki.slicer.org/wiki/Category:Documentation/4.1/Modules/Registration '''See here for an overview of registration methods'''].
 =Transforms and how they are displayed in 3DSlicer=
 Slicer displays images in physical space, using information on ''Image Spacing'' (voxel size), ''image origin'', ''coordinate system'' and the direction of the coordinate axes. This information is usually contained in the image header. Some of it can be seen in the [[Documentation/4.1/Modules/Volumes|''Volumes'']] module under ''Volume Information''. If the same image appears differently in different software, the reason is most likely different use/interpretation of this header information. <br>

← Older revision		Revision as of 07:26, 14 June 2013
Line 1:		Line 1:
		+	<noinclude>{{documentation/versioncheck}}</noinclude>
	This page discusses Resampling of image and model data. [http://wiki.slicer.org/slicerWiki/index.php/Category:Documentation/4.1/Modules/Registration '''See here for an overview of registration methods'''].		This page discusses Resampling of image and model data. [http://wiki.slicer.org/slicerWiki/index.php/Category:Documentation/4.1/Modules/Registration '''See here for an overview of registration methods'''].
	=Transforms and how they are displayed in 3DSlicer=		=Transforms and how they are displayed in 3DSlicer=

@@ Line 2: / Line 2: @@
 =Transforms and how they are displayed in 3DSlicer=
 Slicer displays images in physical space, using information on ''Image Spacing'' (voxel size), ''image origin'', ''coordinate system'' and the direction of the coordinate axes. This information is usually contained in the image header. Some of it can be seen in the [[Documentation/4.1/Modules/Volumes|''Volumes'']] module under ''Volume Information''. If the same image appears differently in different software, the reason is most likely different use/interpretation of this header information. <br>
-A transform describes a relocation from one physical orientation into another physical orientation. All registration routines produce such a transform, but it may be optional to the user to just keep the reoriented image and not the transform. Note that if you keep the transform, you can access it via the [[Documentation/4.1/Modules/Data|''Data module'']], you can save it to a text (ITK) file and apply it to other images. There are several modules available just for the task applying such transforms to an image, a process usually referred to as ''resampling''. There is one important distinction between linear (rigid to affine) and nonlinear (BSpline) transforms: '''Linear transforms can be visualized directly and immediately''' by placing images inside the transform in the [[Documentation/4.1/Modules/Data|''Data module'']] hierarchy. Some registration modules (e.g. BRAINSfit) do this automatically. The effect of a linear transform is therefore visible right away. '''Nonlinear (BSpline) transforms are not visualized on the fly and must be resampled to see.''' Hence if you calculate a BSpline transform inside BRAINSfit and then place a volume inside this transform, you will '''not''' see an effect, because the Viewer can apply only linear transforms directly. So to see a nonrigid transform you must resample the image. We therefore recommend to always select an output volume when running a nonrigid registration. To apply a transform and resample an image see the [[Documentation/4.1/Modules/Resampling#Resampling_via_a_spatial_transform|resampling via a spatial transform]]section below.
+A transform describes a relocation from one physical orientation into another physical orientation. All registration routines produce such a transform, but it may be optional to the user to just keep the reoriented image and not the transform. Note that if you keep the transform, you can access it via the [[Documentation/4.1/Modules/Data|''Data module'']], you can save it to a text (ITK) file and apply it to other images. There are several modules available just for the task applying such transforms to an image, a process usually referred to as ''resampling''. There is one important distinction between linear (rigid to affine) and nonlinear (BSpline) transforms: '''Linear transforms can be visualized directly and immediately''' by placing images inside the transform in the [[Documentation/4.1/Modules/Data|''Data module'']] hierarchy. Some registration modules (e.g. BRAINSfit) do this automatically. <br>
+Slicer Registration Modules offer 2 types of output: an output '''transform''' and/or an '''output volume''':
 {| cellpadding="5" cellspacing="0" border="1"
@@ Line 20: / Line 20: @@
 *<span style="color:green">This result can be seen/viewed immediately in Slicer</span>
 *<span style="color:red">This result requires resampling first, e.g. using  [[Documentation/4.1/Modules/ResampleScalarVectorDWIVolume|Resample ResampleScalar/Vector/DWI Volume]] or  [[Documentation/4.1/Modules/BRAINSResample|Resample Image (BRAINS)]] module </span>
 = What we mean by ''Resampling'' =

@@ Line 10: / Line 10: @@
 | Output 2
 |-
-| Rigid to Affine Registration
+| '''Rigid''' to '''Affine''' Registration
 | <span style="color:green">Output Transform</span>
 | <span style="color:green">Output Volume</span>
 |-
-| B-Spline Registration or combined Affine+B-Spline Registration
+| '''B-Spline''' Registration or combined Affine+B-Spline Registration
 | <span style="color:red">Output Transform</span>
 | <span style="color:green">Output Volume</span>
@@ Line 20: / Line 20: @@
 *<span style="color:green">This result can be seen/viewed immediately in Slicer</span>
 *<span style="color:red">This result requires resampling first, e.g. using  [[Documentation/4.1/Modules/ResampleScalarVectorDWIVolume|Resample ResampleScalar/Vector/DWI Volume]] or  [[Documentation/4.1/Modules/BRAINSResample|Resample Image (BRAINS)]] module </span>
 = What we mean by ''Resampling'' =

@@ Line 4: / Line 4: @@
 A transform describes a relocation from one physical orientation into another physical orientation. All registration routines produce such a transform, but it may be optional to the user to just keep the reoriented image and not the transform. Note that if you keep the transform, you can access it via the [[Documentation/4.1/Modules/Data|''Data module'']], you can save it to a text (ITK) file and apply it to other images. There are several modules available just for the task applying such transforms to an image, a process usually referred to as ''resampling''. There is one important distinction between linear (rigid to affine) and nonlinear (BSpline) transforms: '''Linear transforms can be visualized directly and immediately''' by placing images inside the transform in the [[Documentation/4.1/Modules/Data|''Data module'']] hierarchy. Some registration modules (e.g. BRAINSfit) do this automatically. The effect of a linear transform is therefore visible right away. '''Nonlinear (BSpline) transforms are not visualized on the fly and must be resampled to see.''' Hence if you calculate a BSpline transform inside BRAINSfit and then place a volume inside this transform, you will '''not''' see an effect, because the Viewer can apply only linear transforms directly. So to see a nonrigid transform you must resample the image. We therefore recommend to always select an output volume when running a nonrigid registration. To apply a transform and resample an image see the [[Documentation/4.1/Modules/Resampling#Resampling_via_a_spatial_transform|resampling via a spatial transform]]section below.
-*Rigid to Affine Registration
-**<span style="color:green">Output Transform</span>
+{| cellpadding="5" cellspacing="0" border="1"
-**<span style="color:green">Output Volume</span>
+| Method
-*B-Spline Registration or combined Affine+B-Spline Registration
+| Output 1
-**<span style="color:red">Output Transform</span>
+| Output 2
-**<span style="color:green">Output Volume</span>
+|-
 *<span style="color:green">This result can be seen/viewed immediately in Slicer</span>
-*<span style="color:green">This result requires resampling first, e.g. using </span>
+*<span style="color:red">This result requires resampling first, e.g. using  [[Documentation/4.1/Modules/ResampleScalarVectorDWIVolume|Resample ResampleScalar/Vector/DWI Volume]] or  [[Documentation/4.1/Modules/BRAINSResample|Resample Image (BRAINS)]] module </span>
 = What we mean by ''Resampling'' =

@@ Line 10: / Line 10: @@
 = Resampling in Place: Change Resolution or Field of View=
-*The [[Documentation/4.1/Modules/CropVolume|'''Crop Volume''']] module (''"All Modules"'' menu) lets you clip away the image data outside an interactively defined 3D box. Such ''cropping'' is very useful to focus automated processing (e.g. registration,  segmentation) onto a region of interest or reduce memory usage and speed up performance.  The cropping includes a resampling that allows to change the resolution (''spacing'') of the result image at the same time.
+*The [[Documentation/4.1/Modules/CropVolume|'''Crop Volume''']] module (''"Modules:All Modules"'' menu) lets you clip away the image data outside an interactively defined 3D box. Such ''cropping'' is very useful to focus automated processing (e.g. registration,  segmentation) onto a region of interest or reduce memory usage and speed up performance.  The cropping includes a resampling that allows to change the resolution (''spacing'') of the result image at the same time.
-*The [[Documentation/4.1/Modules/ResampleVolume|'''Resample Scalar Volume''']] module changes resolution (''spacing'') of an image, allowing several interpolation options for different data types.  This is the method of choice if you wish to increase or decrease the number of voxels per mm or make the voxel size isotropic. You need to specify the desired voxel size in mm. If you do not know the current voxel size of your image, go to the ''Volume Information'' tab in the   [[Documentation/4.1/Modules/Volumes|''Volumes'']] module.
+*The [[Documentation/4.1/Modules/ResampleVolume|'''Resample Scalar Volume''']] module (''"Modules:All Modules"'' menu)  changes resolution (''spacing'') of an image, allowing several interpolation options for different data types.  This is the method of choice if you wish to increase or decrease the number of voxels per mm or make the voxel size isotropic. You need to specify the desired voxel size in mm. If you do not know the current voxel size of your image, go to the ''Volume Information'' tab in the   [[Documentation/4.1/Modules/Volumes|''Volumes'']] module.
-*The [[Documentation/4.1/Modules/Cast|'''Cast Scalar Image''']] module lets you change the underlying '''datatype''' of your image, e.g. change from ''floating point'' to an ''integer'' or vice versa. This will not perform an interpolation, since the number of image voxels stays the same, but may be necessary to prepare the image for some modules or to reduce the image (file) size. For example an image stored as ''float'' will need twice as much disk space than one stored as ''short'' and four times as much as a ''char''.
+*The [[Documentation/4.1/Modules/Cast|'''Cast Scalar Image''']] module (''"Modules:All Modules"'' menu)  lets you change the underlying '''datatype''' of your image, e.g. change from ''floating point'' to an ''integer'' or vice versa. This will not perform an interpolation, since the number of image voxels stays the same, but may be necessary to prepare the image for some modules or to reduce the image (file) size. For example an image stored as ''float'' will need twice as much disk space than one stored as ''short'' and four times as much as a ''char''.
-*The [[Documentation/4.1/Modules/PolyDataToLabelMap|'''Model To Label Map''']] module will do the inverse of the Model Maker and generate a binary 3D labelmap image with non-zero values at the location of the surface. This will let you bring the information from surface models back into an ''implicit'' image format. You set the resampling options, i.e. the resolution of the result via a reference image. Note that it will not fill a closed model, but produce points at the surface only.
+*The [[Documentation/4.1/Modules/PolyDataToLabelMap|'''Model To Label Map''']] module  (''"Modules:Surface Models"'' menu)  will do the inverse of the Model Maker and generate a binary 3D labelmap image with non-zero values at the location of the surface. This will let you bring the information from surface models back into an ''implicit'' image format. You set the resampling options, i.e. the resolution of the result via a reference image. Note that it will not fill a closed model, but produce points at the surface only.
-*The [[Documentation/4.1/Modules/OrientImage|'''Orient Scalar Images''']] module will sample the image data along a specified orientation scheme, such as axial/sagittal/coronal planes or RAS or LPI etc. Note that  the slices are '''not''' interpolated, they are just reordered and/or permuted. The resulting volume will cover the original volume.  Because the display is in physical space, you will not see an effect of this resampling in the viewer.
+*The [[Documentation/4.1/Modules/OrientImage|'''Orient Scalar Images''']] module (''"Modules:Converters"'' menu)  will sample the image data along a specified orientation scheme, such as axial/sagittal/coronal planes or RAS or LPI etc. Note that  the slices are '''not''' interpolated, they are just reordered and/or permuted. The resulting volume will cover the original volume.  Because the display is in physical space, you will not see an effect of this resampling in the viewer.
-*The [[Documentation/4.1/Modules/Volumes|'''Volumes''']] module lets you adjust the physical voxel size of an image (Info Tab), but will not generate a new volume. The changes will take effect immediately and you should see adjustments in your slice views. To obtain a new resampled volume, use the  [[Modules:ResampleVolume-Documentation-3.6|Resample Scalar Volume]] module described above.
+*The [[Documentation/4.1/Modules/Volumes|'''Volumes''']] module (''"Modules:Volumes"'' menu)  lets you adjust the physical voxel size of an image (Info Tab), but will not generate a new volume. The changes will take effect immediately and you should see adjustments in your slice views. To obtain a new resampled volume, use the  [[Modules:ResampleVolume-Documentation-3.6|Resample Scalar Volume]] module described above.
-*The [[Documentation/4.1/Modules/BRAINSResample|'''Resample Image (BRAINS)''']] module lets you resample your image to a new resolution (specified implicitly via a reference image), with choice of interpolation method and output datatype. To resample in place leave the ''Warp by Transform'' menu on ''None''.
+*The [[Documentation/4.1/Modules/BRAINSResample|'''Resample Image (BRAINS)''']] module (''"Modules:Registration"'' menu)  lets you resample your image to a new resolution (specified implicitly via a reference image), with choice of interpolation method and output datatype. To resample in place leave the ''Warp by Transform'' menu on ''None''.
 = Resampling via a spatial transform =
-*The  [[Documentation/4.1/Modules/BRAINSResample|'''Resample Image (BRAINS)''']] module supports applying linear transforms and deformation fields to an image, with choice of interpolation method and output datatype.
+*The  [[Documentation/4.1/Modules/BRAINSResample|'''Resample Image (BRAINS)''']] module  (''"Modules:Registration"'' menu) supports applying linear transforms and deformation fields to an image, with choice of interpolation method and output datatype.
-*The [[Documentation/4.1/Modules/ResampleScalarVectorDWIVolume|'''Resample Scalar/Vector/DWI Volume''']] Module sends both scalar and vector images through a transform. Several interpolation options.
+*The [[Documentation/4.1/Modules/ResampleScalarVectorDWIVolume|'''Resample Scalar/Vector/DWI Volume''']] module (''"Modules:All Modules"'' menu) sends both scalar and vector images through a transform. Several interpolation options.
 *The ''Harden Transforms'' function (context menu via the right mouse button) in the [[Documentation/4.1/Modules/Data|'''Data''' Module]] can also be used to resample an image or fiducial set through a '''linear''' transform.
-*The [[Documentation/4.1/Modules/ACPCTransform|'''AC-PC Transform''']] module lets you realign your brain image along the anterior-posterior commissure and interhemispheral midline. You (manually) select fiducials to define these points. An output transform is generated that you can then apply to the image using the resampling tools described here.
+*The [[Documentation/4.1/Modules/ACPCTransform|'''AC-PC Transform''']] module (''"Modules:Registration:Specialized"'' menu) lets you realign your brain image along the anterior-posterior commissure and interhemispheral midline. You (manually) select fiducials to define these points. An output transform is generated that you can then apply to the image using the resampling tools described here.
 *The main registration modules all contain a resampling option, i.e. they offer to produce a direct result volume, which includes a resampling step. In most cases the interpolation is linear. If you wish for more control over how the resampling is performed (e.g. select a different interpolator or output size or voxel size), select the registration module's option to generate an output/saved transform and then use one of the dedicated resampling modules described here to generate the new volume. The exception are modules which do '''not''' (yet) offer a transform output (e.g. Fast Nonrigid BSpline); for those you must use the module-specific resampling options to generate a result image.
-*The [[Documentation/4.1/Modules/ExpertAutomatedRegistration|'''Expert Automated Registration''']] module offers pure resampling from a given transform: select ''None'' for initialization and ''None'' for registration, specify the transform to apply under ''Load Transform'' and set the interpolation type under ''Advanced Registration Parameters''.
+*The [[Documentation/4.1/Modules/ExpertAutomatedRegistration|'''Expert Automated Registration''']] module  (''"Modules:All Modules"'' menu)  offers pure resampling from a given transform: select ''None'' for initialization and ''None'' for registration, specify the transform to apply under ''Load Transform'' and set the interpolation type under ''Advanced Registration Parameters''.
 = Resampling Vector- and Tensor-Data =
-*The [[Documentation/4.1/Modules/ResampleScalarVectorDWIVolume|'''Resample ResampleScalarVectorDWIVolume''']] Module is the method of choice to realign scalar, vector or diffusion weighted data along a given transform. It supports both linear and nonlinear transforms as well as deformation fields. Note that tensor data, such as DTI has a separate volume (below).
+*The [[Documentation/4.1/Modules/ResampleScalarVectorDWIVolume|'''Resample ResampleScalar/Vector/DWI Volume''']] module  (''"Modules:All Modules"'' menu)  is the method of choice to realign scalar, vector or diffusion weighted data along a given transform. It supports both linear and nonlinear transforms as well as deformation fields. Note that tensor data, such as DTI has a separate volume (below).
-*The [[Documentation/4.1/Modules/ResampleDTIVolume|'''Resample DTI Volume''']] module is designed specifically for reorienting diffusion tensor MRI data.  It supports both linear and nonlinear transforms as well as deformation fields. Note that simply sending each component of a DTI tensor through the transform separately would yield an '''incorrect''' result. This module will transform the vector/tensor data correctly.
+*The [[Documentation/4.1/Modules/ResampleDTIVolume|'''Resample DTI Volume''']] module  (''"Modules:All Modules"'' menu)  is designed specifically for reorienting diffusion '''tensor''' MRI data. Note the difference to DWI above. Use this for DTI but not for DWI.  It supports both linear and nonlinear transforms as well as deformation fields. Note that simply sending each component of a DTI tensor through the transform separately would yield an '''incorrect''' result. This module will transform the vector/tensor data correctly.