gwcelery.tasks.raven module

Search for GRB-GW coincidences with ligo-raven.

(task)gwcelery.tasks.raven.calculate_coincidence_far(superevent, exttrig, tl, th)

Compute coincidence FAR for external trigger and superevent coincidence by calling ligo.raven.search.calc_signif_gracedb, using sky map info if available.

Parameters:

• superevent (dict) – superevent dictionary

• exttrig (dict) – external event dictionary

• tl (float) – start of coincident time window

• th (float) – end of coincident time window

(task)gwcelery.tasks.raven.coincidence_search(gracedb_id, alert_object, group=None, pipelines=[], searches=[], se_searches=[])

Perform ligo-raven search for coincidences. Determines time window to use. If events found, launches raven pipeline.

Parameters:

• gracedb_id (str) – ID of the trigger used by GraceDB

• alert_object (dict) – Alert dictionary

• group (str) – Burst or CBC

• pipelines (list) – list of external trigger pipeline names

(task)gwcelery.tasks.raven.search(gracedb_id, alert_object, tl=-5, th=5, group=None, pipelines=[], searches=[], se_searches=[])

Perform ligo-raven search for coincidences.

Parameters:

• gracedb_id (str) – ID of the trigger used by GraceDB

• alert_object (dict) – Alert dictionary

• 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

Return type:

list with the dictionaries of related gracedb events

(task)gwcelery.tasks.raven.raven_pipeline(raven_search_results, gracedb_id, alert_object, tl, th, gw_group)

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:

• raven_search_results (list) – list of dictionaries of each related gracedb trigger

• gracedb_id (str) – ID of either a superevent or external trigger

• alert_object (dict) – Alert dictionary, either a superevent or an external event

• gw_group (str) – Burst or CBC

(task)gwcelery.tasks.raven.preferred_superevent(raven_search_results)

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.update_coinc_far(coinc_far_dict, superevent, ext_event)

Update joint info in superevent based on the current preferred coincidence. This prefers a spacetime joint FAR over a time-only joint FAR. A SNEWS coincidence is preferred over either.

Parameters

coinc_far_dictdict

Dictionary containing coincidence false alarm rate results from RAVEN

supereventdict

superevent dictionary

ext_event: dict

external event dictionary

(task)gwcelery.tasks.raven.trigger_raven_alert(coinc_far_dict, superevent, gracedb_id, ext_event, gw_group)

Determine whether an event should be published as a preliminary alert. If yes, then triggers an alert by applying RAVEN_ALERT to the preferred event.

All of the following conditions must be true for a preliminary 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 to preliminary_alert_far_threshold.

• If the external event is from Swift, both sky maps must be present.

Parameters:

• coinc_far_dict (dict) – Dictionary containing coincidence false alarm rate results from RAVEN

• superevent (dict) – superevent dictionary

• gracedb_id (str) – ID of the trigger that launched RAVEN

• ext_event (dict) – external event dictionary

• gw_group (str) – Burst or CBC