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)

Compute temporal coincidence FAR for external trigger and superevent coincidence by calling ligo.raven.search.calc_signif_gracedb.

Parameters:

• gracedb_id (str) – ID of the superevent trigger used by GraceDB
• group (str) – CBC or Burst; group of the preferred_event associated with the gracedb_id superevent

(task)gwcelery.tasks.raven.calc_signif(search, se_id, exttrig_id, tl, th, incl_sky=False, se_fitsfile=None)

Calculate FAR of GRB exttrig-GW coincidence

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

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’]
• 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=[])

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)

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.

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) – lvalert[‘object’]
• 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