NAME
batdetmask - retrieve BAT gross detector quality map from CALDB
USAGE
batdetmask date outfile
DESCRIPTION
batdetmask retrieves a gross detector quality map (bad pixel map) from
CALDB for the time of a given observation. This quality map is meant
to reflect any operational issues that affected the BAT science data
quality which are not easily extractable from the filter file or other
telemetry. The user is not excused from doing other routine
quality filtering, for example for SAA or noisy detectors. Thus, this
task is most useful for doing gross filtering of data at the
observation level to remove detectors with known bad data.
The master quality maps are stored in CALDB. This task is merely an
interface to retrieve the correct map for the right time. The user
can specify the time explicitly, or an FITS file which contains the
time in a header keyword. The retrieved quality map can also be
combined with an existing user quality map using the detmask
parameter.
The result is a detector quality map suitable for input to any BAT
task which accepts the detmask parameter.
PARAMETERS
- date [string]
- The date of observation. This can be either the date of the exact
form "YYYY-MM-DDThh:mm:ss"; OR the Swift mission elapsed time in
seconds as a real number; OR a file name which contains the
observation time in a header keyword.
- outfile [filename]
- Name of the output detector quality map file.
- (keyword = "TSTART") [string]
- If the "date" parameter specifies a file, then the file is
searched for a header keyword of this name. The keyword value may be
of either of the time formats listed for the "date" parameter.
- (detmask = "NONE") [string]
- The name of a user quality map which should be combined with the
one from CALDB, or NONE if only the CALDB map is desired.
- (outcaldbmask = "NONE") [string]
- Upon return, this parameter is set to the global quality map and
extension found from CALDB which matches the time of the observation.
- (outdetmask = "NONE") [string]
- Upon return, this parameter is set to the detector mask which was selected
(including file name and extension), based on the time of the observation.
- (clobber = NO) [boolean]
- If the output file already exists, then setting "clobber = yes" will cause it to be overwritten.
- (chatter = 2) [integer, 0 - 5]
- Controls the amount of informative text written to standard
output.
EXAMPLES
1. Retrieve the detector quality map for June 5, 2005,
batdetmask 2005-06-05T00:00:00 master.detmask
2. Retrieve the detector quality map based on the TSTART keyword
in file myfile.dpi.
batdetmask myfile.dpi master.detmask keyword=TSTART
SEE ALSO
batglobalgti
LAST MODIFIED
Aug 2007