.TH dwi_mask_bad_slices "1" "Jan 25 2019" "CMTK 3.3.1p1" "The Computational Morphometry Toolkit" .SH NAME dwi_mask_bad_slices \- Find bad slices in set of diffusion-weighted images. .SH SYNOPSIS \fBdwi_mask_bad_slices\fR DiffusionImagePaths .SH DESCRIPTION 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. .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\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\fR Set maximum number of parallel threads (for POSIX threads and OpenMP). .SS Input Options .TP 5 \fB\-\-b0count\fR \fI\fR Number of b=0 images at the beginning of the image list. These are not included in the bad slice detection or masking, but are also written to the output directory for convenience. It is assumed that all b=0 images are at the beginning of the list of input images, but not at the end or in the middle. .B [Default: 0] .TP 5 \fB\-\-slice-orientation\fR Define slice orientation of the diffusion images. Supported values: "axial", "sagittal", "coronal", "slice-x", "slice-y", "slice-z", where the default is "axial", or use one of the following: .RS 5 .TP 5 \fB\-\-axial\fR Axial slices \fB[This is the default]\fR .TP 5 \fB\-\-sagittal\fR Sagittal slices .TP 5 \fB\-\-coronal\fR Coronal slices .TP 5 \fB\-\-slice-x\fR X coordinate axis is slice direction .TP 5 \fB\-\-slice-y\fR Y coordinate axis is slice direction .TP 5 \fB\-\-slice-z\fR Z coordinate axis is slice direction \fB[This is the default]\fR .RE .SS Bad Slice Detection .TP 5 \fB\-\-stdev\fR \fI\fR Threshold for bad slice identification in units of intensity standard deviations over all corresponding slices from the remaining diffusion images. .B [Default: 3] .SS Output Options .TP 5 \fB\-\-convert-to\fR Scalar data type for the output images. If your padding value is negative but your input data unsigned, for example, make sure to select a signed data type for the output. By default, the output data type is the same as the input type. Supported values: "char", "byte", "short", "ushort", "int", "uint", "float", "double", or use one of the following: .RS 5 .TP 5 \fB\-\-char\fR 8 bits, signed .TP 5 \fB\-\-byte\fR 8 bits, unsigned .TP 5 \fB\-\-short\fR 16 bits, signed .TP 5 \fB\-\-ushort\fR 16 bits, unsigned .TP 5 \fB\-\-int\fR 32 bits signed .TP 5 \fB\-\-uint\fR 32 bits unsigned .TP 5 \fB\-\-float\fR 32 bits floating point .TP 5 \fB\-\-double\fR 64 bits floating point .RE .TP 5 \fB\-\-padding-value\fR \fI\fR, \fB\-p\fR \fI\fR Padding value to replace data of detected bad slices in output images. .B [Default: -1] .TP 5 \fB\-\-bad-slice-statistics\fR \fI\fR, \fB\-s\fR \fI\fR CSV file capturing the slice number and distance of bad slices. .B [Default: NONE] .TP 5 \fB\-\-output-directory\fR \fI\fR, \fB\-o\fR \fI\fR File system path for writing images with bad slices masked out (i.e., filled with a padding value). .B [Default: NONE] .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.