NAME

uvotbadpix - create pixel quality maps for images

USAGE

uvotbadpix infile=<filename> outfile=<filename>

DESCRIPTION

This program takes a caldb bad pixel list and creates a pixel quality map for use in uvotmodmap and exposure map generation. This tool checks for missing rows due to packet loss, and optionally check the input image for compression damage (overflows and underflows). uvotbadpix allows the user to

PARAMETERS

infile [filename]
Input image file for which quality maps are created.

badpixlist [filename]
Input caldb bad pixel table. Specify the name of a file, or "CALDB" to retrieve from the calibration database.

outfile [filename]
Output quality map file name.

(compress = yes) [boolean]
If compress = yes then check for compression over or under flows. If compress = no then don't check.

(clobber = no) [boolean]
If outfile already exists, then "clobber = yes" will overwrite it.

(history = yes) [boolean]
If history = yes, then a set of HISTORY keywords will be written to the header of the output file to record the value of all the ftcopy task parameters that were used to produce the output file.

(chatter = 1) [integer, 0 - 5]
Controls the amount of informative text written to standard output. Verbosity increases with larger numbers.

(mode = ql)
Standard PIL mode parameter.

EXAMPLES

The following example is a typical uvotbadpix run.

        uvotbadpix images.fits swubadpix.fits quality.fits

Where images is the name of the input image files, swubadpix.fits holds the CALDB bad pixel list, and quality.fits is the name of the generated quality map,.

Alternatively the user could just run uvotbadpix and be prompted for the inputs.

LAST MODIFIED

October 2004