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

138 APPENDIX D. BAT SOFTWARE TOOL REFERENCE
parameter, and quantization can be disabled. The default quantization (7 bits of noise) should be
more than enough to preserve all image features.
D.8.4 PARAMETERS
infile [filename ]
Input file name containing BAT detector plane image. If pcodemap is ‘YES’, then the contents
of the map are ignored, but the keywords from the map file are used to select the calibration
files from CALDB. Thus, using a detector enable map or a quality map is appropriate in that
case. Avoid using the CFITSIO syntax to select image extensions; use the ‘rows’ parameter
instead.
outfile [filename ]
Output sky image or partial coding map file name.
attitude = “NONE” [string ]
Swift attitude file name. If NONE is given, then a celestial coordinate system cannot be
assigned to the image.
(aperture = “CALDB:FLUX”)[filename ]
BAT aperture map file name, which contains the coded mask pattern and alignment parameters.
If the CALDB database is set up, then CALDB can also be specified. If several
aperture types are available in the CALDB, the user can specify CALDB:apertype. Valid
values of apertype are currently: FLUX or DETECTION, for apertures optimized for flux
reproducibility or detection sensitivity, respectively.
(detmask = “NONE”) [string ]
Name of a detector quality map file. This should be an image file with the same dimensions
as the focal plane map. A pixel value of 0 indicates the detector is enabled for imaging, and
a non-zero value indicates disabled. A default value of NONE implies all detectors are on,
except for the BAT detector gap regions.
(bkgfile = “NONE”) [string ]
Name of a file containing background image data to be subtracted from the input. A value
of NONE indicates no subtraction should be performed.
(bkgvarmap=“NONE”) [string ]
Optional output file name for the theoretical Poisson background fluctuation map. This map
will be either the standard deviation map or the variance map depending on the value of
bkgvartype. NOTE: The input map must not be cleaned for the theoretical map to be
computed properly. A value of NONE indicates no fluctuation maps should be created. A
value of APPEND indicates that each fluctuation map should be appended to the output file
given by ‘outfile’.
(bkgvartype=“STDDEV”) [string ]
Type of output fluctuation map. Valid values are: STDDEV, for a standard deviation map;
or VARIANCE, for a variance map.