NIPY logo
Home · Quickstart · Documentation · Citation · NiPy
Loading

Table Of Contents

Versions

ReleaseDevel
0.9.21.0-dev
Download Github

Links

interfaces.slicer.registration.specialized

ACPCTransform

Link to code

Wraps command **ACPCTransform **

title: ACPC Transform

category: Registration.Specialized

description: <p>Calculate a transformation from two lists of fiducial points.</p><p>ACPC line is two fiducial points, one at the anterior commissure and one at the posterior commissure. The resulting transform will bring the line connecting them to horizontal to the AP axis.</p><p>The midline is a series of points defining the division between the hemispheres of the brain (the mid sagittal plane). The resulting transform will put the output volume with the mid sagittal plane lined up with the AS plane.</p><p>Use the Filtering module<b>Resample Scalar/Vector/DWI Volume</b>to apply the transformation to a volume.</p>

version: 1.0

documentation-url: http://wiki.slicer.org/slicerWiki/index.php/Documentation/4.1/Modules/ACPCTransform

license: slicer3

contributor: Nicole Aucoin (SPL, BWH), Ron Kikinis (SPL, BWH)

acknowledgements: 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.

Inputs:

[Mandatory]
terminal_output: ('stream' or 'allatonce' or 'file' or 'none')
        Control terminal output: `stream` - displays to terminal
        immediately, `allatonce` - waits till command is finished to display
        output, `file` - writes output to file, `none` - output is ignored

[Optional]
acpc: (a list of from 3 to 3 items which are a float)
        ACPC line, two fiducial points, one at the anterior commissure and
        one at the posterior commissure.
args: (a string)
        Additional parameters to the command
debugSwitch: (a boolean)
        Click if wish to see debugging output
environ: (a dictionary with keys which are a value of type 'str' and
         with values which are a value of type 'str', nipype default value:
         {})
        Environment variables
ignore_exception: (a boolean, nipype default value: False)
        Print an error message instead of throwing an exception in case the
        interface fails to run
midline: (a list of from 3 to 3 items which are a float)
        The midline is a series of points defining the division between the
        hemispheres of the brain (the mid sagittal plane).
outputTransform: (a boolean or a file name)
        A transform filled in from the ACPC and Midline registration
        calculation
terminal_output: ('stream' or 'allatonce' or 'file' or 'none')
        Control terminal output: `stream` - displays to terminal
        immediately, `allatonce` - waits till command is finished to display
        output, `file` - writes output to file, `none` - output is ignored

Outputs:

outputTransform: (an existing file name)
        A transform filled in from the ACPC and Midline registration
        calculation

BRAINSDemonWarp

Link to code

Wraps command **BRAINSDemonWarp **

title: Demon Registration (BRAINS)

category: Registration.Specialized

description:
This program finds a deformation field to warp a moving image onto a fixed image. The images must be of the same signal kind, and contain an image of the same kind of object. This program uses the Thirion Demons warp software in ITK, the Insight Toolkit. Additional information is available at: http://www.nitrc.org/projects/brainsdemonwarp.

version: 3.0.0

documentation-url: http://wiki.slicer.org/slicerWiki/index.php/Modules:BRAINSDemonWarp

license: https://www.nitrc.org/svn/brains/BuildScripts/trunk/License.txt

contributor: This tool was developed by Hans J. Johnson and Greg Harris.

acknowledgements: The development of this tool was supported by funding from grants NS050568 and NS40068 from the National Institute of Neurological Disorders and Stroke and grants MH31593, MH40856, from the National Institute of Mental Health.

Inputs:

[Mandatory]
terminal_output: ('stream' or 'allatonce' or 'file' or 'none')
        Control terminal output: `stream` - displays to terminal
        immediately, `allatonce` - waits till command is finished to display
        output, `file` - writes output to file, `none` - output is ignored

[Optional]
args: (a string)
        Additional parameters to the command
arrayOfPyramidLevelIterations: (an integer)
        The number of iterations for each pyramid level
backgroundFillValue: (an integer)
        Replacement value to overwrite background when performing BOBF
checkerboardPatternSubdivisions: (an integer)
        Number of Checkerboard subdivisions in all 3 directions
environ: (a dictionary with keys which are a value of type 'str' and
         with values which are a value of type 'str', nipype default value:
         {})
        Environment variables
fixedBinaryVolume: (an existing file name)
        Mask filename for desired region of interest in the Fixed image.
fixedVolume: (an existing file name)
        Required: input fixed (target) image
gradient_type: ('0' or '1' or '2')
        Type of gradient used for computing the demons force (0 is
        symmetrized, 1 is fixed image, 2 is moving image)
gui: (a boolean)
        Display intermediate image volumes for debugging
