Modules:RegisterImagesMultiRes-Documentation-3.6
Return to Slicer 3.5 Documentation
Module Name
MyModule
General Information
Module Type & Category
Type: CLI
Category: Registration
Authors, Collaborators & Contact
- Author1: Casey Goodlett, Kitware
- Contributor1: Dominik Meier, BWH
- Contact: Casey Goodlett
Module Description
Mutual information based affine registration using a multi-resolution optimization strategy.
Usage
Examples, Use Cases & Tutorials
- This module is intended to be a robust general-purpose mutual information affine registration tool
- See Registration Use Case project
Quick Tour of Features and Use
List all the panels in your interface, their features, what they mean, and how to use them. For instance:
- Required:
- Fixed Image - Target image for registration. The resulting transform will map the moving image to the fixed image.
- Moving Image - Source image for registration. The resulting transform will map the moving image to the fixed image.
- Resample Image - Image node to create a resampled moving image. The image node specified in this transform will store the result of resampling the moving image with computed transform. Typically the user should select to create a new volume here. This does not need to be specified, but the user should select either this option or output transform.
- Output Transform - Store the result of the transform in the given transform node. Typically the user should select to create a new transform node.
- Optional:
- Fixed Image Mask Image - A label image that is used to mask regions of interest in the fixed image. The mask specified here is used to restrict the placement of samples in the fixed image used for optimizing the registration. The user may want to mask the brain from background, mask everything in the brain except a lesion region, or otherwise specify the regions they would like to optimize in the registration.
- Advanced:
- Number of iteration - Number of iterations to run at each stage of the optimization. This method uses Fletcher-Reeves-Polak-Ribiere optimizer and the number of 1-D optimization is bounded by the number of iterations times the dimensionality of the transform.
- Number of line iterations - Number of iterations to use in the 1-D line optimization. This is used to bound the maximum number of iterations that can be used in the 1-D optimization at each iteration of the optimization .
- Step size - Maximum step size of each iteration of the transform. The optimizer computes a 1-D minimum along the gradient direction that is bounded by the current location and this distance. This should be specified in terms of voxels.
- Step Tolerance - Minimum step size to continue optimization. When the 1-D minimization bounds the minimum within this tolerance, the optimizer moves to the next iteration.
- Metric Tolerance - When steps of the optimizer result in changes in the metric value less than this, the optimization stops and the current result is returned.
Development
Dependencies
- Editor, Threshold, Segmentation module: Useful for computing a label mask for the 'Fixed Image Mask Image' option.
Known bugs
Follow this link to the Slicer3 bug tracker.
Usability issues
Follow this link to the Slicer3 bug tracker. Please select the usability issue category when browsing or contributing.
Source code & documentation
Customize following links for your module:
Source code:
More Information
Acknowledgment
This work is part of the National Alliance for Medical Image Computing (NAMIC), funded by the National Institutes of Health through the NIH Roadmap for Medical Research, Grant U54 EB005149. Information on the National Centers for Biomedical Computing can be obtained from National Centers for Biomedical Computing.
References
- FSL Flirt