Documentation/Nightly/Modules/CropVolume - Revision history

Lasso at 19:56, 2 June 2017

2017-06-02T19:56:51Z

Fedorov at 16:34, 7 November 2013

2013-11-07T16:34:11Z

Fedorov at 16:28, 7 November 2013

2013-11-07T16:28:45Z

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

2013-06-14T07:53:13Z

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

JChris.FillionR: 4.1 -> Nightly

2012-08-22T16:58:59Z

4.1 -> Nightly

New page

{{documentation/{{documentation/version}}/module-header}}



{{documentation/{{documentation/version}}/module-section|Introduction and Acknowledgements}}
{{documentation/{{documentation/version}}/module-introduction-start|{{documentation/modulename}}}}
{{documentation/{{documentation/version}}/module-introduction-row}}
This work is part of the National Alliance for Medical Image Computing (NA-MIC), funded by the National Institutes of Health through the NIH Roadmap for Medical Research, Grant U54 EB005149. Information on NA-MIC can be obtained from the [http://www.na-mic.org/ NA-MIC website]. The development of this module was supported in part by NIH CA111288 and CA151261.<br>
Author: Andrey Fedorov, Ron Kikinis, SPL<br>
Contact: Andrey Fedorov, <email>fedorov@bwh.harvard.edu</email><br>
{{documentation/{{documentation/version}}/module-introduction-row}}
{{documentation/{{documentation/version}}/module-introduction-logo-gallery
|{{collaborator|logo|namic}}|NA-MIC
|{{collaborator|logo|ncigt}}|NCIGT
|{{collaborator|logo|spl}}|SPL
}}
{{documentation/{{documentation/version}}/module-introduction-end}}


{{documentation/{{documentation/version}}/module-section|Module Description}}
This module allows to extract rectangular subvolume from a scalar image, with the subvolume defined by Slicer ROI widget.

You can use this module to crop a DTI or DWI volume.

The cropping functionality of this module is enabled by [[Documentation/4.0/Modules/ResampleScalarVectorDWIVolume | Resample Scalar/Vector/DWI Volume]] module, which is called internally.


{{documentation/{{documentation/version}}/module-section|Use Cases}}

{|
|
Most frequently used for these scenarios:

* You are trying to segment an object that occupies small portion of the image. Cropping the ROI with that object can simplify your segmentation task and reduce both the memory requirements and processing time.
* You are trying to register two objects that occupy smaller portions of the image. In this scenario, cropping will allow you to focus the processing at the region of interest, and simplify registration initialization.

|
{|
|[[Image:Slicer4_ExtractSubvolumeROI_before.jpg|thumb|400px|Input image and ROI]]
|-
|[[Image:Slicer4_ExtractSubvolumeROI_after.jpg|thumb|400px|Cropped subvolume]]
|}

|}


{{documentation/{{documentation/version}}/module-section|Tutorials}}
Not available at this time, but see the list of Slicer 3.6 tutorials that use CropVolume here: [[Modules:CropVolume-Documentation-3.6]].


{{documentation/{{documentation/version}}/module-section|Panels and their use}}

{|
|

* '''Input/initialization parameters panel:'''
** '''Input volume''' defines the input image from which you need to crop a subvolume. Output volume will be created automatically.
** '''ROI''' is a Region of Interest (see [[Modules:ROIModule-Documentation-3.6|the ROI module documentation]]), which can be defined outside CropVolume, or by creating new MRMLROINode from the selector menu. The ROI can be adjusted using the widget handles in 3D view panel and/or in the 2D slice view panels.
** '''ROI visibility''' allows to turn the visibility of the 3D widget on or off in the 3D view panel.
** '''Interpolation options'''
*** '''Isotropic output voxel''' if this checkbox is selected, the output image will have isotropic spacing, with the voxel size of the output image in each dimension equal to the ''smallest'' voxel dimension of the input image multiplied by the scaling constant.
*** '''Input spacing scaling constant''' is the coefficient used to determine the spacing of the output volume. The output spacing is defined by multiplying the input spacing in each dimension by the user-specified coefficient. For example, if the input spacing is 1x1x1.4, and the scaling coefficient is 0.5, the output volume will have spacing 0.5x0.5x0.7, effectively doubling the resolution of the output image.
*** '''Interpolator''' allows to select between Nearest Neighbor, Linear, Windowed Sinc or B-spline interpolators (see [[Documentation/4.0/Modules/ResampleScalarVectorDWIVolume | Resample Scalar/Vector/DWI Volume]] for details). For subvolumes being extracted from a label volume, you should use Nearest Neighbor interpolator. Otherwise B-spline is the preferred choice. Linear interpolator requires less computation, which may be important for very large ROIs.
** '''Crop!''' button initiates the subvolume extraction based on the inputs and parameters.

|

{|
|[[Image:Slicer4_ExtractSubvolumeROI_controls.jpg|thumb|400px|CropVolume control panel]]

|}

|}

'''Cropping of oblique sub-volumes''' can be done by placing either or both of input volume and ROI under transform(s). These transforms will be taken into account while preparing the output.


{{documentation/{{documentation/version}}/module-section|Similar Modules}}
* [[Documentation/4.0/Modules/ResampleScalarVectorDWIVolume | Resample Scalar/Vector/DWI Volume]]


{{documentation/{{documentation/version}}/module-section|References}}
N/A


{{documentation/{{documentation/version}}/module-section|Information for Developers}}
{{documentation/{{documentation/version}}/module-developerinfo}}


{{documentation/{{documentation/version}}/module-footer}}

@@ Line 34: / Line 34: @@
 Most frequently used for these scenarios:
-* You are trying to segment an object that occupies small portion of the image. Cropping the ROI with that object can simplify your segmentation task and reduce both the memory requirements and processing time.
+* You are trying to '''segment an object that occupies small portion of the image'''. Cropping the ROI with that object can simplify your segmentation task and reduce both the memory requirements and processing time.
-* You are trying to register two objects that occupy smaller portions of the image. In this scenario, cropping will allow you to focus the processing at the region of interest, and simplify registration initialization.
+* You are trying to '''segment an image that has very different resolution along different axes''' (for example, 0.2mm with in an image slice, 1.0mm between slices). Isotropic spacing option ensures that the output volume has equal spacing on all axes. Doing this as part of cropping is useful, because forcing the same (high) resolution in all axes would increase the total number of voxels (and therefore memory need, processing times, etc.), but removing irrelevant parts of the volume can compensate for this increase in size.
+|
@@ Line 56: / Line 58: @@
 {|
+|
+* '''Crop Volume panel:''' contains a selector to save/retrieve cropping presets.
-* '''Input/initialization parameters panel:'''
+* '''IO panel:'''
-** '''Input volume''' defines the input image from which you need to crop a subvolume. Output volume will be created automatically. Input volume can be under a transform.
+** '''Input volume''' defines the input image from which you need to crop a subvolume. Input volume can be under a transform.
-** '''Input ROI''' is a Region of Interest (see [[Modules:ROIModule-Documentation-3.6|the ROI module documentation]]), which can be defined outside CropVolume, or by creating new MRMLROINode from the selector menu. The ROI can be adjusted using the widget handles in 3D view panel and/or in the 2D slice view panels. Input ROI can be under a transform.
+** '''Input ROI''' is a Region of Interest (see [[Modules:ROIModule-Documentation-3.6|the ROI module documentation]]), which can be defined outside CropVolume, or by creating new ROI by using the ''Mouse Interaction'' toolbar (selection ROI mode and clicking on two points in a slice or 3D view). The ROI can be adjusted using the widget handles in slice and 3D views. ROI can be rotated/translated using a transform.
-** '''Technique'''
+*** '''ROI visibility''' allows to turn the visibility of the 3D widget on or off in the 3D view panel.
-*** '''Interpolated cropping''' will resample the content of the image within the ROI given the interpolation options explained below.
+*** '''Fit to VOlume''' adjusts the ROI to be aligned with the input volume, including axis directions. To crop a volume using axes aligned to RAS, place the ROI using the ''Mouse interaction'' toolbar.
-*** '''Voxel based cropping'''
+** ''Output volume'' defines the volume node where the cropped output will be written into. By default, if no node is selected, output volume is created automatically.
-** '''ROI visibility''' allows to turn the visibility of the 3D widget on or off in the 3D view panel. Image spacing and values within ROI will remain unchanged, and will be copied into a separate image.
+** '''Interpolation'''
 ** '''Interpolation options'''
-*** '''Isotropic output voxel''' if this checkbox is selected, the output image will have isotropic spacing, with the voxel size of the output image in each dimension equal to the ''smallest'' voxel dimension of the input image multiplied by the scaling constant.
+*** '''Spacing scale''' is the coefficient used to determine the spacing of the output volume. The output spacing is defined by multiplying the input spacing in each dimension by the user-specified coefficient. For example, if the input spacing is 1x1x1.4, and the scaling coefficient is 0.5, the output volume will have spacing 0.5x0.5x0.7, effectively doubling the resolution of the output image.
-*** '''Input spacing scaling constant''' is the coefficient used to determine the spacing of the output volume. The output spacing is defined by multiplying the input spacing in each dimension by the user-specified coefficient. For example, if the input spacing is 1x1x1.4, and the scaling coefficient is 0.5, the output volume will have spacing 0.5x0.5x0.7, effectively doubling the resolution of the output image.
+*** '''Isotropic spacing''' if this checkbox is selected, the output image will have isotropic spacing, with the voxel size of the output image in each dimension equal to the ''smallest'' voxel dimension of the input image multiplied by the scaling constant.
 *** '''Interpolator''' allows to select between Nearest Neighbor, Linear, Windowed Sinc or B-spline interpolators (see [[Documentation/Nightly/Modules/ResampleScalarVectorDWIVolume | Resample Scalar/Vector/DWI Volume]] for details). For subvolumes being extracted from a label volume, you should use Nearest Neighbor interpolator. Otherwise B-spline is the preferred choice. Linear interpolator requires less computation, which may be important for very large ROIs.
-** '''Crop!''' button initiates the subvolume extraction based on the inputs and parameters.
+** '''Volume information''' shows preview of spacing and dimensions of the cropped output volume and, for comparison, the input volume. Average dimensions of a volume is about 200-300 voxels along each axis. If the resolution is increased using ''Spacing scale'' and ''Isotropic spacing'' then it is recommended to reduce the region of interest so that the dimensions are not increased significantly.
+|
 {|
-|[[Image:CropVolume-4.3-GUI-panel.png|thumb|400px|CropVolume control panel]]
+|[[Image:CropVolume-4.7-GUI-panel.png|thumb|400px|CropVolume control panel]]
 |}

← Older revision		Revision as of 07:53, 14 June 2013
Line 1:		Line 1:
		+	<noinclude>{{documentation/versioncheck}}</noinclude>
	<!-- ---------------------------- -->		<!-- ---------------------------- -->
	{{documentation/{{documentation/version}}/module-header}}		{{documentation/{{documentation/version}}/module-header}}

@@ Line 25: / Line 25: @@
 You can use this module to crop a DTI or DWI volume.
-The cropping functionality of this module is enabled by [[Documentation/4.0/Modules/ResampleScalarVectorDWIVolume | Resample Scalar/Vector/DWI Volume]] module, which is called internally.
+The cropping functionality of this module is enabled by [[Documentation/Nightly/Modules/ResampleScalarVectorDWIVolume | Resample Scalar/Vector/DWI Volume]] module, which is called internally.
 <!-- ---------------------------- -->
@@ Line 58: / Line 58: @@
 * '''Input/initialization parameters panel:'''
-** '''Input volume''' defines the input image from which you need to crop a subvolume. Output volume will be created automatically.
+** '''Input volume''' defines the input image from which you need to crop a subvolume. Output volume will be created automatically. Input volume can be under a transform.
-** '''ROI''' is a Region of Interest (see [[Modules:ROIModule-Documentation-3.6|the ROI module documentation]]), which can be defined outside CropVolume, or by creating new MRMLROINode from the selector menu. The ROI can be adjusted using the widget handles in 3D view panel and/or in the 2D slice view panels.
+** '''Input ROI''' is a Region of Interest (see [[Modules:ROIModule-Documentation-3.6|the ROI module documentation]]), which can be defined outside CropVolume, or by creating new MRMLROINode from the selector menu. The ROI can be adjusted using the widget handles in 3D view panel and/or in the 2D slice view panels. Input ROI can be under a transform.
-** '''ROI visibility''' allows to turn the visibility of the 3D widget on or off in the 3D view panel.
+** '''Technique'''
 ** '''Interpolation options'''
 *** '''Isotropic output voxel''' if this checkbox is selected, the output image will have isotropic spacing, with the voxel size of the output image in each dimension equal to the ''smallest'' voxel dimension of the input image multiplied by the scaling constant.
@@ Line 80: / Line 83: @@
 <!-- ---------------------------- -->
 {{documentation/{{documentation/version}}/module-section|Similar Modules}}
-* [[Documentation/4.0/Modules/ResampleScalarVectorDWIVolume | Resample Scalar/Vector/DWI Volume]]
+* [[Documentation/Nightly/Modules/ResampleScalarVectorDWIVolume | Resample Scalar/Vector/DWI Volume]]
 <!-- ---------------------------- -->