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

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

heasarc.nasa.gov
from heasarc.nasa.gov More from this publisher
30.01.2013 Views

E.18. SWIFT BAT SOFTWARE BUILD 20: 2006 NOV 06 219 * Primary HDU images are now labeled with HDUNAME instead of EXTNAME. This is still compatible with standard CFITSIO and DS9. batoccultgti * Additional error handling code batoccultmap * Bug fix: when the earth is at the very edge of the FOV and exclusively in the southern hemisphere, the whole FOV was accidentally blanked. Now fixed. * Primary HDU images are now labeled with HDUNAME instead of EXTNAME. This is still compatible with standard CFITSIO and DS9. * Additional error checking for bogus inputs batphasyserr * Additional error handling code batupdatephakw * Additional error handling code Tasks batevt2dpi, batgse2dpi, batgse2dph, and batmasktagpha are considered obsolete, and/or not for end users. E.18 Swift BAT Software Build 20: 2006 Nov 06 1. Overview This build contains one new BAT task, and improvements and fixes to many tasks. It also discusses several non-BAT-related tasks which are delivered by the BAT team. All unit tests pass, and are based on a *NEW* version of the BAT CALDB, which can be found as described below. 2. Summary of tool changes New tools batdetmask * New task for establishing BAT global good/bad detectors for a given time batglobalgti * New task for establishing BAT global good/bad science analysis time filter batgrbproduct * New task which performs fully automatic gamma-ray burst analysis of BAT data Revised tools batbinevt

220 APPENDIX E. BAT SOFTWARE REVISION HISTORY * Now write detector images with BAT_DPI_n extension name instead of just BAT_DPI * New task parameters {min,max}dph{time,frac}overlap allow more flexibility to accept individual survey DPHs, but the default is conservative. batcelldetect * Bug fix: clusters of point sources were being merged together improperly; affects fluxes of bunches of nearby sources; now fixed. * New parameter ’keepbadsources’, which when set, removes sources from the output catalog that failed the analysis process. * New parameter ’sortcolumns’ parameter, controls the sort order of the console listing; the FITS file order is unchanged * Improved logic for the handling of non-BAT images (maximum number of pixels per source; Poisson-distributed data); new parameter ’imagestatistics’ batfftimage * Bug fix: always write BDISTAPP = ’F’, even if the input event list has had ray-tracing with a distortion map. bathotpix * Bug fix: documentation of the QUALITY output column has been corrected (no code change) * More statistics are provided in the output file: NHOTPIX, NCOLDPIX, NGOODPIX, and NDISPIX which are, respectively, hot, cold, good and disabled pixel counts. batmasktaglc * Bug fix: avoid out of bounds memory access when dealing with GTIs; * Bug fix: avoid potential string buffer overflows * Task parameters ’maskwt’ and ’ebounds’ accept both INFILE or FILE * Cosmetic internal changes batmaskwtevt * New parameter ’filtexpr’ allows arbitrary event filtering (used to remove multi-hit and calibration events) * Bug fix: remove BDISTAPP from output event file, if it should not be present batmaskwtimg * Delete the output file if no input file is specified (prevents the user from using the results of an old run) * Bug fix: avoid segfault when calling printf() * Bug fix: remove BDISTAPP from output event file, if it should not be present * Bug fix: avoid accessing an already-closed FITS file pointer batoccultgti * The task now works with both the prefilter "SAO" file and the regular Swift attitude file (if all you are doing is field of view checking)

220 APPENDIX E. <strong>BAT</strong> SOFTWARE REVISION HISTORY<br />

* Now write detector images with <strong>BAT</strong>_DPI_n extension name instead of<br />

just <strong>BAT</strong>_DPI<br />

* New task parameters {min,max}dph{time,frac}overlap allow more<br />

flexibility to accept individual survey DPHs, but the default is<br />

conservative.<br />

batcelldetect<br />

* Bug fix: clusters of point sources were being merged together<br />

improperly; affects fluxes of bunches of nearby sources; now fixed.<br />

* New parameter ’keepbadsources’, which when set, removes sources<br />

from the output catalog that failed the analysis process.<br />

* New parameter ’sortcolumns’ parameter, controls the sort order of<br />

the console listing; the FITS file order is unchanged<br />

* Improved logic for the handling of non-<strong>BAT</strong> images (maximum number<br />

of pixels per source; Poisson-distributed data); new parameter<br />

’imagestatistics’<br />

batfftimage<br />

* Bug fix: always write BDISTAPP = ’F’, even if the input event list<br />

has had ray-tracing with a distortion map.<br />

bathotpix<br />

* Bug fix: documentation of the QUALITY output column has been<br />

corrected (no code change)<br />

* More statistics are provided in the output file: NHOTPIX, NCOLDPIX,<br />

NGOODPIX, and NDISPIX which are, respectively, hot, cold, good and<br />

disabled pixel counts.<br />

batmasktaglc<br />

* Bug fix: avoid out of bounds memory access when dealing with GTIs;<br />

* Bug fix: avoid potential string buffer overflows<br />

* Task parameters ’maskwt’ and ’ebounds’ accept both INFILE or FILE<br />

* Cosmetic internal changes<br />

batmaskwtevt<br />

* New parameter ’filtexpr’ allows arbitrary event filtering (used<br />

to remove multi-hit and calibration events)<br />

* Bug fix: remove BDISTAPP from output event file, if it should not be present<br />

batmaskwtimg<br />

* Delete the output file if no input file is specified (prevents the user from<br />

using the results of an old run)<br />

* Bug fix: avoid segfault when calling printf()<br />

* Bug fix: remove BDISTAPP from output event file, if it should not be present<br />

* Bug fix: avoid accessing an already-closed FITS file pointer<br />

batoccultgti<br />

* <strong>The</strong> task now works with both the prefilter "SAO" file and the regular Swift<br />

attitude file (if all you are doing is field of view checking)

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!