Help for TABLESEARCH

PURPOSE:
	A procedure generally used in camera calibration processing to
	search and extract records from an input file.  The input file is
	created by prf (Point Response Function) and records are extracted
	from it using either or both of two methods.  If SIZE is specified
	by the user then the sums of the columns SLBOX + CLINBOX and SSBOX  	CSINBOX must lie in the rectangle defined by SIZE.  If CL, CS, and
	RADIUS are specified by the user then the point represented by the
	fractional parts of the columns CLINBOX and CSINBOX must lie inside
	the circle defined by (x - CS)^2 + (y - CL)^2 = RADIUS^2.  If the
	circle crosses the square defined by (0,0), (0,1), (1,1) and (1,0)
	then wrap-around is taken into account.

	If either SIZE or RADIUS retain their default values then that
	method of selection is ignored.  Consequently if they both retain
	their default values then all the records in the input file are
	selected and copied to the output file.  If they are both specified
	then selected records must satisfy both conditions.

	Note: As a consequence of using program mf, tablesearch changes the
	value of WORK column 10 in the input file.  This column was set up
	to be used by tablesearch.

EXECUTION:
	tablesearch inp=input.file out=out.file size=(257,257,512,512)  		    cl=0.5 cs=0.3 radius=0.2

	The above command line uses both methods to select records from the
	input file and copy them to the output file.


METHOD:
	1) Use tablelist on input.file to list the records.
	2) Next use tablesearch to search and extract records based on
	   either or both of the two methods described above.

HISTORY:
	4-1996    ...YKK... Wrote C version for VAX/VMS.
	8-29-1997 ...RRD... Converted to VICAR procedure.


PARAMETERS:


INP

Input file

OUT

Output file

SIZE

Size field to contain circular centroid area.

CL

Circular centroid area's center line coordinate.

CS

Circular centroid area's center sample coordinate.

RADIUS

Radius of circular centroid area. .LEVEL 2

INP

Input file of records created by program prf.

OUT

Output file consisting of records selected based on parameters SIZE, CL, CS and RADIUS.

SIZE

If specified, then the sums of the columns SLBOX + CLINBOX and SSBOX CSINBOX must lie in the field defined by SIZE in order for the record to be selected.

CL

If CL, CS, and RADIUS are specified by the user then the point represented by the fractional parts of the columns CLINBOX and CSINBOX must lie inside the circle defined by (x - CL)^2 + (y - CS)^2 = RADIUS^2.

CS

If CL, CS, and RADIUS are specified by the user then the point represented by the fractional parts of the columns CLINBOX and CSINBOX must lie inside the circle defined by (x - CL)^2 + (y - CS)^2 = RADIUS^2.

RADIUS

If CL, CS, and RADIUS are specified by the user then the point represented by the fractional parts of the columns CLINBOX and CSINBOX must lie inside the circle defined by (x - CL)^2 + (y - CS)^2 = RADIUS^2. If RADIUS is not specified then this method of selection is ignored. .END

See Examples:


Cognizant Programmer: