Intro¶

This notebook demonstrates basic usage of the firefly_client API method overlay_footprints which overlays the footprint described in image pixel of JSON format on a FITS image.

Note that it may be necessary to wait for some cells (like those displaying an table) to complete before executing later cells.

Setup¶

Imports for firefly_client:

In [ ]:

from firefly_client import FireflyClient
import astropy.utils.data
using_lab = False
url = 'http://127.0.0.1:8080/firefly'
#FireflyClient._debug= True

In this example, we use local firefly server (you can also use public server - irsaviewer instead):

Instantiate FireflyClient using the url above.

In [ ]:

fc = FireflyClient.make_lab_client() if using_lab else FireflyClient.make_client(url)

Start with Image Data¶

The data used in this example are taken from http://web.ipac.caltech.edu/staff/shupe/firefly_testdata and can be downloaded. Download a file using the image URL below and upload it to the server:

In [ ]:

image_url = 'http://web.ipac.caltech.edu/staff/shupe/firefly_testdata/calexp-subset-HSC-R.fits'
filename = astropy.utils.data.download_file(image_url, cache=True, timeout=120)
imval = fc.upload_file(filename)

Set the plot_id for the image and display it through the opened browser:

In [ ]:

plotid = 'footprinttest'
status = fc.show_fits(file_on_server=imval, plot_id=plotid, title='footprints HSC R-band')

Add Data for Footprints¶

Upload a table with footprint data using the foloowing url from where it can be downloaded:

In [ ]:

table_url = 'http://web.ipac.caltech.edu/staff/shupe/firefly_testdata/footprints-subset-HSC-R.xml'
footprint_table = astropy.utils.data.download_file(table_url, cache=True, timeout=120)
tableval = fc.upload_file(footprint_table)

Overlay a footprint layer (while comparing a highlighted section to the overall footprint) onto the plot using the above table:

In [ ]:

status = fc.overlay_footprints(tableval,  title='footprints HSC R-band',
                               footprint_layer_id='footprint_layer_1', 
                               plot_id=plotid, 
                               highlightColor='yellow', 
                               selectColor='cyan', 
                               style='fill', 
                               color='rgba(74,144,226,0.30)')