NAME

tristarid - find correction to rotate observed objects onto reference objects

USAGE

tristarid infile=<filename[SOURCES]>

DESCRIPTION

This tool attempts a triplet-based match of observations onto reference.

This tool accepts a FITS table containing source positions and attempts to match them to a reference star catalog. If a match can be found, the observed source positions are corrected and a new FITS table is written.

PARAMETERS

infile [filename]
Input FITS file (with extension) holding observation information.

catspec [filename]
Input catalog descriptor for reference star information.

outfile [filename]
Name of output star catalog.

matchtol [real]
Position tolerance for reporting matches [arcsec].

unradius [real]
Radius for reporting unobserved sources [arcsec].

uncount [integer]
Maximum number of unobserved sources to report.

unmag [real]
Magnitude of faintest unobserved source to report.

reflist [string]
List of tag:ra+dec for reporting separations [deg]. For example,
	reflist=XYZ:290.0-8.0,ABC:286.2-8.2
indicates to include columns in the output giving the distances from the XYZ and ABC positions.

(cntcorr = 5) [integer]
Minimum match count to apply correction.

(poscorr = 100) [real]
Maximum position correction [arcsec].

(rotcorr = 1) [real]
Maximum rotation to apply [arcmin].

(errcorr = 5) [real]
Maximum position error after correction [arcsec].

(starid = NONE) [string]
Parameters to pass to tristarid1.

(quat = NONE) [string]
Input correction quaternion. If this parameter is not NONE, it will be used to correct the source positions.

(clobber = no) [boolean]
Overwrite existing output files?

(cleanup = yes) [boolean]
Clean up temporary files?

(history = yes) [boolean]
Write parameter history?

(chatter = 3) [enumerated integer]
Standard HEAdas chatter parameter.

EXAMPLES

The following example illustrates running tristarid

1. run tristarid on given source list

      tristarid infile=detect.fits[SOURCES] outfile=matched.fits

SEE ALSO

tristarid1 catspec

LAST MODIFIED

November 2005