Appendix A
==========

Data points for portfolios
--------------------------

+------------------+----------------------------------------------------------------------------------------------------+
| Name             | Description                                                                                        |
+==================+====================================================================================================+
| obs_id           | Observatory name, which is one of MAXI, Fermi, INTEGRAL, SWIFT, MOA, KONUS, ATels, GCN Circulars   |
+------------------+----------------------------------------------------------------------------------------------------+
| best_telescopes  | List of names of the 3 best ground based telescopes to view the event                              |
+------------------+----------------------------------------------------------------------------------------------------+
| categories       | List of categories of the events in this portfolio. See :doc:`appendixb` for a list of categories  |
+------------------+----------------------------------------------------------------------------------------------------+
| confirmed        | In the case of a GRB, the portfolio is confirmed when a GCN Circular is issued for the event       |
+------------------+----------------------------------------------------------------------------------------------------+
| coordinates_from | Description of the event where the RA and Dec of the portfolio are derived from                    |
+------------------+----------------------------------------------------------------------------------------------------+
| dec              | The Declination, in decimal degrees, of the events in the portfolio                                |
+------------------+----------------------------------------------------------------------------------------------------+
| description      | Description of the events in the portfolio                                                         |
+------------------+----------------------------------------------------------------------------------------------------+
| error            | The error circle, in decimal degrees, of the location of the events in the portfolio               |
+------------------+----------------------------------------------------------------------------------------------------+
| multiple_events  | An event in the portfolio documents multiple transient events                                      |
+------------------+----------------------------------------------------------------------------------------------------+
| name             | Portfolio name                                                                                     |
+------------------+----------------------------------------------------------------------------------------------------+
| portfolio_id     | Portfolio ID                                                                                       |
+------------------+----------------------------------------------------------------------------------------------------+
| ra               | The Right Ascension, in decimal degrees, of the events in the portfolio                            |
+------------------+----------------------------------------------------------------------------------------------------+
| redshift         | The redshift of the events in the portfolio                                                        |
+------------------+----------------------------------------------------------------------------------------------------+
| redshift_from    | Description of the event where the redshift of the portfolio are derived from                      |
+------------------+----------------------------------------------------------------------------------------------------+
| time_detected    | The UTC date and time that the latest event in the portfolio was detected                          |
+------------------+----------------------------------------------------------------------------------------------------+

Data points for events
----------------------

