NAME

fquat -- Insert the rotation quaternion into a data table.

USAGE

fquat intable

DESCRIPTION

This task must be run on any positional astrometry table that has been modified by the centroid task before the table can be used by another task.

Fquat inserts the quaternion into the table. Standard checks are performed, and the telescope pointing coordinates RAV1, DECV1, and ROLLV3 are read in. The inserted quaternion takes the form:

	Q = Qz(alpha) Qy(-delta) Qx(roll) Qa(1|2|3) dQ(Zaxis)

	where
	    Qz(alpha)  = quaternion formed from V1 right ascension
	    Qy(-delta) = quaternion formed from V1 declination
	    Qx(roll)   = quaternion formed from V3 roll angle
	    Qa(1|2|3)  = alignment quaternion for FGS 1, 2, or 3
	    dQ(Zaxis)  = differential aberration quaternion

The following columns are used by fquat:

	INPUT			OUTPUT
	-----			------
	RAV1, DECV1, ROLLV3	Q1, Q2, Q3, Q4
	FRAME			FRAME
	FGS

PARAMETERS

intable [file name template]

The input table can be either a single file, or a list of data table files. NOTE: These tables are modified in-place unless new_table is specified.

(outtable) [file name template]

If the new_table parameter is true, the user will be prompted to enter an output file name. This new table will contain the rotation quaternion, leaving the original table uncorrupted. Outtable will accept a file template when processing a list of data tables.

(new_table = no) [boolean]

Create a new output table? Prevents overwriting the original table.

(verbose = yes) [boolean]

Print transformed coordinates on the terminal screen?

EXAMPLES

1. Process all tables having the default extension ".tab".

	fg> fquat *.tab

	fg> fquat intable new_table+ outtable="out"

BUGS

SEE ALSO