---
name: "cmtk-xform2dfield"
section: "1"
platform: "linux"
package: "cmtk"
version: "3.3.1p2+dfsg-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/cmtk-xform2dfield"
---

# cmtk-xform2dfield(1)

Transformation to Deformation Field

## NAME

xform2dfield - Transformation to Deformation Field

## SYNOPSIS

**xform2dfield** OutputPath ReferenceImage XformList

## DESCRIPTION

Convert parametric rigid or nonrigid transformation to deformation field, sampled at pixel locations of a given reference image

## OPTIONS

### Global Toolkit Options (these are shared by all CMTK tools)

- **--help**

  Write list of basic command line options to standard output.

- **--help-all**

  Write complete list of basic and advanced command line options to standard output.

- **--wiki**

  Write list of command line options to standard output in MediaWiki markup.

- **--man**

  Write man page source in 'nroff' markup to standard output.

- **--version**

  Write toolkit version to standard output.

- **--echo**

  Write the current command line to standard output.

- **--verbose-level** *\<integer\>*

  Set verbosity level.

- **--verbose**, **-v**

  Increment verbosity level by 1 (deprecated; supported for backward compatibility).

- **--threads** *\<integer\>*

  Set maximum number of parallel threads (for POSIX threads and OpenMP).

### Main Options

- **--mask**, **-m**

  Use reference image pixels as a binary mask.

- **--target-image-fsl** *\<string\>*

  Path to optional target image to be used in FSL. This is the image that the transformation (and thus the created deformation field) maps to. When creating a deformation field to be used with FSL's "applywarp" tool, is may be necessary to determine whether the x coordinate of the resulting deformation vectors has to be flipped. **\[Default: disabled\]**

- **--inversion-tolerance-factor** *\<double\>*

  Factor for numerical tolerance of B-spline inversion \[multiples of minimum grid pixel size; default=0.1\] **\[Default: 0.1\]**

- **--downsample** *\<string\>*

  Downsample grid by factors 'x,y,z' or by single factor 'xyz' **\[Default: NONE\]**

- **--output-absolute**

  Make output deformation field with absolute target location vectors, rather than relative offset vectors.

## AUTHORS

Torsten Rohlfing, with contributions from Michael P. Hasak, Greg Jefferis, Calvin R. Maurer, Daniel B. Russakoff, and Yaroslav Halchenko

## LICENSE

http://www.fsf.org/licensing/licenses/gpl.html

## BUGS

Report bugs at http://nitrc.org/projects/cmtk/

## ACKNOWLEDGMENTS

CMTK is developed with support from the NIAAA under Grant AA021697, National Consortium on Alcohol and Neurodevelopment in Adolescence (N-CANDA): Data Integration Component. From April 2009 through September 2011, CMTK development and maintenance was supported by the NIBIB under Grant EB008381.