histogramMatch: (a boolean)
        Histogram Match the input images. This is suitable for images of the
        same modality that may have different absolute scales, but the same
        overall intensity profile.
ignore_exception: (a boolean, nipype default value: False)
        Print an error message instead of throwing an exception in case the
        interface fails to run
initializeWithDisplacementField: (an existing file name)
        Initial deformation field vector image file name
initializeWithTransform: (an existing file name)
        Initial Transform filename
inputPixelType: ('float' or 'short' or 'ushort' or 'int' or 'uchar')
        Input volumes will be typecast to this format:
        float|short|ushort|int|uchar
interpolationMode: ('NearestNeighbor' or 'Linear' or
         'ResampleInPlace' or 'BSpline' or 'WindowedSinc' or 'Hamming' or
         'Cosine' or 'Welch' or 'Lanczos' or 'Blackman')
        Type of interpolation to be used when applying transform to moving
        volume. Options are Linear, ResampleInPlace, NearestNeighbor,
        BSpline, or WindowedSinc
lowerThresholdForBOBF: (an integer)
        Lower threshold for performing BOBF
maskProcessingMode: ('NOMASK' or 'ROIAUTO' or 'ROI' or 'BOBF')
        What mode to use for using the masks: NOMASK|ROIAUTO|ROI|BOBF. If
        ROIAUTO is choosen, then the mask is implicitly defined using a otsu
        forground and hole filling algorithm. Where the Region Of Interest
        mode uses the masks to define what parts of the image should be used
        for computing the deformation field. Brain Only Background Fill uses
        the masks to pre-process the input images by clipping and filling in
        the background with a predefined value.
max_step_length: (a float)
        Maximum length of an update vector (0: no restriction)
medianFilterSize: (an integer)
        Median filter radius in all 3 directions. When images have a lot of
        salt and pepper noise, this step can improve the registration.
minimumFixedPyramid: (an integer)
        The shrink factor for the first level of the fixed image pyramid.
        (i.e. start at 1/16 scale, then 1/8, then 1/4, then 1/2, and finally
        full scale)
minimumMovingPyramid: (an integer)
        The shrink factor for the first level of the moving image pyramid.
        (i.e. start at 1/16 scale, then 1/8, then 1/4, then 1/2, and finally
        full scale)
movingBinaryVolume: (an existing file name)
        Mask filename for desired region of interest in the Moving image.
movingVolume: (an existing file name)
        Required: input moving image
neighborhoodForBOBF: (an integer)
        neighborhood in all 3 directions to be included when performing BOBF
numberOfBCHApproximationTerms: (an integer)
        Number of terms in the BCH expansion
numberOfHistogramBins: (an integer)
        The number of histogram levels
numberOfMatchPoints: (an integer)
        The number of match points for histrogramMatch
numberOfPyramidLevels: (an integer)
        Number of image pyramid levels to use in the multi-resolution
        registration.
numberOfThreads: (an integer)
        Explicitly specify the maximum number of threads to use.
outputCheckerboardVolume: (a boolean or a file name)
        Genete a checkerboard image volume between the fixedVolume and the
        deformed movingVolume.
outputDebug: (a boolean)
        Flag to write debugging images after each step.
outputDisplacementFieldPrefix: (a string)
        Displacement field filename prefix for writing separate x, y, and z
        component images
outputDisplacementFieldVolume: (a boolean or a file name)
        Output deformation field vector image (will have the same physical
        space as the fixedVolume).
outputNormalized: (a boolean)
        Flag to warp and write the normalized images to output. In
        normalized images the image values are fit-scaled to be between 0
        and the maximum storage type value.
outputPixelType: ('float' or 'short' or 'ushort' or 'int' or 'uchar')
        outputVolume will be typecast to this format:
        float|short|ushort|int|uchar
outputVolume: (a boolean or a file name)
        Required: output resampled moving image (will have the same physical
        space as the fixedVolume).
promptUser: (a boolean)
        Prompt the user to hit enter each time an image is sent to the
        DebugImageViewer
registrationFilterType: ('Demons' or 'FastSymmetricForces' or
         'Diffeomorphic')
        Registration Filter Type: Demons|FastSymmetricForces|Diffeomorphic
seedForBOBF: (an integer)
        coordinates in all 3 directions for Seed when performing BOBF
smoothDisplacementFieldSigma: (a float)
        A gaussian smoothing value to be applied to the deformation feild at
        each iteration.
terminal_output: ('stream' or 'allatonce' or 'file' or 'none')
        Control terminal output: `stream` - displays to terminal
        immediately, `allatonce` - waits till command is finished to display
        output, `file` - writes output to file, `none` - output is ignored
upFieldSmoothing: (a float)
        Smoothing sigma for the update field at each iteration
upperThresholdForBOBF: (an integer)
        Upper threshold for performing BOBF
