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