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

Recommendations

Info

D.10. BATGRBPRODUCT 145 D.10 BATGRBPRODUCT D.10.1 NAME batgrbproduct - standard BAT GRB processing D.10.2 USAGE batgrbproduct indir outdir D.10.3 DESCRIPTION batgrbproduct performs standard processing for gamma-ray bursts detected by the Swift BAT instrument. It performs the following activities: • generation of a master quality map • generation of good time interval files • extraction of events near the time of the GRB • computing mask weights for all events for the GRB position • finding an optimal time interval based on Bayesian blocks analysis • generation of sky images • generation of a partial coding map • refinement of the BAT position (if possible) • generation of energy spectra for different time intervals, including – pre-slew – during-slew – post-slew generation of detector response matrices generation of light curves with different samplings computation of counts fluences creation of a summary report creation of a detailed execution log file
146 APPENDIX D. BAT SOFTWARE TOOL REFERENCE NOTE: the scripts batgrbproduct and bat-burst-advocate are identical. The first name has been preserved for historical reasons, and the second name for consistency with the product scripts of the UVOT and XRT. By default it is assumed that the TDRSS position message is present. This message provides information about the position of the burst and the initial time interval of the burst. However, the user can override these values using command line parameters. If the RA and Dec values are set to BLIND, then sky images are made, but no further analysis is done, and it is up to the user to search the image to find new sources. PREREQUISITES - the user must have the standard FTOOLS (6.0.5 or later) installed and set up. Also, the CALDB must be installed and set up. It is assumed that the input directory structure is the same as that produced by the Swift Data Center (SDC). The event by event data should already be energy-calibrated by either the SDC or running bateconvert manually (i.e. the PI and ENERGY columns should be filled). D.10.4 SUMMARY OUTPUTS Upon finishing, the output directory contains a text file calledprocess.log. This file contains all the commands executed and detailed output transcripts. Users can check this file to: (a) diagnose problems; and (b) to get ideas on how to use the software to make their own custom science products. The output directory also contains report.txt, which is text file with a summary report giving basic statistics and factual information about the trigger that was analyzed. The task concludes by printing to the console a detailed inventory of files it created, including the name and a brief description for each file. D.10.5 OUTPUT DIRECTORIES The output files are arranged by type into several directories. The following list describes each directory. Each file name contains code phrases which are also described. outdir/lc Light curves. File names with “1chan” and “4chan” have 1 and 4 energy bins respectively. Time binnings can be 1 second (“1s”), 64 millisecond (“64ms”) and 4 millisecond (“4ms”). The light curves cover the full range of event data. outdir/pha Spectra and response matrices. Spectra are computed for the total burst interval, the T50/T90 intervals, the peak flux interval (1 second), and also for the pre-slew, slew, and post-slew intervals. Response matrices are computed for the pre-slew and post-slew intervals. outdir/dpi Detector images. Detector images are made in the pre-burst, pre-slew and post-slew time intervals. Pre-burst means an image created before any detectable emission. Images with 1 and 4 energy bins are created. outdir/img Sky and partial coding images. Sky images are made in the same time intervals as detector images, but only for the 1-channel images. Small “postage-stamp” images are also created (suffix “.postimg”), centered on the burst position. Partial coding maps are made for the pre-slew and post-slew intervals. outdir/gti Duration information. Various good time interval files are generated. Files with “acs” are spacecraft-attitude related (“acs 10am”, “acs sett”, “acs slew” corresponding to the 10arcmin, settled, and slewing flags, respectively). Files with “grb” select events near the GRB
Page 1 and 2:
The SWIFT BAT Software Guide Versio
Page 3 and 4:
ii CONTENTS 4.4 How Sky Fluxes are
Page 5 and 6:
iv CONTENTS 6 BAT Analysis Issues 5
Page 7 and 8:
vi CONTENTS D.1.6 SEE ALSO . . . .
Page 9 and 10:
viii CONTENTS D.10.2 USAGE . . . .
Page 11 and 12:
x CONTENTS D.18.5 EXAMPLES . . . .
Page 13 and 14:
xii CONTENTS
Page 15 and 16:
2 CHAPTER 1. INTRODUCTION • Appen
Page 17 and 18:
4 CHAPTER 2. BAT INSTRUMENT Figure
Page 19 and 20:
6 CHAPTER 2. BAT INSTRUMENT Figure
Page 21 and 22:
8 CHAPTER 2. BAT INSTRUMENT The The
Page 23 and 24:
10 CHAPTER 2. BAT INSTRUMENT
Page 25 and 26:
12 CHAPTER 3. BAT OPERATING MODES A
Page 27 and 28:
Page 29 and 30:
Page 31 and 32:
Page 33 and 34:
20 CHAPTER 4. INTRODUCTION TO BAT A
Page 35 and 36:
Page 37 and 38:
Page 39 and 40:
Page 41 and 42:
28 CHAPTER 5. BAT ANALYSIS PROCEDUR
Page 43 and 44:
Page 45 and 46:
Page 47 and 48:
Page 49 and 50:
Page 51 and 52:
Page 53 and 54:
Page 55 and 56:
Page 57 and 58:
Page 59 and 60:
Page 61 and 62:
Page 63 and 64:
Page 65 and 66:
Page 67 and 68:
Page 69 and 70:
56 CHAPTER 6. BAT ANALYSIS ISSUES T
Page 71 and 72:
58 CHAPTER 6. BAT ANALYSIS ISSUES w
Page 73 and 74:
60 CHAPTER 6. BAT ANALYSIS ISSUES T
Page 75 and 76:
62 CHAPTER 6. BAT ANALYSIS ISSUES 2
Page 77 and 78:
Page 79 and 80:
Page 81 and 82:
Page 83 and 84:
70 APPENDIX A. BAT DATA FORMATS Nam
Page 85 and 86:
72 APPENDIX A. BAT DATA FORMATS A.5
Page 87 and 88:
74 APPENDIX A. BAT DATA FORMATS A.5
Page 89 and 90:
76 APPENDIX A. BAT DATA FORMATS Nam
Page 91 and 92:
78 APPENDIX A. BAT DATA FORMATS wil
Page 93 and 94:
80 APPENDIX A. BAT DATA FORMATS BBi
Page 95 and 96:
82 APPENDIX A. BAT DATA FORMATS Arr
Page 97 and 98:
84 APPENDIX A. BAT DATA FORMATS 535
Page 99 and 100:
86 APPENDIX B. BAT FITS KEYWORDS
Page 101 and 102:
88 APPENDIX B. BAT FITS KEYWORDS
Page 103 and 104:
90 APPENDIX C. BAT ACRONYM AND TERM
Page 105 and 106:
92 APPENDIX C. BAT ACRONYM AND TERM
Page 107 and 108: 94 APPENDIX D. BAT SOFTWARE TOOL RE
Page 113 and 114: 100 APPENDIX D. BAT SOFTWARE TOOL R
Page 157: 144 APPENDIX D. BAT SOFTWARE TOOL R
Page 203 and 204: 190 APPENDIX E. BAT SOFTWARE REVISI
Page 209 and 210:
196 APPENDIX E. BAT SOFTWARE REVISI
Page 211 and 212:
Page 213 and 214:
Page 215 and 216:
Page 217 and 218:
Page 219 and 220:
Page 221 and 222:
Page 223 and 224:
Page 225 and 226:
Page 227 and 228:
Page 229 and 230:
Page 231 and 232:
Page 233 and 234:
Page 235 and 236:
Page 237:
show all

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

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?