MINCCMP(1) MINC User's Guide MINCCMP(1)NAME
minccmp - compare one or more minc file using comparator operators
SYNOPSIS
minccmp [<options>] <in1.mnc> <in2.mnc> [<inn.mnc> ...]
DESCRIPTION
minccmp will calculate simple statistical measures between two minc files or more by comparing all subsequent files to the first. The
results for each subseqent file are then returned in order. By default all statistics are calculated. If specifitc statistics are
requested via a command-line option, then only the requested statistics are printed.
A very useful feature of this program is the ability to restrict the set of voxels included in the statistic calculation, either by
restricting the range of included values (-floor, -ceil or -range), or by using a mask file (-mask) with a restricted range.
The comparison statistics available in minccmp are given below. Note that two of these (-xcorr and -zscore) are a very close approximation
to what is used in minctracc.
OPTIONS
Note that options can be specified in abbreviated form (as long as they are unique) and can be given anywhere on the command line.
General options-clobber
Overwrite an existing file.
-noclobber
Don't overwrite an existing file (default).
-debug Dump a lot of extra information (for when things go haywire).
-verbose
Print out extra information (more than the default).
-quiet Print out only the requested numbers
-max_buffer_size_in_kb size
Specify the maximum size of the internal buffers (in kbytes). Default is 4 MB.
-check_dimensions
Check that all input files have matching sampling in world dimensions (default).
-nocheck_dimensions
Ignore any differences in world dimensions sampling for input files .
Volume range options-floor min
A lower bound for ranges of data to include in statistic calculations.
-ceil max
An upper bound for ranges of data to include in statistic calculations.
-range min,max
A lower and upper bound for the ranges of data to include in statistics.
-mask filename.mnc
Name of file to be used for masking data included in statistic calculations.
Basic statistics-all Compute all statistical measures. This is the default.
-ssq Print the Sum Squared Difference between two input files
SSQ = Sum( (A-B)^2 )
-rmse Print the Root Mean Squared Error between two input files
RMSE = sqrt( 1/n * Sum((A-B)^2))
-xcorr Print the Cross Correlation between two input files
XCORR = Sum((A*B)^2) / (sqrt(Sum(A^2)) * sqrt(Sum(B^2))
-zscore
Print the z-score difference between two input files
ZSCORE = Sum( |((A - mean(A)) / stdev(A)) -
((B - mean(B)) / stdev(B))| ) / n
Generic options for all commands:
-help Print summary of command-line options and exit.
-version
Print the program's version number and exit.
AUTHOR
Andrew Janke
COPYRIGHTS
Copyright (C) 2010 by Andrew Janke
$Date: 2010-03-02 12:12:20 $ MINCCMP(1)
Check Out this Related Man Page
MINCINFO(1) MINC User's Guide MINCINFO(1)NAME
mincinfo - print out specified information about a minc file
SYNOPSIS
mincinfo [<options>] <file> [<file> ...]
DESCRIPTION
mincinfo will print out either a general description of a minc file (type, sign and range of data, plus a brief description of dimensions
and their order), or specific information about dimensions, variables or attributes in the file. This program can be very useful for build-
ing shell scripts that access minc files.
All information given by mincinfo is presented as read from the file with no transformation. This means that start and step values, for
example, are not in the world coordinate system. To display the start values for a file in world coordinates, use voxeltoworld.
OPTIONS
Note that options can be specified in abbreviated form (as long as they are unique) and can be given anywhere on the command line. Dimen-
sions, variables and attributes are all specified by name. Attributes are specified by variable:attribute where variable can be omitted to
specify global attributes. More than one option can be specified, in which case the return value from each option is printed on a separate
line (-image_info prints on many lines) in the order of the options on the command line.
-image_info
Print out the default general information about the file. This information includes the type, sign and range of the pixel data, the
order of the dimensions, and a list of dimensions giving name, length, start and step for each one.
-dimnames
Print out a space-separated list of the dimensions in the file.
-varnames
Print out a space-separated list of the variables in the file.
-dimlength dimension
Print the length of the specified dimension.
-vartype variable
Print the type of the variable.
-vardims variable
Print a space-separated list of the dimensions that subscript the variable (in C order).
-varatts variable
Print a space-separated list of the attribute names for the specified variable.
-varvalues variable
Print a newline-separated list of the values of the specified variable.
-atttype variable:attribute
Print out the type of the specified attribute.
-attvalue variable:attribute
Print out a space-separated list of the values of the specified attribute.
-error_string string
Specifies a string to print out if an error occurs. This will cause the program to exit with normal status. The default is to print
an appropriate error message and exit with an error status.
-help Print summary of command-line options and abort.
-version
Print the program's version number and exit.
EXAMPLES
Print out standard information about a minc file.
mincinfo file.mnc
Print out contents of global history attribute.
mincinfo file.mnc -attvalue :history
Print out step value for x dimension, setting the default value to 1.
mincinfo file.mnc -attvalue xspace:step -error 1
Print out the step values for x, y and z, setting the default value to 1.
mincinfo file.mnc -error 1
-attvalue xspace:step
-attvalue yspace:step
-attvalue zspace:step
Print out the names of the dimensions subscripting the image variable.
mincinfo file.mnc -vardims image
AUTHOR
Peter Neelin
COPYRIGHTS
Copyright (C) 1993 by Peter Neelin
SEE ALSO voxeltoworld(1)
$Date: 2004-05-20 21:52:08 $ MINCINFO(1)