CMTK(1)

NAME
cmtk - the Computational Morphometry Toolkit

SYNOPSIS
cmtk <command> [options]

DESCRIPTION
This helper script provides a unified access to all command line tools provided by CMTK. Please specify CMTK's command to run and its options. See cmtk-<command>(1) manpage or output of cmtk <command> --help for <command> specific options

COMMANDS

asegment
    Register a target image to an atlas, using affine followed by nonrigid B-spline registration, then reformat the atlas label map to the target image.

asegment_sri24
    Register a target image to a selected channel of the SRI24 human brain atlas, then reformat one of the atlas label maps to the target image. Note: it is assume that the target image is skull-stripped, i.e., contains only the brain.

average_affine
    This tool computes the average of a sequence of user-provided affine coordinate transformations.

average_images
    This tool computes pixelwiase average, variance, standard deviation, z-score, or entropy images from a list of user-provided intensity images.

average_labels
    Average co-registered label images using partial volumes

avg_adm
    Compute average-shape average-intensity images and deformation maps using an active deformation model.

concat_affine
    This tool computes the explicit concatenation of multiple affine coordinate transformations, each of which can be optionally inverted.

convert_warp
    This tool converts nonrigid B-spline free-format deformation coordinate transformations between different representations (e.g., absolute vs. relative vectors). Also creates fractional transformations.

convertx
    This tool converts between image file formats and pixel data types. It can also apply simple, general-purpose image operations in the process. An arbitrary number of operations can be specified on the command line, which will be applied exactly in the order given.

dbtool
    This tool modifies and queries the database of images and transformations between them.

dcm2image
    Combine sets of DICOM slices to 3D image stacks

describe
    This tool prints a detailed description of the input files as either image(s) or transformation(s).

destripe
    This program corrects stripe artifacts in acquired image stacks which can result from between-slice intensity scale differences.

detect_adni_phantom
    This tool detects the locations of all spherical landmarks in a 3D image of the Magphan EMR051 structural imaging phantom (a.k.a. ADNI Phantom).

detect_spheres_matched_filter
    This tool detects spherical objects in three-dimensional images.

dof2mat
    Convert affine transformation from degrees-of-freedom representation to matrix form

dwi_mask_bad_slices
    This tool reads a set of 3D diffusion-weighted MR images and finds bad slices. A bad slice in a diffusion image is detected as one whose mean intensity is outside a specified interval around the mean of the means of all corresponding slices from the remaining diffusion images.

epiunwarp
    Correct B0 field inhomogeneity-induced distortion in Echo Planar Images (e.g., diffusion-weighted images) using two images acquired with opposing phase encoding directions.

fib2image
    Fiber tracking results from the UNC Fiber Tracking tool are read from Standard Input and all fiber points are drawn into a 3D image. The result is written in one of the supported image file formats.

fibxform
    A file with fiber tracking results from the UNC Fiber Tracking tool is read from Standard Input and one or more (concatenated) coordinate transformations are applied to all fiber point coordinates. The result is written to Standard Output, again in UNC fiber file format.

film
    This tool splits an interleaved input image into the pass images, co-registers them, and reconstructs a motion-corrected image

filter
    This tool applies spatial filtering operators, including cnotent-sensitive opersators, based on selective Gaussian kernels.

fit_affine_dfield
    Fit a linear affine transformation to a nonrigid transformation, either a B-spline free-form deformation or a non-parametric deformation field.

fit_affine_xform
    Fit a linear affine transformation to a list of concatenated, optionally inverted, transformations.

fit_affine_xform_landmarks
    Fit a linear affine transformation to a set of matched landmarks.

fit_spline_dfield
    Fit a parametric nonrigid transformation (B-spline free-form deformation) to a deformation field

fit_spline_xform
    Fit a parametric nonrigid transformation (B-spline free-form deformation) to a list of concatenated, optionally inverted, transformations.

geomatch
    This tool reads two or more images and tests whether their grid dimensions, pixel sizes, and image-to-space transformations match. Optionally, all images are reoriented into standard orientation before performing the test. If all images match, the tool returns with exit code 0, otherwise it returns with exit code 2. In case of an error (e.g., one of the images can not be read), the exit code is 1.

glm Statistical modeling of pixel intensities in multiple images using a General Linear Model.

gmm Segment an image into c classes using the EM algorithm for Gaussian mixtures with optional priors.

gregxform
    THIS TOOL IS DEPRECATED. PLEASE USE streamxform INSTEAD.

groupwise_affine
    This tool registers a population of input images simultaneously, without a template, using either the 'congealing' algorithm or a groupwise similarity measure based on a continuous approximation of mutual information ('RMI').

groupwise_init
    Compute initial affine alignment for a group of input images, which can be used as an input for groupwise registration

groupwise_warp
    This tool nonrigidly registers a population of input images simultaneously, without a template, using either the 'congealing' algorithm or a groupwise similarity measure based on a continuous approximation of mutual information ('RMI').

hausdorff
    This tool computes the Hausdorff distance between two label images.

histogram
    Create a histogram of image intensities and write as tab-separated text file to standard output

imagemath
    Perform operations on images using stack-based postfix notation.

interleaved_bad_slices
    This tool reads a time series of 3D images and detects outliers.

iterative_shape_averaging

jidb
    This tool splits an interleaved input image into the pass images, co-registers them, and reconstructs a motion-corrected image

levelset
    Levelset-type segmentation of foreground/background using minimum regional variance energy

lmsba
    This tool combines multiple multi-class segmentations from co-registered and reformatted atlases using locally-weighted Shape-Based Averaging.

lsba
    This tool combines multiple binary segmentations from co-registered and reformatted atlases using locally-weighted Shape-Based Averaging.

