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

Recommendations

Info

D.14. BATMASKWTEVT 161 D.14.5 DISTORTION CORRECTION Batmaskwtevt can correct for systematic non-linear centroid shifts in the BAT imaging system. It is assumed that the input position (either celestial or instrumental) is in “true” undistorted coordinates. All distortion corrections occur internally within the task. The distortion correction occurs if the ‘distfile’ parameter points to a correction map. D.14.6 PARAMETERS infile [filename ] Input event file name. This file must contain BAT events, and have at least the columns TIME, MASK WEIGHT, DETX and DETY. The MASK WEIGHT column is overwritten by this tool, so the file must be writeable. attitude [string ] ra [real ] File name of Swift attitude history, or NONE if none is used. Right ascension of source in decimal degrees, or other source position coordinate, depending on coord type. dec [real ] Declination of source in decimal degrees, or other source position coordinate, depending on coord type. (aperture = “CALDB”)[filename ] BAT aperture map file name, which contains the coded mask pattern and alignment parameters. If the CALDB database is set up, then CALDB can also be specified. If several aperture types are available in the CALDB, the user can specify CALDB:apertype. Valid values of apertype are currently: FLUX or DETECTION, for apertures optimized for flux reproducibility or detection sensitivity, respectively. (coord type = “sky”) [string ] Method of specifying the source coordinates. It should be one of: “sky”; “tanxy” (coordinates expressed in tangent-plane coordinates); “cartesian” (source at cartesian position in BAT coordinates); “unit” (unit vector direction in BAT coordinates); “fswlonlat” (flight software phi and theta); “grmclonlat” (source at simulator longitude and latitude). All coordinate types but the first are specified in the instrument coordinate system. (rebalance = YES) [boolean ] If YES, then the mask weight map will be adjusted so that its additive mean is zero. If NO, then, the map will be written unadjusted. (corrections = “default”) [string ] Comma-separated list of corrections to apply to the mask weighting, or “none” if no corrections are to be applied. The possible corrections are: default Default corrections, which is shorthand for: “flatfield,ndets,pcode,maskwt” flatfield Apply corrections for cosine and edge projection effects
162 APPENDIX D. BAT SOFTWARE TOOL REFERENCE maskwt Apply corrections for mask weighting technique pcode Apply partial coding corrections ndets Normalize by number of exposed detectors subpixelate Use slower but potentially higher fidelity algorithm forward Reserved for clean procedure unbalanced Reserved for clean procedure nearfield Near field corrections for ground calibration analysis only • The “pcode” and “ndets” corrections require the user to supply the detmask keyword. (pcodethresh = 0.00) [real ] Minimum allowable partial coding value allowed for the source position. This is a fraction between 0.0 (no partial coding) and 1.0 (fully coded). For example, a value of 0.01 implies that at least 1% of the detectors must be illuminated. Mask weights for events whose partial coding is below the threshold will be set to zero. (detmask = “NONE”) [string ] Name of a detector quality map file. This should be an image file with the same dimensions as the detector plane map. A pixel value of 0 indicates the detector is enabled, and a non-zero value indicates disabled. A default value of NONE implies all detectors are on, except for the BAT detector gap regions. This map is only used for computing the fraction of illuminated pixels. The output mask weight map contains a value for all detectors in the array, regardless of detmask. (auxfile = “NONE”) [string ] Specifies an auxiliary output file which describes the position of the source in the BAT field of view as a function of time, including various ray tracing diagnostics. The columns are TIME (MET in seconds); BAT X/Y/ZOBJ (source position in instrument coordinates in cm); IMX/Y (source tangent plane coordinates); PCODEFR (partial coding fraction); NGOODPIX (number of enabled detectors); MSKWTSQF (normalization parameter). One row is created for each ray tracing operation performed. This file is required for response matrix generation during slews. (filtexpr = ”(EVENT FLAGS == 0) —— (EVENT FLAGS == 16)”) [string ] Event filtering expression to be applied to the data. Any column filtering expression using the columns or keywords in the event file is valid (see the help for the “colfilter” task for more information). Events that fail the expression will have their mask weight set to zero. The default expression rejects calibration and multi-hit events, which are never due to cosmic sources. NOTE: users should not use spatial filters which exclude certain detectors, since batmaskwtevt will be unable to properly normalize the weights. For spatial filtering, use a detmask. (bat z = 0) [real ] Position of the source in BAT Z coordinates, if coord type is “cartesian” (in units of cm). (maskwtcol = “MASK WEIGHT”) [string ] Name of mask weight column.
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 109 and 110:
Page 111 and 112:
Page 113 and 114:
100 APPENDIX D. BAT SOFTWARE TOOL R
Page 115 and 116:
Page 117 and 118:
Page 119 and 120:
Page 121 and 122:
Page 123 and 124: 110 APPENDIX D. BAT SOFTWARE TOOL R
Page 173: 160 APPENDIX D. BAT SOFTWARE TOOL R
Page 203 and 204: 190 APPENDIX E. BAT SOFTWARE REVISI
Page 225 and 226:
212 APPENDIX E. BAT SOFTWARE REVISI
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

Create successful ePaper yourself

Delete template?

Save as template?