NAME
mincmakescalar - convert vector minc files to scalar
SYNOPSIS
mincmakescalar [<options>] <in>.mnc <out>.mnc
DESCRIPTION
Mincmakescalar converts vector minc files to scalar minc files. A
vector minc file is one that contains the dimension vector_dimension
as the fastest varying dimension of the image data and represents
vector data at each voxel such as RGB images or gradient volumes. A
scalar minc file does not contain the vector dimension and represents
grayscale or intensity data.
A variety of conversion schemes are possible. The simplest is an
average of the components of the vector. The magnitude of the vector at
each voxel can also be computed. RGB volumes can be converted to
greyscale by a standard linear combination. Finally, the user can
supply a list of coefficients for a linear combination of vector
components.
Some options will require a specific number of components on the input
vectors (RGB data should have 3 components and the number of
coefficients supplied for the linear combination should match the
number of components on the input vectors), but the program will also
accept input scalar data and will copy it through without modification.
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
-2 Create a MINC 2.0 format output file.
-clobber
Overwrite an existing file.
-noclobber
Don’t overwrite an existing file (default).
-no_clobber
Synonym for -noclobber.
-verbose
Print out progress information for each chunk of data copied
(default).
-quiet Do not print out progress information.
-buffer_size size
Specify the maximum size of the internal buffers (in kbytes).
Default is 10 MB.
-filetype
Create an output file with the same type as the first input file
(default).
-byte Store output voxels as 8-bit integers.
-short Store output voxels as 16-bit integers.
-int Store output voxels as 32-bit integers
-long Superseded by -int.
-float Store output voxels as 32-bit floating point numbers.
-double
Store output voxels as 64-bit floating point numbers.
-signed
Create an output file with data stored in a signed type. This
only has an effect if the one of the -byte, -short or -int
options is specified.
-unsigned
Create an output file with data stored in an unsigned type. This
only has an effect if the one of the -byte, -short or -int
options is specified.
-valid_range min max
Create an output file with integer data stored in the specified
restricted range. This only has an effect if the one of the
-byte, -short or -int options is specified.
Conversion options
-magnitude
Compute the magnitude of each vector (default).
-average
Compute the average of the components of each vector.
-rgbtogrey
Convert RGB (3-component) files to greyscale using a linear
combination with standard set of weighting coefficients.
-rgbtogray
Synonym for -rgbtogrey.
-linear c1,c2,c3,...
Compute a linear combination of the components of each vector
using the specified coefficients (these weights must be given as
a comma or space-separated list of numbers in a single command-
line argument). The number of coefficients must match the number
of components on the input vectors.
Generic options for all commands:
-help Print summary of command-line options and exit.
-version
Print the program’s version number and exit.
EXAMPLES
To convert an RGB file to an grayscale file:
mincmakescalar -rgbtogrey rgb.mnc gray.mnc
To compute the gradient magnitude from a gradient volume
mincmakescalar -magnitude gradient.mnc magnitude.mnc
To convert an RGB file to a grayscale file using a different set of
weighting factors for red, green and blue:
mincmakescalar -linear ’0.2,0.5,0.3’ rgb.mnc gray.mnc
AUTHOR
Peter Neelin
COPYRIGHTS
Copyright © 1997 by Peter Neelin
$Date: 2004-05-20 21:52:08 $