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 distance from a particular pixel to the reference pixel location 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 frequencyies 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.