HEADAS help file

NAME

uvotflagqual

USAGE

uvotflagqual infile=<filename> rawfile=<filename> outreg=<filename>

DESCRIPTION

This tool calculates source detection quality flags.

The inputs are a raw UVOT image and the source table for that image output by uotdetect.

The tool will update the source table with a DETFLAGS column holding the detection quality flags for each source. If outfile is requested, a raw map of detection quality flags will be created matching the raw image. The flag definitions are written as comments to the quality map.

PARAMETERS

infile [filename]: Source table corresponding to the RAW image. This file is prepared by running uvotdetect on rawfile.
rawfile [filename]: RAW UVOT image.
outfile [filename]: Map of quality flags in raw coordinates. The resulting image will match the rawfile image. The special NONE indicates that no map is desired.
(badpixfile = CALDB) [filename]: Bad pixel table filename. The special value CALDB automatically determines the appropriate bad pixel table for rawfile from the calibration database.
(psffwhm = 2.0) [real]: The PSF (Point Spread Function) FWHM (Full-Width Half-Maximum) [arcsec]. This parameter is exposed for tool calibration. A source is considered a point source if its minor axis is less than a constant (pntext parameter) times psffwhm.
(aperture = 5.0) [real]: Point source aperture [arcsec]. This parameter is exposed for tool calibration. When flags are set for a point source, all of the pixels within that aperture have the flag applied.
(pntext = 1.0) [real]: Source type determination scaling factor. See the psffwhm parameter. This parameter is exposed for tool calibration.
(extscale = 1.0) [real]: Ellipse size scaling factor for extended sources. This parameter is exposed for tool calibration. A scale of 1 corresponds to the ellipse given by Equation 26 in the SExtractor Users Guide with R = 3. The scaling is linear in each dimension.
(flagdet = yes) [boolean]: Flag detections? If true, the region associated with each detection object will have the point or extended source flag in outfile. This parameter is exposed for tool calibration.
(clobber = no) [boolean]: Overwrite existing output files?
(history = yes) [boolean]: Write history keywords?
(cleanup = yes) [boolean]: Remove temporary files?
(chatter = 2) [integer: 1-5]: Standard HEAdas chatter parameter.

EXAMPLES

The following example illustrates running uvotflagqual

      uvotflagqual infile=detect.fits[OBJECTS] \
			rawfile=swu_rw.img+3 outfile=dq.img

LAST MODIFIED