+--------------------------+----------------------------------------------------------------------------------------------------+
| Name                     | Description                                                                                        |
+==========================+====================================================================================================+
| algorithm                | The index value identifying which location_calculation algorithm was used for this event           |
+--------------------------+----------------------------------------------------------------------------------------------------+
| amplifier                | The amplifier used during the readout                                                              |
+--------------------------+----------------------------------------------------------------------------------------------------+
| atel_body                | The body of the Astronomer's Telegram (ATel) notice                                                |
+--------------------------+----------------------------------------------------------------------------------------------------+
| atel_from                | The originator of the ATel                                                                         |
+--------------------------+----------------------------------------------------------------------------------------------------+
| atel_number              | The number of the ATel                                                                             |
+--------------------------+----------------------------------------------------------------------------------------------------+
| atel_object_name         | The name of the object that is the subject of the ATel                                             |
+--------------------------+----------------------------------------------------------------------------------------------------+
| atel_queries             | The authors of the ATel                                                                            |
+--------------------------+----------------------------------------------------------------------------------------------------+
| base_mag                 | The baseline/quiescent magnitude of the lensed star                                                |
+--------------------------+----------------------------------------------------------------------------------------------------+
| base_mag_uncert          | The error in the baseline/quiescent magnitude value                                                |
+--------------------------+----------------------------------------------------------------------------------------------------+
| binning_index            | Pixel binning                                                                                      |
+--------------------------+----------------------------------------------------------------------------------------------------+
| bkg_dur                  | The duration of the background interval                                                            |
+--------------------------+----------------------------------------------------------------------------------------------------+
| bkg_inten                | The total number of events in the time interval used for the background subtraction of the         | 
|                          | detector_rate_map                                                                                  |
+--------------------------+----------------------------------------------------------------------------------------------------+
| bkg_mean                 | The mean value of the background level in the exposure                                             |
+--------------------------+----------------------------------------------------------------------------------------------------+
| bkg_time                 | The starting time of the background interval                                                       |
+--------------------------+----------------------------------------------------------------------------------------------------+
| categories               | List of categories of the event. See :doc:`appendixb.rst` for a list of categories                 |
+--------------------------+----------------------------------------------------------------------------------------------------+
| centroid_x               | X coordinate of the centroid position                                                              |
+--------------------------+----------------------------------------------------------------------------------------------------+
| centroid_y               | Y coordinate of the centroid position                                                              |
+--------------------------+----------------------------------------------------------------------------------------------------+
| circular_body            | The body of a Gamma-ray Coordinates Network (GCN) Circular notice                                  |
+--------------------------+----------------------------------------------------------------------------------------------------+
| circular_from            | The author(s) of the GCN Circular                                                                  |
+--------------------------+----------------------------------------------------------------------------------------------------+
| circular_number          | The number of the GCN Circular                                                                     |
+--------------------------+----------------------------------------------------------------------------------------------------+
| counts                   | The minimum number of events needed to calculate a proper centroid                                 |
+--------------------------+----------------------------------------------------------------------------------------------------+
| cusp_width               | Einstein crossing time                                                                             |
+--------------------------+----------------------------------------------------------------------------------------------------+
| data_interval            | The interval over which the data were accumulated                                                  |
+--------------------------+----------------------------------------------------------------------------------------------------+
| data_signif              | The significance level of the data in the on-going integrated data                                 |
+--------------------------+----------------------------------------------------------------------------------------------------+
| data_time_scale          | Timesampling of the countrate lightcurve used during the iterative location calculation phase of   |
|                          | the processing                                                                                     |
+--------------------------+----------------------------------------------------------------------------------------------------+
| delta_time               | The amount of time between the ra,dec pointing samples                                             |
+--------------------------+----------------------------------------------------------------------------------------------------+
| description              | Description of the event                                                                           |
+--------------------------+----------------------------------------------------------------------------------------------------+
| det_thresh               | The detection threshold used in this exposure                                                      |
+--------------------------+----------------------------------------------------------------------------------------------------+
| discovery_date           | The detection/declaration date of the event                                                        |
+--------------------------+----------------------------------------------------------------------------------------------------+
| discovery_time           | The detection/declaration time of the event                                                        |
+--------------------------+----------------------------------------------------------------------------------------------------+
| e_range_hi_chan_energy   | The energy range of the high energy channel                                                        |
+--------------------------+----------------------------------------------------------------------------------------------------+
| e_range_hi_chan_index    | The energy range of the high energy channel index                                                  |
+--------------------------+----------------------------------------------------------------------------------------------------+
| e_range_lo_chan_energy   | The energy range of the low energy channel                                                         |
+--------------------------+----------------------------------------------------------------------------------------------------+
| e_range_lo_chan_index    | The energy range of the low energy channel index                                                   |
+--------------------------+----------------------------------------------------------------------------------------------------+
| ecl_coords_lat           | Ecliptic latitude of the spacecraft at the time of the observation                                 |
+--------------------------+----------------------------------------------------------------------------------------------------+
| ecl_coords_long          | Ecliptic longitude of the spacecraft at the time of the observation                                |
+--------------------------+----------------------------------------------------------------------------------------------------+
| error_code               | The value for why a position was not found. The values are:  1= no source found in image,          |
|                          | 2= algorithm did not converge, 3= standard deviation too large, and 0xFFF= general error           |
+--------------------------+----------------------------------------------------------------------------------------------------+
| event_date               | The date of the trigger                                                                            |
+--------------------------+----------------------------------------------------------------------------------------------------+
| event_dec                | The J2000 declination coordinate of the event in degrees                                           |
+--------------------------+----------------------------------------------------------------------------------------------------+
| event_eband              | The energy band for the successful trigger criteria: 0 - undefined/unavailable,                    |
|                          | 1= Low, 2-4 keV, 2= Medium, 4-10 keV, 3= High, 10-20 keV, 4= L+M, 2-10 keV                         |
+--------------------------+----------------------------------------------------------------------------------------------------+
| event_error              | The radius of the circle that contains most of the event locations                                 |
+--------------------------+----------------------------------------------------------------------------------------------------+
| event_flux               | The flux (in mCrab units) of the event during the time duration of the successful trigger criterion|
+--------------------------+----------------------------------------------------------------------------------------------------+
| event_id                 | The SkyWatch generated id of the event                                                             |
+--------------------------+----------------------------------------------------------------------------------------------------+
| event_id_num             | The numeric id of the event, assigned by the observatory                                           |
+--------------------------+----------------------------------------------------------------------------------------------------+
| event_ra                 | The J2000 right ascension coordinate of the event in degrees                                       |
+--------------------------+----------------------------------------------------------------------------------------------------+
| event_time               | The time of the trigger                                                                            |
+--------------------------+----------------------------------------------------------------------------------------------------+
| event_tscale             | The timescale index values are: 0= undefined/unavailable, 1= 1 sec, 2= 3 sec, 3= 10 sec, 4= 30 sec,|
|                          | 5= 1 scan, 6= 1 orbit, 7= 4 orbits, 8= 1 day                                                       |
+--------------------------+----------------------------------------------------------------------------------------------------+
| expo_time                | The nominal exposure time for the image for this event                                             |
+--------------------------+----------------------------------------------------------------------------------------------------+
| exposure_id              | The exposure id in spacecraft seconds                                                              |
+--------------------------+----------------------------------------------------------------------------------------------------+
| filter                   | The filter used for the image. Values: 0= Blocked, 1= UV_Grism, 2= UVW2, 3= V, 4= UVM2,            |
|                          | 5= Vis_Grism, 6= UVW1, 7= U, 8= Magnifier, 9= B, 10= White, 11= unknown                            |
+--------------------------+----------------------------------------------------------------------------------------------------+
| flags                    | Two flag bits related to the status of the given burst wrt the Automated Target (AT) and Slewing   |
+--------------------------+----------------------------------------------------------------------------------------------------+
| gain                     | The gain of the amplifier used during the readout of the CCD. The value will be 1, 2, 4, 8, or 16. |
|                          | If the gain is greater than 1, then the "object" in the image is likely due to a cosmic ray, and   | 
|                          | not due to a GRB afterglow                                                                         |
+--------------------------+----------------------------------------------------------------------------------------------------+
| gal_coords_lat           | Galactic latitude of the spacecraft at the time of the observation                                 |
+--------------------------+----------------------------------------------------------------------------------------------------+
| gal_coords_long          | Galactic longitude of the spacecraft at the time of the observation                                |
+--------------------------+----------------------------------------------------------------------------------------------------+
| grb_date                 | The date of the event                                                                              |
+--------------------------+----------------------------------------------------------------------------------------------------+
| grb_dec                  | The Declination, in decimal degrees, of the event                                                  |
+--------------------------+----------------------------------------------------------------------------------------------------+
| grb_error                | The error circle, in decimal degrees, of the location of the event                                 |
+--------------------------+----------------------------------------------------------------------------------------------------+
| grb_inten_burst_inten    | The number of events in the 50-300 keV band averaged over the two closed detectors and             |
|                          | cosine-corrected                                                                                   |
+--------------------------+----------------------------------------------------------------------------------------------------+
| grb_inten_n_bright_pix   | The number of bright pixels in the image                                                           |
+--------------------------+----------------------------------------------------------------------------------------------------+
| grb_inten_sigma          | The intensity of the burst in sigma units                                                          |
+--------------------------+----------------------------------------------------------------------------------------------------+
| grb_mag                  | The magnitude of the burst/afterglow                                                               |
+--------------------------+----------------------------------------------------------------------------------------------------+
| grb_name                 | The name of the GRB                                                                                |
+--------------------------+----------------------------------------------------------------------------------------------------+
| grb_phi                  | The BAT instrument phi coordinate of the trigger (burst) as determined by the BAT flight software  | 
|                          | program                                                                                            |
+--------------------------+----------------------------------------------------------------------------------------------------+
| grb_pos_xrt_y            | The GRB x-ray afterglow Y position in XRT coordinates                                              |
+--------------------------+----------------------------------------------------------------------------------------------------+
| grb_pos_xrt_z            | The GRB x-ray afterglow Z position in XRT coordinates                                              |
+--------------------------+----------------------------------------------------------------------------------------------------+
| grb_ra                   | The Right Ascension, in decimal degrees, of the event                                              |
+--------------------------+----------------------------------------------------------------------------------------------------+
| grb_signif               | A measure of the significance of the afterglow detection                                           |
+--------------------------+----------------------------------------------------------------------------------------------------+
| grb_theta                | The BAT instrument theta coordinate of the trigger (burst) as determined by the BAT flight software| 
|                          | program                                                                                            |
+--------------------------+----------------------------------------------------------------------------------------------------+
| grb_time                 | The time of the event                                                                              |
+--------------------------+----------------------------------------------------------------------------------------------------+
| hard_ratio               | The hardness ratio                                                                                 |
+--------------------------+----------------------------------------------------------------------------------------------------+
| height                   | The height of the image subarray                                                                   |
+--------------------------+----------------------------------------------------------------------------------------------------+
| im_url                   | The filename portion of the URL of the image. The leading path for the full URL is                 |
|                          | http://gcn.gsfc.nasa.gov/gcn/notices_s/                                                            |
+--------------------------+----------------------------------------------------------------------------------------------------+
| image_signif             |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| image_url                |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| img_start_date           |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| img_start_time           |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| inst_modes_uvot          |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| inst_modes_xrt           |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| integ_time               |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| lc_live_time             |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| lc_start_date            |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| lc_start_time            |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| lc_stop_date             |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| lc_stop_time             |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| lc_url                   |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| lead_time                |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| livetime                 |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| loc_algorithm            |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| loc_url                  |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| lrpd_bias                |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| mag_limit                |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| magnitude                |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| max_date                 |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| max_mag                  |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| max_time                 |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| max_uncert               |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| merit                    |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| merit_params             |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| mode                     |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| moon_dist                |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| moon_illum               |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| moon_postn_dec           |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| moon_postn_ra            |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| most_likely_index        |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| most_likely_prob         |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| n_bins                   |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| n_stars                  |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| notice_date              |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| notice_type              |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| notice_type_description  |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| obs_id                   | Observatory name - one of MAXI, Fermi, INTEGRAL, SWIFT, MOA, KONUS, ATels, GCN Circulars           |
+--------------------------+----------------------------------------------------------------------------------------------------+
| obs_time                 |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| ph2_iter                 |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| photo_thresh             |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| point_dec                |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| point_ra                 |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| point_roll               |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| portfolio_id             | Portfolio ID of the portfolio that contains this event                                             |
+--------------------------+----------------------------------------------------------------------------------------------------+
| rate_signif              |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| record_num               |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| redshift                 | The redshift of the event                                                                          |
+--------------------------+----------------------------------------------------------------------------------------------------+
| region_dec               |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| region_error             |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| region_ra                |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| region_source            |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| roll                     |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| sc_dec                   |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| sc_ra                    |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| second_most_likely_index |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| second_most_likely_prob  |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| sl_url                   |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| slew_query               |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| soln_status              |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| sourcexml                | The raw VOEvent XML of the event that SkyWatch received                                            |
+--------------------------+----------------------------------------------------------------------------------------------------+
| spec_start_date          |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| spec_start_time          |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| spec_stop_date           |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| spec_stop_time           |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| spec_url                 |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| src_dec                  |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| src_id_num               |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| src_ra                   |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| std_dev                  |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| sun_angle                |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| sun_dist                 |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| sun_postn_dec            |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| sun_postn_ra             |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| tam0_x_tam_1             |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| tam1_y_tam_1             |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| tam2_x_tam_2             |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| tam3_y_tam_2             |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| term_cond                |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| time_detected            | The UTC date and time that the event was detected.                                                 |
+--------------------------+----------------------------------------------------------------------------------------------------+
| tp_expo_time             |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| tp_start_date            |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| tp_start_time            |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| tp_url                   |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| trigger_dur              |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| trigger_index            |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| trigger_num              |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| trigger_signif           |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| u0                       |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| u0_uncert                |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| wait_time                |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| waveform                 | The waveform number of the readout                                                                 |
+--------------------------+----------------------------------------------------------------------------------------------------+
| width                    | The width of the image subarray                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| x_grb_pos                |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| x_max                    |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| x_offset                 |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| xrt_thresholded_pixels   |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| y_grb_pos                |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| y_max                    |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+
| y_offset                 |                                                                                                    |
+--------------------------+----------------------------------------------------------------------------------------------------+