Skip to content

Improve OpenUniverse2024 Firefly visualization tutorial - #379

Merged
jaladh-singhal merged 9 commits into
Caltech-IPAC:mainfrom
jaladh-singhal:ou-firefly-improvements
Sep 4, 2026
Merged

Improve OpenUniverse2024 Firefly visualization tutorial#379
jaladh-singhal merged 9 commits into
Caltech-IPAC:mainfrom
jaladh-singhal:ou-firefly-improvements

Conversation

@jaladh-singhal

@jaladh-singhal jaladh-singhal commented Sep 3, 2026

Copy link
Copy Markdown
Member

Fixes #377

  • Besides updating several sections, reordered them as per new narrative flow
  • Reduced number of SIA calls to keep notebook runtime low.

Note: the diff won't look super helpful so it's better to check "rendering preview".

Please check the new flow of narrative if it makes sense while teaching visualization techniques with Firefly.

Firefly outputs (won't show up in docs preview)

The notebook ran end to end in Fornax and was able to display all the images & catalogs sent to Firefly:
image

Images in expanded mode:
image

@jaladh-singhal jaladh-singhal self-assigned this Sep 3, 2026
@jaladh-singhal jaladh-singhal added the content: openuniverse Content related issues/PRs for notebooks with OpenUniverse relevance label Sep 3, 2026

@jkrick jkrick left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I read/ran it through top to bottom, and was able to get everything to run with the make_client(). I left some suggestions for slight changes. The biggest request is to make the text around the firefly startup simpler for those of us who don't know as much about firefly. I understand that firefly might change on Fornax, so not sure what to recommend there since the narrative needs to indicate exactly what to do if running this on Fornax.

The 3-color image is a bit disappointing, in that all three colors show a pretty similar sky. Since the notebook is already quite long, I would suggest we remove that section. If you then want to keep the firefly set_pan(), set_zoom(), and align_images() cell, I think we can apply those above when we have the roman and rubin images side by side in firefly. This isn't a big deal, so if you'd rather leave it, that is fine too.


```{code-cell} ipython3
fig, axs = plt.subplots(1, 2, figsize=(12, 6))
You can pan and zoom around the image display in the Firefly UI. Try zooming out the outlined Roman region and see how it sits within the wider Rubin field around it.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Suggested change
You can pan and zoom around the image display in the Firefly UI. Try zooming out the outlined Roman region and see how it sits within the wider Rubin field around it.
You can pan and zoom around the image display in the Firefly UI. Using the "+" and "-" magnifying glass icons in the upper left of the right-hand Roman image, try zooming out the outlined Roman region and see how it sits within the wider Rubin field around it.

@jaladh-singhal jaladh-singhal Sep 4, 2026

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

This is a bit misleading, you can zoom by using your mouse/trackpad gestures too. Try scrolling up/down or pinching in/out gestures in the image, it will do a more natural zooming than "+", "-" icons. And same for panning you hold and drag. All of this very similar to UX of a Google maps like tool that users are used to.

I added:

You can pan and zoom around the image display using the same controls as Google Maps or similar map apps (scroll/pinch to zoom, drag to pan, or the magnifying glass icons in the upper left).

You can visualize catalogs interactively with Firefly using [`show_table`](https://caltech-ipac.github.io/firefly_client/api/firefly_client.FireflyClient.html#firefly_client.FireflyClient.show_table). This capability can take many parameters. Here we will simply send our catalog to Firefly so that we can (a) see an interactive table; (b) see this table plotted over the image that we've already sent; and (c) use the GUI to quickly create exploratory plots. See if you can use the GUI to quickly determine approximately how many galaxies cover the Rubin image and what the redshift distribution of these galaxies is.
You can visualize catalogs interactively with Firefly using [`show_table`](https://caltech-ipac.github.io/firefly_client/api/firefly_client.FireflyClient.html#firefly_client.FireflyClient.show_table). This capability can take many parameters. Here we will simply send our catalog to Firefly so that we can (a) see an interactive table; (b) see this table plotted over the image that we've already sent; and (c) use the GUI to quickly create exploratory plots. See if you can use the GUI to quickly determine approximately how many galaxies cover the Roman exposure and what the redshift distribution of these galaxies is.

```{code-cell} ipython3

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I would put this code in the same cell as the one above which defines ra_bounds, dec_bounds. Then comes the text which describes show_table, then the show_table cell.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Good catch! done.

@jaladh-singhal

jaladh-singhal commented Sep 4, 2026

Copy link
Copy Markdown
Member Author

The biggest request is to make the text around the firefly startup simpler for those of us who don't know as much about firefly. I understand that firefly might change on Fornax, so not sure what to recommend there since the narrative needs to indicate exactly what to do if running this on Fornax.

@jkrick I decided not to do this here since the original preview-release tutorial also had same complicated narrative. We have a dedicated issue #310 for this which applies to this tutorial as well as all other tutorials using firefly.

The 3-color image is a bit disappointing, in that all three colors show a pretty similar sky. Since the notebook is already quite long, I would suggest we remove that section. If you then want to keep the firefly set_pan(), set_zoom(), and align_images() cell, I think we can apply those above when we have the roman and rubin images side by side in firefly. This isn't a big deal, so if you'd rather leave it, that is fine too.

I know the 3-color image is not interesting here but I still left it just to show 3-color image plotting is possible. I'm inclined not to remove it because I remember @vandesai1 specifically asked me to add this to showcase 3-color capability when we developed this tutorial. As for the length, I deliberately added it as the last section so that I can skip it if the walkthrough of the notebook takes longer.

@jaladh-singhal
jaladh-singhal merged commit 8109ac6 into Caltech-IPAC:main Sep 4, 2026
8 checks passed
github-actions Bot pushed a commit that referenced this pull request Sep 4, 2026
Improve OpenUniverse2024 Firefly visualization tutorial 8109ac6
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

content: openuniverse Content related issues/PRs for notebooks with OpenUniverse relevance

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update OU Firefly visualization tutorial after switching to full data release

2 participants