VLSAMPLEVisionX V4
NAME
vlsample - samples intensities along given points
SYNOPSISvlsample if=<ifile> ig=<ifile> of=<ofile> og=<ofile> [oh=<ofile>] [d=<dist>] [n=<number of sampling lines> | i=<line interval>] [-v]
DESCRIPTIONvlsample 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 |
vlrevmap
AUTHORJ. Lee