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

28 CHAPTER 5. BAT ANALYSIS PROCEDURES
5.2 Complete GRB Processing Script
This section describes how to run automatic GRB processing script, batgrbproduct. This script
produces light curves, spectra and summary reports that many common users would want. It also
produces a detailed log of commands executed, which users can cut and paste to make their own
products.
5.2.1 Introduction
In late 2006, a new version of the BAT software became available which includes the task
batgrbproduct. This task generates standard products for a GRB observation, using conservative
data filtering and sensible defaults. The BAT team recommends that most users start with
this script for their analysis of a GRB. The BAT team itself uses this script to produce the results
posted on GCN circulars. The batgrbproduct script performs the mask weighting operation
(ray-tracing), creates a quality map, and generates light curves spectra and response matrices with
various binnings. Sky images are produced, and if possible, a refined GRB position is derived from
these positions.
The task also produces a detailed log file which users can consult when they want to make their
own custom light curves or spectra.
5.2.2 Prerequisites
• A complete Swift observation containing GRB event data (usually this will be in observation
segment 0, labeled NNNNNNNNN000 with three final zeroes);
• a recent version of HEASoft tools (version 6.1.2 or later);
• a recent version of CALDB.
It is assumed that the correct energy calibration has been run on the event file. Please see the
section on applying an energy calibration to BAT event data for more information.
5.2.3 Change to Data Directory
Change to the directory containing the observation, but not into the observation directory itself.
Extract the observation data if needed. For example, if the observation directory was
/data/grbs/00145675000, then issue the following command,
cd /data/grbs
5.2.4 Creating GRB Products Automatically
To run the script, issue the following command,
batgrbproduct indir=./00145675000 outdir=./00145675000-results
where