.. sectionauthor:: Robert Nikutta <robert.nikutta@noirlab.edu>
.. index::
   pair: notebook; list of

.. _sec_Notebooks:

Notebooks
=========

.. todo:: Complete below table

The table below lists many useful Jupyter notebooks (``*.ipynb``
files) that get you started with Data Lab. To use a notebook in your
Jupyter notebook server, copy the notebook file from the respective
link in the right-hand column of the table, then upload it into
your notebook server. Alternatively, you can run all Jupyter notebooks
on the `Astro Data Lab notebook server <https://datalab.noirlab.edu/devbooks>`_.

Some science examples also come with more detailed Guided Tutorials in
the Data Lab user manual.

.. table:: Links to various Jupyter notebooks
   :widths: auto

   +------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
   | What                                                                   | Where                                                                                                                                                                   |
   +========================================================================+=========================================================================================================================================================================+
   |                                                                                                                                                                                                                                                  |
   +------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
   | **Basic**                                                                                                                                                                                                                                        |
   +------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
   | Introduction to Data Lab                                               | `notebook_link <https://github.com/astro-datalab/notebooks-latest/blob/master/01_GettingStartedWithDataLab/02_GettingStartedWithDataLab.ipynb>`_                        |
   +------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
   |                                                                                                                                                                                                                                                  |
   +------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
   | **Science examples**                                                                                                                                                                                                                             |
   +------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
   | Star/galaxy/QSO classification                                         | :ref:`Guided tutorial <sec_StarGalaxyQSOClassification>` /                                                                                                              |
   |                                                                        | `notebook_link <https://github.com/astro-datalab/notebooks-latest/blob/master/03_ScienceExamples/StarGalQSOSeparation/StarGalQsoLSDR9.ipynb>`_                          |
   +------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
   | Probe large-scale structure in DECaLS                                  | :ref:`Guided tutorial <sec_ProbeLargeScaleStructureInDECaLS>` /                                                                                                         |
   |                                                                        | `notebook_link <https://github.com/astro-datalab/notebooks-latest/blob/master/03_ScienceExamples/LargeScaleStructure/LargeScaleStructureSdssLs.ipynb>`_                 |
   +------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
   | Discover faint Milky Way dwarf galaxies                                | :ref:`Guided tutorial <sec_DiscoverFaintMilkyWayDwarfGalaxies>` /                                                                                                       |
   |                                                                        | `notebook_link <https://github.com/astro-datalab/notebooks-latest/blob/master/03_ScienceExamples/DwarfGalaxies/DwarfGalaxiesInSmash.ipynb>`_                            |
   +------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
   | Times series analysis of an RR Lyrae star in Hydra II                  | :ref:`Guided tutorial <sec_RRLyraeTimeSeriesAnalysis>` /                                                                                                                |
   |                                                                        | `notebook_link <https://github.com/astro-datalab/notebooks-latest/blob/master/03_ScienceExamples/TimeSeriesAnalysisRrLyraeStar/TimeSeriesAnalysisOfRrLyraeStar.ipynb>`_ |
   +------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
   |                                                                                                                                                                                                                                                  |
   +------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
   | **Technical**                                                                                                                                                                                                                                    |
   +------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
   | AuthClient                                                             | `notebook_link <https://github.com/astro-datalab/notebooks-latest/blob/master/04_HowTos/AuthClient/How_to_use_the_Data_Lab_AuthClient.ipynb>`_                          |
   +------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
   | StoreClient                                                            | `notebook_link <https://github.com/astro-datalab/notebooks-latest/blob/master/04_HowTos/StoreClient/How_to_use_the_Data_Lab_StoreClient.ipynb>`_                        |
   +------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
   | QueryClient                                                            | `notebook_link <https://github.com/astro-datalab/notebooks-latest/blob/master/04_HowTos/QueryClient/How_to_use_the_Data_Lab_QueryClient.ipynb>`_                        |
   +------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
   | JobManager                                                             | [COMING SOON...]                                                                                                                                                        |
   +------------------------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------+