Grundlett: Text replacement - "https?:\/\/(?:www|wiki)\.slicer\.org\/slicerWiki\/index\.php\/([^ ]+) " to "https://www.slicer.org/wiki/$1 "

2019-11-27T13:16:06Z

Text replacement - "https?:\/\/(?:www|wiki)\.slicer\.org\/slicerWiki\/index\.php\/([^ ]+) " to "https://www.slicer.org/wiki/$1 "

Matsuij: Created page with 'NOTOC ===Coregister B0 to Anatomy B-Spline=== Coregister B0 to Anatomy B-Spline {| |User Interface |[[Image:screenshotBl…'

2010-06-24T19:07:41Z

Created page with '__NOTOC__ ===Coregister B0 to Anatomy B-Spline=== Coregister B0 to Anatomy B-Spline {| |thumb|280px|User Interface |[[Image:screenshotBl…'

New page

__NOTOC__
===Coregister B0 to Anatomy B-Spline===
Coregister B0 to Anatomy B-Spline

{|
|[[Image:screenshotBlankNotOptional.png|thumb|280px|User Interface]]
|[[Image:screenshotBlank.png|thumb|280px|Output]]
|[[Image:screenshotBlank.png|thumb|280px|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===

{| style="color:green" border="1"

|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 || http://wiki.slicer.org/slicerWiki/index.php/Modules:GTRACT

|-
|}

== 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''

|[[Image:screenshotBlankNotOptional.png|thumb|280px|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 [http://www.cdash.org/CDash/index.php?project=Slicer3 Dashboard], these tests verify that the module is working on various platforms:

* MyModuleTest1 [http://viewvc.slicer.org/viewcvs.cgi/trunk MyModuleTest1.cxx]
* MyModuleTest2 [http://viewvc.slicer.org/viewcvs.cgi/trunk MyModuleTest2.cxx]

===Known bugs===

Links to known bugs in the Slicer3 bug tracker

* [http://www.na-mic.org/Bug/view.php?id=000 Bug 000: description]

===Usability issues===

Follow this [http://na-mic.org/Mantis/main_page.php 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:
*[http://viewvc.slicer.org/viewcvs.cgi/trunk file.cxx ]
*[http://viewvc.slicer.org/viewcvs.cgi/trunk file.h ]

Doxygen documentation:
*[http://www.na-mic.org/Slicer/Documentation/Slicer3-doc/html/classes.html class1]

== 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.

@@ Line 40: / Line 40: @@
 |-
-|Program documentation-url || http://wiki.slicer.org/slicerWiki/index.php/Modules:GTRACT
+|Program documentation-url || https://www.slicer.org/wiki/Modules:GTRACT |-
 |}

GtractCoRegAnatomy - Revision history

Grundlett: Text replacement - "https?:\/\/(?:www|wiki)\.slicer\.org\/slicerWiki\/index\.php\/([^ ]+) " to "https://www.slicer.org/wiki/$1 "

Matsuij: Created page with '__NOTOC__ ===Coregister B0 to Anatomy B-Spline=== Coregister B0 to Anatomy B-Spline {| |User Interface |[[Image:screenshotBl…'

Matsuij: Created page with 'NOTOC ===Coregister B0 to Anatomy B-Spline=== Coregister B0 to Anatomy B-Spline {| |User Interface |[[Image:screenshotBl…'