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

134 APPENDIX D. BAT SOFTWARE TOOL REFERENCE
D.7 BATEREBIN
D.7.1 NAME
baterebin - read in a survey DPH and rebin the energy spectra using non-linear corrections
D.7.2 USAGE
baterebin infile outfile calfile [residfile pulserfile fltpulserfile outmap lowecare
highecare detmask ebins outdatatype wholecount rows
D.7.3 DESCRIPTION
This code reads in a BAT Detector Plane Histogram (DPH), which is organized as a single threedimensional
binary table with spectral information for each BAT detector arranged by geometric
location in the focal plane. The tool extracts the individual detector spectra and reanalyzes them
using cubic corrections from a ground cal file. A new DPH is output with the new spectra.
D.7.4 PARAMETERS
infile=”” [string ]
Input file name, which must contain a detector plane histogram (extension names BAT DPH
and EBOUNDS must be in the file).
outfile=”” [filename ]
Name of the output file. The output file is also a DPH file with a new DPH COUNTS column
that has been corrected.
calfile=“gainoffset.fits” [filename ]
Name of the file that contains the “gain/offset” maps. These are pseudo-linear calibration
constants for conversion of ADU to energy units.
(residfile=“CALDB”) [string ]
Name of the file that contains the quadratic or cubic residuals to the ADU to DAC relation,
or CALDB. The keyword GAINMETH in this file will control whether the quadratic or cubic
correction is performed.
(pulserfile=“CALDB”) [string ]
Name of the file that contains the pulser DAC to energy calibration coefficients, or “CALDB”
to search CALDB. These are the best known coefficients derived from ground calibration
efforts.