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

D.1. BATBINEVT 97
outfile [filename ]
Output light curve or spectrum file name.
outtype [string ]
Chooses output format of either light curve (outtype=“LC”), spectrum (outtype=“PHA”,
“PHA1”, “PHA2”), detector plane histogram (outtype=“DPH”), detector plane image (outtype=“DPI”),
or detetector plane image table (outtype=“DPITAB”). The difference between
DPI and DPITAB is that DPI output has one detector image per FITS image extension and
the later has one image per FITS row in a single extension.
timedel = 1.0 [real ]
Select a time bin size, in seconds. If time binning is uniform, then a value of timedel=0.0
causes the tool to accumulate all data into a single time bin. If time binning algorithm is
“snr”, then a non-zero bin size indicates the maximum bin size regardless of the signal to
noise ratio. A zero value of timedel indicates no maximum bin size.
timebinalg = uniform [string ]
One of “uniform”, for uniform binning, “snr”, for constant signal to noise ratio, “gti” for time
binning according to the intervals in the GTI file, “infile” to mimic the input file binning
(binned input data only), or “matchlc” to match an existing light curve. Only the first
character of the algorithm type needs to be specified.
energybins = “-” [string ]
Energy bin ranges, expressed as a comma-separated list of floating point number ranges, a
file name containing energy bin ranges, INFILE, FILEBINS or CALDB.
Comma-separated list Each bin in the comma-separated list is specified as EMIN1-
EMAX1,EMIN2-EMAX2,... (in units of keV). Pulse heights which satisfy EMIN[n] ≤ E
< EMAX[n] are considered to be in bin n. If EMIN[n] is missing, then it is assumed to
be 0. If EMAX[n] is missing it is assumed to be the maximum energy. A value of “-”
indicates single all-inclusive energy bin. At least one bin must be given to make even a
light curve, and bins must not overlap.
File name The name of a FITS file with an EBOUNDS extension (such as a response
matrix), containing columns E MIN and E MAX (in keV), or an ASCII file containing
a comma-separated energy bin list as described above.
FILEBINS or INFILE FILEBINS or INFILE indicates that the energy binning of the
first input file is used. (this only applies when the inputs are DPHs, and the DPH must
have an EBOUNDS extension).
CALDB If CALDB is specified, then the CALDB database is consulted for energy bins. A
standard 4-channel and 80-channel set of binnings is chosen depending on whether the
outtype is LC or PHA, respectively. By using CALDB:n, a specific n-channel binning
can be selected (provided it exists in CALDB).
(gtifile = NONE) [string ]
Name of goodtime interval file or time bin file. If the time binning algorithm is “gti” or
“matchlc” then this file is used to establish the time bins. Normally, this file is a standard
GTI. However, for time binning algorithm “matchlc”, this file should be standard OGIP light
curve. The user-supplied good times are logically intersected with the good times of the input
files (i.e. only overlap portions are used). The default of NONE implies that all good time
intervals from the input files will be used.