NAME

uvotexpmap - generate exposure maps for UVOT sky images

USAGE

uvotexpmap infile=<filename> outfile=<filename>

DESCRIPTION

This tool generates exposure maps given a UVOT level 2 sky image product. An exposure map is created for each extension in the image file.

PARAMETERS

infile [filename]
UVOT level 2 sky image file (see SSC UVOT Data Handbook).
badpixfile [filename]
Bad pixel file. See the Data Handbook for the bad pixel file format. It has extension names corresponding to those in the sky image file. The bad pixel file is created by uvotbadpix.
method [MEANFOV|SHIFTADD]
Exposure map method. If method is MEANFOV, then the exposure map is based on a single attitude (the attitude at the same time used when projecting the image onto the sky). If method is SHIFTADD, then the processing follows the attitude changes during the exposure as given by the aspect following packets and/or attitude data and the trackfile parameter should be set.
attfile [filename]
Attitude history file (in coordfits/ATTFILE format).
teldeffile [filename]
Telescope definition file (coordfits/TELDEF format).
outfile [filename]
Exposure map output file. One extension for each image extension in the input sky image file. See Data Handbook for details.
(maskfile = NONE) [filename]
Name of optional output mask file which can be used to screen out outer pixels to suppress edge-effects. This maskfile can be passed as an input parameter to uvotimsum.
(masktrim = 0) [integer]
Mask trimming control. This parameter is only used if maskfile is not NONE. A positive value gives the number of pixels to be trimmed from the top/bottom/left/right or the mask. A negative value trims the mask based on the attitude variation during the exposure. The special value 0 is treated as -1 if method is MEANFOV, or 1 if method is SHIFTADD.
(maskminf = 0.1) [real]
When generating mask, the minimum exposure fraction to include in mask. For example, given a 100 second exposure, maskminf=0.1 will mask pixels exposed less than 10 seconds. This masking can be disabled by providing a negative value.
(trackfile = NONE) [filename]
If method is SHIFTADD, this gives the name of the aspect following housekeeping file (sw*uaf.hk).
(sssfile = CALDB) [filename]
Small-scale sensitivity file which can be CALDB, NONE, or the path to a file having the format of the calibration product. When used, pixels which indicate invalid small scale sensitivity are treated as bad pixels when generating the exposure map. Note that badpixfile must be provided for sssfile processing. See also ssstype.
(ssstype = LOW) [LOW|MID|HIGH]
When determining the small scale sensitivity CALDB product, the ssstype parameter specifies the TYPE constraint.
(attdelta = 0.1) [real]
Maximum change in attitude exposure map increments [arcsec].
(aberration = no) [boolean]
Account for velocity aberration?
(refattopt = NONE) [string]
Conditions under which to use reference (instead of sampled) attitude. See minnow options parameter for details.
(chatter = 1) [enumerated integer]
Standard HEAdas chatter parameter. A range of 0 to 5 is enforced by the min and max fields in the parameter file.
(cleanup = yes) [boolean]
Clean up temporary files?
(clobber = no) [boolean]
Standard HEAdas clobber parameter.
(history = yes) [boolean]
Standard HEAdas history parameter.

EXAMPLES

The following examples illustrate running uvotexpmap

1. run uvotexpmap prompting for options

      uvotexpmap
2. run uvotexpmap in command line specifying sky image input, bad pixel and attitude files, and create a mask that screens out edge-effects

      uvotexpmap infile=skyimages.fits badpixfile=badpixels.fits attfile=attitude.fits maskfile=mask.fits

SEE ALSO

expomap, uvotbadpix, uvotimsum

LAST MODIFIED

December 2021