lvote
    This tool combines multiple segmentations fro co-registered and reformatted atlases using locally-weighted voting.

make_initial_affine
    Compute initial affine transformation by aligning centers of mass or principal axes

mat2dof
    Convert transformation matrix to degrees of freedom

mcaffine
    Multi-channel affine image registration using histogram-based or covariance-based joint entropy measures

mcwarp
    Multi-channel nonrigid B-spline image registration using histogram-based or covariance-based joint entropy measures

mk_adni_phantom
    Generate image of the ADNI structural imaging calibration phantom (a.k.a. Magphan EMR051).

mk_analyze_hdr
    Make header file according Analzye 7.5 format based on user-supplied parameters for geometry, data type, orientation, etc.

mk_nifti_hdr
    Make header file according to NIFTI file format based on user-supplied parameters for geometry, data type, orientation, etc.

mk_phantom_3d
    Generate 3D digital phantom images using a selection of drawing commands

mrbias
    This program corrects intensity inhomogeneity artifacts in MR images using a bias field estimated via entropy minimization.

overlap
    Compute overlap measures between two or more images

probe
    This tool prints pixel values or symbolic labels at a list of user-provided image coordinates.

pxsearch
    This tool reads an image file, as well as a list of pixel coordinates from standard input. For each pixel, a local neighbourhood in the image is searched for the maximum value. The location of the maximum is then written to standard output.

reformatx
    Extended volume reformatter tool to compute reformatted images and Jacobian maps from arbitrary sequences of concatenated transformations

registration
    This program performs rigid and affine image registration using multi-resolution optimization of voxel-based image similarity measures.

registrationx
    This program performs rigid and affine image registration using multi-resolution optimization of voxel-based image similarity measures.

regress
    Linear (and higher-order polynomial) regression of deformation fields and images.

reorient
    Convert between image orientations, i.e., physically re-order pixel array and adapt stored anatomical orientation information

sba Average segmentations (label fields) using the Euclidean Distance Transform. All input images must be in the same space. EDT is computed in this space also. See http://dx.doi.org/10.1109/TIP.2006.884936 for details of the underlying algorithm.

sbai
    Average segmentations (label fields) using the Euclidean Distance Transform. This tool performs joint interpolation and averaging by interpolating from the EDT. This requires that the inputs are transformations from the same fixed to (not necessarily) different moving images. EDT computation is done in the space of each moving image. See http://dx.doi.org/10.1109/TIP.2006.884936 for details of the underlying algorithm.

sequence
    Analyze sequence of numerical values, which is read from standard input

similarity
    Compute similarity measures such as intensity difference or label overlaps between two images.

split
    Split volume image into sub-images, i.e., to separate interleaved images into passes

statistics
    Statistical computations on image pixel intensities, i.e., means and standard deviations

stream_pixels
    This tool reads one or more images and writes all their pixels to standard output in binary form. Optionally, each image can be reoriented to a specified anatomical orientation and/or converted to a different data type. This is useful for piping image data through a pipeline, e.g., the Camino DTI toolkit.

streamxform
    An ASCII-format list of point coordinates is read from standard input and a user-provided sequence of coordinate transformations (each optionally inverted) is applied to them. The transformed points are then written to standard output.

sympl
    Compute the approximate symmetry plane of an image to determine, for example, the mid-sagittal plane in human brain images. Various forms of output are supported, e.g., writing the input image with the symmetry plane drawn into it, or the input image realigned along the symmetry plane.

symplx
    Compute the approximate symmetry plane of an image to determine, for example, the mid-sagittal plane in human brain images. Various forms of output are supported, e.g., writing the input image with the symmetry plane drawn into it, or the input image realigned along the symmetry plane.

ttest
    Pixelwise tests of statistical significance. Also compute correlations and z-scores

unsplit
    Join separate image stacks into a single interleaved image volume

unwarp_image_phantom
    This tool computes either a polynomial transformation or B-spline free-form deformation to unwarp an image. The transformation is based on expected and detected landmarks in an image of a structural phantom acquired on the same scanner. Use the 'detect_adni_phantom' tool to detect landmarks of the ADNI Phantom in an image and generate a phantom description file suitable for use with this tool.

vol2csv
    This tool computes the volumes of regions in a label image. It optionally accepts density maps (e.g., for different tissues) and computes and prints the per-region content for each. Also, the tool can accept an optional 'pixel volume' map to account for local pixel volume variations, e.g., due to spatial distortion.

volume_injection
    Reconstruction a high-resolution volume from multiple co-registered (low-resolution) images using forward volume injection

volume_reconstruction
    Iterative volume reconstruction from co-registered images using inverse interpolation or joint deblurring

vtkxform
    An ASCII-format VTK file is read from standard input and a user-provided coordinate transformation (optionally inverted) is applied to the vertex coordinates. A VTK file with transformed points is then written to standard output.

warp
    This program performs nonrigid image registration using multi-resolution optimization of voxel-based image similarity measures and a multi-resolution B-spline transformation model.

warp2ps
    Write deformation field as deformed grid in PostScript format for visualization and illustration

warpx
    This program performs nonrigid image registration using multi-resolution optimization of voxel-based image similarity measures and a multi-resolution B-spline transformation model.

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

xform2itk
    This tool converts coordinate transformations from CMTK format to ITK format and, in the process, also correct for differences in image coordinate conventions

xform2scalar
    This tool extracts scalar measures from transformations and deformation fields, sampled at grid locations, and writes the results to an image. Examples of supported scalar measures are: x,y,z component of the transformation, magnitude of the transformation, and Jacobian determinants.

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.