The SWIFT BAT Software Guide Version 6.3 30 ... - HEASARC - Nasa

5.4. MAKING A DETECTOR QUALITY MAP 33
5.4.2 Prerequisites
• BAT detector enable/disable map (in obsid/bat/hk/swNNNNNNNNNNNbdecb.hk.gz);
• BAT event data (in obsid/bat/event/swNNNNNNNNNNNbevsh*.evt.gz);
• Access to Calibration Database (CALDB).
The SDC should be producing a detector enable/disable file for every observation. If it is not
present, then you must locate the nearest one in time in the trend data in the archive (see below).
The process involves three main steps. First, a detector plane image of the event data is created.
Second, using the observation time of the image, a master quality map is retrieved from CALDB.
Finally, the detector plane image is searched for noisy detectors which may have flared up during
the observation, using the task bathotpix.
In this case, let us create a quality map for GRB 050713A (obsid 00145675 000).
5.4.3 Initial Steps
Change directories to the location of the event data.
cd 00145675000/bat/event
5.4.4 Create a Detector Plane Image
Create a detector plane image for the time or energy range of interest. This is a temporary file
which will be checked for noisy detectors.
For our example, we will simply sum all the event data, including all times and all energy ranges.
This should normally be acceptable, since summing over a long period of time should produce the
most conservative number of detectors to exclude.
batbinevt infile=sw00145675000bevshsp_uf.evt.gz outfile=total.dpi \
outtype=DPI timedel=0 timebinalg=u energybins=- \
weighted=NO outunits=COUNTS clobber=YES
• infile is the event file accumulated;
• outfile is the temporary detector plane image;
• outtype=DPI indicates that a detector plane image will be created;
• timedel=0 indicates to sum all the data into one map. It would be possible to set tstart=
and tstop= to narrow the range of time if desired;
• energybins=- indicates to sum all energies. A narrower energy range can be given as ELOW-
EHIGH;
• weighted=NO indicates to make an unweighted detector map
• outunits=COUNTS indicates that the map should be in units of counts instead of rate;