.. _tutorials:

=========
Tutorials
=========

If you've landed here without first reading through the :ref:`cookbook`, you're
encouraged to start there and come back.

If this is your **first time using PypeIt**, you're encouraged to read through
the :doc:`Shane Kast<kast_howto>` tutorial as a general example of how to use
PypeIt.  **You are also encouraged to pull example data from the DevSuite for
your instrument when learning how to use the software**; see :ref:`dev-suite`.

For examples of reductions for different types of data, we recommend the
following starting points:

    - **Long-slit data**: :doc:`Shane Kast<kast_howto>`

    - **Multi-slit data**: :doc:`Keck DEIMOS<deimos_howto>`

    - **NIR data**: :doc:`Keck MOSFIRE<mosfire_howto>`

    - **Echelle data**: :doc:`Gemini GNIRS<gnirs_howto>`

For additional instrument-specific recommendations, please see the links at the
bottom of the :doc:`../spectrographs/spectrographs` page.

----

.. toctree::
   :caption: Instrument-specific Tutorials
   :maxdepth: 1

   APF Levy <apf_howto>
   Gemini GNIRS <gnirs_howto>
   Keck DEIMOS <deimos_howto>
   Keck HIRES <hires_howto>
   Keck LRIS <lris_howto>
   Keck MOSFIRE <mosfire_howto>
   Keck NIRES <nires_howto>
   Keck NIRSPEC <nirspec_high_howto>
   Shane Kast <kast_howto>

----

.. toctree::
   :caption: Other Tutorials
   :maxdepth: 1

   2D Coadds <coadd2d_howto>