NAME

ypeakup -- Plot positions of a ACQ/PEAK FOS observation

USAGE

ypeakup root

DESCRIPTION

ypeakup produces a graph and listing of the offsets, in arcseconds, used by an FOS ACQ/PEAK observation.

PARAMETERS

root [string]

The rootname of the FOS ACQ/PEAK observation to analyze. Only one can be specified.

(plot = yes) [boolean]

Produce a plot of the positions.

(v2v3off = no) [boolean]

Only calculate the offsets in V2/V3 space. If "no", then offsets will be computed in both V2/V3 and in X/Y space, both in arcseconds.

(pos_tab = "") [file name]

If specified, the name of the table to create containing the X/Y offset positions.

(short_title = no) [boolean]

Place only a short title on the plot.

(igi_script = "") [file name]

If specified, the name of a file that will be created containing the igi script that will produce the plot. If specified, no plot will actually be seen; the igi task will need to be run with this file as input.

(xoff) [Output: real]

This parameter will contain the value of the offset in X chosen as the location of the target.

(yoff) [Output: real]

This parameter will contain the value of the offset in Y chosen as the location of the target.

(v2off) [Output: real]

This parameter will contain the value of the offset in V2 chosen as the location of the target.

(v3off) [Output: real]

This parameter will contain the value of the offset in V3 chosen as the location of the target.

EXAMPLES

1. Produce a plot of the FOS ACQ/PEAK observation y15i0206t

  fo> ypeakup y15i0206t

BUGS

This task is written as a cl script and is therefore slow and not robust; needs to be written as a compiled task.

There is a period of time, from June 20, 1995 to November 19, 1995, where the necessary keywords in the image headers for ACQ/PEAKS where not populated correctly. If this task is run for any of those observations, the results will be nonsensical.

REFERENCES

Author: Jonathan Eisenhamer, STSDAS

HELP

For assistance using this or any other tasks, please contact help@stsci.edu or call the help desk at 410-338-1082.

SEE ALSO