
vcost(1)                     Khoros                      vcost(1)

PROGRAM
     vcost - Compute cost (surface arc length) for an image

SYNTAX
     vcost

     -i             input image

     -o             output image

     -x             X coordinate of reference pixel

     -y             Y coordinate of reference pixel

     [-m]           mask image

     [-V]           Gives the version for vcost

     [-U]           Gives the usage for vcost

     [-P]           Prompts for command line options

     [-A [file1]]   Creates the answer file called vcost.ans or
                    file1

     [-a [file1]]   Uses vcost.ans or file1 as the answer file

DESCRIPTION
     vcost computes the surface arc length from a given pixel
     location to every other pixel in the image. The surface dis-
     tance from a particular pixel to the reference pixel loca-
     tion is stored in the corresponding location in the output
     image. Image pixels are resampled at 1/10 of thier spacing
     using bilinear interpolation for use in forming the surface
     profile between any two points. This provides an surface
     distance accurate to around 1% for relatively smooth images.
     An image with very sharp transitions or other high frequen-
     cyies will produce less accurate results.

     If the mask image is used, then only those pixels that have
     a non-zero value at the corresponding pxiel in the mask will
     be evaluated for surface distance. All other output pixels
     are set to -1.

     The output is of type float.

REQUIRED ARGUMENTS
     -i     type: infile
            desc: input image

     -o     type: outfile
            desc: output image

     -x     type: integer
            desc: X coordinate of reference pixel

     -y     type: integer
            desc: Y coordinate of reference pixel

OPTIONAL ARGUMENTS
     -m     type: infile
            desc: mask image

EXAMPLES
     % vcost -i surface -o dist -x 16 -y 21

SEE ALSO
     intro(1), verror(3), vgparms(3), vutils(3), lvcost(3)

RESTRICTIONS
     lvcost works on all data types.

COPYRIGHT
     Copyright 1991, University of New Mexico.  All rights
     reserved.

Khoros                    Release: 1.0                          1

