Difference between revisions of "Modules:DeformableB-SplineRegistration-Documentation-3.6"

From Slicer Wiki
Jump to: navigation, search
Line 4: Line 4:
 
__NOTOC__
 
__NOTOC__
 
===Module Name===
 
===Module Name===
MyModule
+
Deformable B-Spline Registration
 +
<gallery>
 +
Image:NoBSpline1.png|Data set that was to be deformed
 +
Image:WildBSpline.png|Data set after b-Spline with wrong parameters
 +
</gallery>
  
 
{|
 
{|
Line 13: Line 17:
  
 
== General Information ==
 
== General Information ==
 +
This module was implemented by Jim Miller and Bill Lorensen and is based on the ITK B-spline implementation.
 +
 
===Module Type & Category===
 
===Module Type & Category===
  
Line 27: Line 33:
  
 
== Usage ==
 
== Usage ==
 +
*Parameters:
 +
**Iterations: Number of iterations to run the optimization method to estimate the registration parameters.
 +
**Grid Size: Number of grid points on interior of the fixed image. Larger grid sizes allow for finer registrations.
 +
*** You can use this module to manually run a multiresolution registration by starting with a coarse grid, creating a resampled volume, and passing that resampled volume as the moving image for the next run with a finer grid.
 +
*** '''Make sure you hit the tab key when changing the grid size'''.
 +
**Histogram bins: Number of histogram bins to use for Mattes Mutual Information. Reduce the number of bins if a deformable registration fails. If the number of bins is too large, the estimated PDFs will be a field of impulses and will inhibit reliable registration estimation.
 +
**Spatial samples: Number of spatial samples to use in estimating Mattes Mutual Information. Larger values yield more accurate PDFs and improved registration quality.
 +
**Constrain deformation: Constrain the deformation to the amount specified in Maximum Deformation
 +
**Maximum deformation: If Constrain Deformation is checked, limit the deformation to this amount.
 +
**Default pixel value: Default pixel value used if resampling a pixel outside of the volume.
 +
*IO
 +
**Intial Transform: Initial transform for aligning the fixed and moving image. Maps positions in the fixed coordinate frame to positions in the moving coordinate frame. This transform should be an affine or rigid transform.  It is used an a bulk transform for the BSpline. Optional.
 +
**Fixed image: Fixed image to which to register
 +
**Moving image: Image to register to the fixed image
 +
** Output transform: Transform calculated that aligns the fixed and moving image. Maps positions from the fixed coordinate frame to the moving coordinate frame. Optional (specify an output transform or an output volume or both).
 +
** Output Volume: Resampled moving image to fixed image coordinate frame. Optional (specify an output transform or an output volume or both).
 +
* click Apply
 +
 +
* Be careful how you set the parameters
  
 
===Examples, Use Cases & Tutorials===
 
===Examples, Use Cases & Tutorials===
 +
The BSpline registration module is used in the following examples of the [[Projects:RegistrationDocumentation:UseCaseInventory||Registration Case Library]].
 +
Each case contains a step-by-step tutorial incl. parameter selections/presets.
 +
[http://na-mic.org/Wiki/index.php/Projects:RegistrationDocumentation:RegLib_03_DWIToBaseline DWI alignment: align DTI volume with structural reference scan (T2)]
 +
 +
*[[Image:RegLib_C10_EMAtlas1.png|70px|lleft|Target Brain]] [[Image:RegLib_C10_EMAtlas2.png|70px|lleft|Probabilistic Tissue Atlas]]  '''Case 10: [[Projects:RegistrationDocumentation:RegLib_10_AtlasBasedSegmentation|Segmentation via co-registered probabilistic tissue atlas]]'''
 +
*[[Image:RegLib_C03_Baseline_axial.png|70px|lleft|RegLib 03: DTI alignment]] [[Image:RegLib_C03_DTIVol_axial.png|70px|lleft|RegLib C03: DTI alignment]]  '''Case 03: [[Projects:RegistrationDocumentation:RegLib_03_DWIToBaseline|DWI alignment: align DTI volume with structural reference scan (T2)]]'''
 +
*[[Image:RegLib C06 BreastMRIPostRx.png|70px|lleft|RegLib 06: Breast MRI]] [[Image:RegLib C06 BreastMRIPreRx.png|70px|lleft|RegLib 06: Breast MRI follow-up]]  '''Case 06: [[Projects:RegistrationDocumentation:RegLib_06_BreastMRI|Breast MRI follow-up pre/post treatment with contrast enhancement and strong intensity inhomogeneity]]'''
 +
*[[Image:RegLib_C08_WholeBodyPET-CT1.png|70px|lleft|RegLib C08: PET-CT1]] [[Image:RegLib_C08_WholeBodyPET-CT1.png|70px|lleft|RegLib C08: : PET-CT2]]  '''Case 08: [[Projects:RegistrationDocumentation:RegLib_08_WholeBodyPET-CT|Intra-subject PET-CT scan.''' Two exams each with a co-registered PET-CT dataset.]]
  
* Note use cases for which this module is especially appropriate, and/or link to examples.
 
* Link to examples of the module's use
 
* Link to any existing tutorials
 
  
 
===Quick Tour of Features and Use===
 
===Quick Tour of Features and Use===

Revision as of 13:47, 29 March 2010

Home < Modules:DeformableB-SplineRegistration-Documentation-3.6

Return to Slicer 3.4 Documentation

Gallery of New Features

Module Name

Deformable B-Spline Registration

Caption 1
Caption 2
Caption 3

General Information

This module was implemented by Jim Miller and Bill Lorensen and is based on the ITK B-spline implementation.

Module Type & Category

Type: CLI

Category: Base or (Filtering, Registration, etc.)

Authors, Collaborators & Contact

  • Author: Bill Lorensen
  • Contact: bill.lorensen at gmail.com

Module Description

Overview of what the module does goes here.

Usage

  • Parameters:
    • Iterations: Number of iterations to run the optimization method to estimate the registration parameters.
    • Grid Size: Number of grid points on interior of the fixed image. Larger grid sizes allow for finer registrations.
      • You can use this module to manually run a multiresolution registration by starting with a coarse grid, creating a resampled volume, and passing that resampled volume as the moving image for the next run with a finer grid.
      • Make sure you hit the tab key when changing the grid size.
    • Histogram bins: Number of histogram bins to use for Mattes Mutual Information. Reduce the number of bins if a deformable registration fails. If the number of bins is too large, the estimated PDFs will be a field of impulses and will inhibit reliable registration estimation.
    • Spatial samples: Number of spatial samples to use in estimating Mattes Mutual Information. Larger values yield more accurate PDFs and improved registration quality.
    • Constrain deformation: Constrain the deformation to the amount specified in Maximum Deformation
    • Maximum deformation: If Constrain Deformation is checked, limit the deformation to this amount.
    • Default pixel value: Default pixel value used if resampling a pixel outside of the volume.
  • IO
    • Intial Transform: Initial transform for aligning the fixed and moving image. Maps positions in the fixed coordinate frame to positions in the moving coordinate frame. This transform should be an affine or rigid transform. It is used an a bulk transform for the BSpline. Optional.
    • Fixed image: Fixed image to which to register
    • Moving image: Image to register to the fixed image
    • Output transform: Transform calculated that aligns the fixed and moving image. Maps positions from the fixed coordinate frame to the moving coordinate frame. Optional (specify an output transform or an output volume or both).
    • Output Volume: Resampled moving image to fixed image coordinate frame. Optional (specify an output transform or an output volume or both).
  • click Apply
  • Be careful how you set the parameters

Examples, Use Cases & Tutorials

The BSpline registration module is used in the following examples of the |Registration Case Library. Each case contains a step-by-step tutorial incl. parameter selections/presets. DWI alignment: align DTI volume with structural reference scan (T2)


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:

  • Input panel:
  • Parameters panel:
  • Output panel:
  • Viewing panel:

Development

Dependencies

Other modules or packages that are required for this module's use.

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

Source Code: [1]

Documentation: doxygen

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