30.01.2013 Views

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

SHOW MORE
SHOW LESS

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’):

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!