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

D.7. BATEREBIN 135
(fltpulserfile=“CALDB”) [string ]
Name of the file that contains the pulser DAC to energy calibration coefficients, or CALDB;
this should be the as-flown coefficients at the time of the observation.
(detmask=“NONE”) [string ]
Name of the file that contains a detmask image or table containing a detmask image. A
detmask is a DPI. Pixels containing values other than the value in the goodval keyword are
zeroed out in the output DPH.
(outmap=“NONE”) [string ]
Name of the file to be written that contains a detmask image. The values in the image are:
bit 0 indicates high edge of input integral bin is more than the low edge of the lowest energy
non integral output bin that you care about (default 14.0 keV)
bit 1 indicates low edge of input integral bin is less than the high edge of the highest non
integral output bin that you care about (default 151.4 keV)
bit 2 (value=4) indicates correction > 50 keV in magnitude
bit 4 (value=8) indicates wacked gain/offset values
bit 5 (value=16) indicates no V -> energy conversion value available
bit 6 (value=32) indicates detector masked by input detmask
(lowecare=14.0) [real ]
Lowest energy you care about. This value determines only if bit 1 is set in outmap when the
integral bin runs into a bin that you care about.
(highecare=151.4.0) [real ]
Highest energy you care about. This value determines only if bit 2 is set in outmap when the
integral bin runs into a bin that you care about.
(ebins=“FILEBINS”) [string ]
If FILEBINS, the output has the same energy bins as the input (but the counts will be redistributed
into the correct energy bins). Energy bin ranges, expressed as a comma-separated
list of floating point number ranges, a file name containing energy bin ranges, or CALDB.
Each bin in the comma-separated list is specified as EMIN1-EMAX1,EMIN2-EMAX2,... (in
units of keV). Bins may not overlap. If a file name is given, it can either be an ASCII file
containing the same comma-separated energy bin list, or a FITS file with an EBOUNDS
extension (such as a response matrix), containing columns E MIN and E MAX (in keV). If
CALDB is specified, then the CALDB database is consulted for energy bins. A standard
80-channel set of binnings is used. By using CALDB:n, a specific n-channel binning can be
selected (provided it exists in CALDB). If the first energy bin starts at 0, the first bin will
include the all the counts from the first bin from the input (which has all counts less than
a nominal linear uncorrected 10 keV). If the highest energy bin stops at 6553.6, the highest
bin will include all the counts from the highest input bin (which has all counts greater than
a nominal linear uncorrectd 191.4 keV). Otherwise integral bin counts will be discarded.
(wholecount = no) [boolean ]
Selects whether the output contains only whole (wholecount=yes) or possibly fractional
(wholecount=no) counts. Automatically set to yes if the output data type is an integer
type. Either way, the output should contain the same total counts per detector as the input.