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

116 APPENDIX D. BAT SOFTWARE TOOL REFERENCE
D.3 BATCLEAN
D.3.1 NAME
batclean - read in a DPI and clean out a fit to the diffuse background
D.3.2 USAGE
batclean infile outfile incatalog [detmask] [options]
D.3.3 DESCRIPTION
This tool fits a simple background or source plus background model to a detector plane image. The
code contains a default background model which is described below. The user can also specify one
or more background models to be fit using the bkgmodel parameter. The output file can be either
the cleaned focal plane (default), the fit to the detector plane or the original input file.
The tool can also, optionally, balance the detector plane either before or after or instead of
cleaning. See below under the “balance” parameter for more details.
This code reads in a Detector Plane Image (DPI) file as well as an optional detector mask file. If
no detector mask file is provided, then all detectors with non-zero data are included in the fit. The
tool works on either flight or simulated flight data (sources at infinity) or ground calibration data
(sources at a finite distance). See the description of the bat z parameter for more about cleaning
of sources at a finite distance.
Source Cleaning
If one or more sources are to be cleaned from the DPI (default), then the tool reads the source locations
from the incatalog file and then calls the routine maskwtimg which uses a forward projection
to create a model of the source exposure through the aperture onto the detector plane.
Background Cleaning
The tool creates a simple eighteen parameter background model, which is described as follows:
• 1 = constant, 2 = proportional to X, 3 = proportional to Y
• 4 = proportional to X 2 , 5 = proportional to Y 2
• 6 = proportional to X Y,
• 7 = Detector on left (-X) side of sandwiches: constant,
• 8 = Left side detectors: proportional to X,