use_vanilla_dem: (a boolean)
        Run vanilla demons algorithm

Outputs:

outputCheckerboardVolume: (an existing file name)
        Genete a checkerboard image volume between the fixedVolume and the
        deformed movingVolume.
outputDisplacementFieldVolume: (an existing file name)
        Output deformation field vector image (will have the same physical
        space as the fixedVolume).
outputVolume: (an existing file name)
        Required: output resampled moving image (will have the same physical
        space as the fixedVolume).

FiducialRegistration

Link to code

Wraps command **FiducialRegistration **

title: Fiducial Registration

category: Registration.Specialized

description: Computes a rigid, similarity or affine transform from a matched list of fiducials

version: 0.1.0.$Revision$

documentation-url: http://wiki.slicer.org/slicerWiki/index.php/Documentation/4.1/Modules/TransformFromFiducials

contributor: Casey B Goodlett (Kitware), Dominik Meier (SPL, BWH)

acknowledgements: 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.

Inputs:

[Mandatory]
terminal_output: ('stream' or 'allatonce' or 'file' or 'none')
        Control terminal output: `stream` - displays to terminal
        immediately, `allatonce` - waits till command is finished to display
        output, `file` - writes output to file, `none` - output is ignored

[Optional]
args: (a string)
        Additional parameters to the command
environ: (a dictionary with keys which are a value of type 'str' and
         with values which are a value of type 'str', nipype default value:
         {})
        Environment variables
fixedLandmarks: (a list of from 3 to 3 items which are a float)
        Ordered list of landmarks in the fixed image
ignore_exception: (a boolean, nipype default value: False)
        Print an error message instead of throwing an exception in case the
        interface fails to run
movingLandmarks: (a list of from 3 to 3 items which are a float)
        Ordered list of landmarks in the moving image
outputMessage: (a string)
        Provides more information on the output
rms: (a float)
        Display RMS Error.
saveTransform: (a boolean or a file name)
        Save the transform that results from registration
terminal_output: ('stream' or 'allatonce' or 'file' or 'none')
        Control terminal output: `stream` - displays to terminal
        immediately, `allatonce` - waits till command is finished to display
        output, `file` - writes output to file, `none` - output is ignored
transformType: ('Translation' or 'Rigid' or 'Similarity')
        Type of transform to produce

Outputs:

saveTransform: (an existing file name)
        Save the transform that results from registration

VBRAINSDemonWarp

Link to code

Wraps command **VBRAINSDemonWarp **

title: Vector Demon Registration (BRAINS)

category: Registration.Specialized

description:
This program finds a deformation field to warp a moving image onto a fixed image. The images must be of the same signal kind, and contain an image of the same kind of object. This program uses the Thirion Demons warp software in ITK, the Insight Toolkit. Additional information is available at: http://www.nitrc.org/projects/brainsdemonwarp.

version: 3.0.0

documentation-url: http://wiki.slicer.org/slicerWiki/index.php/Modules:BRAINSDemonWarp

license: https://www.nitrc.org/svn/brains/BuildScripts/trunk/License.txt

contributor: This tool was developed by Hans J. Johnson and Greg Harris.

acknowledgements: The development of this tool was supported by funding from grants NS050568 and NS40068 from the National Institute of Neurological Disorders and Stroke and grants MH31593, MH40856, from the National Institute of Mental Health.

Inputs:

[Mandatory]
terminal_output: ('stream' or 'allatonce' or 'file' or 'none')
        Control terminal output: `stream` - displays to terminal
        immediately, `allatonce` - waits till command is finished to display
        output, `file` - writes output to file, `none` - output is ignored

[Optional]
args: (a string)
        Additional parameters to the command
arrayOfPyramidLevelIterations: (an integer)
        The number of iterations for each pyramid level
backgroundFillValue: (an integer)
        Replacement value to overwrite background when performing BOBF
checkerboardPatternSubdivisions: (an integer)
        Number of Checkerboard subdivisions in all 3 directions
environ: (a dictionary with keys which are a value of type 'str' and
         with values which are a value of type 'str', nipype default value:
         {})
        Environment variables
fixedBinaryVolume: (an existing file name)
        Mask filename for desired region of interest in the Fixed image.
fixedVolume: (an existing file name)
        Required: input fixed (target) image
gradient_type: ('0' or '1' or '2')
        Type of gradient used for computing the demons force (0 is
        symmetrized, 1 is fixed image, 2 is moving image)
gui: (a boolean)
        Display intermediate image volumes for debugging
histogramMatch: (a boolean)
        Histogram Match the input images. This is suitable for images of the
        same modality that may have different absolute scales, but the same
        overall intensity profile.
ignore_exception: (a boolean, nipype default value: False)
        Print an error message instead of throwing an exception in case the
        interface fails to run
