evaluate-dof [<dof>...] [options]


Calculates registration transformation quality measures such as the voxel-wise cumulative or mean inverse-consistency error (CICE/MICE) for pairs of forward transformation from target to source and backward transformation from source to target image. Another voxel-wise measure that can be computed using this program are the cumulative or mean transitivity error (CTE/MTE) given three transformations, from target (A) to B, from B to C, and from C to A again.

This tool can further be used to evaluate the deviation of N affine transformations which map a template to each one of N images from the barycenter corresponding to the identity transformation. A larger deviation indicates a stronger bias of the template towards a subset of the images and/or unbalanced registration errors.



File path of input transformation. Depending on the evaluation measure, multiple consecutive transformations are processed in tuples of fixed size and an error measure is computed for each such tuple of transformations. In the default case of 1-tuples, each transformation is evaluated separately. For other evaluation measures which are based on more than just one transformation see the list of optional arguments below.

Command options

-dofs <file>

Text file with (additional) input transformation paths. (default: none)

-output <file>

Name of voxel-wise output error map. (default: none)

-target <file>

Target image. (default: FFD lattice)

-mask <file>

Target region-of-interest mask. (default: none)

-padding <value>

Target background value, unused if -mask specified. (default: none)


Whether to compute the cumulative error. (default: mean)


Request evaluation of inverse-consistency error for each pair of input transformations when applied in the given order.


Request evaluation of transitivity error for each triple of input transformations when applied in the given order.


Evaluate norm of the average log map of all input transformations. When the transformations map each image to the common barycenter, the reported value should be (close to) zero.

Standard options

-v, -verbose [n]

Increase/Set verbosity of output messages. (default: 0)

-debug [level]

Increase/Set debug level for output of intermediate results. (default: 0)

-version [major.minor]

Print version and exit or set version to emulate.


Print revision (or version) number only and exit.

-h, -help

Print help and exit.