Documentation/Nightly/Modules/ResampleScalarVolume

From SlicerWiki
Jump to: navigation, search
Home < Documentation < Nightly < Modules < ResampleScalarVolume

For the stable Slicer documentation, visit the 4.6 page.


Introduction and Acknowledgements

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 NA-MIC website.
Author: Jim Miller, GE
Contact: Jim Miller,

GE  
Itk  
NA-MIC  

Module Description

Resampling an image is an important task in image analysis. It is especially important in the frame of image registration. This module implements image resampling through the use of itk Transforms. This module uses an Identity Transform. The resampling is controlled by the Output Spacing. "Resampling" is performed in space coordinates, not pixel/grid coordinates. It is quite important to ensure that image spacing is properly set on the images involved. The interpolator is required since the mapping from one space to the other will often require evaluation of the intensity of the image at non-grid positions. Several interpolators are available: linear, nearest neighbor, bspline and five flavors of sinc. The sinc interpolators, although more precise, are much slower than the linear and nearest neighbor interpolator. To resample label volumnes, nearest neighbor interpolation should be used exclusively.


Use Cases

  • Usage:
ResampleVolume  [--processinformationaddress
                <std::string>] [--xml] [--echo] [-i
                <linear|nearestNeighbor|hamming
                |cosine|welch|lanczos|blackman>]
                [-s <std::vector<float>>] [--]
                [--version] [-h] <std::string>
                <std::string>
Where: 
   --processinformationaddress <std::string>
     Address of a structure to store process information (progress, abort,
     etc.). (default: 0)

   --xml
     Produce xml description of command line arguments (default: 0)

   --echo
     Echo the command line arguments (default: 0)

   -i <linear|nearestNeighbor|hamming|cosine|welch|lanczos|blackman>, 
      --interpolation <linear|nearestNeighbor|hamming|cosine|welch|lanczos
      |blackman>
     Sampling algorithm (linear, nearest neighbor  or windowed sinc). There
     are several sinc algorithms available as described in the following
     publication: Erik H. W. Meijering, Wiro J. Niessen, Josien P. W. Pluim
     , Max A. Viergever: Quantitative Comparison of Sinc-Approximating
     Kernels for Medical Image Interpolation. MICCAI 1999, pp. 210-217.
     Each window has a radius of 3; (default: linear)

   -s <std::vector<float>>,  --spacing <std::vector<float>>
     Spacing along each dimension (0 means use input spacing) (default: 0,0
     ,0)

   --,  --ignore_rest
     Ignores the rest of the labeled arguments following this flag.

   --version
     Displays version information and exits.

   -h,  --help
     Displays usage information and exits.

   <std::string>
     (required)  Input volume to be resampled

   <std::string>
     (required)  Resampled Volume

Tutorials

N/A

Panels

Parameters:

  • Resampling Parameters: Parameters used for resampling
    • Spacing (outputPixelSpacing): Spacing along each dimension (0 means use input spacing)
    • Interpolation (interpolationType): Sampling algorithm (linear, nearest neighbor, bspline(cubic) or windowed sinc). There are several sinc algorithms available as described in the following publication: Erik H. W. Meijering, Wiro J. Niessen, Josien P. W. Pluim, Max A. Viergever: Quantitative Comparison of Sinc-Approximating Kernels for Medical Image Interpolation. MICCAI 1999, pp. 210-217. Each window has a radius of 3;
  • IO: Input/output parameters
    • Input Volume (InputVolume): Input volume to be resampled
    • Output Volume (OutputVolume): Resampled Volume


List of parameters generated transforming this XML file using this XSL file. To update the URL of the XML file, edit this page.


Similar Modules

N/A

References

N/A

Information for Developers