.. _tutorials:

Tutorials
=========

.. contents:: Contents
    :depth: 2

.. note::

   The tutorials below are currently out of date and will not run without
   modification against the current version of ``FastSpecFit``. Updated
   notebooks will be provided in a future release.

The following resources provide worked examples for common science tasks using
``FastSpecFit`` and the broader DESI data ecosystem.

FastSpecFit Notebooks
---------------------

These Jupyter notebooks are included in the ``FastSpecFit`` repository under
``doc/nb/``:

- `tutorial-fastspecfit.ipynb`_ — running ``fastspec`` and ``fastphot``
  interactively and reading the results.
- `tutorial-kcorrections.ipynb`_ — computing custom K-corrections and
  rest-frame photometry from the best-fitting SED model.
- `tutorial-vmax.ipynb`_ — estimating :math:`V_{\rm max}` for luminosity
  function calculations.

DESI Tutorials
--------------

For a broader introduction to working with DESI data — including how to access
data, navigate the file system, and work with DESI spectra — see the `DESI
tutorials`_ repository. The `Getting Started`_ and `Digging Deeper`_
collections are particularly relevant for new users.

.. _`tutorial-fastspecfit.ipynb`: https://github.com/desihub/fastspecfit/blob/main/doc/nb/tutorial-fastspecfit.ipynb
.. _`tutorial-kcorrections.ipynb`: https://github.com/desihub/fastspecfit/blob/main/doc/nb/tutorial-kcorrections.ipynb
.. _`tutorial-vmax.ipynb`: https://github.com/desihub/fastspecfit/blob/main/doc/nb/tutorial-vmax.ipynb
.. _`DESI tutorials`: https://github.com/desihub/tutorials
.. _`Getting Started`: https://github.com/desihub/tutorials/tree/main/01_getting_started
.. _`Digging Deeper`: https://github.com/desihub/tutorials/tree/main/02_digging_deeper