NAME

match - determines shift of star lists

SYNOPSIS

match locallist [radius=] [nrow=] [ncol=] [remote | local | diff | extra | duplicate | duplicate2] [simple] [debug]

DESCRIPTION

Use match to determine the distance offset in rows and columns between two lists of stars.

match reads the local list as the first argument on the command line and compares it to the remote list from stdin. It then compares both lists shifting them as needed to see how many stars match. A match is considered whenever the position of a star in each agrees to with the specified radius (default:1). The algorithm looks for matching triangles.

Stars are specified as an ASCII file

row col [other columns]
The row and column are space delimited and subsequent columns are ignored.

When successful match prints out the best row and column offset dr and dc and the number of matches.

The sense of the offset is such that if applied to the remote star list, it will match the local one.

OPTIONS

local - causes the local locations that match the unshifted input to be printed out. No matching is done. Use listshift if needed to shift input list.

remote - does the same as the above but prints out the value of the remote table. No shifting is done.

diff - prints out the dr and dc values. No shifting is done.

duplicate - prints out duplicate entries with a list.

duplicate2 - prints out the other duplicate entries with a list. This mode does not require any file from the standard input.

extra - prints out stars present in the remote list that are not found in the local list. No shifting is done.

ncol= sets the number of cols in the image so the rotation occurs around the midpoint (default:0).

nrow= sets the number of rows in the image so the rotation occurs around the midpoint (default:0).

radius= sets how close the two targets have to be to make a match (default: 1).

simple - prints out the difference between two star positions.


XVista index