GtractCoRegAnatomy

From Slicer Wiki
Jump to: navigation, search
Home < GtractCoRegAnatomy

Coregister B0 to Anatomy B-Spline

Coregister B0 to Anatomy B-Spline

User Interface
Output
Caption

General Information

Module Type & Category

Type: CLI

Category: Diffusion.GTRACT


Authors, Collaborators & Contact

Author: This tool was developed by Vincent Magnotta and Greg Harris.

Contributors:

Contact: name, email


Module Description

Program title Coregister B0 to Anatomy B-Spline
Program description This program will register a Nrrd diffusion weighted 4D vector image to a fixed anatomical image. Two registration methods are supported for alignment with anatomical images: Rigid and B-Spline. The rigid registration performs a rigid body registration with the anatomical images and should be done as well to initialize the B-Spline transform. The B-SPline transform is the deformable transform, where the user can control the amount of deformation based on the number of control points as well as the maximum distance that these points can move. The B-Spline registration places a low dimensional grid in the image, which is deformed. This allows for some susceptibility related distortions to be removed from the diffusion weighted images. In general the amount of motion in the slice selection and read-out directions direction should be kept low. The distortion is in the phase encoding direction in the images. It is recommended that skull stripped (i.e. image containing only brain with skull removed) images shoud be used for image co-registration with the B-Spline transform.
Program version 4.0.0
Program documentation-url -

Usage

Use Cases, Examples

This module is especially appropriate for these use cases:

  • Use Case 1:
  • Use Case 2:

Examples of the module in use:

  • Example 1:
  • Example 2:

Tutorials

  • Tutorial 1
    • Data Set 1

Quick Tour of Features and Use

A list panels in the interface, their features, what they mean, and how to use them.

  • Input Image Parameters
    • Input Image Volume [--inputVolume] : Required: input vector image file name. It is recommended that the input volume is the skull stripped baseline image of the DWI scan.
    • Input Anatomical Image Volume [--inputAnatomicalVolume] : Required: input anatomical image file name. It is recommended that that the input anatomical image has been skull stripped and has the same orientation as the DWI scan.
    • Vector Image Index [--vectorIndex] : Vector image index in the moving image (within the DWI) to be used for registration. Default value: 0
    • Input Rigid Transform [--inputRigidTransform] : Required (for B-Spline type co-registration): input rigid transform file name. Used as a starting point for the anatomical B-Spline registration.


  • Output Files
    • Output Transform [--outputTransformName] : Required: filename for the fit transform.


  • Registration Parameters
    • Transform Type [--transformType] : Transform Type: Rigid|Bspline Default value: Rigid
    • Number Of Iterations [--numberOfIterations] : Number of iterations in the selected 3D fit Default value: 1000
    • Grid Size [--gridSize] : Number of grid subdivisions in all 3 directions Default value: 12,4,12
    • Border Size [--borderSize] : Size of border Default value: 3
    • Number of Histogram Bins [--numberOfHistogramBins] : Number of histogram bins Default value: 50
    • Spatial Scale [--spatialScale] : Scales the number of voxels in the image by this value to specify the number of voxels used in the registration Default value: 100
    • Convergence Factor [--convergence] : Convergence Factor Default value: 10000000
    • Gradient Tolerance [--gradientTolerance] : Gradient Tolerance Default value: 0.0001
    • Maximum Step Size [--maximumStepSize] : Maximum permitted step size to move in the selected 3D fit Default value: 0.2
    • Minimum Step Size [--minimumStepSize] : Minimum required step size to move in the selected 3D fit without converging -- decrease this to make the fit more exacting Default value: 0.0001
    • Translation Scale [--translationScale] : How much to scale up changes in position compared to unit rotational changes in radians -- decrease this to put more translation in the fit Default value: 1000.0
    • Relaxation Factor [--relaxationFactor] : Fraction of gradient from Jacobian to attempt to move in the selected 3D fit Default value: 0.5
    • Number Of Samples [--numberOfSamples] : Number of voxels sampled for mutual information computation in the selected 3D fit Default value: 100000
    • Initialize with MomentsAlign registration phase [--useMomentsAlign] : MomentsAlign assumes that the center of mass of the images represent similar structures. Perform a MomentsAlign registration as part of the sequential registration steps. This option MUST come first, and CAN NOT be used with either CenterOfHeadLAlign, GeometryAlign, or initialTransform file. This family of options superceeds the use of transformType if any of them are set. Default value: false
    • Initialize with GeometryCenterAlign registration phase [--useGeometryAlign] : GeometryAlign on assumes that the center of the voxel lattice of the images represent similar structures. Perform a GeometryCenterAlign registration as part of the sequential registration steps. This option MUST come first, and CAN NOT be used with either MomentsAlign, CenterOfHeadAlign, or initialTransform file. This family of options superceeds the use of transformType if any of them are set. Default value: false
    • Initialize with CenterOfHeadAlign registration phase [--useCenterOfHeadAlign] : CenterOfHeadAlign attempts to find a hemisphere full of foreground voxels from the superior direction as an estimate of where the center of a head shape would be to drive a center of mass estimate. Perform a CenterOfHeadAlign registration as part of the sequential registration steps. This option MUST come first, and CAN NOT be used with either MomentsAlign, GeometryAlign, or initialTransform file. This family of options superceeds the use of transformType if any of them are set. Default value: false


User Interface

Development

Notes from the Developer(s)

Algorithms used, library classes depended upon, use cases, etc.

Dependencies

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

Tests

On the Dashboard, these tests verify that the module is working on various platforms:

Known bugs

Links to known bugs in 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

Links to the module's source code:

Source code:

Doxygen documentation:

More Information

Acknowledgment

Funding for this version of the GTRACT program was provided by NIH/NINDS R01NS050568-01A2S1

References

Publications related to this module go here. Links to pdfs would be useful.