NAME

uvotlss - calculate large scale sensitivity corrections

USAGE

uvotlss infile=<filename> lssfile=<filename> x=<float> y=<float> input=<string> history=<boolean> chatter=<integer>

DESCRIPTION

This tool calculates the large scale sensitivity correction (LSS) factor for a position, or updates and applies the LSS correction factors in a table created by uvotsource.

PARAMETERS

lssfile [filename]
Name of large scale sensitivity file or CALDB.

input [TABLE|RADEC|IMAGE|DET|MM]
Input mode. This determines how the infile, x, and y parameters are processed.

infile [filename]
If input=TABLE, infile must give a FITS table created by uvotsource with DETX, DETY, AP_COI_SRC_RATE, AP_COI_SRC_RATE_ERR columns. If input=RADEC or input=IMAGE, infile must give a FITS sky image which contains WCS keywords for the sky coordinates and WCS D keywords for detector coordinates.

If lssfile=CALDB, infile is used to parameterize the CALDB lookup.

x [real]
This gives the X coordinate for the input mode. If input=RADEC, x is the source R.A. [deg]. If input=IMAGE, x is the X FITS coordinate in the infile sky image [pixel]. If input=MM, x is the X coordinate in the UVOT TELDEF DET system [mm]. If input=DET, x is the X coordinate in the UVOT TELDEF DET system [pixel].

y [real]
This gives the Y coordinate for the input mode. See the x parameter for a description of the coordinate system and units for each value of the input parameter.

(history = yes) [boolean]
Write parameter history? The parameter history is only written for input=TABLE.

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

EXAMPLES

1. This example illustrates running uvotlss specifying the table extension to process:

      uvotlss input=TABLE infile=table.fits[2]
2. This example provides a sky image and specifies the source sky position on the command line:

      uvotlss input=RADEC infile=sky.fits[vv123091236I] x=243.435 y=-23.54

SEE ALSO

uvotsource

LAST MODIFIED

October 2007