NAME

uvotgcn - process UVOT TDRSS packets

USAGE

uvotgcn

DESCRIPTION

uvotgcn manages running Swift UVOT software to process UVOT TDRSS packets.

The input packets are FITS files and are accompanied by text pseudo-GCN notices which contain position and error information.

The possible output products are three FITS files: a sky image, a list of sources, and a list of sources correlated against a star catalog; and a Postscript finding chart (field). The catalog file is only created if the source positions are successfully matched to the catalog.

PARAMETERS

packetfile [filename]
Name of the FITS file containing the UVOT TDRSS packet.
batfile [filename]
Name of the input pseudo BAT position notice.
xrtfile [filename]
Name of the input pseudo XRT position notice.
blcfile [filename]
Name of the input pseudo BAT light curve position notice.
catspec [filename]
Name of the catalog desciptor.
(lockfile = uvotgcn.lock) [filename]
File used to synchronize access to the input files.
(skyfile = DEFAULT) [filename]
Name of the output FITS sky image.
(sourcesfile = DEFAULT) [filename]
Name of the output FITS source table.
(catalogfile = DEFAULT) [filename]
Name of the output FITS source table correlated using catspec.
(fieldfile = DEFAULT) [filename]
Name of the output annotated Postscript finding chart or NONE.
(signalfile = DEFAULT) [filename]
Name of the packet processing complete signal file.
(timeout = 20) [int]
Maximum time to wait for sky image before timing out [sec].
(starid = NONE) [string]
Parameters to pass to star identification.
(threshold = 2) [real]
Source detection threashold.
(stale = 500) [int]
Maximum age of pseudo-notices to load [sec].
(archive = uvotdata) [directory]
Location of UVOT TDRSS processing archive.
(remote = no) [boolean]
Transfer job for remote processing?
(chatter = 1) [integer, 0 - 5]
Standard HEAdas verbosity parameter.

EXAMPLES

1. Execute uvotgcn providing a UVOT TDRSS packet

	uvotgcn packetfile=swmsufc.fits

SEE ALSO

tristarid. catspec.

LAST MODIFIED

November 2005