gwcelery.tasks.external_skymaps module

Create and upload external sky maps.

gwcelery.tasks.external_skymaps.create_combined_skymap(se_id, ext_id)

Creates and uploads the combined LVC-Fermi skymap.

This also uploads the external trigger skymap to the external trigger GraceDB page.

(task)gwcelery.tasks.external_skymaps.get_skymap_filename(graceid)

Get the skymap fits filename.

If not available, will try again 10 seconds later, then 20, then 40, etc. until up to 10 minutes after initial attempt.

(task)gwcelery.tasks.external_skymaps.combine_skymaps(skymap1filebytes, skymap2filebytes)

This task combines the two input skymaps, in this case the external trigger skymap and the LVC skymap and writes to a temporary output file. It then returns the contents of the file as a byte array.

(task)gwcelery.tasks.external_skymaps.external_trigger(graceid)

Returns the associated external trigger GraceDB ID.

(task)gwcelery.tasks.external_skymaps.external_trigger_heasarc(external_id)

Returns the HEASARC fits file link.

(task)gwcelery.tasks.external_skymaps.get_external_skymap(link, search)

Download the Fermi sky map fits file and return the contents as a byte array. If GRB, will construct a HEASARC url, while if SubGRB, will use the link directly.

If not available, will try again 10 seconds later, then 20, then 40, etc. until up to 10 minutes after initial attempt.

(task)gwcelery.tasks.external_skymaps.get_upload_external_skymap(graceid, search, skymap_link=None)

If a Fermi sky map is not uploaded yet, tries to download one and upload to external event. If sky map is not available, passes so that this can be re-run the next time an update GCN notice is received. If GRB, will construct a HEASARC url, while if SubGRB, will use the link directly.

gwcelery.tasks.external_skymaps.create_external_skymap(ra, dec, error, pipeline, notice_type=111)

Create a sky map, either a gaussian or a single pixel sky map, given an RA, dec, and error radius.

If from Fermi, convolves the sky map with both a core and tail Gaussian and then sums these to account for systematic effects as measured in doi:10.1088/0067-0049/216/2/32

If from Swift, converts the error radius from that containing 90% of the credible region to ~68% (see description of Swift error here:https://gcn.gsfc.nasa.gov/swift.html#tc7)

Parameters:

• ra (float) – right ascension in deg
• dec (float) – declination in deg
• error (float) – error radius in deg

Returns:

skymap – sky map array

Return type:

numpy array

gwcelery.tasks.external_skymaps.write_to_fits(skymap, event, notice_type, notice_date)

Write external sky map fits file, populating the header with relevant info.

Parameters:

• skymap (numpy array) – sky map array
• event (dict) – Dictionary of Swift external event

Returns:

skymap fits – bytes array of sky map

Return type:

bytes array

(task)gwcelery.tasks.external_skymaps.create_upload_external_skymap(event, notice_type, notice_date)

Create and upload external sky map using RA, dec, and error radius information.

Parameters:event (dict) – Dictionary of Swift external event