interfaces.ants.utils

AverageAffineTransform

Link to code

Wraps command AverageAffineTransform

Examples

>>> from nipype.interfaces.ants import AverageAffineTransform
>>> avg = AverageAffineTransform()
>>> avg.inputs.dimension = 3
>>> avg.inputs.transforms = ['trans.mat', 'func_to_struct.mat']
>>> avg.inputs.output_affine_transform = 'MYtemplatewarp.mat'
>>> avg.cmdline 
'AverageAffineTransform 3 MYtemplatewarp.mat trans.mat func_to_struct.mat'

Inputs:

[Mandatory]
dimension: (3 or 2)
        image dimension (2 or 3)
        flag: %d, position: 0
output_affine_transform: (a file name)
        Outputfname.txt: the name of the resulting transform.
        flag: %s, position: 1
transforms: (a list of items which are an existing file name)
        transforms to average
        flag: %s, position: 3

[Optional]
args: (a unicode string)
        Additional parameters to the command
        flag: %s
environ: (a dictionary with keys which are a newbytes or None or a
         newstr or None and with values which are a newbytes or None or a
         newstr or None, 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
num_threads: (an integer (int or long), nipype default value: 1)
        Number of ITK threads to use
terminal_output: (u'stream' or u'allatonce' or u'file' or u'none')
        Control terminal output: `stream` - displays to terminal immediately
        (default), `allatonce` - waits till command is finished to display
        output, `file` - writes output to file, `none` - output is ignored

Outputs:

affine_transform: (an existing file name)
        average transform file

AverageImages

Link to code

Wraps command AverageImages

Examples

>>> from nipype.interfaces.ants import AverageImages
>>> avg = AverageImages()
>>> avg.inputs.dimension = 3
>>> avg.inputs.output_average_image = "average.nii.gz"
>>> avg.inputs.normalize = True
>>> avg.inputs.images = ['rc1s1.nii', 'rc1s1.nii']
>>> avg.cmdline 
'AverageImages 3 average.nii.gz 1 rc1s1.nii rc1s1.nii'

Inputs:

[Mandatory]
dimension: (3 or 2)
        image dimension (2 or 3)
        flag: %d, position: 0
images: (a list of items which are an existing file name)
        image to apply transformation to (generally a coregistered
        functional)
        flag: %s, position: 3
normalize: (a boolean)
        Normalize: if true, the 2nd imageis divided by its mean. This will
        select the largest image to average into.
        flag: %d, position: 2

[Optional]
args: (a unicode string)
        Additional parameters to the command
        flag: %s
environ: (a dictionary with keys which are a newbytes or None or a
         newstr or None and with values which are a newbytes or None or a
         newstr or None, 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
num_threads: (an integer (int or long), nipype default value: 1)
        Number of ITK threads to use
output_average_image: (a file name, nipype default value:
         average.nii)
        the name of the resulting image.
        flag: %s, position: 1
terminal_output: (u'stream' or u'allatonce' or u'file' or u'none')
        Control terminal output: `stream` - displays to terminal immediately
        (default), `allatonce` - waits till command is finished to display
        output, `file` - writes output to file, `none` - output is ignored

Outputs:

output_average_image: (an existing file name)
        average image file

CreateJacobianDeterminantImage

Link to code

Wraps command CreateJacobianDeterminantImage

Examples

>>> from nipype.interfaces.ants import CreateJacobianDeterminantImage
>>> jacobian = CreateJacobianDeterminantImage()
>>> jacobian.inputs.imageDimension = 3
>>> jacobian.inputs.deformationField = 'ants_Warp.nii.gz'
>>> jacobian.inputs.outputImage = 'out_name.nii.gz'
>>> jacobian.cmdline 
'CreateJacobianDeterminantImage 3 ants_Warp.nii.gz out_name.nii.gz'

Inputs:

[Mandatory]
deformationField: (an existing file name)
        deformation transformation file
        flag: %s, position: 1
imageDimension: (3 or 2)
        image dimension (2 or 3)
        flag: %d, position: 0
outputImage: (a file name)
        output filename
        flag: %s, position: 2

[Optional]
args: (a unicode string)
        Additional parameters to the command
        flag: %s
doLogJacobian: (0 or 1)
        return the log jacobian
        flag: %d, position: 3
environ: (a dictionary with keys which are a newbytes or None or a
         newstr or None and with values which are a newbytes or None or a
         newstr or None, 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
num_threads: (an integer (int or long), nipype default value: 1)
        Number of ITK threads to use
terminal_output: (u'stream' or u'allatonce' or u'file' or u'none')
        Control terminal output: `stream` - displays to terminal immediately
        (default), `allatonce` - waits till command is finished to display
        output, `file` - writes output to file, `none` - output is ignored
useGeometric: (0 or 1)
        return the geometric jacobian
        flag: %d, position: 4

Outputs:

jacobian_image: (an existing file name)
        jacobian image

MultiplyImages

Link to code

Wraps command MultiplyImages

Examples

>>> from nipype.interfaces.ants import MultiplyImages
>>> test = MultiplyImages()
>>> test.inputs.dimension = 3
>>> test.inputs.first_input = 'moving2.nii'
>>> test.inputs.second_input = 0.25
>>> test.inputs.output_product_image = "out.nii"
>>> test.cmdline 
'MultiplyImages 3 moving2.nii 0.25 out.nii'

Inputs:

[Mandatory]
dimension: (3 or 2)
        image dimension (2 or 3)
        flag: %d, position: 0
first_input: (an existing file name)
        image 1
        flag: %s, position: 1
output_product_image: (a file name)
        Outputfname.nii.gz: the name of the resulting image.
        flag: %s, position: 3
second_input: (an existing file name or a float)
        image 2 or multiplication weight
        flag: %s, position: 2

[Optional]
args: (a unicode string)
        Additional parameters to the command
        flag: %s
environ: (a dictionary with keys which are a newbytes or None or a
         newstr or None and with values which are a newbytes or None or a
         newstr or None, 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
num_threads: (an integer (int or long), nipype default value: 1)
        Number of ITK threads to use
terminal_output: (u'stream' or u'allatonce' or u'file' or u'none')
        Control terminal output: `stream` - displays to terminal immediately
        (default), `allatonce` - waits till command is finished to display
        output, `file` - writes output to file, `none` - output is ignored

Outputs:

output_product_image: (an existing file name)
        average image file