.TH mat2dof "1" "Jun  6 2022" "CMTK 3.3.1p2" "The Computational Morphometry Toolkit"
.SH NAME
mat2dof \- Matrix to degrees of freedom
.SH SYNOPSIS
mat2dof [options] < matrix
.SH DESCRIPTION
Convert transformation matrix to degrees of freedom
.SH OPTIONS
.SS Global Toolkit Options (these are shared by all CMTK tools)
.TP 5
\fB\-\-help\fR
Write list of basic command line options to standard output.
.TP 5
\fB\-\-help-all\fR
Write complete list of basic and advanced command line options to standard output.
.TP 5
\fB\-\-wiki\fR
Write list of command line options to standard output in MediaWiki markup.
.TP 5
\fB\-\-man\fR
Write man page source in 'nroff' markup to standard output.
.TP 5
\fB\-\-version\fR
Write toolkit version to standard output.
.TP 5
\fB\-\-echo\fR
Write the current command line to standard output.
.TP 5
\fB\-\-verbose-level\fR \fI<integer>\fR
Set verbosity level.
.TP 5
\fB\-\-verbose\fR, \fB\-v\fR
Increment verbosity level by 1 (deprecated; supported for backward compatibility).
.TP 5
\fB\-\-threads\fR \fI<integer>\fR
Set maximum number of parallel threads (for POSIX threads and OpenMP).
.SS Input Options
.TP 5
\fB\-\-matrix3x3\fR, \fB\-3\fR
Only input upper left 3x3 submatrix.
.TP 5
\fB\-\-transpose\fR, \fB\-t\fR
Transpose input matrix.
.TP 5
\fB\-\-pixel-size\fR \fI<string>\fR
For matrices in pixel space (i.e., mapping from grid index to physical coordinate), set image grid pixel size.
.B [Default: NONE]
.SS Transformation Modifiers
.TP 5
\fB\-\-center\fR \fI<string>\fR
Set center x,y,z for rotation and scaling.
.B [Default: NONE]
.TP 5
\fB\-\-offset\fR \fI<string>\fR
Set offset dx,dy,dz for translation.
.B [Default: NONE]
.TP 5
\fB\-\-xlate\fR \fI<string>\fR
Translate result relative by given vector.
.B [Default: NONE]
.TP 5
\fB\-\-inverse\fR
Output inverse transformation. Inversion happens after all other modifiers have been applied.
.SS Output Options
.TP 5
\fB\-\-output\fR \fI<string>\fR, \fB\-o\fR \fI<string>\fR
Write output transformation to this file
.B [Default: NONE]
.TP 5
\fB\-\-list\fR \fI<string>\fR
Write output in list format to this archive (directory including 'registration' and 'studylist' files).
.B [Default: NONE]
.TP 5
\fB\-\-append\fR
Append to output file rather than create a new one and overwrite exisiting files.
.SH AUTHORS
Torsten Rohlfing, with contributions from Michael P. Hasak, Greg Jefferis, Calvin R. Maurer, Daniel B. Russakoff, and Yaroslav Halchenko
.SH LICENSE
http://www.fsf.org/licensing/licenses/gpl.html
.SH BUGS
Report bugs at http://nitrc.org/projects/cmtk/
.SH 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.