RETRO commands


PROGRAM NAME

vsamp - Sample an Image Along an Arbitrary Line (K1)

DESCRIPTION

NOTE: Program will NOT execute! vsamp functionality is replaced by the DATAMANIP::ksampline operator. The following command line arguments have changed.
     -x1 (starting x coordinate for line), is now -wc1
     -x2 (ending x coordinate for line), is now -wc2
     -y1 (starting y coordinate for line), is now -hc1
     -y2 (ending y coordinate for line), is now -hc1
the values may be be slightly different because vsamp used bilinear interpolation whereas ksampline uses inverse-distance weighting interpolation (which is mush easier to extend to 5D and mask'd data).

Given an image of arbitrary size and a line through that image, sample the image along the line. The sampling interval is independent of image size and line orientation. The value at each sample point is obtained by bilinear interpolation.

The first sample point is precisely at the starting point and the final sample is precisely at the ending point.

REQUIRED ARGUMENTS

-i
type: infile
desc: input image
-o
type: outfile
desc: output image

OPTIONAL ARGUMENTS

-x1
type: integer
desc: starting x coordinate for line
default: 0
bounds: value >= 0
-x2
type: integer
desc: ending x coordinate for line
default: 511
bounds: value >= 0
-y1
type: integer
desc: starting y coordinate for line
default: 255
bounds: value >= 0
-y2
type: integer
desc: ending y coordinate for line
default: 255
bounds: value >= 0
-n
type: integer
desc: number of samples
default: 1
bounds: value > 0

EXAMPLES

vsamp -i diffract.xv -o line_data.xv -x1 0 -y1 0 -x2 0 -y2 0 -n 400

Will sample the image diffract.xv to obtain a one dimensional data array in line_data.xv. The line goes from the top left corner to the bottom right. 400 evenly spaced samples will be obtained via bilinear interpolation.

SEE ALSO

DATAMANIP::ksampline

RESTRICTIONS

vsamp will only work on images of type FLOAT.

REFERENCES

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.