uvotscreen - filter a UVOT event list


uvotscreen infile=<filename> attorbfile=<filename> outfile=<filename> aoexpr=<filtering expression>


This tool screens UVOT level 1 event files. It has an optional preprocessing step that sets the QUALITY flags for intrinsically bad pixels. The output file contains the filtered events table and GTI extensions corresponding to each input GTI extension intersected with the GTIs of the filtering expression applied to the orbital/attitude quantities. The output WINDOW extension is updated based on the filtering performed.


infile [filename]
UVOT level 1 events file (see SSC UVOT Data Handbook).

outfile [filename]
UVOT level 2 events file (see SSC UVOT Data Handbook).

attorbfile [filename]
Orbit and attitude quantities. This file is produced by prefilter.

badpixfile [filename or NONE]
Bad pixel list or NONE. If not NONE, used to update the QUALITY flags for hot, cold, dead, flickering bad pixels.

aoexpr [string]
Orbit/attitude filtering expression. Passed to maketime.

evexpr [string]
Event filtering expression. Applied to EVENT table.

(cleanup = yes) [boolean]
Clean up temporary files?

(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.

(clobber = no) [boolean]
Standard HEAdas clobber parameter.

(history = yes) [boolean]
Standard HEAdas history parameter.


The following example illustrates running uvotscreen

1. run uvotscreen specifying input and output event files, orbit/attitude file, and filtering expression on command line

      uvotscreen infile=unfiltered.fits attorbfile=prefilter.fits \


prefilter, maketime, extractor


March 2008