mincinfo - Online in the Cloud

PROGRAM:

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

Use mincinfo online using onworks.net services