initializeWithDisplacementField: (an existing file name)
        Initial deformation field vector image file name
initializeWithTransform: (an existing file name)
        Initial Transform filename
inputPixelType: ('float' or 'short' or 'ushort' or 'int' or 'uchar')
        Input volumes will be typecast to this format:
        float|short|ushort|int|uchar
interpolationMode: ('NearestNeighbor' or 'Linear' or
         'ResampleInPlace' or 'BSpline' or 'WindowedSinc' or 'Hamming' or
         'Cosine' or 'Welch' or 'Lanczos' or 'Blackman')
        Type of interpolation to be used when applying transform to moving
        volume. Options are Linear, ResampleInPlace, NearestNeighbor,
        BSpline, or WindowedSinc
lowerThresholdForBOBF: (an integer)
        Lower threshold for performing BOBF
makeBOBF: (a boolean)
        Flag to make Brain-Only Background-Filled versions of the input and
        target volumes.
max_step_length: (a float)
        Maximum length of an update vector (0: no restriction)
medianFilterSize: (an integer)
        Median filter radius in all 3 directions. When images have a lot of
        salt and pepper noise, this step can improve the registration.
minimumFixedPyramid: (an integer)
        The shrink factor for the first level of the fixed image pyramid.
        (i.e. start at 1/16 scale, then 1/8, then 1/4, then 1/2, and finally
        full scale)
minimumMovingPyramid: (an integer)
        The shrink factor for the first level of the moving image pyramid.
        (i.e. start at 1/16 scale, then 1/8, then 1/4, then 1/2, and finally
        full scale)
movingBinaryVolume: (an existing file name)
        Mask filename for desired region of interest in the Moving image.
movingVolume: (an existing file name)
        Required: input moving image
neighborhoodForBOBF: (an integer)
        neighborhood in all 3 directions to be included when performing BOBF
numberOfBCHApproximationTerms: (an integer)
        Number of terms in the BCH expansion
numberOfHistogramBins: (an integer)
        The number of histogram levels
numberOfMatchPoints: (an integer)
        The number of match points for histrogramMatch
numberOfPyramidLevels: (an integer)
        Number of image pyramid levels to use in the multi-resolution
        registration.
numberOfThreads: (an integer)
        Explicitly specify the maximum number of threads to use.
outputCheckerboardVolume: (a boolean or a file name)
        Genete a checkerboard image volume between the fixedVolume and the
        deformed movingVolume.
outputDebug: (a boolean)
        Flag to write debugging images after each step.
outputDisplacementFieldPrefix: (a string)
        Displacement field filename prefix for writing separate x, y, and z
        component images
outputDisplacementFieldVolume: (a boolean or a file name)
        Output deformation field vector image (will have the same physical
        space as the fixedVolume).
outputNormalized: (a boolean)
        Flag to warp and write the normalized images to output. In
        normalized images the image values are fit-scaled to be between 0
        and the maximum storage type value.
outputPixelType: ('float' or 'short' or 'ushort' or 'int' or 'uchar')
        outputVolume will be typecast to this format:
        float|short|ushort|int|uchar
outputVolume: (a boolean or a file name)
        Required: output resampled moving image (will have the same physical
        space as the fixedVolume).
promptUser: (a boolean)
        Prompt the user to hit enter each time an image is sent to the
        DebugImageViewer
registrationFilterType: ('Demons' or 'FastSymmetricForces' or
         'Diffeomorphic' or 'LogDemons' or 'SymmetricLogDemons')
        Registration Filter Type: Demons|FastSymmetricForces|Diffeomorphic|L
        ogDemons|SymmetricLogDemons
seedForBOBF: (an integer)
        coordinates in all 3 directions for Seed when performing BOBF
smoothDisplacementFieldSigma: (a float)
        A gaussian smoothing value to be applied to the deformation feild at
        each iteration.
terminal_output: ('stream' or 'allatonce' or 'file' or 'none')
        Control terminal output: `stream` - displays to terminal
        immediately, `allatonce` - waits till command is finished to display
        output, `file` - writes output to file, `none` - output is ignored
upFieldSmoothing: (a float)
        Smoothing sigma for the update field at each iteration
upperThresholdForBOBF: (an integer)
        Upper threshold for performing BOBF
use_vanilla_dem: (a boolean)
        Run vanilla demons algorithm
weightFactors: (a float)
        Weight fatctors for each input images

Outputs:

outputCheckerboardVolume: (an existing file name)
        Genete a checkerboard image volume between the fixedVolume and the
        deformed movingVolume.
outputDisplacementFieldVolume: (an existing file name)
        Output deformation field vector image (will have the same physical
        space as the fixedVolume).
outputVolume: (an existing file name)
        Required: output resampled moving image (will have the same physical
        space as the fixedVolume).