Skip to content

Simplify & update firefly_client use in Euclid PHZ tutorial #307

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jaladh-singhal merged 2 commits into from
May 5, 2026
+14 −27
Merged

Simplify & update firefly_client use in Euclid PHZ tutorial #307

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
149bba0
Simplify & update firefly_client use in Euclid PHZ tutorial
jaladh-singhal Apr 30, 2026
34f761c
Improve wording and cross-link initializing notebook for more context
jaladh-singhal May 5, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
41 changes: 14 additions & 27 deletions tutorials/euclid/4_Euclid_intro_PHZ_catalog.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -73,6 +73,7 @@ We rely on ``astroquery`` features that have been recently added, so please make
```{code-cell} ipython3
import os
import re
import io
import urllib

import numpy as np
Expand Down Expand Up @@ -394,51 +395,37 @@ ax.imshow(cutout_galaxy.data, cmap='gray', origin='lower',

## 6. Load the image in Firefly for interactive exploration

+++

Save the data locally if you have not already done so, in order to upload to IRSA viewer.
First we intialize the Firefly client as explained [here](https://caltech-ipac.github.io/firefly_client/usage/initializing-vanilla.html) so that we can send our data to Firefly for visualization.

```{code-cell} ipython3
download_path = "data"
if os.path.exists(download_path):
print("Output directory already created.")
else:
print("Creating data directory.")
os.mkdir(download_path)
fc = FireflyClient.make_client('https://irsa.ipac.caltech.edu/irsaviewer')
Copy link
Copy Markdown
Member

@bsipocz bsipocz Apr 30, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would move this code cell down, right after current line 404. (I like having the narrative first and the see the code that does what the narrative describes)

```

### Vizualize the image with Firefly
### Vizualize the FITS image with Firefly

First initialize the client, then set the path to the image, upload it to firefly, load it and align with WCS.
After initializing the client, we can directly use the FITS image file URL to visualise it in Firefy.

Note this can take a while to upload the full MER image.

```{code-cell} ipython3
fc = FireflyClient.make_client('https://irsa.ipac.caltech.edu/irsaviewer')

fc.show_fits(url=filename)

fc.align_images(lock_match=True)
fc.show_fits_image(filename)
```

### Save the table as a CSV for Firefly upload

```{code-cell} ipython3
csv_path = os.path.join(download_path, "mer_df.csv")
result_galaxies.write(csv_path, format="csv")
```
### Display the table as an overlay on the FITS image

### Upload the CSV table to Firefly and display as an overlay on the FITS image
Since our galaxies table is in memory, we write it to an IO stream (file-like object) for visualizing it in Firefly.
Besides displaying the table, Firefly will also overlay the positions of the galaxies on the FITS image we visualized earlier.
You can click on a table row to inspect the particular galaxy in the image, or click on an overlay marker to inspect the particular galaxy in the table.

```{code-cell} ipython3
uploaded_table = fc.upload_file(csv_path)
print(f"Uploaded Table URL: {uploaded_table}")
tbl_stream = io.BytesIO()
result_galaxies.write(tbl_stream, format='votable')

fc.show_table(uploaded_table)
fc.show_table(tbl_stream)
```

## About this Notebook

**Updated**: 2025-09-24
**Updated**: 2026-04-29

**Contact:** [the IRSA Helpdesk](https://irsa.ipac.caltech.edu/docs/help_desk.html) with questions or reporting problems.
Loading