Man Linux: Main Page and Category List

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 $