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

178 APPENDIX D. BAT SOFTWARE TOOL REFERENCE
D.18 BATPHASYSERR
D.18.1 NAME
batphasyserr - apply BAT spectral systematic error vector
D.18.2 USAGE
batphasyserr infile syserrfile
D.18.3 DESCRIPTION
batphasyserr adds the BAT systematic error vector to a BAT spectral file. The systematic error
vector contains an estimate of the fractional systematic error in each BAT spectral channel.
Normally this information comes from the BAT calibration database (CALDB).
The task handles the differences between type I and type II spectral files transparently. It also
resamples the systematic error template to the energy bin edges of the input spectrum (this is done
by pure averaging).
D.18.4 PARAMETERS
infile [filename ]
Input/output spectral file. The file should be an OGIP-standard type I or type II spectral
file. The DATE-OBS keyword is used to query the CALDB. The file is modified in place. If
necessary, the SYS ERR column is created, and the SYS ERR keyword is deleted.
syserrfile [filename ]
Name of the systematic error vector file to use. Normally this should be set to “CALDB” so
that the current best estimate of the BAT spectral systematic error is used for the date of
the given infile.
(chatter = 2) [integer, 0 - 5 ]
Controls the amount of informative text written to standard output.
D.18.5 EXAMPLES
1. Create the SYS ERR column in a spectral file named myspectrum.pha.
batphasyserr myspectrum.pha CALDB
The systematic error vector is retrieved from the calibration database.