PISAMATCH - Matches the indices in one file against those in a second file

Description:

This routine matches the first column of values (the object indices) of the two input files. When a match is located between the indices the complete entry in the second file is copied to the output file. It is intended primarily to match a list of object indices (such as those produced by PISAKNN or possibly a PISACUT list of PISAPEAK results).

Usage:

PISAMATCH ONE TWO OUT

Parameters:

ONE = FILENAME (Read)

Name of the file containing the indices to match to those of file TWO.

TWO = FILENAME (Read)

Name of the file containing the entries whose indices are to be matched to those of file ONE. Entries with a matched index will be written to file OUT.

OUT = FILENAME (Write)

Name of a file to contain the entries from file TWO which have the same indices as those specified in file ONE. [PISAMATCH.DAT]

Examples:

PISAMATCH CLASS1 PISAFIND STARS

This matches the indices in file CLASS1 to those of file PISAFIND. The PISAFIND entries with indices found in file CLASS1 are written to file STARS.

Notes:

• The maximum number of entries allowed in file ONE is 10000. No restriction applies to file TWO.

• The indices in both files must be in the first column.