gwcelery.tasks.raven module¶
Search for GRB-GW coincidences with ligo-raven.
-
(task)
gwcelery.tasks.raven.
calculate_coincidence_far
(superevent_id, exttrig_id, preferred_id, group)[source]¶ Compute temporal coincidence FAR for external trigger and superevent coincidence by calling ligo.raven.search.calc_signif_gracedb.
Parameters:
-
(task)
gwcelery.tasks.raven.
calc_signif
(search, se_id, exttrig_id, tl, th, incl_sky=False, se_fitsfile=None)[source]¶ Calculate FAR of GRB exttrig-GW coincidence
-
(task)
gwcelery.tasks.raven.
coincidence_search
(gracedb_id, alert_object, group=None, pipelines=[])[source]¶ Perform ligo-raven search for coincidences. The ligo.raven.search.search method applies EM_COINC label on its own.
Parameters:
-
(task)
gwcelery.tasks.raven.
search
(gracedb_id, alert_object, tl=-5, th=5, group=None, pipelines=[])[source]¶ Perform ligo-raven search for coincidences. The ligo.raven.search.search method applies EM_COINC label on its own.
Parameters: - gracedb_id (str) – ID of the trigger used by GraceDB
- alert_object (dict) – lvalert[‘object’]
- tl (int) – number of seconds to search before
- th (int) – number of seconds to search after
- group (str) – Burst or CBC
- pipelines (list) – list of external trigger pipelines for performing coincidence search against
Returns: Return type: list with the dictionaries of related gracedb events
-
(task)
gwcelery.tasks.raven.
raven_pipeline
(raven_search_results, gracedb_id, alert_object, gw_group)[source]¶ Executes much of the full raven pipeline, including adding the external trigger to the superevent, calculating the coincidence false alarm rate, and applying ‘EM_COINC’ to the appropriate events. Also a preimlinary alert will be triggered if the coincidence passes threshold.
Parameters:
-
(task)
gwcelery.tasks.raven.
preferred_superevent
(raven_search_results)[source]¶ Chooses the superevent with the lowest far for an external event to be added to. This is to prevent errors from trying to add one external event to multiple superevents.
Parameters: raven_search_results (list) – list of dictionaries of each related gracedb trigger
-
(task)
gwcelery.tasks.raven.
_get_coinc_far_try_raven_alert
(superevent, ext_event, gracedb_id, superevent_id, exttrig_id, gw_group)[source]¶
-
(task)
gwcelery.tasks.raven.
trigger_raven_alert
(coinc_far_json, superevent, gracedb_id, ext_event, gw_group)[source]¶ Determine whether an event should be published as a public alert. If yes, then launches an alert by applying EM_COINC to the preferred event.
All of the following conditions must be true for a public alert:
- The external event must be a threshold GRB or SNEWS event.
- If triggered on a SNEW event, the GW false alarm rate must pass
snews_gw_far_threshold
. - The event’s RAVEN coincidence false alarm rate, weighted by the
group-specific trials factor as specified by the
preliminary_alert_trials_factor
configuration setting, is less than or equal topreliminary_alert_far_threshold
.
Parameters: