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: