GCN
INTERNET SOCKET PACKET DEFINITION DOC
Scott Barthelmy 05 Dec 94 (revised 06 Jul 08)
MODS: The material in this document on KONUS_Lightcurve & SNEWS notices
is not quite settled. 31jul04
The watchdog timeout flag bit in SWIFT_FOM_OBS
moved from 2^25 to 2^29 (to be like all the others). 06apr06
The MILAGRO notice has been finalized. 12may06
The material for GLAST is nearly stable at this time,
and should be used for guidance as to what things
will look like for launch/operations. 16oct06
Added the catnum to BAT_POS packet. 12apr07
Change the definition of the TRIG_ID 2^11 bit
in the Swift/BAT_POS (& LC, FOM, SLEW, TRANS packets
(from 0.0 to 6.5 sigma). 04may07
Added GLAST_LAT_GRB_POS_TEST. 12may07
Finished the GLAST OBS_REQUEST & REQUEST_REPONSE. 13may07
More stuff in the GLAST_LAT_INI/UPD/FIN. 15may07
Start the AGILE stuff. 16may07
Added 'misc' field to SWIFT_POINTDIR.
Added the near_brt_star flagbit to Swift, AGILE, & GLAST. 30may07
Tweaked the GLAST_LAT types. 02jun07
Added the Gnd-generated bit to the Swift_PointDir Misc. 13jun07
Added the Swift-BAT_SUBTHRESHOLD type. 21jun07
Added the galaxy coincidence flag bits to Sift-BAT_POS/_TRANS/_TEST
and XRT_POS/_IMAGE. 27jun07
Added the galaxy coincidence flag bits to Sift-BAT_LC & _SM
and FOM_OBS & SC_SLEW. 30jun07
Added the Swift-BAT_SLEW_GRB_POSITION type. 30sep07
Added the 2^14 bit to SolnStatus in SWIFT_BAT_GRB_POS and
SWIFT_XRT_POS. 11jan08
Move GLAST_GBM_LC from 112 to 113; added POS_UPD as 112. 19jan08
Added the 2^5, 2^14, 2^15 & 2^30 bit fields to PKT_MISC
in XRT_POS_CENTROID. 26jan05
Added the 2^29 bit field to the PKT_MISC in XRT_POS_CENTROID.
13feb08
Several changes to the GLAST_LAT_INI/UPD/FIN/TRANS/TEST. 18feb08
Added the 3 e_range bits to the MISC field in BAT_SLEW_POS.24feb08
Added the 'far_away' bit to MISC in XRT_IMAGE & _POS. 03apr08
Added 'rmvd_catalog' bit to 'soln_status' in BAT_POS/LC/SM/FOM/SLEW.
12apr08
Added XRT-BAT_position distance to XRT_POSITION.
Added UVOT-XRT_position distance to UVOT_POSITION. 14apr08
Added AGILE_POINTDIR. 20apr08
Added SIMBAD/NED Results. 11jun08
Added many flagbits toTRIG_ID and MISC for the AGILE and
GLAST packets. 06jul08
TABLE OF CONTENTS:
INTRODUCTION:
Scope
Variations in Packeting Format
Integer vs Floating Point
Byte and Word Order
Obtaining an e-copy
PACKET NAME vs TYPE NUMBER
COMPARING THE TYPE=1,2,3,4,11,21,22,24-45,51-55,58-59,60-99,110-113,118-130 CONTENTS/FORMATS
PACKET ITEM MACROS
TYPE=1 PACKET CONTENTS (BATSE_ORIGINAL) [NO LONGER AVAILABLE]
Packet Item Descriptions
TYPE=2 PACKET CONTENTS (Test coords)
Packet Item Descriptions
TYPE=3 PACKET CONTENTS (Imalive)
Packet Item Descriptions
TYPE=4 PACKET CONTENTS (Kill)
TYPE=11 PACKET CONTENTS (BATSE_MAXBC) [NO LONGER AVAILABLE]
Packet Item Descriptions (only those unique to type=11)
TYPE=21 PACKET CONTENTS/DESCRIPTION (Bradford Test) [NO LONGER AVAILABLE]
TYPE=22 PACKET CONTENTS/DESCRIPTION (BATSE_FINAL) [NO LONGER AVAILABLE]
TYPE=24 PACKET CONTENTS/DESCRIPTION (BATSE_LOCBURST) [NO LONGER AVAILABLE]
TYPE=25 PACKET CONTENTS (ALEXIS)
Packet Item Descriptions (only those unique to type=25)
TYPE=26 PACKET CONTENTS (XTE-PCA Alert)
Packet Item Descriptions (only those unique to type=26)
TYPE=27 PACKET CONTENTS (XTE-PCA Source)
Packet Item Descriptions (only those unique to type=27)
TYPE=28 PACKET CONTENTS (XTE-ASM Alert) [NOT YET AVAILABLE]
TYPE=29 PACKET CONTENTS (XTE-ASM Source)
Packet Item Descriptions (only those unique to type=29)
TYPE=30 PACKET CONTENTS (COMPTEL) [NO LONGER AVAILABLE]
TYPE=31 PACKET CONTENTS (IPN_Raw) [NOT IMPLIMENTED]
TYPE=32 PACKET CONTENTS (IPN_Segment) [NO LONGER AVAILABLE]
Packet Item Descriptions (only those unique to type=32)
TYPE=33 PACKET CONTENTS (SAX-WFC Alert) [NOT AVAILABLE]
TYPE=34 PACKET CONTENTS (SAX-WFC Source) [NO LONGER AVAILABLE]
Packet Item Descriptions (only those unique to type=34)
TYPE=35 PACKET CONTENTS (SAX-NFI Alert) [NOT AVAILABLE]
TYPE=36 PACKET CONTENTS (SAX-NFI Source) [NO LONGER AVAILABLE]
Packet Item Descriptions (only those unique to type=36)
TYPE=37 PACKET CONTENTS (RXTE-ASM_XTRANS)
Packet Item Descriptions (only those unique to type=37)
TYPE=38 PACKET CONTENTS (spare for development testing)
TYPE=39 PACKET CONTENTS (IPN_Position)
Packet Item Descriptions (only those unique to type=39)
TYPE=40 PACKET CONTENTS (HETE_S/C_ALERT Source)
Packet Item Descriptions
TYPE=41 PACKET CONTENTS (HETE_S/C_UPDATE Source)
Packet Item Descriptions (only those unique to type=41)
TYPE=42 PACKET CONTENTS (HETE_S/C_LAST Source)
Packet Item Descriptions (only those unique to type=42)
TYPE=43 PACKET CONTENTS (HETE_GROUND_ANALYSIS Source)
Packet Item Descriptions (only those unique to type=43)
HETE FLAG BITS VS NOTICE TYPE
TYPE=44 PACKET CONTENTS (HETE_Test Source)
HETE-BASED PACKET ITEM MACROS
TYPE=45 PACKET CONTENTS (GRB_COUNTERPART Source)
Packet Item Descriptions
TYPE=51 PACKET CONTENTS (INTEGRAL_POINTDIR)
Packet Item Descriptions
TYPE=52 PACKET CONTENTS (INTEGRAL_SPIACS)
Packet Item Descriptions
TYPE=53 PACKET CONTENTS (INTEGRAL_WAKEUP Source)
Packet Item Descriptions
TYPE=54 PACKET CONTENTS (INTEGRAL_REFINED Source)
Packet Item Descriptions
TYPE=55 PACKET CONTENTS (INTEGRAL_OFFLINE Source)
Packet Item Descriptions
TYPE=57 PACKET CONTENTS (SNEWS Source) [NOT YET AVAILABLE]
Packet Item Descriptions
TYPE=58 PACKET CONTENTS (MILAGRO Source)
Packet Item Descriptions
TYPE=59 PACKET CONTENTS (KONUS_Lightcurve)
Packet Item Descriptions
TYPE=60 PACKET CONTENTS (SWIFT_BAT_GRB_ALERT)
Packet Item Descriptions
TYPE=61 PACKET CONTENTS (SWIFT_BAT_GRB_POSITION Source)
Packet Item Descriptions
TYPE=62 PACKET CONTENTS (SWIFT_BAT_GRB_NACK_POSITION)
Packet Item Descriptions
TYPE=63 PACKET CONTENTS (SWIFT_BAT_GRB_LIGHTCURVE)
Packet Item Descriptions
TYPE=64 PACKET CONTENTS (SWIFT_BAT_SCALED_MAP) [NOT AVAILABLE TO THE PUBLIC]
Packet Item Descriptions
TYPE=65 PACKET CONTENTS (SWIFT_FOM_OBSERVE)
Packet Item Descriptions
TYPE=66 PACKET CONTENTS (SWIFT_SC_SLEW)
Packet Item Descriptions
TYPE=67 PACKET CONTENTS (SWIFT_XRT_POSITION Source)
Packet Item Descriptions
TYPE=68 PACKET CONTENTS (SWIFT_XRT_SPECTRUM)
Packet Item Descriptions
TYPE=69 PACKET CONTENTS (SWIFT_XRT_IMAGE)
Packet Item Descriptions
TYPE=70 PACKET CONTENTS (SWIFT_XRT_LIGHTCURVE)
Packet Item Descriptions
TYPE=71 PACKET CONTENTS (SWIFT_XRT_NACK_POSITION)
Packet Item Descriptions
TYPE=72 PACKET CONTENTS (SWIFT_UVOT_IMAGE)
Packet Item Descriptions
TYPE=73 PACKET CONTENTS (SWIFT_UVOT_SRC_LIST)
Packet Item Descriptions
TYPE=74 PACKET CONTENTS (SWIFT_FULL_DATA_INIT) [NOT YET AVAILABLE]
Packet Item Descriptions
TYPE=75 PACKET CONTENTS (SWIFT_FULL_DATA_UPDATE) [NOT YET AVAILABLE]
Packet Item Descriptions
TYPE=76 PACKET CONTENTS (SWIFT_BAT_GRB_LIGHTCURVE_PROC) [NOT YET AVAILABLE]
Packet Item Descriptions
TYPE=77 PACKET CONTENTS (SWIFT_XRT_SPECTRUM_PROC)
Packet Item Descriptions
TYPE=78 PACKET CONTENTS (SWIFT_XRT_IMAGE_PROC)
Packet Item Descriptions
TYPE=79 PACKET CONTENTS (SWIFT_UVOT_IMAGE_PROC)
Packet Item Descriptions
TYPE=80 PACKET CONTENTS (SWIFT_UVOT_SRC_LIST_PROC)
Packet Item Descriptions
TYPE=81 PACKET CONTENTS (SWIFT_UVOT_POSITION Source)
Packet Item Descriptions
TYPE=82 PACKET CONTENTS (SWIFT_BAT_GRB_POS_TEST Source)
Packet Item Descriptions
TYPE=83 PACKET CONTENTS (SWIFT_POINTDIR)
Packet Item Descriptions
TYPE=84 PACKET CONTENTS (SWIFT_BAT_TRANS Source)
Packet Item Descriptions
TYPE=85 PACKET CONTENTS (SWIFT_XRT_THRESHPIX) [NOT AVAILABLE TO THE PUBLIC]
Packet Item Descriptions
TYPE=86 PACKET CONTENTS (SWIFT_XRT_THRESHPIX_PROC) [NOT AVAILABLE TO THE PUBLIC]
Packet Item Descriptions
TYPE=87 PACKET CONTENTS (SWIFT_XRT_SPER) [NOT AVAILABLE TO THE PUBLIC]
Packet Item Descriptions
TYPE=88 PACKET CONTENTS (SWIFT_XRT_SPER_PROC) [NOT AVAILABLE TO THE PUBLIC]
Packet Item Descriptions
TYPE=89 PACKET CONTENTS (SWIFT_UVOT_NACK_POSITION Source)
Packet Item Descriptions
TYPE=98 PACKET CONTENTS (SWIFT_BAT_SUBTHRESHOLD_POSITION Source) [NOT YET AVAILABLE]
Packet Item Descriptions
TYPE=99 PACKET CONTENTS (SWIFT_BAT_SLEW_GRB_POSITION Source)
Packet Item Descriptions
TYPE=100 PACKET CONTENTS (SuperAGILE_GRB_POS_WAKEUP Source)
Packet Item Descriptions
TYPE=101 PACKET CONTENTS (SuperAGILE_GRB_POS_GROUND Source)
Packet Item Descriptions
TYPE=102 PACKET CONTENTS (SuperAGILE_GRB_POS_REFINED Source)
Packet Item Descriptions
TYPE=107 PACKET CONTENTS (AGILE_POINTDIR)
Packet Item Descriptions
TYPE=108 PACKET CONTENTS (SuperAGILE_TRANS Source) [NOT YET AVAILABLE]
Packet Item Descriptions
TYPE=109 PACKET CONTENTS (SuperAGILE_GRB_POS_TEST Source)
Packet Item Descriptions
TYPE=110 PACKET CONTENTS (GLAST_GBM_GRB_ALERT) [NOT YET AVAILABLE]
Packet Item Descriptions
TYPE=111 PACKET CONTENTS (GLAST_GBM_GRB_POS_ACK Source) [NOT YET AVAILABLE]
Packet Item Descriptions
TYPE=112 PACKET CONTENTS (GLAST_GBM_GRB_POS_UPD Source) [NOT YET AVAILABLE]
Packet Item Descriptions
TYPE=113 PACKET CONTENTS (GLAST_GBM_LC) [NOT YET AVAILABLE]
Packet Item Descriptions
TYPE=118 PACKET CONTENTS (GLAST_GBM_TRANS Source) [NOT YET AVAILABLE]
Packet Item Descriptions
TYPE=119 PACKET CONTENTS (GLAST_GBM_GRB_POS_TEST Source)
Packet Item Descriptions
TYPE=120 PACKET CONTENTS (GLAST_LAT_GRB_POS_INI Source) [NOT YET AVAILABLE]
Packet Item Descriptions
TYPE=121 PACKET CONTENTS (GLAST_LAT_GRB_POS_UPD Source) [NOT YET AVAILABLE]
Packet Item Descriptions
TYPE=122 PACKET CONTENTS (GLAST_LAT_GRB_POS_DIAG Source)[NOT YET AVAILABLE]
Packet Item Descriptions
TYPE=123 PACKET CONTENTS (GLAST_LAT_TRANS Source) [NOT YET AVAILABLE]
Packet Item Descriptions
TYPE=124 PACKET CONTENTS (GLAST_LAT_GRB_POS_TEST Source)
Packet Item Descriptions
TYPE=125 PACKET CONTENTS (GLAST_OBS_REQUEST) [NOT YET AVAILABLE]
Packet Item Descriptions
TYPE=126 PACKET CONTENTS (GLAST_SC_SLEW) [NOT YET AVAILABLE]
Packet Item Descriptions
TYPE=127 PACKET CONTENTS (GLAST_LAT_GND_REF Source) [NOT YET AVAILABLE]
Packet Item Descriptions
TYPE=128 PACKET CONTENTS (GLAST_LAT_GND_TRIG Source) [NOT YET AVAILABLE]
Packet Item Descriptions
TYPE=129 PACKET CONTENTS (GLAST_POINTDIR) [NOT YET AVAILABLE]
Packet Item Descriptions
TYPE=130 PACKET CONTENTS (SIMBAD/NED Search Results)
Packet Item Descriptions
COORDINATES EPOCH and QUANTIZATION COMPARISON
INTRODUCTION:
Scope:
This is the Socket Packet Format Specification Document.
It contains the complete format and contents of each of the packets that are
sent to GCN Internet socket sites. This document lists only those packet types
available to the GCN Sites -- there are other packet types (not listed
in this doc) that are used for internal communication and processing
purposes within the GCN system (ie types 5-10, 12-20, 23, & 81-96).
Variations in Packeting Format:
Given the intrinsic variation of data types across all the missions,
it is not possible to have the same format for all packet types, nor is it
possible to have the same locations for those items that do appear
in more than one mission (packet type). Whenever possible, herculean effort
was made to put the same items in standard locations within the packet.
Integer vs Floating Point:
The basic packet is 160 bytes composed of 40 long_words (4-byte integers).
Integers are used even for the intrinsically floating point quantities
so as to make the transfer between platforms and operating systems easier.
All floating point quantities have been scaled up to preserve the decimal
fraction and then integerized. There are only two levels of scaling and
quantization. For those coordinates source with relative large uncertainties,
the scaling is 100x [0.01 degrees]. And for those sources with better accuracy,
the scalling is 10,000x [0.0001 degrees]. All that remains for inter-platform
compatibility is possibly word and/or byte swapping.
Byte and Word Order:
These socket packets were originally created on a Sun Sparc platform
(which is a big-endian machine). But even though the packets are now
created on a small-endian machine, the byte order is adjusted back
to the big-endian order just prior to being written out the socket
connections. This rotation is done to maintain format continuity
over the years. If the GCN recipient site is small-endien machine,
you will have to perform byte and/or word swapping on the 40 long-word
fields to get them into a proper order for its computer. The location
of the '\n' character within the last 4-byte field in the packet
can be used to diagnose the byte and/or word swapping necessary.
Obtaining an e-copy:
Most of this document is preformatted, so the user can easily get a copy
of this document by using the get_document_source command within
their browser and removing the purposely very small number of html-ism's.
PACKET NAME vs TYPE NUMBER
This table lists all the currently valid notices (by their name) versus
the packet type number.
NUMBER NAME COMMENT
1 BATSE_ORIGINAL NO LONGER AVAILABLE
2 Test
3 Imalive
4 Kill
11 BATSE_MAXBC NO LONGER AVAILABLE
21 Bradford_TEST NO LONGER AVAILABLE
22 BATSE_FINAL NO LONGER AVAILABLE
24 BATSE_LOCBURST NO LONGER AVAILABLE
25 ALEXIS
26 RXTE-PCA_ALERT
27 RXTE-PCA
28 RXTE-ASM_ALERT
29 RXTE-ASM
30 COMPTEL NO LONGER AVAILABLE
31 IPN_RAW NOT IMPLEMENTED
32 IPN_SEGMENT NO LONGER AVAILABLE
33 SAX-WFC_ALERT NOT AVAILABLE
34 SAX-WFC NO LONGER AVAILABLE
35 SAX-NFI_ALERT NOT AVAILABLE
36 SAX-NFI NO LONGER AVAILABLE
37 RXTE-ASM_XTRANS
38 spare/unused
39 IPN_POSITION
40 HETE_S/C_ALERT
41 HETE_S/C_UPDATE
42 HETE_S/C_LAST
43 HETE_GNDANA
44 HETE_Test
45 GRB_COUNTERPART
51 INTEGRAL_POINTDIR
52 INTEGRAL_SPIACS
53 INTEGRAL_WAKEUP
54 INTEGRAL_REFINED
55 INTEGRAL_OFFLINE
57 SNEWS NOT YET AVAILABLE
58 MILAGRO
59 KONUS_LIGHTCURVE
60 SWIFT_BAT_GRB_ALERT
61 SWIFT_BAT_GRB_POSITION
62 SWIFT_BAT_GRB_NACK_POSITION
63 SWIFT_BAT_GRB_LIGHTCURVE
64 SWIFT_BAT_SCALED_MAP NOT AVAILABLE
65 SWIFT_FOM_OBSERVE
66 SWIFT_SC_SLEW
67 SWIFT_XRT_POSITION
68 SWIFT_XRT_SPECTRUM
69 SWIFT_XRT_IMAGE
70 SWIFT_XRT_LIGHTCURVE
71 SWIFT_XRT_NACK_POSITION
72 SWIFT_UVOT_IMAGE
73 SWIFT_UVOT_SRC_LIST
74 SWIFT_FULL_DATA_INIT NOT YET AVAILABLE
75 SWIFT_FULL_DATA_UPDATE NOT YET AVAILABLE
76 SWIFT_BAT_GRB_PROC_LIGHTCURVE NOT YET AVAILABLE
77 SWIFT_XRT_PROC_SPECTRUM
78 SWIFT_XRT_PROC_IMAGE
79 SWIFT_UVOT_PROC_IMAGE
80 SWIFT_UVOT_PROC_SRC_LIST
81 SWIFT_UVOT_POSITION
82 SWIFT_BAT_GRB_POS_TEST
83 SWIFT_POINTDIR
84 SWIFT_BAT_TRANS
85 SWIFT_XRT_THRESHPIX NOT AVAILABLE TO THE PUBLIC
86 SWIFT_XRT_THRESHPIX_PROC NOT AVAILABLE TO THE PUBLIC
87 SWIFT_XRT_SPER NOT AVAILABLE TO THE PUBLIC
88 SWIFT_XRT_SPER_PROC NOT AVAILABLE TO THE PUBLIC
89 SWIFT_UVOT_NACK_POSITION
98 SWIFT_BAT_SUBTHRESHOLD_POSITION NOT YET AVAILABLE
99 SWIFT_BAT_SLEW_GRB_POSITION
100 SuperAGILE_GRB_POS_WAKEUP
101 SuperAGILE_GRB_POS_GROUND
102 SuperAGILE_GRB_POS_REFINED
108 AGILE_POINTDIR
108 SuperAGILE_TRANS NOT YET AVAILABLE
109 SuperAGILE_GRB_POS_TEST
110 GLAST_GBM_GRB_ALERT NOT YET AVAILABLE
111 GLAST_GBM_GRB_POS_ACK NOT YET AVAILABLE
112 GLAST_GBM_GRB_POS_UPD NOT YET AVAILABLE
113 GLAST_GBM_LC NOT YET AVAILABLE
118 GLAST_GBM_TRANS NOT YET AVAILABLE
119 GLAST_GBM_GRB_POS_TEST
120 GLAST_LAT_GRB_POS_INI NOT YET AVAILABLE
121 GLAST_LAT_GRB_POS_UPD NOT YET AVAILABLE
122 GLAST_LAT_GRB_POS_DIAG NOT YET AVAILABLE
123 GLAST_LAT_TRANS NOT YET AVAILABLE
124 GLAST_LAT_GRB_POS_TEST
125 GLAST_OBS_REQUEST NOT YET AVAILABLE
126 GLAST_SC_SLEW NOT YET AVAILABLE
127 GLAST_LAT_GND_REF NOT YET AVAILABLE
128 GLAST_LAT_GND_TRIG NOT YET AVAILABLE
129 GLAST_POINTDIR NOT YET AVAILABLE
130 SIMBAD/NED_SEARCH_RESULTS
COMPARING THE TYPE=1,2,3,4,11,21,22,24-45,51-55,58-59,
60-89,98,99,100-102,107-109,110-113,118-130 CONTENTS/FORMATS:
The contents and formats of all the valid packets for distribution are listed
below. The descriptions and definitions for each of the items within
the packets are given in the sections following each packet type.
Entries with a "-" or a "spare" in the table are undefined spare slots.
Type: 1 2 3 4 11
Loc: ORIGINAL TEST IMALIVE KILL MAXBC
0 pkt_type pkt_type pkt_type pkt_type pkt_type
1 pkt_sernum pkt_sernum pkt_sernum pkt_sernum pkt_sernum
2 pkt_hopcnt pkt_hopcnt pkt_hopcnt pkt_hopcnt pkt_hopcnt
3 pkt_sod pkt_sod pkt_sod pkt_sod pkt_sod
4 trig_num trig_num - - trig_num
5 burst_tjd burst_tjd burst_tjd - burst_tjd
6 burst_sod burst_sod burst_sod - burst_sod
7 burst_ra burst_ra - - burst_ra
8 burst_dec burst_dec - - burst_dec
9 burst_inten burst_inten - - burst_inten
10 burst_peak burst_peak - - burst_peak
11 burst_error burst_error - - burst_error
12 sc_az sc_az=0 - - sc_az
13 sc_el sc_el=0 - - sc_el
14 sc_x_ra sc_x_ra=0 - - sc_x_ra
15 sc_x_dec sc_x_dec=0 - - sc_x_dec
16 sc_z_ra sc_z_ra=0 - - sc_z_ra
17 sc_z_dec sc_z_dec=0 - - sc_z_dec
18 trig_id trig_id - - trig_id
19 misc misc - - misc
20 earth_sc_az earth_sc_az - - earth_sc_az
21 earth_sc_el earth_sc_el - - earth_sc_el
22 sc_radius sc_radius - - sc_radius
23 t_peak spare - - maxc1[0]
24 sam_used spare - - maxc1[1]
25 spare spare - - maxc1[2]
26 spare spare - - maxc1[3]
27 spare spare - - maxc1[4]
28 spare spare - - maxc1[5]
29 spare spare - - maxc1[6]
30 spare spare - - maxc1[7]
31 spare spare - - maxbc[0]
32 spare spare - - maxbc[1]
33 spare spare - - maxbc[2]
34 spare spare - - maxbc[3]
35 spare spare - - maxbc[4]
36 spare spare - - maxbc[5]
37 spare spare - - maxbc[6]
38 spare spare - - maxbc[7]
39 pkt_term pkt_term pkt_term pkt_term pkt_term
Type: 21 22 24 25
Loc: BRAD_COORDS FINAL LOCBURST ALEXIS
0 pkt_type pkt_type pkt_type pkt_type
1 pkt_sernum pkt_esrnum pkt_sernum pkt_sernum
2 pkt_hopcnt pkt_hopcnt pkt_hopcnt pkt_hopcnt
3 pkt_sod pkt_sod pkt_sod pkt_sod
4 trig_num trig_num trig_num src_num
5 burst_tjd burst_tjd burst_tjd trans_tjd
6 burst_sod burst_sod burst_sod trans_sod
7 burst_ra burst_ra burst_ra trans_ra
8 burst_dec burst_dec burst_dec trans_dec
9 burst_inten burst_inten burst_inten -
10 burst_peak burst_peak burst_peak -
11 burst_error burst_error burst_error trans_error
12 sc_az=0 sc_az sc_az -
13 sc_el=0 sc_el sc_el -
14 sc_x_ra=0 sc_x_ra sc_x_ra -
15 sc_x_dec=0 sc_x_dec sc_x_dec -
16 sc_z_ra=0 sc_z_ra sc_z_ra -
17 sc_z_dec=0 sc_z_dec sc_z_dec -
18 - trig_id trig_id -
19 misc misc misc -
20 - earth_sc_az - -
21 - earth_sc_el - -
22 - sc_radius - trans_alpha
23 - - - map_duration
24 - - - tele_id
25 - - - -
26 - - - -
27 - - - -
28 - - - -
29 - - - -
30 - - - -
31 - - - -
32 - - - -
33 - - - -
34 - - - -
35 - - - -
36 - - - -
37 - - - -
38 - - - -
39 pkt_term pkt_term pkt_term pkt_term
Type: 26 27 28 29 30
Loc: RXTE-PCA_ALERT RXTE-PCA XTE-ASM_ALERT XTE-ASM COMPTEL
0 pkt_type pkt_type pkt_type pkt_type pkt_type
1 pkt_sernum pkt_sernum pkt_sernum pkt_sernum pkt_sernum
2 pkt_hopcnt pkt_hopcnt pkt_hopcnt pkt_hopcnt pkt_hopcnt
3 pkt_sod pkt_sod pkt_sod pkt_sod pkt_sod
4 trig_num trig_num trig_num trig_num trig_num
5 burst_tjd burst_tjd burst_tjd burst_tjd burst_tjd
6 burst_sod burst_sod burst_sod burst_sod burst_sod
7 locburst_ra burst_ra burst_ra burst_ra burst_ra
8 locburst_dec burst_dec burst_dec burst_dec burst_dec
9 - burst_inten - burst_inten burst_inten
10 - burst_peak - burst_peak burst_peak
11 - burst_error - burst_error burst_error
12 - - - burst_cont -
13 - - - - -
14 - - - - -
15 - - - - -
16 - - - - -
17 - - - - -
18 - - trig_id trig_id trig_id
19 misc misc misc misc misc
20 - - - - -
21 - - - - -
22 - - - - -
23 - - - - -
24 obs_tjd - - err_ra1 err_ra1
25 obs_sod - - err_dec1 err_dec1
26 - - - err_ra2 err_ra2
27 - - - err_dec2 err_dec2
28 - - - err_ra3 err_ra3
29 - - - err_dec3 err_dec3
30 - - - err_ra4 err_ra4
31 - - - err_dec4 err_dec4
32 - - - length det_signif
33 - - - width -
34 - - - pos_angle -
35 - - - - -
36 - - - - -
37 - - - - -
38 - - - - -
39 pkt_term pkt_term pkt_term pkt_term pkt_term
Type: 31 32 33 34
Loc: IPN_RAW IPN_SEG SAX-WFC_ALERT SAX-WFC
0 pkt_type pkt_type pkt_type pkt_type
1 pkt_sernum pkt_sernum pkt_sernum pkt_sernum
2 pkt_hopcnt pkt_hopcnt pkt_hopcnt pkt_hopcnt
3 pkt_sod pkt_sod pkt_sod pkt_sod
4 trig_num trig_num - -
5 burst_tjd burst_tjd burst_tjd burst_tjd
6 burst_sod burst_sod burst_sod burst_sod
7 ? ipn_center_ra burst_ra burst_ra
8 ? ipn_center_decburst_dec burst_dec
9 ? ipn_radius - burst_inten
10 ? - - burst_peak
11 ? ipn_width - burst_error
12 ? 3sig_ra - burst_cont
13 ? 3sig_dec - -
14 ? 2sig_ra - -
15 ? 2sig_dec - -
16 ? 1sig_ra - -
17 ? 1sig_dec - -
18 ? max_prob_ra trig_id trig_id
19 ? max_prob_dec misc misc
20 ? 1sig_ra - -
21 ? 1sig_dec - -
22 ? 2sig_ra - -
23 ? 2sig_dec - -
24 ? 3sig_ra - -
25 ? 3sig_dec - -
26 ? - - -
27 ? - - -
28 ? - - -
29 ? - - -
30 ? - - -
31 ? - - -
32 ? - - -
33 ? - - -
34 ? - - -
35 ? - - -
36 ? - - -
37 ? - - -
38 ? - - -
39 pkt_term pkt_term pkt_term pkt_term
Type: 35 36 37
Loc: SAX-NFI_ALERT SAX-NFI XTE-ASM_XTRANS
0 pkt_type pkt_type pkt_type
1 pkt_sernum pkt_sernum pkt_sernum
2 pkt_hopcnt pkt_hopcnt pkt_hopcnt
3 pkt_sod pkt_sod pkt_sod
4 - - ref_num
5 burst_tjd burst_tjd trans_tjd
6 burst_sod burst_sod trans_sod
7 burst_ra burst_ra trans_ra
8 burst_dec burst_dec trans_dec
9 - burst_inten trans_inten
10 - burst_peak -
11 - burst_error trans_error
12 - burst_cont -
13 - - time_since
14 - - chi_sq_1
15 - - chi_sq_2
16 - - SigNoise1
17 - - SigNoise2
18 trig_id trig_id trig_id
19 misc misc misc
20 - - -
21 - - -
22 - - -
23 - - -
24 - - ra1
25 - - dec1
26 - - ra2
27 - - dec2
28 - - ra3
29 - - dec3
30 - - ra4
31 - - dec4
32 - - line_length
33 - - line_width
34 - - pos_angle
35 - - -
36 - - -
37 - - -
38 - - -
39 pkt_term pkt_term pkt_term
Type: 39
Loc: IPN_POS
0 pkt_type
1 pkt_sernum
2 pkt_hopcnt
3 pkt_sod
4 ref_num
5 burst_tjd
6 burst_sod
7 burst_ra
8 burst_dec
9 burst_fluence
10 -
11 burst_error
12 sample_interval
13 -
14 -
15 -
16 burst2_ra
17 burst2_dec
18 sernum
19 misc
20 -
21 box_area
22 duration
23 ra1
24 dec1
25 ra2
26 dec2
27 ra3
28 dec3
29 ra4
30 dec4
31 ra21
32 dec21
33 ra22
34 dec22
35 ra23
36 dec23
37 ra24
38 dec24
39 pkt_term
Type: 40 41 42 43 44
Loc: HETE_S/C_ALERT HETE_S/C_UPDATE HETE_S/C_LAST HETE_GNDANA HETE_Test
0 pkt_type pkt_type pkt_type pkt_type pkt_type
1 pkt_sernum pkt_sernum pkt_sernum pkt_sernum pkt_sernum
2 pkt_hopcnt pkt_hopcnt pkt_hopcnt pkt_hopcnt pkt_hopcnt
3 pkt_sod pkt_sod pkt_sod pkt_sod pkt_sod
4 trig_seq_num trig_seq_num trig_seq_num trig_seq_num trig_seq_num
5 burst_tjd burst_tjd burst_tjd burst_tjd burst_jtd
6 burst_sod burst_sod burst_sod burst_sod burst_sod
7 [burst_ra] burst_ra burst_ra burst_ra burst_ra
8 [burst_dec] burst_dec burst_dec burst_dec burst_dec
9 trig_flags trig_flags trig_flags trig_flags trig_flags
10 gamma_cnts gamma_cnts gamma_cnts gamma_cnts gamma_cnts
11 wxm_s2n wxm_s2n wxm_s2n wxm_s2n wxm_s2n
12 sxc_cnts sxc_cnts sxc_cnts sxc_cnts sxc_cnts
13 gamma_time gamma_time gamma_time gamma_time gamma_time
14 wxm_time wxm_time wxm_time wxm_time wxm_time
15 sc_point sc_point sc_point sc_point sc_point
16 - wxra1 wxra1 wxra1 wxra1
17 - wxdec1 wxdec1 wxdec1 wxdec1
18 - wxra2 wxra2 wxra2 wxra1
19 - wxdec2 wxdec2 wxdec2 wxdec2
20 - wxra3 wxra3 wxra3 wxra1
21 - wxdec3 wxdec3 wxdec3 wxdec3
22 - wxra4 wxra4 wxra4 wxra1
23 - wxdec4 wxdec4 wxdec4 wxdec4
24 - wx_errors wx_errors wx_errors wx_errors
25 - wx_dimsig wx_dimsig wx_dimsig wx_dimsig
26 - sxra1 sxra1 sxra1 sxra1
27 - sxdec1 sxdec1 sxdec1 sxdec1
28 - sxra2 sxra2 sxra2 sxra1
29 - sxdec2 sxdec2 sxdec2 sxdec2
30 - sxra3 sxra3 sxra3 sxra1
31 - sxdec3 sxdec3 sxdec3 sxdec3
32 - sxra4 sxra4 sxra4 sxra1
33 - sxdec4 sxdec4 sxdec4 sxdec4
34 - sx_errors sx_errors sx_errors sx_errors
35 - sx_simsig sx_simsig sx_simsig sx_simsig
36 - pos_flags pos_flags pos_flags pos_flags
37 - validity validity validity validity
38 - lc_img_sn lc_img_sn lc_img_sn lc_img_sn
39 pkt_term pkt_term pkt_term pkt_term pkt_term
Type: 45
Loc: GRB_COUNTERPART
0 pkt_type
1 pkt_sernum
2 pkt_hopcnt
3 pkt_sod
4 ref_num
5 burst_tjd
6 burst_sod
7 cp_ra
8 cp_dec
9 cp_inten
10 inten_uncert
11 pos_error
12 filter
13 seeing
14 obs_start_date
15 obs_start_time
16 obs_dur
17 id_conf_level
18 trig_id
19 misc
20 tele_name_c0-3
21 tele_name_c4-7
22 tele_name_c8-11
23 tele_name_c11-15
24 name_c0-3
25 name_c4-7
26 name_...
27 name_...
28 name_...
29 name_...
30 name_...
31 name_...
32 name_...
33 name_...
34 name_...
35 name_...
36 name_...
37 name_...
38 name_c56-59
39 pkt_term
Type: 51 52 53 54 55
Loc: INTEGRAL_ INTEGRAL_ INTEGRAL_ INTEGRAL_ INTEGRAL_
POINTDIR SPIACS WAKEUP REFINED OFFLINE
0 pkt_type pkt_type pkt_type pkt_type pkt_type
1 pkt_sernum pkt_sernum pkt_sernum pkt_sernum pkt_sernum
2 pkt_hopcnt pkt_hopcnt pkt_hopcnt pkt_hopcnt pkt_hopcnt
3 pkt_sod pkt_sod pkt_sod pkt_sod pkt_sod
4 trig_sub_num trig_sub_num trig_sub_num trig_sub_num trig_sub_num
5 slew_tjd burst_tjd burst_tjd burst_tjd burst_tjd
6 slew_sod burst_sod burst_sod burst_sod burst_sod
7 - - burst_ra burst_ra burst_ra
8 - - burst_dec burst_dec burst_dec
9 - det_flags det_flags det_flags det_flags
10 - inten_sigma inten_sigma inten_sigma inten_sigma
11 - - burst_error burst_error burst_error
12 test_mpos test_mpos test_mpos test_mpos test_mpos
13 - time_scale time_scale time_scale time_scale
14 next_sc_ra - sc_ra sc_ra sc_ra
15 next_sc_dec - sc_dec sc_dec sc_dec
16 - time_error time_error time_error time_error
17 - - - - -
18 - - - - -
19 misc_att misc_att misc_att misc_att misc_att
20 - - - - -
21 - - - - -
22 - - - - -
23 - - - - -
24 - - - - -
25 - - - - -
26 - - - - -
27 - - - - -
28 - - - - -
29 - - - - -
30 - - - - -
31 - - - - -
32 - - - - -
33 - - - - -
34 - - - - -
35 - - - - -
36 - - - - -
37 - - - - -
38 - - - - -
39 pkt_term pkt_term pkt_term pkt_term pkt_term
Type: 57 58
Loc: SNEWS MILAGRO
0 pkt_type pkt_type
1 pkt_sernum pkt_sernum
2 pkt_hopcnt pkt_hopcnt
3 pkt_sod pkt_sod
4 trig_num trig_num
5 event_tjd burst_tjd
6 event_sod burst_sod
7 event_ra burst_ra
8 event_dec burst_dec
9 event_signal burst_signal
10 - background
11 event_error burst_error
12 containment significance
13 duration duration
14 - ann_rate
15 - zen_angle
16 - -
17 - -
18 trig_id trig_id
19 misc misc
20 - -
21 - -
22 - -
23 - -
24 - -
25 - -
26 - -
27 - -
28 - -
29 - -
30 - -
31 - -
32 - -
33 - -
34 - -
35 - -
36 - -
37 - -
38 - -
39 pkt_term pkt_term
Type: 59
Loc: KONUS_LC
0 pkt_type
1 pkt_sernum
2 pkt_hopcnt
3 pkt_sod
4 -
5 burst_tjd
6 burst_sod
7 -
8 -
9 -
10 -
11 -
12 -
13 -
14 -
15 -
16 -
17 -
18 -
19 -
20 -
21 -
22 url_c0-3
23 url_c4-7
24 url_c8-11
25 url_...
26 url_...
27 url_...
28 url_...
29 url_...
30 url_...
31 url_...
32 url_...
33 url_...
34 url_...
35 url_...
36 url_...
37 url_...
38 url_c64-67
39 pkt_term
SWIFT PACKETS:
Type: 60 61 62 63 64
Loc: BAT_GRB_ALERT BAT_GRB_POS BAT_GRB_NACK BAT_GRB_LC BAT_SCALEDMAP
0 pkt_type pkt_type pkt_type pkt_type pkt_type
1 pkt_sernum pkt_sernum pkt_sernum pkt_sernum pkt_sernum
2 pkt_hopcnt pkt_hopcnt pkt_hopcnt pkt_hopcnt pkt_hopcnt
3 pkt_sod pkt_sod pkt_sod pkt_sod pkt_sod
4 trig_obs_num trig_obs_num trig_obs_num trig_obs_num trig_obs_num
5 trig_tjd burst_tjd trig_tjd burst_tjd burst_tjd
6 trig_sod burst_sod trig_sod burst_sod burst_sod
7 - burst_ra - burst_ra point_ra
8 - burst_dec - burst_dec point_dec
9 - burst_flue - - -
10 - burst_ipeak - - -
11 - burst_error - - -
12 - phi - phi -
13 - theta - theta -
14 - integ_time integ_time delta_time foregnd_dur
15 - - - integ_time integ_time
16 lon_lat lon_lat lon_lat lon_lat lon_lat
17 trig_index trig_index trig_index trig_index trig_index
18 soln_status soln_status soln_status soln_status soln_status
19 misc misc misc misc misc
20 - image_signif image_signif - -
21 rate_signif rate_signif rate_signif - -
22 - bkg_flue bkg_flue url_c0-3 url_c0-3
23 - bkg_start bkg_start url_c4-7 url_c4-7
24 - bkg_dur bkg_dur url_c8-11 url_c8-11
25 - cat_num - url_... url_...
26 - - - url_... url_...
27 - - - url_... url_...
28 - - - url_... url_...
29 - - - url_... url_...
30 - - - url_... url_...
31 - - - url_... url_...
32 - - - url_... url_...
33 - - - url_... url_...
34 - - - url_... url_...
35 - - - url_... url_...
36 - merit_0-3 merit_0-3 url_... url_...
37 - merit_4-7 merit_4-7 url_... url_...
38 - merit_8-9 merit_8-9 url_c64-67 url_c64-67
39 pkt_term pkt_term pkt_term pkt_term pkt_term
Type: 65 66
Loc: FOM_OBS SC_SLEW
0 pkt_type pkt_type
1 pkt_sernum pkt_sernum
2 pkt_hopcnt pkt_hopcnt
3 pkt_sod pkt_sod
4 trig_obs_num trig_obs_num
5 burst_tjd burst_tjd
6 burst_sod burst_sod
7 burst_ra burst_ra
8 burst_dec burst_dec
9 roll roll
10 lon_lat lon_lat
11 - -
12 - -
13 - wait_time
14 - obs_time
15 integ_time integ_time
16 soln_status soln_status
17 trig_index trig_index
18 at_slew_flags slew_rtn
19 misc misc
20 - -
21 rate_signif rate_signif
22 - bat_mode
23 - xrt_mode
24 - uvot_mode
25 - -
26 - -
27 - -
28 - -
29 - -
30 - -
31 - -
32 - -
33 - -
34 - -
35 - -
36 - -
37 - -
38 merit_value merit_value
39 pkt_term pkt_term
Type: 67 68 69 70 71
Loc: XRT_POS XRT_SPEC XRT_IMAGE XRT_LC XRT_NACK_POS
0 pkt_type pkt_type pkt_type pkt_type pkt_type
1 pkt_sernum pkt_sernum pkt_sernum pkt_sernum pkt_sernum
2 pkt_hopcnt pkt_hopcnt pkt_hopcnt pkt_hopcnt pkt_hopcnt
3 pkt_sod pkt_sod pkt_sod pkt_sod pkt_sod
4 trig_obs_num trig_obs_num trig_obs_num trig_obs_num trig_obs_num
5 data_tjd spec_start_tjd image_start_tjd start_tjd data_tjd
6 data_sod spec_start_sod image_start_sod start_sod data_sod
7 burst_ra bore_ra burst_ra bore_ra point_ra
8 burst_dec bore_dec burst_dec bore_dec point_dec
9 burst_flue livetime centroid_cnt livetime centroid_cnts
10 - spec_stop_tjd - stop_tjd min_count
11 burst_error spec_stop_sod centroid_stddev stop_sod centroid_stddev
12 x_tam_i1 mode centroid_x - sig_max
13 y_tam_i1 waveform centroid_y - -
14 x_tam_i2 bias raw_x - -
15 y_tam_i2 - raw_y - -
16 - - roll - ph2_iter
17 amp_wave - gain/mode/wave - max_iter
18 soln_status - expo_time - err_flag
19 misc misc misc misc misc
20 xrt-bat - grb_in_xrt_y - -
21 det_signif term_cond grb_in_xrt_z term_cond -
22 - url_c0-3 url_c0-3 url_c0-3 -
23 - url_c4-7 url_c4-7 url_c4-7 -
24 - url_... url_... url_... -
25 - url_... url_... url_... -
26 - url_... url_... url_... -
27 - url_... url_... url_... -
28 - url_... url_... url_... -
29 - url_... url_... url_... -
30 - url_... url_... url_... -
31 - url_... url_... url_... -
32 - url_... url_... url_... -
33 - url_... url_... url_... -
34 - url_... url_... url_... -
35 - url_... url_... url_... -
36 - url_... url_... url_... -
37 - url_... url_... url_... -
38 - url_c64-67 url_c64-67 url_c64-67 -
39 pkt_term pkt_term pkt_term pkt_term pkt_term
Type: 72 73
Loc: UVOT_IMAGE UVOT_SRCLIST
0 pkt_type pkt_type
1 pkt_sernum pkt_sernum
2 pkt_hopcnt pkt_hopcnt
3 pkt_sod pkt_sod
4 trig_obs_num trig_obs_num
5 expo_start_tjd expo_start_tjd
6 expo_start_sod expo_start_sod
7 point_ra point_ra
8 point_dec point_dec
9 image_roll image_roll
10 filter filter
11 expo_id bkg_mean
12 x_offset x_max
13 y_offset y_max
14 width n_stars
15 height x_offset
16 xy_grb y_offset
17 n_frames det_thresh
18 swl_lwl photo_thresh
19 misc misc
20 - -
21 - -
22 url_c0-3 url_c0-3
23 url_c4 7 url_c4-7
24 url_... url_...
25 url_... url_...
26 url_... url_...
27 url_... url_...
28 url_... url_...
29 url_... url_...
30 url_... url_...
31 url_... url_...
32 url_... url_...
33 url_... url_...
34 url_... url_...
35 url_... url_...
36 url_... url_...
37 url_... url_...
38 url_c64-67 url_c64-67
39 pkt_term pkt_term
Type: 74 75
Loc: FULL_DATA_INIT FULL_DATA_UPDATE
0 pkt_type pkt_type
1 pkt_sernum pkt_sernum
2 pkt_hopcnt pkt_hopcnt
3 pkt_sod pkt_sod
4 - -
5 - -
6 - -
7 - -
8 - -
9 - -
10 - -
11 - -
12 - -
13 - -
14 - -
15 - -
16 - -
17 - -
18 - -
19 misc misc
20 - -
21 - -
22 url_c0-3 url_c0-3
23 url_c4-7 url_c4-7
24 url_... url_...
25 url_... url_...
26 url_... url_...
27 url_... url_...
28 url_... url_...
29 url_... url_...
30 url_... url_...
31 url_... url_...
32 url_... url_...
33 url_... url_...
34 url_... url_...
35 url_... url_...
36 url_... url_...
37 url_... url_...
38 url_c64-67 url_c64-67
39 pkt_term pkt_term
Type: 76 77 78 79 80
Loc: BAT_PROC_LC XRT_PROC_SPEC XRT_PROC_IMAGE UVOT_PROC_IM UVOT_PROC_SL
0 pkt_type pkt_type pkt_type pkt_type pkt_type
1 pkt_sernum pkt_sernum pkt_sernum pkt_sernum pkt_sernum
2 pkt_hopcnt pkt_hopcnt pkt_hopcnt pkt_hopcnt pkt_hopcnt
3 pkt_sod pkt_sod pkt_sod pkt_sod pkt_sod
4 trig_obs_num trig_obs_num trig_obs_num trig_obs_num trig_obs_num
5 burst_tjd spec_start_tjd image_start_tjd expo_start_tjd expo_start_tjd
6 burst_sod spec_start_sod image_start_sod expo_start_sod expo_start_sod
7 burst_ra bore_ra burst_ra point_ra point_ra
8 burst_dec bore_dec burst_dec point_dec point_dec
9 T90_time burst_flue Centroid_Cnts image_roll image_roll
10 - SpecStopTJD - filter filter
11 - SpecStopSOD CentStdDev expo_id bkg_mean
12 phi mode centroid_x x_offset x_max
13 theta waveform centroid_y y_offset y_max
14 delta_time - raw_x width n_stars
15 integ_time - raw_y height x_offset
16 lon_lat - roll xy_grb y_offset
17 trig_index - gain/mode/wave n_frames det_thresh
18 soln_status - expo_time swl_lwl photo_thresh
19 misc misc misc misc misc
20 - - - - -
21 - - - - -
22 url_c0-3 url_c0-3 url_c0-3 url_c0-3 url_c0-3
23 url_c4-7 url_c4-7 url_c4-7 url_c4-7 url_c4-7
24 url_... url_... url_... url_... url_...
25 url_... url_... url_... url_... url_...
26 url_... url_... url_... url_... url_...
27 url_... url_... url_... url_... url_...
28 url_... url_... url_... url_... url_...
29 url_... url_... url_... url_... url_...
30 url_... url_... url_... url_... url_...
31 url_... url_... url_... url_... url_...
32 url_... url_... url_... url_... url_...
33 url_... url_... url_... url_... url_...
34 url_... url_... url_... url_... url_...
35 url_... url_... url_... url_... url_...
36 url_... url_... url_... url_... url_...
37 url_... url_... url_... url_... url_...
38 url_c64-67 url_c64-67 url_c64-67 url_c64-67 url_c64-67
39 pkt_term pkt_term pkt_term pkt_term pkt_term
Type: 81 82 83 84
Loc: UVOT_POS BAT_GRB_POS_TEST POINTDIR BAT_TRANS
0 pkt_type pkt_type pkt_type pkt_type
1 pkt_sernum pkt_sernum pkt_sernum pkt_sernum
2 pkt_hopcnt pkt_hopcnt pkt_hopcnt pkt_hopcnt
3 pkt_sod pkt_sod pkt_sod pkt_sod
4 trig_obs_num trig_obs_num trig_obs_num trig_obs_num
5 burst_tjd burst_tdj point_tjd trans_tjd
6 burst_sod burst_sod point_sod trans_sod
7 burst_ra burst_ra point_ra trans_ra
8 burst_dec burst_dec point_dec trans_dec
9 burst_mag burst_flue point_roll trans_flue
10 filter burst_ipeak - trans_ipeak
11 burst_error burst_error - trans_error
12 - phi - phi
13 - theta - theta
14 - integ_time obs_time integ_time
15 - - merit_value -
16 - lon_lat lon_lat lon_lat
17 - trig_index - trig_index
18 soln_status soln_status - soln_status
19 misc misc misc misc
20 mag_error image_signif - image_signif
21 - rate_signif - rate_signif
22 - bkg_flue tgt_c0-3 bkg_flue
23 - bkg_start tgt_c4-7 bkg_start
24 - bkg_dur tgt_c8-11 bkg_dur
25 - - tgt_... -
26 - - tgt_... -
27 - - tgt_... -
28 - - tgt_... -
29 - - tgt_... -
30 - - tgt_... -
31 - - tgt_... -
32 - - tgt_... -
33 - - tgt_... -
34 - - tgt_... -
35 - - tgt_... -
36 - merit_0-3 tgt_... merit_0-3
37 - merit_4-7 tgt_... merit_4-7
38 - merit_8-9 tgt_c64-67 merit_8-9
39 pkt_term pkt_term pkt_term pkt_term
Type: 85 86 87 88
Loc: XRT_THRESHPIX XRT_TP_PROC XRT_SPER XRT_SPER_PROC
0 pkt_type pkt_type pkt_type pkt_type
1 pkt_sernum pkt_sernum pkt_sernum pkt_sernum
2 pkt_hopcnt pkt_hopcnt pkt_hopcnt pkt_hopcnt
3 pkt_sod pkt_sod pkt_sod pkt_sod
4 trig_obs_num trig_obs_num trig_obs_num trig_obs_num
5 burst_tjd burst_tdj burst_tjd burst_tjd
6 burst_sod burst_sod burst_sod burst_sod
7 point_ra point_ra point_ra point_ra
8 point_dec point_dec point_dec point_dec
9 expo_time expo_time expo_time expo_time
10 stop_date stop_date stop_date stop_date
11 stop_time stop_time stop_time stop_time
12 seq_num seq_num num_pkt num_pkt
13 - - num_evt num_evt
14 - - - -
15 - - - -
16 - - - -
17 - - - -
18 - - - -
19 misc misc misc misc
20 - - - -
21 - - - -
22 url_c0-3 url_c0-3 url_c0-3 url_c0-3
23 url_c4-7 url_c4-7 url_c4-7 url_c4-7
24 url_... url_... url_... url_...
25 url_... url_... url_... url_...
26 url_... url_... url_... url_...
27 url_... url_... url_... url_...
28 url_... url_... url_... url_...
29 url_... url_... url_... url_...
30 url_... url_... url_... url_...
31 url_... url_... url_... url_...
32 url_... url_... url_... url_...
33 url_... url_... url_... url_...
34 url_... url_... url_... url_...
35 url_... url_... url_... url_...
36 url_... url_... url_... url_...
37 url_... url_... url_... url_...
38 url_c64-67 url_c64-67 url_c64-67 url_c64-67
39 pkt_term pkt_term pkt_term pkt_term
Type: 89
Loc: UVOT_POS_NACK
0 pkt_type
1 pkt_sernum
2 pkt_hopcnt
3 pkt_sod
4 trig_obs_num
5 trig_tjd
6 trig_sod
7 src_ra
8 src_dec
9 mag_lim
10 filter
11 src_error
12 src
13 -
14 -
15 -
16 -
17 -
18 soln_status
19 misc
20 lim_sigma
21 -
22 -
23 -
24 -
25 -
26 -
27 -
28 -
29 -
30 -
31 -
32 -
33 -
34 -
35 -
36 -
37 -
38 -
39 pkt_term
Type: 98 99
Loc: BAT_SUBTHRESHOLD_POS BAT_SLEW_GRB_POS
0 pkt_type pkt_type
1 pkt_sernum pkt_sernum
2 pkt_hopcnt pkt_hopcnt
3 pkt_sod pkt_sod
4 trig_obs_num id_num
5 burst_tjd burst_tjd
6 burst_sod burst_sod
7 burst_ra burst_ra
8 burst_dec burst_dec
9 burst_flue burst_flue
10 burst_ipeak burst_ipeak
11 burst_error burst_error
12 phi -
13 theta -
14 integ_time integ_time
15 - -
16 lon_lat -
17 trig_index trig_index
18 soln_status soln_status
19 misc misc
20 image_signif image_signif
21 rate_signif -
22 bkg_flue -
23 bkg_start -
24 bkg_dur -
25 cat_num -
26 - -
27 - -
28 - -
29 - -
30 - -
31 - -
32 - -
33 - -
34 - -
35 - -
36 merit_0-3 -
37 merit_4-7 -
38 merit_8-9 -
39 pkt_term pkt_term
SuperAGILE PACKETS:
Note: 100=Wakeup, 101=Ground, 102=Refined
Type: 100-102 107 108 109
Loc: SuperAGILE_POS AGILE_POINTDIR SuperAGILE_TRANS SuperAGILE_POS_TEST
0 pkt_type pkt_type pkt_type pkt_type
1 pkt_sernum pkt_sernum pkt_sernum pkt_sernum
2 pkt_hopcnt pkt_hopcnt pkt_hopcnt pkt_hopcnt
3 pkt_sod pkt_sod pkt_sod pkt_sod
4 trig_num - trig_num trig_num
5 burst_tjd curr_tjd trans_tjd burst_tjd
6 burst_sod curr_sod trans_sod burst_sod
7 burst_ra curr_ra trans_ra burst_ra
8 burst_dec curr_dec trans_dec burst_dec
9 burst_intenX - trans_intenX burst_intenX
10 burst_intenY - trans_intenY burst_intenY
11 burst_error - trans_error burst_error
12 - next_tjd - -
13 - next_sod - -
14 - next_ra - -
15 - next_dec - -
16 - - - -
17 - - - -
18 trig_id - trig_id trig_id
19 misc misc misc misc
20 burst_signif - trans_signif burst_signif
21 - - - -
22 - - - -
23 - - - -
24 - - - -
25 - - - -
26 - - - -
27 - - - -
28 - - - -
29 - - - -
30 - - - -
31 - - - -
32 - - - -
33 - - - -
34 - - - -
35 - - - -
36 - - - -
37 - - - -
38 - - - -
39 pkt_term pkt_term pkt_term pkt_term
GLAST PACKETS:
Type: 110 111 112 113 118 119
Loc: GBM_ALERT GBM_POS GBM_UPD GBM_LC GBM_TRANS GBM_POS_TEST
0 pkt_type pkt_type pkt_type pkt_type pkt_type pkt_type
1 pkt_sernum pkt_sernum pkt_sernum pkt_sernum pkt_sernum pkt_sernum
2 pkt_hopcnt pkt_hopcnt pkt_hopcnt pkt_hopcnt pkt_hopcnt pkt_hopcnt
3 pkt_sod pkt_sod pkt_sod pkt_sod pkt_sod pkt_sod
4 trig_num trig_num trig_num trig_num trig_num trig_num
5 burst_tjd burst_tjd burst_tjd burst_tjd trans_tjd burst_tjd
6 burst_sod burst_sod burst_sod burst_sod trans_sod burst_sod
7 - burst_ra burst_ra burst_ra trans_ra burst_ra
8 - burst_dec burst_dec trans_dec trans_dec burst_dec
9 algorithm burst_flue burst_flue ??? trans_flue burst_flue
10 - burst_inten burst_inten ??? trans_inten burst_inten
11 - burst_error burst_error ??? trans_error burst_error
12 - - endday_of_max - - -
13 - - endsod_of_max - - -
14 - integ_time integ_time ??? integ_time integ_time
15 - - - - -
16 - lon_lat - ??? lon_lat lon_lat
17 - trig_index - ??? trig_index trig_index
18 - soln_status - ??? soln_status soln_status
19 misc misc misc ??? misc misc
20 rec_seq_num rec_seq_num rec_seq_num ??? rec_seq_num rec_seq_num
21 - rate_signif - ??? rate_signif rate_signif
22 - loc_algor - ??? loc_algor loc_algor
23 - most_likely - ??? most_likely most_likely
24 - 2most_likely - ??? 2most_likely 2most_likely
25 - - - - - -
26 dets - lo_e - - -
27 - - hi_e - - -
28 - - sc_x - - -
29 - - sc_y - - -
30 - - sc_z - - -
31 - - - - - -
32 - - - - - -
33 - - - - - -
34 - - - - - -
35 - - - - - -
36 - - - - - -
37 - - - - - -
38 - - - - - -
39 pkt_term pkt_term pkt_term pkt_term pkt_term pkt_term
Type: 120 121 122 123 124
Loc: LAT_POS_INI LAT_POS_UPD LAT_POS_DIAG LAT_TRANS LAT_POS_TEST
0 pkt_type pkt_type pkt_type pkt_type pkt_type
1 pkt_sernum pkt_sernum pkt_sernum pkt_sernum pkt_sernum
2 pkt_hopcnt pkt_hopcnt pkt_hopcnt pkt_hopcnt pkt_hopcnt
3 pkt_sod pkt_sod pkt_sod pkt_sod pkt_sod
4 trig_num trig_num trig_num trig_num trig_num
5 burst_tjd burst_tjd burst_tjd trans_tjd burst_tjd
6 burst_sod burst_sod burst_sod trans_sod burst_sod
7 burst_ra burst_ra burst_ra trans_ra burst_ra
8 burst_dec burst_dec burst_dec trans_dec burst_dec
9 tot_inten tot_inten tot_inten tot_inten tot_inten
10 inten_4 inten_4 inten_4 inten_4 inten_4
11 burst_error burst_error burst_error trans_error burst_error
12 phi phi phi phi phi
13 theta theta theta theta theta
14 int_time int_time int_time int_time int_time
15 - - - - -
16 - - - - -
17 trig_index trig_index trig_index trig_index trig_index
18 trig_id trig_id trig_id trig_id trig_id
19 misc misc misc misc misc
20 - - - - -
21 - - - - -
22 - - - - -
23 - - - - -
24 - - - - -
25 rate_signif rate_signif rate_signif rate_signif rate_signif
26 image_signif image_signif image_signif image_signif image_signif
27 - - - - -
28 - - - - -
29 - - - - -
30 - - - - -
31 - - - - -
32 - - - - -
33 - - - - -
34 - - - - -
35 - - - - -
36 - - - - -
37 - - - - -
38 - - - - -
39 pkt_term pkt_term pkt_term pkt_term
Type: 125 126
Loc: GLAST_OBS_REQ GLAST_SC_SLEW
0 pkt_type pkt_type
1 pkt_sernum pkt_sernum
2 pkt_hopcnt pkt_hopcnt
3 pkt_sod pkt_sod
4 trig_num trig_num
5 point_tjd point_tjd
6 point_sod point_sod
7 point_ra point_ra
8 point_dec point_dec
9 - -
10 - -
11 - -
12 - -
13 dwell_time dwell_time
14 - -
15 - -
16 - -
17 - -
18 - -
19 misc misc
20 - -
21 - -
22 - -
23 - -
24 - -
25 - -
26 - -
27 - -
28 - -
29 - -
30 - -
31 - -
32 - -
33 - -
34 - -
35 - -
36 - -
37 - -
38 - -
39 pkt_term pkt_term
Type: 127 128
Loc: LAT_GND_REF LAT_GND_TRIG
0 pkt_type pkt_type
1 pkt_sernum pkt_sernum
2 pkt_hopcnt pkt_hopcnt
3 pkt_sod pkt_sod
4 trig_num trig_num
5 burst_tjd burst_tjd
6 burst_sod burst_sod
7 burst_ra burst_ra
8 burst_dec burst_dec
9 tot_inten tot_inten
10 inten_4 inten_4
11 burst_error burst_error
12 - -
13 - -
14 int_time int_time
15 - -
16 - -
17 trig_index trig_index
18 trig_id trig_id
19 misc misc
20 - -
21 - -
22 - -
23 - -
24 - -
25 - -
26 det_signif det_signif
27 - -
28 - -
29 - -
30 - -
31 - -
32 - -
33 - -
34 - -
35 - -
36 - -
37 - -
38 - -
39 pkt_term pkt_term
Type: 129
Loc: POINTDIR
0 pkt_type
1 pkt_sernum
2 pkt_hopcnt
3 pkt_sod
4 -
5 start_tjd
6 start_sod
7 start_ra
8 start_dec
9 delta_t
10 ra_dec_1t
11 ra_dec_2t
12 ra_dec_3t
13 ra_dec_4t
14 ra_dec_5t
15 ra_dec_6t
16 ra_dec_7t
17 ra_dec_8t
18 ra_dec_9t
19 ra_dec_10t
20 ra_dec_11t
21 ra_dec_12t
22 ra_dec_13t
23 ra_dec_14t
24 ra_dec_15t
25 ra_dec_16t
26 ra_dec_17t
27 ra_dec_18t
28 ra_dec_19t
29 ra_dec_20t
30 ra_dec_21t
31 ra_dec_22t
32 ra_dec_23t
33 ra_dec_24t
34 ra_dec_25t
35 ra_dec_26t
36 ra_dec_27t
37 ra_dec_28t
38 ra_dec_29t
39 pkt_term
Type: 130
Loc: SIMBAD/NED
0 pkt_type
1 pkt_sernum
2 pkt_hopcnt
3 pkt_sod
4 trig_obs_num
5 trig_tjd
6 trig_sod
7 ra
8 dec
9 -
10 -
11 error
12 orig_type
13 -
14 -
15 -
16 -
17 -
18 -
19 -
20 -
21 -
22 fname_c0-3
23 fname_c4-7
24 fname_c8-11
25 ...
26 ...
27 -
28 -
29 -
30 -
31 -
32 -
33 -
34 -
35 -
36 -
37 -
38 -
39 pkt_term
PACKET ITEM MACROS:
Below are the C-language define's for picking out the various elements
of the array of longs that make up the packet. They have names which
reflect the contents of packet types 1, 2, & 3 (for historical reasons).
For the other types, these macros are reusable and for others their names
conote the wrong concept, so straight numerical indices are used in accessing
the packet buffer array. [For the HETE-based packets, a new set of 40 macros
was define'd (see a section towards the end of this document).]
/* Indices into the socket packet array of 40 longs: */
#define PKT_TYPE 0 /* Packet type number */
#define PKT_SERNUM 1 /* Packet serial number */
#define PKT_HOP_CNT 2 /* Packet hop counter */
#define PKT_SOD 3 /* Packet Sec-Of-Day [centi-sec] (sssss.sss*100) */
#define BURST_TRIG 4 /* BATSE Trigger number */
#define BURST_TJD 5 /* Truncated Julian Day */
#define BURST_SOD 6 /* Sec-of-Day [centi-secs] (sssss.sss*100) */
#define BURST_RA 7 /* RA [centi-deg] (0.0 to 359.999 *100) */
#define BURST_DEC 8 /* Dec [centi-deg] (-90.0 to +90.0 *100) */
#define BURST_INTEN 9 /* Intensity [cnts] */
#define BURST_PEAK 10 /* Peak Intensity [cnts/1.024sec] */
#define BURST_ERROR 11 /* Location uncertainty [centi-deg] */
#define SC_AZ 12 /* Burst SC Az [centi-deg] (0.0 to 359.999 *100) */
#define SC_EL 13 /* Burst SC El [centi-deg] (-90.0 to +90.0 *100) */
#define SC_X_RA 14 /* SC X-axis RA [centi-deg] (0.0 to 359.999 *100) */
#define SC_X_DEC 15 /* SC X-axis Dec [centi-deg] (-90.0 to +90.0 *100) */
#define SC_Z_RA 16 /* SC Z-axis RA [centi-deg] (0.0 to 359.999 *100) */
#define SC_Z_DEC 17 /* SC Z-axis Dec [centi-deg] (-90.0 to +90.0 *100) */
#define TRIGGER_ID 18 /* Flag bits that identify the trigger type */
#define MISC 19 /* Misc indicator flag bits */
#define E_SC_AZ 20 /* Earth's center in SC Az */
#define E_SC_EL 21 /* Earth's center in SC El */
#define SC_RADIUS 22 /* Orbital radius of the GRO SC [km] */
#define BURST_T_PEAK 23 /* Time of Peak intensity [centi-sec] (sssss.ss*100) */
#define PKT_SPARE24 24 /* Beginning of spare section */
#define PKT_SPARE38 38 /* End of the spare section */
#define PKT_TERM 39 /* Packet termination character */
#define SIZLBUF 40 /* Number of longwords in socket packet */
TYPE=1 PACKET CONTENTS:
NOTE: Type=1 packets (BATSE_Original) are no longer available (June 2000).
The packet consists of 40 four-byte quantities. The order and contents
are listed in the table below:
Declaration Index Item Units Comments
Type Name
----------- ----- --------- ---------- ----------------
long 0 pkt_type integer Packet type number
long 1 pkt_sernum integer 1 thru infinity
long 2 pkt_hop_cnt integer Incremented by each node
long 3 pkt_sod [centi-sec] (int)(sssss.sss *100)
long 4 burst_trig integer BATSE trigger number
long 5 burst_tjd [days] Truncated Julian Day
long 6 burst_sod [centi-sec] (int)(sssss.sss *100)
long 7 burst_ra [centi-deg] (int)(0.0 to 359.9999 *100)
long 8 burst_dec [centi-deg] (int)(-90.0 to +90.0 *100)
long 9 burst_inten [cnts] Intensity, 0 to infinity
long 10 burst_peak [cnts/1.024s] Peak Intensity, 0 to infinity
long 11 burst_error [centi-deg] (int)(0.0 to 180.0 *100)
long 12 sc_az [centi-deg] (int)(0.0 to 359.9999 *100)
long 13 sc_el [centi-deg] (int)(-90.0 to +90.0 *100)
long 14 sc_x_ra [centi-deg] (int)(0.0 to 359.9999 *100)
long 15 sc_x_dec [centi-deg] (int)(-90.0 to +90.0 *100)
long 16 sc_z_ra [centi-deg] (int)(0.0 to 359.9999 *100)
long 17 sc_z_dec [centi-deg] (int)(-90.0 to +90.0 *100)
long 18 trigger_id bits Trigger identification flags
long 19 misc bits Misc stuff packed in here
long 20 e_sc_az [centi-deg] (int)(0.0 to 359.999 *100)
long 21 e_sc_el [centi-deg] (int)(-90.0 to +90.0 *100)
long 22 sc_radius [km] SC orbital radius
long 23 t_peak [centi-sec] (int)(sssss.sss *100)
long 24 sam_used integer Num samples integrated
long 25-38 spare[14] integer 56 bytes for the future
long 39 pkt_term integer Pkt Termination (always = \n)
PACKET ITEM DESCRIPTIONS for type=1:
The "pkt_type" is an integer with a value of 1, 2 or 3 that tells
which type of packet this is and therefore what the contents are (they change
between the various types). The types are: 1) Real BATSE trigger
initiated notices (GRBs, SFs, PEs, etc), 2) Test trigger notices,
3) Imalive packets. The other types (4, 11, 22, & 24-34) are discussed
in other sections below. And packet types (4-10, 12-21 & 23) never make it
to the outside world -- they are for internal GCN-use only.
The "pkt_sernum" is the serial number for that packet type. Each packet
type has its own sequential serial numbering. They all start from 1 when
the GCN programs start up.
The "pkt_hop_cnt" is a sequential numbering scheme that is incremented by 1
for each machine that the packet passes through (starting from 0 on the
machine of origin -- sometimes PK and sometimes capella). It is used
in checking the hand-shake processing through the PK, CC, & capella machines
within the GCN system.
The "pkt_sod" is UT seconds-of-day when the packet was created/sent from
the machine of origin. Do not confuse this with the burst_sod (see below).
The units are in centi-seconds (ie the fl.pt. seconds were multiplied by 100
and then integerized).
The "burst_trig" is the uniquely identifying serial number assigned by the
on-board BATSE flight software to each trigger. It started with SN=1 just
after launch and is currently (Jun97) in the 6000's.
The "burst_tjd" is the Truncated Julian Day of the BATSE trigger,
eg. TJD=10281 is 17 Jul 96.
The "burst_sod" is the UT seconds-of-day of the BATSE trigger. This is the
spacecraft system clock UT time when the on-board software found a large
enough increase in the countrate (the 5.5-sigma threshold) in two or more
detectors in the selected energy band in any of the 3 sampling time scales
(64, 256, or 1024 msec). It is derived from the spacecraft clock which has
more accuracy, but then is truncated to 10msec level, multiplied by 100,
and converted to a 32-bit integer for the packet.
The "burst_ra" & "burst_dec" are the RA,Dec coordinates of the trigger/burst
as determined by the GCN program (current epoch). These intrinsically
floating point quantities have been multiplied by 100 and then integerized
to make an integer quantity with units of centi-degrees.
The "burst_inten" is actually the integrated fluence of the trigger (burst).
For Original notices, it is just the counts in the first 1.024 or 2.048 sec
of the burst after the time when there was enough counts for GCN to
calculate a direction solution.
The "burst_peak" is the maximum count rate intensity seen in the
trigger (burst). Since there are several time domains in which
the notices are sent, the peak intensity is that so far encountered
in the light curve. For type=1 it is the brightest 1-sec sample
of the 1or2 rate samples used from that Major Frame of telemetry data.
The "burst_error" is the radius of the circle that will contain on average
68% of the bursts. This number is generated from an emperical comparison
to the Huntsville locations from an ensemble of past bursts.
The "sc_az" & "sc_el" are the spacecraft coordinates of the trigger (burst)
as determined by the GCN program. The location in this coordinate system
is useful for the other 3 instruments on the GRO spacecraft (especially
the elevation angle allows the two z-axis instruments to determine if it is
in their FOVs).
The "sc_x_ra", "sc_x_dec", "sc_z_ra", & "sc_z_dec" are the RA,Dec (J2000)
coordinates to which the spacecraft x- & z-axes point. These are the four
quantities needed to turn the spacecraft az,el directions into celestial
coordinates.
The "trigger_id" field contains bit_flags which attempt to identify
the type of transient event that triggered the BATSE instrument.
The bit packing of the "trigger_id" entry in the packet is:
Bit_Number Item_name Description
---------- --------- -----------
0 suspected_grb 0=No or 1=Yes, it is a suspected GRB
1 definite_grb 0=No or 1=Yes, it is definitely a GRB
2 near_sun 0=No or 1=Yes, the direction is near the Sun
3 soft_sf 0=No or 1=Yes, the spectrum is SF soft
4 suspected_pe 0=No or 1=Yes, it is a suspected Particle evt
5 definite_pe 0=No or 1=Yes, it is definitely a Particle evt
6 x_x_x_x_xxx spare
7 definite_unk 0=No or 1=Yes, it is definitely an Unknown
8 earthward 0=No or 1=Yes, the direction is in the Earth cone
9 soft_flag 0=No or 1=Yes, the spectrum is a little soft
10 near_saa 0=No or 1=Yes, the spacecraft location is in SAA
11 definite_saa 0=No or 1=Yes, trigger is definitely SAA related
12 suspected_sf 0=No or 1=Yes, it is a suspected Solar Flare
13 definite_sf 0=No or 1=Yes, it is definitely a Solar Flare
14 op_flag 0=No or 1=Yes, the 2 brightest dets are opposites
15 def_not_grb 0=No or 1=Yes, it is definitely not a GRB
16 iso_pe 0=No or 1=Yes, Datlowe isotropic param is low
17 iso_grb 0=No or 1=Yes, Datlowe isotropic param is high
18 neg_h_ratio 0=No or 1=Yes, the hardness ratio is negative
19 neg_iso_bc 0=No or 1=Yes, Datlowe isotropic param is negative
20 not_soft 0=No or 1=Yes, the hardness ratio is not soft
21 hi_iso_ratio 0=No or 1=Yes, Datlowe iso C3/C2 ratio is high
22 low_inten 0=No or 1=Yes, intensity too small to be a GRB
23-30 spare spare
31 bow 0=No or 1=Yes, it is a Burst OverWrite
These define's are in C-language programs for masking to get the various items
out of "trigger_id":
#define SUSP_GRB 0x00000001 /* Suspected GRB */
#define DEF_GRB 0x00000002 /* Definitely a GRB */
#define NEAR_SUN 0x00000004 /* Coords are near the Sun (<15deg) */
#define SOFT_SF 0x00000008 /* Spectrum is soft, h_ratio > 2.0 */
#define SUSP_PE 0x00000010 /* Suspected Particle Event */
#define DEF_PE 0x00000020 /* Definitely a Particle Event */
#define X_X_X_X_XXX 0x00000040 /* spare */
#define DEF_UNK 0x00000080 /* Definitely an Unknown */
#define EARTHWARD 0x00000100 /* Location towards Earth center */
#define SOFT_FLAG 0x00000200 /* Small hardness ratio (>1.5) */
#define NEAR_SAA 0x00000400 /* It is near/in the SAA region */
#define DEF_SAA 0x00000800 /* Definitely an SAA region */
#define SUSP_SF 0x00001000 /* Suspected Solar Flare */
#define DEF_SF 0x00002000 /* Definitely a Solar Flare */
#define OP_FLAG 0x00004000 /* Op-dets flag set */
#define DEF_NOT_GRB 0x00008000 /* Definitely not a GRB event */
#define ISO_PE 0x00010000 /* Datelowe Iso param is small (PE) */
#define ISO_GRB 0x00020000 /* D-Iso param is large (GRB/SF) */
#define NEG_H_RATIO 0x00040000 /* Negative h_ratio */
#define NEG_ISO_BC 0x00080000 /* Negative iso_part[1] or iso_part[2] */
#define NOT_SOFT 0x00100000 /* Not soft flag, GRB or PE */
#define HI_ISO_RATIO 0x00200000 /* Hi C3/C2 D-Iso ratio */
#define LOW_INTEN 0x00400000 /* Inten too small to be a real GRB */
#define X_X_X_X_XX2 0x7F800000 /* spare */
#define BOW_FLAG 0x80000000 /* Burst OverWrite trigger */
The "misc" field contains various bit_flags, the algorithm level, the
notice type, and the program source-code version numbers.
The bit packing of the "misc" entry in the packet is:
Bit_Number Item_name Description
---------- --------- -----------
0 tm_indicator 0=No_TM, 1=TM_present
1 bad_calc Singular matrix (bad calculation)
2 comptel_fov Position is in COMPTEL FOV
3 egret_fov Position is in EGRET FOV
4 osse_fov Position is in OSSE FOV
5-7 level Program coords calc level [1-4]
8-9 notice_type 0=Original coords notice,
1=Updates coords notice,
2=Delay coords notice,
3=Final coords notice.
10 alex_anti_sun Position is in the Anti-Solar hemisphere (ALEXIS)
11 ipn_peak Passed the IPN Peak Inten Threshold criteria
12 ipn_flue Passed the IPN Fluence Threshold criteria
13 xte_crit Passed the RXTE follow-up criteria
14 xte_type RXTE-PCA_ALERT and RXTE-PCA packet sub-types:
0=RXTE_ALERT_WILL_NOT_OBSERVE
1=RXTE_ALERT_WILL_OBSERVE
0=RXTE_OBS_SAW_NOTHING
1=RXTE_OBS_SAW_SOMETHING
15 no_trig_ind BATSE is not in a triggerable mode
16-27 ver_minor Program version, Minor number [0-2047]
28-31 ver_major Program version, Major number [1-15]
The define's for masking to get the various items out of "misc":
#define TM_IND_MASK 0x00000001 /* TM Indicator mask */
#define BAD_CALC_MASK 0x00000002 /* Singular matrix (bad calculation) */
#define C_FOV_MASK 0x00000004 /* COMPTEL FOV indicator mask */
#define E_FOV_MASK 0x00000008 /* EGRET FOV indicator mask */
#define O_FOV_MASK 0x00000010 /* OSSE FOV indicator mask */
#define PROG_LEV_MASK 0x000000E0 /* Program Algorithm Level mask */
#define NOTICE_TYPE_MASK 0x00000300 /* Notification Type mask */
#define A_ASD_MASK 0x00000400 /* ALEXIS Anti-Solar Dir ind mask */
#define IPN_PEAK_MASK 0x00000800 /* Passed the IPN Peak Inten thresh */
#define IPN_FLUE_MASK 0x00001000 /* Passed the IPN Fluence thresh */
#define XTE_CRITERIA 0x00002000 /* Meets RXTE follow-up criteria */
#define XTE_STATUS 0x00004000 /* Won't/will obs & Didn't/did see */
#define NO_TRIG_MASK 0x00008000 /* BATSE is not in a triggerable mode */
#define VER_MINOR_MASK 0x0FFF0000 /* Program Minor Version Number mask */
#define VER_MAJOR_MASK 0xF0000000 /* Program Major Version Number mask */
The "e_sc_az" & "e_sc_el" are the spacecraft az,el coordinates of the
center of the Earth.
The "sc_radius" is the distance of the spacecraft from the center of the Earth.
The "t_peak" item is the UT seconds-of-day of the time of the peak/maximum
count rate [cnts/1.024sec] seen so far (remember there are a series of notices)
in the trigger/burst light curve. This count rate has been normalized back
to be the true planewave intensity of the burst -- not for any given detector.
The "sam_used" item is the number of 1.024-sec samples of rate data
that went into the accumulation (integration). For type=1 packets it must
be either a 1 or a 2. For type=22 packets it can be a value of 1 to 32.
There are 14 "spare" items in the packet for future growth.
The "pkt_term" is the packet termination character. It is an ASCII
newline (decimal value 10) in the last byte of the last 4-byte long
in the packet. This highly specialized termination character was required
by the firewall machine at LLNL in the very early days of operation.
It has since become a permanent fixture as multiple sites are now operating,
and it is not wise to play with format/content changes. And it still
does function as a fixed-content termination value for validity checking.
TYPE=2 PACKET CONTENTS:
The TEST packet consist of 40 four-byte quantities. The order and contents
are listed in the table below:
Declaration Index Item Units Comments
Type Name
----------- ----- --------- ---------- ----------------
long 0 pkt_type integer Packet type number
long 1 pkt_sernum integer 1 thru infinity
long 2 pkt_hop_cnt integer Incremented by each node
long 3 pkt_sod [centi-sec] (int)(sssss.sss *100)
long 4 burst_trig integer BATSE trigger number
long 5 burst_tjd [days] Truncated Julian Day
long 6 burst_sod [centi-sec] (int)(sssss.sss *100)
long 7 burst_ra [centi-deg] (int)(0.0 to 359.9999 *100)
long 8 burst_dec [centi-deg] (int)(-90.0 to +90.0 *100)
long 9 burst_inten [cnts] Intensity, 0 to infinity
long 10 burst_peak [cnts/1.024s] Peak Intensity, 0 to infinity
long 11 burst_error [centi-deg] (int)(0.0 to 180.0 *100)
long 12 sc_az [centi-deg] (int)(0.0 to 359.9999 *100)
long 13 sc_el [centi-deg] (int)(-90.0 to +90.0 *100)
long 14 sc_x_ra [centi-deg] (int)(0.0 to 359.9999 *100)
long 15 sc_x_dec [centi-deg] (int)(-90.0 to +90.0 *100)
long 16 sc_z_ra [centi-deg] (int)(0.0 to 359.9999 *100)
long 17 sc_z_dec [centi-deg] (int)(-90.0 to +90.0 *100)
long 18 trigger_id bits Trigger identification flags
long 19 misc bits Misc stuff packed in here
long 20 e_sc_az [centi-deg] (int)(0.0 to 359.999 *100)
long 21 e_sc_el [centi-deg] (int)(-90.0 to +90.0 *100)
long 22 sc_radius [km] SC orbital radius
long 23-38 spare[16] integer 64 bytes for the future
long 39 pkt_term integer Pkt Termination (always = \n)
PACKET ITEM DESCRIPTIONS for type=2:
The "pkt_type" is an integer with a value of 1, 2 or 3 that tells
which type of packet this is and therefore what the contents are (they change
between the various types). The types are: 1) Real BATSE trigger
initiated notices (GRBs, SFs, PEs, etc), 2) Test trigger notices,
3) Imalive packets. The other types (4, 11, 22, & 24-34) are discussed
in other sections below. And packet types (4-10, 12-21 & 23) never make it
to the outside world -- they are for internal GCN-use only.
The "pkt_sernum" is the serial number for that packet type. Each packet
type has its own sequential serial numbering. They all start from 1 when
the GCN programs start up.
The "pkt_hop_cnt" is a sequential numbering scheme that is incremented by 1
for each machine that the packet passes through (starting from 0 on the
machine of origin -- sometimes PK and sometimes capella). It is used
in checking the hand-shake processing through the PK, CC, & capella machines
within the GCN system.
The "pkt_sod" is UT seconds-of-day when the packet was created/sent.
Do not confuse this with the burst_sod (see below).
The units are in centi-seconds (ie the fl.pt. seconds were multiplied by 100
and then integerized).
The "burst_trig" is the uniquely identifying serial number assigned by the
on-board BATSE flight software to each trigger. It started with SN=1 just
after launch and is currently (Jun97) in the 6000's. This is always -1
for type=2 packets.
The "burst_tjd" is the Truncated Julian Day of the BATSE trigger,
eg. TJD=10281 is 17 Jul 96.
The "burst_sod" is the UT seconds-of-day of the BATSE trigger. This is the
spacecraft system clock UT time when the on-board software found a large
enough increase in the countrate (the 5.5-sigma threshold) in two or more
detectors in the selected energy band in any of the 3 sampling time scales
(64, 256, or 1024 msec). It is derived from the spacecraft clock which has
more accuracy, but then is truncated to 10msec level, multiplied by 100,
and converted to a 32-bit integer for the packet.
The "burst_ra" & "burst_dec" are the RA,Dec coordinates of the trigger/burst
as determined by the GCN program (current epoch). These intrinsically
floating point quantities have been multiplied by 100 and then integerized
to make an integer quantity with units of centi-degrees.
The "burst_inten" is set to 1000 cnts/sec for Test Notices.
The "burst_peak" is set to 1000 cnts/sec for Test Notices.
The "burst_error" is the radius of the circle that will contain on average
68% of the bursts. This number is generated from an emperical comparison
to the Huntsville locations from an ensemble of past bursts.
The "trigger_id" field contains bit_flags which attempt to identify
the type of transient event that triggered the BATSE instrument.
The bit packing of the "trigger_id" entry in the packet is:
Bit_Number Item_name Description
---------- --------- -----------
0 suspected_grb 0=No or 1=Yes, it is a suspected GRB
1 definite_grb 0=No or 1=Yes, it is definitely a GRB
2 near_sun 0=No or 1=Yes, the direction is near the Sun
3 soft_sf 0=No or 1=Yes, the spectrum is SF soft
4 suspected_pe 0=No or 1=Yes, it is a suspected Particle evt
5 definite_pe 0=No or 1=Yes, it is definitely a Particle evt
6 x_x_x_x_xxx spare
7 definite_unk 0=No or 1=Yes, it is definitely an Unknown
8 earthward 0=No or 1=Yes, the direction is in the Earth cone
9 soft_flag 0=No or 1=Yes, the spectrum is a little soft
10 near_saa 0=No or 1=Yes, the spacecraft location is in SAA
11 definite_saa 0=No or 1=Yes, trigger is definitely SAA related
12 suspected_sf 0=No or 1=Yes, it is a suspected Solar Flare
13 definite_sf 0=No or 1=Yes, it is definitely a Solar Flare
14 op_flag 0=No or 1=Yes, the 2 brightest dets are opposites
15 def_not_grb 0=No or 1=Yes, it is definitely not a GRB
16 iso_pe 0=No or 1=Yes, Datlowe isotropic param is low
17 iso_grb 0=No or 1=Yes, Datlowe isotropic param is high
18 neg_h_ratio 0=No or 1=Yes, the hardness ratio is negative
19 neg_iso_bc 0=No or 1=Yes, Datlowe isotropic param is negative
20 not_soft 0=No or 1=Yes, the hardness ratio is not soft
21 hi_iso_ratio 0=No or 1=Yes, Datlowe iso C3/C2 ratio is high
22 low_inten 0=No or 1=Yes, intensity too small to be a GRB
23-30 spare spare
31 bow 0=No or 1=Yes, it is a Burst OverWrite
These define's are in C-language programs for masking to get the various items
out of "trigger_id":
#define SUSP_GRB 0x00000001 /* Suspected GRB */
#define DEF_GRB 0x00000002 /* Definitely a GRB */
#define NEAR_SUN 0x00000004 /* Coords are near the Sun (<15deg) */
#define SOFT_SF 0x00000008 /* Spectrum is soft, h_ratio > 2.0 */
#define SUSP_PE 0x00000010 /* Suspected Particle Event */
#define DEF_PE 0x00000020 /* Definitely a Particle Event */
#define X_X_X_X_XXX 0x00000040 /* spare */
#define DEF_UNK 0x00000080 /* Definitely an Unknown */
#define EARTHWARD 0x00000100 /* Location towards Earth center */
#define SOFT_FLAG 0x00000200 /* Small hardness ratio (>1.5) */
#define NEAR_SAA 0x00000400 /* It is near/in the SAA region */
#define DEF_SAA 0x00000800 /* Definitely an SAA region */
#define SUSP_SF 0x00001000 /* Suspected Solar Flare */
#define DEF_SF 0x00002000 /* Definitely a Solar Flare */
#define OP_FLAG 0x00004000 /* Op-dets flag set */
#define DEF_NOT_GRB 0x00008000 /* Definitely not a GRB event */
#define ISO_PE 0x00010000 /* Datelowe Iso param is small (PE) */
#define ISO_GRB 0x00020000 /* D-Iso param is large (GRB/SF) */
#define NEG_H_RATIO 0x00040000 /* Negative h_ratio */
#define NEG_ISO_BC 0x00080000 /* Negative iso_part[1] or iso_part[2]*/
#define NOT_SOFT 0x00100000 /* Not soft flag, GRB or PE */
#define HI_ISO_RATIO 0x00200000 /* Hi C3/C2 D-Iso ratio */
#define LOW_INTEN 0x00400000 /* Inten too small to be a real GRB */
#define X_X_X_X_XX2 0x7F800000 /* spare */
#define BOW_FLAG 0x80000000 /* Burst OverWrite trigger */
The "misc" field contains various bit_flags, the algorithm level, the
notice type, and the program source-code version numbers.
The bit packing of the "misc" entry in the packet is:
Bit_Number Item_name Description
---------- --------- -----------
0 tm_indicator 0=No_TM, 1=TM_present
1 bad_calc Singular matrix (bad calculation)
2 comptel_fov Position is in COMPTEL FOV
3 egret_fov Position is in EGRET FOV
4 osse_fov Position is in OSSE FOV
5-7 level Program coords calc level [1-4]
8-9 notice_type 0=Original coords notice,
1=Updates coords notice,
2=Delay coords notice,
3=Final coords notice.
10 alex_anti_sun Position is in the Anti-Solar hemisphere (ALEXIS)
11 ipn_peak Passed the IPN Peak Inten Threshold criteria
12 ipn_flue Passed the IPN Fluence Threshold criteria
13 xte_crit Passed the RXTE follow-up criteria
14 xte_type RXTE-PCA_ALERT and RXTE-PCA packet sub-types:
0=RXTE_ALERT_WILL_NOT_OBSERVE
1=RXTE_ALERT_WILL_OBSERVE
0=RXTE_OBS_SAW_NOTHING
1=RXTE_OBS_SAW_SOMETHING
15 no_trig_ind BATSE is not in a triggerable mode
16-27 ver_minor Program version, Minor number [0-2047]
28-31 ver_major Program version, Major number [1-15]
The define's for masking to get the various items out of "misc":
#define TM_IND_MASK 0x00000001 /* TM Indicator mask */
#define BAD_CALC_MASK 0x00000002 /* Singular matrix (bad calculation) */
#define C_FOV_MASK 0x00000004 /* COMPTEL FOV indicator mask */
#define E_FOV_MASK 0x00000008 /* EGRET FOV indicator mask */
#define O_FOV_MASK 0x00000010 /* OSSE FOV indicator mask */
#define PROG_LEV_MASK 0x000000E0 /* Program Algorithm Level mask */
#define NOTICE_TYPE_MASK 0x00000300 /* Notification Type mask */
#define A_ASD_MASK 0x00000400 /* ALEXIS Anti-Solar Dir ind mask */
#define IPN_PEAK_MASK 0x00000800 /* Passed the IPN Peak Inten thresh */
#define IPN_FLUE_MASK 0x00001000 /* Passed the IPN Fluence thresh */
#define XTE_CRITERIA 0x00002000 /* Meets RXTE follow-up criteria */
#define XTE_STATUS 0x00004000 /* Won't/will obs & Didn't/did see */
#define NO_TRIG_MASK 0x00008000 /* BATSE is not in a triggerable mode */
#define VER_MINOR_MASK 0x0FFF0000 /* Program Minor Version Number mask */
#define VER_MAJOR_MASK 0xF0000000 /* Program Major Version Number mask */
There are 16 "spare" items in the packet for future growth.
The "pkt_term" is the packet termination character. It is an ASCII
newline (decimal value 10) in the last byte of the last 4-byte long
in the packet. This highly specialized termination character was required
by the firewall machine at LLNL in the very early days of operation.
It has since become a permanent fixture as multiple sites are now operating,
and it is not wise to play with format/content changes. And it still
does function as a fixed-content termination value for validity checking.
TYPE=3 PACKET CONTENTS:
The IMALIVE packet consists of 40 four-byte quantities. The order and contents
are listed in the table below:
Declaration Index Item Units Comments
Type Name
----------- ----- --------- ---------- ----------------
long 0 pkt_type integer Packet type number
long 1 pkt_sernum integer 1 thru infinity
long 2 pkt_hop_cnt integer Incremented by each node
long 3 pkt_sod [centi-sec] (int)(sssss.sss *100)
long 4 spare integer 4 bytes for the future
long 5 burst_tjd [days] Truncated Julian Day
long 6 burst_sod [centi-sec] (int)(sssss.sss *100)
long 7-38 spare[32] integer 128 bytes for the future
long 39 pkt_term integer Pkt Termination (always = \n)
PACKET ITEM DESCRIPTIONS for type=3:
The "pkt_type" is an integer with a value of 1, 2 or 3 that tells
which type of packet this is and therefore what the contents are (they change
between the various types). The types are: 1) Real BATSE trigger
initiated notices (GRBs, SFs, PEs, etc), 2) Test trigger notices,
3) Imalive packets. The other types (4, 11, 22, & 24-34) are discussed
in other sections below. And packet types (4-10, 12-21 & 23) never make it
to the outside world -- they are for internal GCN-use only.
The "pkt_sernum" is the serial number for that packet type. Each packet
type has its own sequential serial numbering. They all start from 1 when
the GCN programs start up.
The "pkt_hop_cnt" is a sequential numbering scheme that is incremented by 1
for each machine that the packet passes through (starting from 0 on the
machine of origin -- sometimes PK and sometimes capella). It is used
in checking the hand-shake processing through the PK, CC, & capella machines
within the GCN system.
The "pkt_sod" is UT seconds-of-day when the packet was created/sent.
The units are in centi-seconds (ie the fl.pt. seconds were multiplied by 100
and then integerized).
The "burst_tjd" is the Truncated Julian Day when this packet was formed.
eg. TJD=10281 is 17 Jul 96. Since this is an "imalive" packet, the "burst"
aspect of this is meaningless. It is filled because the filtering code
needs to have this field to work for all packet types.
The "burst_sod" is the UT seconds-of-day when this packet was formed.
It is identical in value to the "pkt_sod" field.
The units are in centi-seconds (ie the fl.pt. seconds were multiplied by 100
and then integerized). Since this is an "imalive" packet, the "burst" aspect
of this is meaningless. It is filled because the filtering code needs to have
this field to work for all packet types.
There are 32 "spare" items in the packet for future growth.
The "pkt_term" is the packet termination character. It is an ASCII
newline (decimal value 10) in the last byte of the last 4-byte long
in the packet. This highly specialized termination character was required
by the firewall machine at LLNL in the very early days of operation.
It has since become a permanent fixture as multiple sites are now operating,
and it is not wise to play with format/content changes. And it still
does function as a fixed-content termination value for validity checking.
TYPE=4 PACKET CONTENTS:
The KILL packet consists of 40 four-byte quantities. It is used to send a
signal the site-end of the socket connection that GCN is going to close
the connection immediately (within milliseconds). This is the only socket
packet that is never echo-ed back to the GCN system. The order and contents
are listed in the table below. They have the same function, meaning, and
content as the items of the same name in the previous packet types (1-3).
Declaration Index Item Units Comments
Type Name
----------- ----- --------- ---------- ----------------
long 0 pkt_type integer Packet type number (=4)
long 1 pkt_sernum integer 1 thru infinity
long 2 pkt_hop_cnt integer Incremented by each node
long 3 pkt_sod [centi-sec] (int)(sssss.sss *100)
long 4-38 spare[35] integer 140 bytes for the future
long 39 pkt_term integer Pkt Termination (always = \n)
TYPE=11 PACKET CONTENTS:
NOTE: This Type=11 (BATSE_MAXBC) is no longer available.
The MAXBC packet consists of 40 four-byte quantities. The order and contents
are listed in the table below:
Declaration Index Item Units Comments
Type Name
----------- ----- --------- ---------- ----------------
long 0 pkt_type integer Packet type number (=11)
long 1 pkt_sernum integer 1 thru infinity
long 2 pkt_hop_cnt integer Incremented by each node
long 3 pkt_sod [centi-sec] (int)(sssss.sss *100)
long 4 burst_trig integer BATSE trigger number
long 5 burst_tjd [days] Truncated Julian Day
long 6 burst_sod [centi-sec] (int)(sssss.sss *100)
long 7 burst_ra [centi-deg] (int)(0.0 to 359.9999 *100)
long 8 burst_dec [centi-deg] (int)(-90.0 to +90.0 *100)
long 9 burst_inten [cnts] Linear scale, 0 to infinity
long 10 burst_peak [cnts/1.024s] Linear scale, 0 to infinity
long 11 burst_error [centi-deg] (int)(0.0 to 180.0 *100)
long 12 sc_az [centi-deg] (int)(0.0 to 359.9999 *100)
long 13 sc_el [centi-deg] (int)(-90.0 to +90.0 *100)
long 14 sc_x_ra [centi-deg] (int)(0.0 to 359.9999 *100)
long 15 sc_x_dec [centi-deg] (int)(-90.0 to +90.0 *100)
long 16 sc_z_ra [centi-deg] (int)(0.0 to 359.9999 *100)
long 17 sc_z_dec [centi-deg] (int)(-90.0 to +90.0 *100)
long 18 trigger_id integer Trigger identification flags
long 19 misc integer Misc stuff packed in here
long 20 e_sc_az [centi-deg] (int)(0.0 to 359.999 *100)
long 21 e_sc_el [centi-deg] (int)(-90.0 to +90.0 *100)
long 22 sc_radius [km] SC orbital radius
long 23 maxc1[0] [cnts/64mSec] Linear scale, 0 to infinity
long 24 maxc1[1] [cnts/64mSec] Linear scale, 0 to infinity
long 25 maxc1[2] [cnts/64mSec] Linear scale, 0 to infinity
long 26 maxc1[3] [cnts/64mSec] Linear scale, 0 to infinity
long 27 maxc1[4] [cnts/64mSec] Linear scale, 0 to infinity
long 28 maxc1[5] [cnts/64mSec] Linear scale, 0 to infinity
long 29 maxc1[6] [cnts/64mSec] Linear scale, 0 to infinity
long 30 maxc1[7] [cnts/64mSec] Linear scale, 0 to infinity
long 31 maxbc[0] [cnts/64mSec] Linear scale, 0 to infinity
long 32 maxbc[1] [cnts/64mSec] Linear scale, 0 to infinity
long 33 maxbc[2] [cnts/64mSec] Linear scale, 0 to infinity
long 34 maxbc[3] [cnts/64mSec] Linear scale, 0 to infinity
long 35 maxbc[4] [cnts/64mSec] Linear scale, 0 to infinity
long 36 maxbc[5] [cnts/64mSec] Linear scale, 0 to infinity
long 37 maxbc[6] [cnts/64mSec] Linear scale, 0 to infinity
long 38 maxbc[7] [cnts/64mSec] Linear scale, 0 to infinity
long 39 pkt_term integer Pkt Termination (always = \n)
PACKET ITEM DESCRIPTIONS (only those unique to type=11):
The 8 "maxc1[i]" and the 8 "maxbc[i]" are the 16 maximum (bkg subtracted) rates
[cnts/64mSec] as determined by the BATSE flight software during the 0-10
minutes after the initial trigger. The index "i" runs from 0 to 7 for the 8
LADs. The "c1" refers to the C1 DISCLA channel (~20-50 keV). The "bc" refers
to the "burst channels" which is most of the time set to the two middle
DISCLA channels (50-100-300 keV).
TYPE=21 PACKET CONTENTS/DESCRIPTION:
NOTE: This Type=11 (Bradford) is no longer available.
The format and content of this BRAD_COORDS packet is identical to the
Test Coords packet (type=2). The only difference is that the values
for the test RA,Dec locations are different than the set used for type=2.
The Bradford telescope system needed a different set of locations than
the generic set, so a separate packet type was defined and this different type
allowed the necessary filtering differences between the Bradford site
and the rest of the GCN sites.
TYPE=22 PACKET CONTENTS/DESCRIPTION:
NOTE: This Type=22 (BATSE_Final) is no longer available.
The format and content of this FINAL packet is identical to the ORIGINAL
(type=1) with the one exception: that the "inten" is now a fluence value
for the number of "sam_used" values that went into the integration
of the burst light curve.
TYPE=24 PACKET CONTENTS/DESCRIPTION:
NOTE: This Type=24 (BATSE_LOCBURST) is no longer available.
The format and content of this LOCBURST packet is identical to the
GRB Coords packet (type=1). The major difference is that the values
of the RA,Dec location are calculated using the LOCBURST algorithm
instead of the ideal-physics and are, therefore, more accurate.
The "t_peak" value at location index=23 is undefined for this packet type.
TYPE=25 PACKET CONTENTS:
The ALEXIS packet consists of 40 four-byte quantities. The order and contents
are listed in the table below:
Declaration Index Item Units Comments
Type Name
----------- ----- --------- ---------- ----------------
long 0 pkt_type integer Packet type number (=25)
long 1 pkt_sernum integer 1 thru infinity
long 2 pkt_hop_cnt integer Incremented by each node
long 3 pkt_sod [centi-sec] (int)(sssss.sss *100)
long 4 src_num integer ALEXIS source number
long 5 trans_tjd [days] Truncated Julian Day
long 6 trans_sod [centi-sec] (int)(sssss.sss *100)
long 7 trans_ra [centi-deg] (int)(0.0 to 359.9999 *100)
long 8 trans_dec [centi-deg] (int)(-90.0 to +90.0 *100)
long 9-10 spare[2] integer Unused at this point
long 11 trans_error [centi-deg] (int)(0.0 to 180.0 *100)
long 12-22 spare[11] integer Unused at this point
long 22 trans_alpha integer (int)(alpha *100)
long 23 map_dur integer Always 12, 24, or 48
long 24 tele_id integer Always 1, 2, 3, 4, 5, or 6
long 25-38 spare[14] integer 56 bytes for the future
long 39 pkt_term integer Pkt Termination (always = \n)
PACKET ITEM DESCRIPTIONS (only those unique to type=25):
Only the packet items that are different than the type=1,2,3 packet contents
are listed below. The standard packet items are described and defined
in the above sections.
The "src_num" is the uniquely identifying number assigned by the ground
ALEXIS data processing software to each identified source. It starts with 1
for each processing run and progresses upwards (typically 0-20 sources
are identified each 12-hr run).
The "trans_tjd" is the Truncated Julian Day of the ALEXIS source,
eg. TJD=10281 is 17 Jul 96. It is the TJD of the ending date/time stamp
of the map accumulation in which the transient was found.
The "trans_sod" is the UT seconds-of-day of the ALEXIS source. It is the
SOD of the ending date/time stamp of the map accumulation in which the
transient was found. While the units are centi-seconds, the value is always
a whole second. The use of centi-seconds maintains the format/precission
that is used throughout all the packets.
The "trans_ra" & "trans_dec" are the RA,Dec coordinates of the transient
as determined by the ALEXIS batch processing analysis program (current epoch).
The units are centi-degrees.
The "trans_error" is the 3-sigma radius of the error circle. It contains
the sum of the statistical and systematic errors. This number is derived
from a comparison of the known location of the HZ 43 object and the
instrument's determination.
The "trans_alpha" is the -log10(probability_of_false_detection). The alpha
parameter is only the statistical significance of the detection, or put another
way, -log10 of the probability that the source could be a natural fluctuation
above a Poisson background.
The "map_duration" is the amount of data (the last 12, 24, or 48 hours)
that went into the accumulation that the transient was found. The ALEXIS
processing uses three different time scales as a tradeoff between transient
duration and sensitivity. This integer has only the 12, 24, or 48 numeric
values -- all other values are invalid.
The "tele_id" is the telescope that the transient was detected in. This is
an integer with only 1 through 6 as the valid values for the six detectors.
The telescope names and energy bandpasses are: 1="1A 93eV", 2="1B 70eV",
3="2A 93eV", 4="2B 66eV", 5="3A 70eV", 6="3B 66eV". (Telescopes 1 & 2
are co-aligned on ALEXIS, as are telescopes 3 & 4, and telescopes 5 & 6.)
TYPE=26 PACKET CONTENTS:
The RXTE-PCA_ALERT packet consist of 40 four-byte quantities. The order and
contents are listed in the table below:
Declaration Index Item Units Comments
Type Name
----------- ----- --------- ---------- ----------------
long 0 pkt_type integer Packet type number
long 1 pkt_sernum integer 1 thru infinity
long 2 pkt_hop_cnt integer Incremented by each node
long 3 pkt_sod [centi-sec] (int)(sssss.sss *100)
long 4 burst_trig integer BATSE trigger number
long 5 burst_tjd [days] Truncated Julian Day
long 6 burst_sod [centi-sec] (int)(sssss.sss *100)
long 7 locburst_ra [10^-4-deg] (int)(0.0 to 359.9999 *10000)
long 8 locburst_dec [10^-4-deg] (int)(-90.0 to +90.0 *10000)
long 9-18 spare[10] integer 40 bytes for the future
long 19 misc integer Misc stuff packed in here
long 20-23 spare[4] integer 16 bytes for the future
long 24 obs_tjd integer Observation start TJD
long 25 obs_sod integer (int)(sssss.ss *100)
long 26-38 spare[19] integer 76 bytes for the future
long 39 pkt_term integer Pkt Termination (always = \n)
PACKET ITEM DESCRIPTIONS (only those unique to type=26):
For the type=26 (PCA ALERT) packets, the normal burst_ra/_dec locations
contain the LOCBURST RA/Dec location. This allows the potential follow-up
observer to make tentative observing plans based approximate LOCBURST location
on the sky.
The "misc" field contains various bit_flags (see the section for types=1,2,3
for the definition of all the normal bits), and for the specialty bits
for type=26 (see the partial table below):
Bit_Number Item_name Description
---------- --------- -----------
13 xte_crit Passed the RXTE-PCA follow-up criteria
14 xte_type RXTE-PCA_ALERT packet sub-types:
0=RXTE_ALERT_WILL_NOT_OBSERVE
1=RXTE_ALERT_WILL_OBSERVE
The define's for masking to get the various items out of "misc":
#define XTE_CRITERIA 0x00002000 /* Meets RXTE-PCA follow-up criteria */
#define XTE_STATUS 0x00004000 /* Won't/will observe */
The "obs_tjd" and "obs_sod" fields are the Truncated Julian Day and
Seconds-of_day for the start of the RXTE-PCA observation. Putting this
timestamp in the ALERT notice allows the follow-up observer to know
when the RXTE-PCA observation is planned and about when the RXTE-PCA coordinates
will become available.
TYPE=27 PACKET CONTENTS:
The RXTE-PCA GRB coordinates packet consist of 40 four-byte quantities.
The order and contents are listed in the table below:
Declaration Index Item Units Comments
Type Name
----------- ----- --------- ---------- ----------------
long 0 pkt_type integer Packet type number
long 1 pkt_sernum integer 1 thru infinity
long 2 pkt_hop_cnt integer Incremented by each node
long 3 pkt_sod [centi-sec] (int)(sssss.sss *100)
long 4 burst_trig integer BATSE trigger number
long 5 burst_tjd [days] Truncated Julian Day
long 6 burst_sod [centi-sec] (int)(sssss.sss *100)
long 7 burst_ra [10^-4-deg] (int)(0.0 to 359.9999 *10000)
long 8 burst_dec [10^-4-deg] (int)(-90.0 to +90.0 *10000)
long 9 burst_inten [mCrab] Linear scale, 0 to infinity
long 10 spare integer spare
long 11 burst_error [10^-4-deg] (int)(0.0 to 180.0 *10000)
long 12-18 spare[7] integer 28 bytes for the future
long 19 misc integer Misc stuff packed in here
long 20-38 spare[19] integer 76 bytes for the future
long 39 pkt_term integer Pkt Termination (always = \n)
PACKET ITEM DESCRIPTIONS (only those unique to type=27):
The "burst_ra" & "burst_dec" are the RA,Dec coordinates of the burst
(current epoch). These intrinsically floating point quantities have been
multiplied by 10000 and then integerized to make an integer quantity
with units of 0.0001-degrees.
The "burst_inten" is slightly different than the burst_inten used in type=1.
It is units of mCrab (instead of the counts/sec).
The "misc" field contains various bit_flags (see the section for types=1,2,3
for the definition of all the normal bits), and for the specialty bits
for type=27 (see the partial table below):
Bit_Number Item_name Description
---------- --------- -----------
13 xte_crit Passed the RXTE-PCA follow-up criteria
14 xte_type RXTE-PCA packet sub-types:
0=RXTE_OBS_SAW_NOTHING
1=RXTE_OBS_SAW_SOMETHING
The define's for masking to get the various items out of "misc":
#define XTE_CRITERIA 0x00002000 /* Meets RXTE-PCA follow-up criteria */
#define XTE_STATUS 0x00004000 /* Didn't/did see a source */
TYPE=28 PACKET CONTENTS:
The packet for the RXTE-ASM ALERT notice has not been finalized yet.
TYPE=29 PACKET CONTENTS:
The RXTE-ASM GRB coordinates packet consist of 40 four-byte quantities.
The order and contents are listed in the table below:
Declaration Index Item Units Comments
Type Name
----------- ----- --------- ---------- ----------------
long 0 pkt_type integer Packet type number
long 1 pkt_sernum integer 1 thru infinity
long 2 pkt_hop_cnt integer Incremented by each node
long 3 pkt_sod [centi-sec] (int)(sssss.sss *100)
long 4 burst_trig integer BATSE trigger number
long 5 burst_tjd [days] Truncated Julian Day
long 6 burst_sod [centi-sec] (int)(sssss.sss *100)
long 7 burst_ra [10^-4-deg] (int)(0.0 to 359.9999 *10000)
long 8 burst_dec [10^-4-deg] (int)(-90.0 to +90.0 *10000)
long 9 burst_inten [mCrab] Linear scale, 0 to infinity
long 10 spare integer spare
long 11 burst_error [10^-4-deg] (int)(0.0 to 180.0 *10000)
long 12 burst_conf [10^-2] (int)(0.0 to 100.0 *100)
long 13-18 spare[6] integer 24 bytes for the future
long 19 misc integer Misc stuff packed in here
long 20-23 spare[4] integer 16 bytes for the future
long 24 err_ra1 [10^-4-deg] (int)(0.0 to 359.9999 *10000)
long 25 err_dec1 [10^-4-deg] (int)(-90.0 to +90.0 *10000)
long 26 err_ra2 [10^-4-deg] (int)(0.0 to 359.9999 *10000)
long 27 err_dec2 [10^-4-deg] (int)(-90.0 to +90.0 *10000)
long 28 err_ra3 [10^-4-deg] (int)(0.0 to 359.9999 *10000)
long 29 err_dec3 [10^-4-deg] (int)(-90.0 to +90.0 *10000)
long 30 err_ra4 [10^-4-deg] (int)(0.0 to 359.9999 *10000)
long 31 err_dec4 [10^-4-deg] (int)(-90.0 to +90.0 *10000)
long 32 length [10^-4-deg] (int)(0.0 to 180.0 *10000)
long 33 width [10^-4-deg] (int)(0.0 to 180.0 *10000)
long 34 pos_angle [10^-4-deg] (int)(0.0 to 360.0 *10000)
long 35-38 spare[4] integer 16 bytes for the future
long 39 pkt_term integer Pkt Termination (always = \n)
PACKET ITEM DESCRIPTIONS (only those unique to type=29):
The "burst_ra" & "burst_dec" are the RA,Dec coordinates of the burst
(current epoch). These intrinsically floating point quantities have been
multiplied by 10000 and then integerized to make an integer quantity
with units of 0.0001-degrees.
The "burst_inten" is slightly different than the burst_inten used in type=1.
It is units of mCrab (instead of the counts/sec).
The "misc" field contains various bit_flags (see the section for type=1,2,3
for the definition of all the normal bits), and for the specialty bits
for type=32 (see the partial table below):
Bit_Number Item_name Description
---------- --------- -----------
8-9 notice_type 0=Initial coords notice,
1=Updates coords notice,
3=Final coords notice.
14 box_v_line RXTE-ASM error box sub-types:
0=line
1=box
The define's for masking to get the various items out of "misc":
#define NOTICE_TYPE_MASK 0x00000300 /* Notification Type mask */
The "burst_error" is the radius of a circle which circumscribes the error
box (diamond-shaped). It is decimal degrees and is for the "burst_cont"
containment (statistical + systematic).
The "burst_cont" is the confidence containment percentage for the quoted
burst_error value. It is stored in the packet in centi-percentage
(e.g. 98.5% would be an integer value of 9850).
The "err_ra1" & "err_dec1" are the RA,Dec coordinates for the 1st corner
of the error box. Ditto for "2", "3", and "4" for the second, third, and
fourth corners, respectively. (These fields are valid when the error box
is type "box".) Note that these RA,Dec values are J2000 epoch, whereas the
RA,Dec of the center of the box is in Current epoch. The use of different
epochs is, admittedly, ugly, but is due to historical/evolutionary aspects
that are way too lengthy and of little practical importance to explain here.
The "length" is the length of the error box when the error box is type "line".
The "width" is the width of the error box when the error box is type "line".
The "pos_angle" is the position angle of the error box when the error box
is type "line". It is measured eastward from north.
================================================================================
TYPE=30 PACKET CONTENTS:
NOTE: Type=30 (COMPTEL) is no longer available (since CGRO was de-orbitted).
{Note that the RA,Dec of the center are in J2000 epoch, and not
in the rest-of-the-program standard Current epoch. The corners
of the error box are in the J2000 epoch.}
================================================================================
TYPE=31 PACKET CONTENTS:
The packet for the IPN_RAW notice has not been finalized yet.
TYPE=32 PACKET CONTENTS:
NOTE: Type=32 (IPN_SEGMENT) is no longer available (since it part of the
input to this type was the BATSE position).
The IPN_SEGMENT packet consists of 40 four-byte quantities. The order and
contents are listed in the table below:
Declaration Index Item Units Comments
Type Name
----------- ----- --------- ---------- ----------------
long 0 pkt_type integer Packet type number (=31)
long 1 pkt_sernum integer 1 thru infinity
long 2 pkt_hop_cnt integer Incremented by each node
long 3 pkt_sod [centi-sec] (int)(sssss.sss *100)
long 4 burst_trig integer BATSE trigger number
long 5 burst_tjd [days] Truncated Julian Day
long 6 burst_sod [centi-sec] (int)(sssss.sss *100)
long 7 ipn_c_ra [10^-4-deg] (int)(0.0 to 359.9999 *10000)
long 8 ipn_c_dec [10^-4-deg] (int)(-90.0 to +90.0 *10000)
long 9 ipn_radius [10^-4-deg] (int)(0.0 to +90.0 *10000)
long 10 ipn_width [10^-4-deg] (int)(0.0 to +90.0 *10000)
long 11 3sig_ra [10^-4-deg] (int)(0.0 to 360.0 *10000)
long 12 3sig_dec [10^-4-deg] (int)(-90.0 to +90.0 *10000)
long 13 2sig_ra [10^-4-deg] (int)(0.0 to 360.0 *10000)
long 14 2sig_dec [10^-4-deg] (int)(-90.0 to +90.0 *10000)
long 15 1sig_ra [10^-4-deg] (int)(0.0 to 360.0 *10000)
long 16 1sig_dec [10^-4-deg] (int)(-90.0 to +90.0 *10000)
long 17 max_prob_ra [10^-4-deg] (int)(0.0 to 360.0 *10000)
long 18 max_prob_dec [10^-4-deg] (int)(-90.0 to +90.0 *10000)
long 19 1sig_ra [10^-4-deg] (int)(0.0 to 360.0 *10000)
long 20 1sig_dec [10^-4-deg] (int)(-90.0 to +90.0 *10000)
long 21 2sig_ra [10^-4-deg] (int)(0.0 to 360.0 *10000)
long 22 2sig_dec [10^-4-deg] (int)(-90.0 to +90.0 *10000)
long 23 3sig_ra [10^-4-deg] (int)(0.0 to 360.0 *10000)
long 24 3sig_dec [10^-4-deg] (int)(-90.0 to +90.0 *10