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 building 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.   Dimensions,  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 © 1993 by Peter Neelin

SEE ALSO

       voxeltoworld(1)

                                          $Date: 2004-05-20 21:52:08 $                               MINCINFO(1)