NAME

uvotskycorr - attempt to aspect correct UVOT sky images

USAGE

uvotskycorr skyfile=<filename>

DESCRIPTION

This tool iterates over UVOT image files attempting to determine or applying aspect corrections.

PARAMETERS

what [string] (ID|SKY)
Whether to find corrections (what=ID) or apply corrections (what=SKY).

skyfile [filename]
Name of input image file(s). This can be a comma-delimited list of file names or @<file> where <file> contains the names of the files to process, one per line.

corrfile [filename]
Input corrections file for what=SKY.

attfile [filename]
Input attitude file.

outfile [filename]
Output file name. For what=ID, the aspect corrections will be written to this file.

(starid = NONE) [string]
Parameters to pass to star identification. This parameter value is merged with default settings to derive the aspcorr sub-task starid parameter value. The starid value format is a space delimited string made up of name=value elements which aspcorr and tristarid understand.

(catspec = usnob1.spec) [filename]
Catalog descriptor file(s). A comma-delimited list allows specifying multiple catalog descriptors which will be used left to right.

(options = NONE) [string]
Options for aspect correction processing. This is a comma-delimited list of keywords. The keyword INTERPOLATE causes otherwise uncorrected images to have corrections interpolated/extrapolated from adjacent images in the same snapshot with known corrections. The keyword FORCE causes existing ASPCORR keyword values to be ignored when applying corrections.

(detopt = NONE) [string]
Options for source detection. This parameter value is merged with default settings to derive the uvotdetect sub-task parameter values. The detopt value format is a space delimited string made up of name=value elements which uvotdetect understands.

(cleanup = yes) [boolean]
Remove intermediate files?

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

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

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

EXAMPLES

The following examples illustrate running uvotskycorr

1. run uvotskycorr to find corrections

      uvotskycorr what=ID infile=usk.img

2. run uvotskycorr to find corrections providing star identification options

      uvotskycorr what=ID infile=usk.img starid='mag.min=13 min.matches=4'

3. run uvotskycorr to find corrections providing source detection options

      uvotskycorr what=ID infile=usk.img detopt='coinfile=NONE sensfile=NONE'

SEE ALSO

tristarid aspcorr catspec uvotdetect

LAST MODIFIED

May 2013