mat2dof(1)

📦
version 3.3.1p2 · 7 versions
, in ubuntu stonking

💅 mat2dof — the manual page, but make it make sense

okay bestie, welcome to mat2dof(1), a tool from The Computational Morphometry Toolkit (CMTK, we love her). she's a tiny little converter and honestly? she eats. let's get into it ✨

🌸 NAME 🌸

mat2dof — Matrix to degrees of freedom

like... that's literally the whole plot. matrix in, degrees of freedom out. periodt.

✨ SYNOPSIS ✨

mat2dof [options] < matrix

she reads the matrix from standard input 💖 so you pipe it in, you don't pass a filename. iykyk.

🦋 DESCRIPTION 🦋

Convert transformation matrix to degrees of freedom.

that's it. that's the vibe check. she takes your transformation matrix and hands you back degrees of freedom. no cap.

💅 OPTIONS 💅

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

these are the universal bestie behaviors, every CMTK tool has them:

  • --help — gets you the list of basic command line options, printed to standard output.
  • --help-all — the deluxe version: the complete list of basic and advanced command line options, to standard output.
  • --wiki — spits out the list of command line options to standard output, but in MediaWiki markup. wiki girlies rise 🫶
  • --man — writes man page source in 'nroff' markup to standard output.
  • --version — writes the toolkit version to standard output.
  • --echo — writes the current command line to standard output. she repeats you back, iconic.
  • --verbose-level <integer> — sets the verbosity level.
  • --verbose, -v — bumps the verbosity level up by 1. ⚠️ heads up: this one is deprecated, it's only hanging around for backward compatibility.
  • --threads <integer> — sets the maximum number of parallel threads (for POSIX threads and OpenMP). multi-threaded main character energy 🔥

🎀 Input Options 🎀

  • --matrix3x3, -3 — only takes in the upper left 3x3 submatrix. keep it small, keep it cute.
  • --transpose, -t — transposes the input matrix. flip it like it's hot 💀
  • --pixel-size <string> — for matrices living in pixel space (aka mapping from grid index to physical coordinate), set the image grid pixel size. [Default: NONE]

🌈 Transformation Modifiers 🌈

this is where you customize the ✨lewk✨:

  • --center <string> — set center x,y,z for rotation and scaling. [Default: NONE]
  • --offset <string> — set offset dx,dy,dz for translation. [Default: NONE]
  • --xlate <string> — translate the result relative by the given vector. [Default: NONE]
  • --inverse — outputs the inverse transformation. no cap: inversion happens AFTER all the other modifiers have been applied — order matters, don't play with her.

🍓 Output Options 🍓

  • --output <string>, -o <string> — write the output transformation to this file. [Default: NONE]
  • --list <string> — write the output in list format to this archive (a directory that includes the 'registration' and 'studylist' files). [Default: NONE]
  • --append — append to the output file instead of creating a new one and overwriting exisiting files.
⚠️ yes, --append overwrites-vs-appends exisiting files — read it twice if you must, but she's not asking permission before she clobbers stuff. 💀

🫶 AUTHORS 🫶

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

a whole squad. we stan a collaborative effort 💖

⭐ LICENSE ⭐

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

🙈 BUGS 🙈

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

not me asking you to file a bug report but like... do it nicely okay 😭

🌸 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.

look at the receipts. grants. funders. the whole glow up 👑

okay that's the page!! this was CMTK 3.3.1p2, dated Jun 24 2026 — shoutout to the CMTK girlies, and to you for reading all the way to the bottom. slay, stay hydrated, and always read your man pages 💜✨🎀

📦 where this page comes from