gwcelery.tasks.raven module

Search for GRB-GW coincidences with ligo-raven.

gwcelery.tasks.raven.calculate_spacetime_coincidence_far(gracedb_id, group)[source]

Compute spatio-temporal coincidence FAR for GRB external trigger and superevent coincidence by calling ligo.raven.search.calc_signif_gracedb. Note: this will only run if skymaps from both triggers are available to download.

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
gwcelery.tasks.raven.calculate_coincidence_far(gracedb_id, group)[source]

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(se, exttrig, tl, th, incl_sky)[source]

Calculate FAR of GRB exttrig-GW coincidence

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=[])[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.add_exttrig_to_superevent(raven_search_results, gracedb_id)[source]

Add external trigger to the list of em_events after ligo.raven.search.search finds a coincidence

Parameters:
  • raven_search_results (list) – list of dictionaries of each related gracedb trigger
  • gracedb_id (str) – ID of either a superevent or external trigger