volumesel(1Vi)															    volumesel(1Vi)

NAME

       volumesel - select volumes from a volume set

SYNOPSIS

       volumesel  <options> [infile] [outfile]

DESCRIPTION

       volumesel  selects  volumes from a set of volumes according to some given selection criterion. Possible criteria are: size, circularity and
       compactness.

       "Size" refers to be number of voxels belonging to the volume.

       "Circularity" is a measure of roundness defined as:

	 (3.0 * size) / (4.0 * pi * rmax)

       where "rmax" is the radius of the smallest enclosing sphere.  Thus if the volume is a sphere, this value will be "1", The further the  vol-
       ume's shape deviates from spherical shape, the smaller this value will become.

       "Compactness" is defined as the ratio between the number of border voxels and volume size. Thus, if most voxels belonging to the volume are
       interior voxels this value will be close to "1".

       The input image must be of type "volumes". The output image will be also be of type "volumes".

COMMAND LINE OPTIONS

       volumesel accepts the following options:

       -help	      Prints a message describing options.

       -in infile     Specifies the Vista data file containing the first input image.

       -image infile  Specifies the Vista data file containing the second input image.

       -out outfile   Specifies where to write the output images as a Vista data file.

       -feature outfile
		      Specifies the selection criterion. Possible choices are: size | circularity | compactness. Default: size.

       -min min       Specifies the lower bound for the feature value.

       -max max       Specifies the upper bound for the feature value.

       Input and output files can be specified on the command line or allowed to default to the standard input and output streams.

SEE ALSO

       VImage(3Vi), Vista(7Vi)

AUTHOR

       Gabriele Lohmann <lohmann@cns.mpg.de>

Vista Version 2.0						  15 Februar 1994						    volumesel(1Vi)