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
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)
- Page 181 and 182: 168 APPENDIX D. BAT SOFTWARE TOOL R
- Page 183 and 184: 170 APPENDIX D. BAT SOFTWARE TOOL R
- Page 185 and 186: 172 APPENDIX D. BAT SOFTWARE TOOL R
- Page 187 and 188: 174 APPENDIX D. BAT SOFTWARE TOOL R
- Page 189 and 190: 176 APPENDIX D. BAT SOFTWARE TOOL R
- Page 191 and 192: 178 APPENDIX D. BAT SOFTWARE TOOL R
- Page 193 and 194: 180 APPENDIX D. BAT SOFTWARE TOOL R
- Page 195 and 196: 182 APPENDIX D. BAT SOFTWARE TOOL R
- Page 197 and 198: 184 APPENDIX D. BAT SOFTWARE TOOL R
- Page 199 and 200: 186 APPENDIX D. BAT SOFTWARE TOOL R
- Page 201 and 202: 188 APPENDIX D. BAT SOFTWARE TOOL R
- Page 203 and 204: 190 APPENDIX E. BAT SOFTWARE REVISI
- Page 205 and 206: 192 APPENDIX E. BAT SOFTWARE REVISI
- Page 207 and 208: 194 APPENDIX E. BAT SOFTWARE REVISI
- Page 209 and 210: 196 APPENDIX E. BAT SOFTWARE REVISI
- Page 211 and 212: 198 APPENDIX E. BAT SOFTWARE REVISI
- Page 213 and 214: 200 APPENDIX E. BAT SOFTWARE REVISI
- Page 215 and 216: 202 APPENDIX E. BAT SOFTWARE REVISI
- Page 217 and 218: 204 APPENDIX E. BAT SOFTWARE REVISI
- Page 219 and 220: 206 APPENDIX E. BAT SOFTWARE REVISI
- Page 221 and 222: 208 APPENDIX E. BAT SOFTWARE REVISI
- Page 223 and 224: 210 APPENDIX E. BAT SOFTWARE REVISI
- Page 225 and 226: 212 APPENDIX E. BAT SOFTWARE REVISI
- Page 227 and 228: 214 APPENDIX E. BAT SOFTWARE REVISI
- Page 229 and 230: 216 APPENDIX E. BAT SOFTWARE REVISI
- Page 231: 218 APPENDIX E. BAT SOFTWARE REVISI
- Page 235 and 236: 222 APPENDIX E. BAT SOFTWARE REVISI
- Page 237: 224 APPENDIX E. BAT SOFTWARE REVISI
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)