VLSAMPLE

VisionX V4
NAME

vlsample - samples intensities along given points

SYNOPSIS

vlsample if=<ifile> ig=<ifile> of=<ofile> og=<ofile> [oh=<ofile>] [d=<dist>] [n=<number of sampling lines> | i=<line interval>] [-v]

DESCRIPTION

vlsample is a program that samples intensities near the given set of points. 2D image from which the intensities will be sampled is passed in as [if=]. The points are given as a set of coordinates in a boundary file [ig=]. The accepted formats for the coordinates in [ig=] are V2D and V3D vectors. For V3D vector format, z value is ignored.

The program first fits a 3rd degree polynomial through the given points. The fitted line may optionally be output to an image (oh=). [oh=] will be a byte image showing the given points as well as the fitted line. Each sampling line is established perpendicularly through the fitted polynomial, extending as far as [d=] in both directions.

The sampling line locations may be defined with [n=] or [i=] parameters. [n=] specifies the number of evenly-divided sampling lines along the line. [i=] specifies the space between two sampling lines. When both are specified, [n=] is ignored. By default [i=] value of 1 is used, meaning that the intensities will be sampled at every pixel along the line.

The program produces two output images [of=] and [og=]. Both images will have dimensions defined by [d=] and [n=] parameters. (n by d*2 images will be produced) [of=] will contain the intensity sampled using bilinear interpolation. The y dimension of [of=] spans from -d to +d, and the fitted line should correspond to y=0 of [of=]. The x dimension starts at 0 and goes up to the number of sampling lines minus 1.

[og=] is a two-channeled float image, where channel 1 and channel 2 will contain original image’s x and y coordinates, respectively. [og=] has two bounding boxes. The first bounding box is the bounding box of the original image, stored in [og=] for the purpose of reverse mapping, and the second bounding box is the actual bounding box of [og=].

CONSTRAINT

[if=] should be a short image. [of=] will be a short image, and [og=] will be a 2-channeled float image. [og=], if specified, will be a byte image.

OPTIONS

if=

input 2D image

ig=

input boundary file with list of coordinates

of=

output image with sampled intensities

og=

output 2-channeled image that stores original image coordinates

oh=

output image showing the fitted polynomial

d=

sampling distance from the fitted line (default=10)

n=

number of sampling plane along the fitted line

i=

interval between two sampling planes (default=1)

-v

verbose mode

SEE ALSO

vlrevmap

AUTHOR

J. Lee