Man pages sections > man1 > ANTS

ANTS - part of ANTS registration suite

ANTS(1) User Commands ANTS(1)

NAME

ANTS - part of ANTS registration suite

DESCRIPTION

COMMAND:

ANTS

OPTIONS:

-x, --mask-image maskFileName
this mask -- defined in the 'fixed' image space defines the region of interest over which the registration is computed ==> above 0.1 means inside mask ==> continuous values in range [0.1,1.0] effect optimization like a probability. ==> values > 1 are treated as = 1.0
-m, --image-metric
The metric weights are relative to the weights on the N other metrics passed to ANTS --- N is unlimited. So, the weight, w_i on the i^{th} metric will be w_i=w_i/ ( sum_i w_i ).Intensity-Based Metrics:
CC/cross-correlation/CrossCorrelation[fixedImage,movingImage,weight,radius/OrForMI-#histogramBins] MI/mutual-information/MutualInformation[fixedImage,movingImage,weight,radius/OrForMI-#histogramBins] SMI/spatial-mutual-information/SpatialMutualInformation[fixedImage,movingImage,weight,radius/OrForMI-#histogramBins] PR/probabilistic/Probabilistic[fixedImage,movingImage,weight,radius/OrForMI-#histogramBins] SSD
--- standard intensity difference.[fixedImage,movingImage,weight,radius/OrForMI-#histogramBins]
MSQ/mean-squares/MeanSquares
-- demons-like, radius > 0 uses moving image gradient in metric
deriv.[fixedImage,movingImage,weight,radius/OrForMI-#histogramBins]
Point-Set-Based Metrics:
PSE/point-set-expectation/PointSetExpectation[fixedImage,movingImage,fixedPoints,movingPoints,weight,pointSetPercentage,pointSetSigma,boundaryPointsOnly,kNeighborhood,
PartialMatchingIterations=100000]
the partial matching option assumes the
complete labeling is in the first set of label parameters ... more iterations leads to more symmetry in the matching - 0 iterations means full asymmetry
[fixedImage,movingImage,fixedPoints,movingPoints,weight,pointSetPercentage,pointSetSigma,boundaryPointsOnly,kNeighborhood,alpha,meshResolution,splineOrder,numberOfLevels,useAnisotropicCovariances]
-o, --output-naming
The name for the output - a prefix or a name+type : e.g. -o OUT or -o OUT.nii or -o OUT.mha
--R
TODO/FIXME: the --R sets an ROI option -- it passes a vector of parameters that sets the center and bounding box
of the region of interest for a sub-field
registration. e.g. in 3D the option setting
-r 10x12x15x50x50x25
sets up a
bounding box of size 50,50,25 with origin at 10,12,15 in voxel (should this be physical?) coordinates. <VALUES>: 0
-i, --number-of-iterations
number of iterations per level -- a 'vector' e.g. : 100x100x20 <VALUES>: 10x10x5
--Restrict-Deformation
restrict the gradient that drives the deformation by scalar factors along specified dimensions -- a TReal 'vector' of length ImageDimension to multiply against the similarity metric's gradient values --- e.g. in 3D : 0.1x1x0 --- will set the z gradient to zero and scale the x gradient by 0.1 and y by 1 (no change). Thus, you get a 2.5-Dimensional registration as there is still 3D continuity in the mapping. <VALUES>: 1x1
-v, --verbose
verbose output
--use-all-metrics-for-convergence
enable to use weighted sum of all metric terms for convergence computation. By default, only the first metric is used <VALUES>: 0
-h
Print the help menu (short version). <VALUES>: 0
--help
Print the help menu. <VALUES>: 1, 0
-t, --transformation-model
TRANSFORMATION[gradient-step-length,number-of-time-steps,DeltaTime,symmetry-type].
Choose one of the following TRANSFORMATIONS:
Diff = diffeomorphic Elast =
Elastic
Exp = exponential diff
Greedy Exp = greedy exponential diff, like
diffeomorphic demons. same parameters.
SyN -- symmetric normalization
DeltaTime is the integration time-discretization step - sub-voxel - n-time steps currently fixed at 2 <VALUES>: SyN[0.5]
-r, --regularization
REGULARIZATION[gradient-field-sigma,def-field-sigma,truncation].
Choose one of
the following REGULARIZATIONS:
Gauss = gaussian DMFFD = directly manipulated
free form deformation <VALUES>: Gauss[3,0.5]
-a, --initial-affine
use the input file as the initial affine parameter
-F, --fixed-image-initial-affine
use the input file as the initial affine parameter for the fixed image
--fixed-image-initial-affine-ref-image
reference space for using the input file as the initial affine parameter for the fixed image
-T, --geodesic
= 0 / 1 / 2, 0 = not time-dependent, 1 = asymmetric , 2 = symmetric
-G, --go-faster
true / false -- if true, SyN is faster but loses some accuracy wrt inverse-identity constraint, see Avants MIA 2008. <VALUES>: false
--continue-affine
true (default) | false, do (not) perform affine given the initial affine parameters <VALUES>: true
--number-of-affine-iterations
number of iterations per level -- a 'vector' e.g. : 100x100x20 <VALUES>: 10000x10000x10000
--use-NN
use nearest neighbor interpolation <VALUES>: 0
--use-Histogram-Matching
use histogram matching of moving to fixed image <VALUES>: 0
--affine-metric-type
MI: mutual information (default), MSQ: mean square error, SSD, CC: Normalized correlation, CCH: Histogram-based correlation coefficient (not recommended), GD: gradient difference (not recommended) <VALUES>: MI
--MI-option
option of mutual information: MI_bins x MI_samples (default: 32x32000) <VALUES>: 32x5000
--rigid-affine
use rigid transformation : true / false(default) <VALUES>: false
--do-rigid
use rigid transformation : true / false(default) <VALUES>: false
--affine-gradient-descent-option
option of gradient descent in affine transformation: maximum_step_length x relaxation_factor x minimum_step_length x translation_scales <VALUES>: 0.1x0.5x1.e-4x1.e-4
--use-rotation-header
use rotation matrix in image headers: true (default) / false <VALUES>: false
--ignore-void-origin
ignore the apparently unmatched origins (when use-rotation-header is false and the rotation matrix is identity: true (default) / false <VALUES>: false
--gaussian-smoothing-sigmas
At each resolution level the image is subsampled and smoothed by Gaussian convolution. This option allows the user to override the default smoothing by specifying sigma values (in mm) for smoothing both fixed and moving images for each resolution level. <VALUES>:
--subsampling-factors
At each resolution level the image is subsampled and smoothed by Gaussian convolution. This option allows the user to override the default subsampling by specifying the subsampling factor for both fixed and moving images for each resolution level. <VALUES>:
September 2017 ANTS 2.1.0