gwcelery.tasks.external_triggers module¶
This module listens to the GCNs from SNEWS and the Fermi, Swift, INTEGRAL, and AGILE missions. It is also responsible for carrying out tasks related to external trigger-gravitational wave coincidences, including looking for temporal coincidences, creating combined GRB-GW sky localization probability maps, and computing their joint temporal and spatio-temporal false alarm rates.
There are two GCN and two LVAlert message handlers in the ~gwcelery.tasks.external_triggers module:
handle_sn_gcn()
is called for each SNEWS GCN.handle_grb_gcn()
is called for each GRB GCN such as Fermi, Swift, INTEGRAL, and AGILE MCAL.handle_sn_lvalert()
is called for each SNEWS external trigger and superevent LVAlert.handle_grb_lvalert()
is called for each Fermi and Swift external trigger and superevent LVAlert.
Flow Chart¶
Tasks¶
-
gwcelery.tasks.external_triggers.
REQUIRED_LABELS_BY_TASK
= {'combine': {'EXT_SKYMAP_READY', 'RAVEN_ALERT', 'SKYMAP_READY'}, 'compare': {'EM_COINC', 'EXT_SKYMAP_READY', 'SKYMAP_READY'}}¶ These labels should be present on an external event to consider it to be ready for sky map comparison.
-
gwcelery.tasks.external_triggers.
FERMI_GRB_CLASS_VALUE
= 4¶ This is the index that denote GRBs within Fermi’s Flight Position classification.
-
gwcelery.tasks.external_triggers.
FERMI_GRB_CLASS_THRESH
= 0.5¶ This values denotes the threshold of the most likely Fermi source classification, above which we will consider a Fermi Flight Position notice.
-
(task)
gwcelery.tasks.external_triggers.
handle_snews_gcn
(payload)[source]¶ Handles the payload from SNEWS alerts.
Prepares the alert to be sent to graceDB as ‘E’ events.
-
(task)
gwcelery.tasks.external_triggers.
handle_grb_gcn
(payload)[source]¶ Handles the payload from Fermi and Swift alerts.
Prepares the alert to be sent to graceDB as ‘E’ events.
-
(task)
gwcelery.tasks.external_triggers.
handle_grb_lvalert
(alert)[source]¶ Parse an LVAlert message related to superevents/GRB external triggers and dispatch it to other tasks.
Notes
This LVAlert message handler is triggered by creating a new superevent or GRB external trigger event, or applying the
EM_COINC
label to any superevent:- Any new event triggers a coincidence search with
gwcelery.tasks.raven.coincidence_search()
. - When both a GW and GRB sky map are available during a coincidence,
indicated by the labels
SKYMAP_READY
andEXT_SKYMAP_READY
respectfully, this trigger the spacetime coinc FAR to be calculated. If an alert is triggered with these same conditions, indicated by theRAVEN_ALERT
label, a combined GW-GRB sky map is created usinggwcelery.tasks.external_skymaps.create_combined_skymap()
.
- Any new event triggers a coincidence search with
-
(task)
gwcelery.tasks.external_triggers.
handle_snews_lvalert
(alert)[source]¶ Parse an LVAlert message related to superevents/SN external triggers and dispatch it to other tasks.
Notes
This LVAlert message handler is triggered by creating a new superevent or SN external trigger event, or applying the
EM_COINC
label to any superevent:- Any new event triggers a coincidence search with
gwcelery.tasks.raven.coincidence_search()
.
- Any new event triggers a coincidence search with