cmtk(1) 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.
fview

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

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.