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
You also want an ePaper? Increase the reach of your titles
YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.
70 APPENDIX A. <strong>BAT</strong> DATA FORMATS<br />
Name Format [Units](Range) Comment<br />
TIME 1D [s] TIME associated with event<br />
DET ID 1I (0:32767) Detector Channel, DM, Side and<br />
Block<br />
EVENT FLAGS 1B DM Event Flags<br />
PHA 1I chan(0:4095) Raw Pulse Height<br />
PI 1I keV Pulse Height Invariant (filled by bateconvert)<br />
MASK WEIGHT 1E Mask weight value for source of interest<br />
(filled by batmaskwtevt)<br />
DETX 1I (0:285) <strong>BAT</strong> X detector pixel number<br />
DETY 1I (0:172) <strong>BAT</strong> Y detector pixel number<br />
DET ID defines the location of the detector in the <strong>BAT</strong> electronics hierarchy. <strong>The</strong> result is a<br />
single integer between 0 and 32767.<br />
<strong>The</strong> coding is: (2048 * Block) + (256 * DM) + (128 * Side) + (Channel).<br />
0 ≤ Block ≤ 15 ; 0 ≤ DM ≤ 7; 0 ≤ Side ≤ 1; 0 ≤ Channel ≤ 127.<br />
EVENT FLAGS is a bitmask of event flags, reported in the DM Event Flag DWord, which is an<br />
optional continuation word which follows the Normal Event DWord. <strong>The</strong> following bit assignments<br />
are be made:<br />
Bits Bit Mask Meaning<br />
5-7 b00000000 Reserved (zero)<br />
4 b00010000 Long format event converted to Short format (derived by bat2fits)<br />
3 b00001000 ADC Error Flag<br />
2 b00000100 Front Tagged Source Coincidence Flag<br />
1 b00000010 Rear Tagged Source Coincidence Flag<br />
0 b00000001 Multiple Hit Flag<br />
- b000X0000 Good event<br />
When the Event Flag bitmap is not present in the telemetry stream for a given event, the<br />
respective bits will be set to zero. A valid X-ray may have bit 4 set, but for “normal short” events,<br />
the Event Flag normally be zero.<br />
<strong>The</strong> mapping between (DETX, DETY) and DET ID is quite complicated and can be done using<br />
the tool batid2xy.<br />
Event files also include a Good Time Interval (GTI) extension giving the time spanned by events<br />
in the file.<br />
A.4 Survey Detector Plane Histograms<br />
<strong>The</strong>se files are the other primary science data product (along with event files). <strong>The</strong> bulk of the<br />
<strong>BAT</strong> data volume is Detector Plane Histograms (DPHs). Survey DPHs have suffix “dph” and are<br />
distinguished by the code “sv.” A typical file name also includes the gain/offset indices associated<br />
with the survey. For example, the file sw00074651000bsvo0002g0001.dph, would be for Observation<br />
ID 00074651, Segment 000, Offset index 0002 and gain index 0001.<br />
<strong>The</strong> columns in a Detector Plane Histogram are (EXTNAME=‘<strong>BAT</strong> DPH’):