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
CONTENTS v A.5.3 64-Millisecond Rates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72 A.5.4 Maximum Rates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72 A.5.5 Mask-tagged Light Curves . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73 A.5.6 TDRSS GRB Light Curves . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 A.6 Maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 A.6.1 Detector Enable/Disable Map . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 A.6.2 Detector Quality Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 A.6.3 Gain / Offset Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75 A.6.4 Mask Weight Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 A.7 TDRSS Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76 A.7.1 BAT GRB Alert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 A.7.2 GRB Position Message (ACK or NACK) . . . . . . . . . . . . . . . . . . . . 77 A.7.3 FoM and S/C Will/Will Not Observe . . . . . . . . . . . . . . . . . . . . . . 77 A.7.4 BAT Light Curves . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 A.8 Housekeeping Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 A.8.1 Americium Survey DPHs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 A.8.2 Americium Block Spectra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 A.8.3 Calibration Pulser Maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 A.8.4 Detector Array Panel (DAP) Housekeeping . . . . . . . . . . . . . . . . . . . 79 A.8.5 BAT Engineering Housekeeping . . . . . . . . . . . . . . . . . . . . . . . . . . 82 A.8.6 DI Commandables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 A.8.7 Debug Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 A.8.8 Trigger Diagnostic Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 B BAT FITS Keywords 85 B.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 B.1.1 Keywords Used . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 B.1.2 Data Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 C BAT Acronym and Terminology Glossary 89 D BAT Software Tool Reference 93 D.1 BATBINEVT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 D.1.1 NAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 D.1.2 USAGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 D.1.3 DESCRIPTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 D.1.4 PARAMETERS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96 D.1.5 EXAMPLES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
vi CONTENTS D.1.6 SEE ALSO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 D.1.7 LAST MODIFIED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104 D.2 BATCELLDETECT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 D.2.1 NAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 D.2.2 USAGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 D.2.3 DESCRIPTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 D.2.4 CATALOG OUTPUT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106 D.2.5 DISTORTION CORRECTION . . . . . . . . . . . . . . . . . . . . . . . . . . 109 D.2.6 PARAMETERS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109 D.2.7 EXAMPLES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114 D.2.8 SEE ALSO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 D.2.9 LAST MODIFIED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115 D.3 BATCLEAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 D.3.1 NAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 D.3.2 USAGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 D.3.3 DESCRIPTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116 D.3.4 PARAMETERS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 D.3.5 EXAMPLES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121 D.3.6 BUGS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 D.3.7 SEE ALSO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 D.3.8 REFERENCES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 D.3.9 LAST MODIFIED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 D.4 BATDETMASK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 D.4.1 NAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 D.4.2 USAGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 D.4.3 DESCRIPTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 D.4.4 PARAMETERS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 D.4.5 EXAMPLES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 D.4.6 SEE ALSO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 D.4.7 LAST MODIFIED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 D.5 BATDRMGEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 D.5.1 NAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 D.5.2 USAGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 D.5.3 DESCRIPTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 D.5.4 THEORY of OPERATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126 D.5.5 PARAMETERS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126 D.5.6 EXAMPLES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
- Page 1 and 2: The SWIFT BAT Software Guide Versio
- Page 3 and 4: ii CONTENTS 4.4 How Sky Fluxes are
- Page 5: iv CONTENTS 6 BAT Analysis Issues 5
- 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: 14 CHAPTER 3. BAT OPERATING MODES A
- Page 29 and 30: 16 CHAPTER 3. BAT OPERATING MODES A
- Page 31 and 32: 18 CHAPTER 3. BAT OPERATING MODES A
- Page 33 and 34: 20 CHAPTER 4. INTRODUCTION TO BAT A
- Page 35 and 36: 22 CHAPTER 4. INTRODUCTION TO BAT A
- Page 37 and 38: 24 CHAPTER 4. INTRODUCTION TO BAT A
- Page 39 and 40: 26 CHAPTER 4. INTRODUCTION TO BAT A
- Page 41 and 42: 28 CHAPTER 5. BAT ANALYSIS PROCEDUR
- Page 43 and 44: 30 CHAPTER 5. BAT ANALYSIS PROCEDUR
- Page 45 and 46: 32 CHAPTER 5. BAT ANALYSIS PROCEDUR
- Page 47 and 48: 34 CHAPTER 5. BAT ANALYSIS PROCEDUR
- Page 49 and 50: 36 CHAPTER 5. BAT ANALYSIS PROCEDUR
- Page 51 and 52: 38 CHAPTER 5. BAT ANALYSIS PROCEDUR
- Page 53 and 54: 40 CHAPTER 5. BAT ANALYSIS PROCEDUR
- Page 55 and 56: 42 CHAPTER 5. BAT ANALYSIS PROCEDUR
vi CONTENTS<br />
D.1.6 SEE ALSO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104<br />
D.1.7 LAST MODIFIED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104<br />
D.2 <strong>BAT</strong>CELLDETECT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105<br />
D.2.1 NAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105<br />
D.2.2 USAGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105<br />
D.2.3 DESCRIPTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105<br />
D.2.4 CATALOG OUTPUT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106<br />
D.2.5 DISTORTION CORRECTION . . . . . . . . . . . . . . . . . . . . . . . . . . 109<br />
D.2.6 PARAMETERS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109<br />
D.2.7 EXAMPLES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114<br />
D.2.8 SEE ALSO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115<br />
D.2.9 LAST MODIFIED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115<br />
D.3 <strong>BAT</strong>CLEAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116<br />
D.3.1 NAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116<br />
D.3.2 USAGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116<br />
D.3.3 DESCRIPTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116<br />
D.3.4 PARAMETERS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117<br />
D.3.5 EXAMPLES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121<br />
D.3.6 BUGS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122<br />
D.3.7 SEE ALSO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122<br />
D.3.8 REFERENCES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122<br />
D.3.9 LAST MODIFIED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122<br />
D.4 <strong>BAT</strong>DETMASK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123<br />
D.4.1 NAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123<br />
D.4.2 USAGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123<br />
D.4.3 DESCRIPTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123<br />
D.4.4 PARAMETERS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123<br />
D.4.5 EXAMPLES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124<br />
D.4.6 SEE ALSO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124<br />
D.4.7 LAST MODIFIED . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124<br />
D.5 <strong>BAT</strong>DRMGEN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125<br />
D.5.1 NAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125<br />
D.5.2 USAGE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125<br />
D.5.3 DESCRIPTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125<br />
D.5.4 THEORY of OPERATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126<br />
D.5.5 PARAMETERS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126<br />
D.5.6 EXAMPLES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129