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

94 APPENDIX D. BAT SOFTWARE TOOL REFERENCE
D.1 BATBINEVT
D.1.1 NAME
batbinevt - accumulate BAT event and DPH data into spectra, lightcurves or images
D.1.2 USAGE
batbinevt infile outfile outtype timedel timebinalg energybins
D.1.3 DESCRIPTION
batbinevt computes mask weighted light curves and spectra for BAT event and detector plane histogram
data (DPHs). This tool can use the weights generated by batmaskwtevt or batmaskwtimg
to make binned output light curves and spectra. batbinevt can also be used to make raw detector
plane images and histograms, and to rebin raw detector plane histograms in time or energy.
The input event file must normally have been processed first by batmaskwtevt for a particular
source position. Thus, batbinevt will only extract weighted products for one source at a time,
although it can compute many time or energy samples.
INPUT FILE TYPES
batbinevt operates on either event data or BAT DPH data. Event data must have the TIME and
energy columns. If weighting is applied, then either the MASK WEIGHT column must be present,
or a separate mask weight image file must be supplied.
batbinevt can also read detector plane histograms (DPHs). BAT DPHs have two spatial dimensions
and one energy dimension. They are produced by the BAT flight software, and also perhaps
previous runs of batbinevt. They must contain an EBOUNDS extension which describes the energy
bin edges.
OUTPUT FILE TYPES
batbinevt can output several file types. The most common will be
LC standard OGIP light curve (default: weighted=yes, outunits=RATE);
PHA standard OGIP spectrum (type I or II; weighted=yes, outunits=RATE);
Output format is determined automatically; if there is one output spectrum then the output
file is a type I spectrum; otherwise it is type II.
PHA1 standard OGIP spectrum (type I; default: weighted=yes, outunits=RATE);
PHA2 standard OGIP spectrum (type II; default: weighted=yes, outunits=RATE);