###############
Demo Notebooks
###############


Reference Guide
-----------------

For a high-level overview of the Firefly Python client API and important methods, refer to this `reference guide notebook <https://nbviewer.org/github/Caltech-IPAC/firefly_client/tree/master/examples/reference-guide.ipynb>`_.


Science Use-cases
-----------------

IRSA Tutorials is collection of multiple notebooks that demonstrate the use of IRSA data services and tools for science use-cases.
The following tutorial notebooks demonstrates the use of Firefly Python client:

- `Using Firefly visualization tools in Python to vet SEDs <https://caltech-ipac.github.io/irsa-tutorials/tutorials/firefly/SEDs_in_Firefly.html>`_
- `Using Firefly visualization tools to understand the light curves of Solar System objects <https://caltech-ipac.github.io/irsa-tutorials/tutorials/firefly/NEOWISE_light_curve_demo.html>`_
- `Using Firefly to Explore OpenUniverse2024 Data Preview Simulated Roman and Rubin Images <https://caltech-ipac.github.io/irsa-tutorials/tutorials/firefly/OpenUniverse2024Preview_Firefly.html>`_
- `Euclid Q1: PHZ catalogs — Visualize with Firefly section <https://caltech-ipac.github.io/irsa-tutorials/tutorials/euclid_access/4_Euclid_intro_PHZ_catalog.html#vizualize-the-image-with-firefly>`_


Other Examples
---------------

For a full list of notebooks/scripts that demonstrate the use of
Firefly Python client, refer to |nbviewer_examples| (rendered in nbviewer).

.. warning::
    Several of the notebooks in the examples directory use deprecated API (or discouraged API that is about to be deprecated) and will be updated soon.


.. |nbviewer_examples| raw:: html

   <a href="https://nbviewer.org/github/Caltech-IPAC/firefly_client/tree/master/examples/"
   target="_blank">this examples directory</a>