Tutorials
=========

Tutorials are packaged with CryoSwath and assume the package is installed
in the active Python environment. After installation, copy them into a
project directory with:

.. code-block:: sh

   cryoswath get-tutorials

By default, notebooks are copied to ``tutorials/`` below the current project
directory. Use ``--destination`` to choose another location. They can also be
viewed on GitHub.

Available notebooks
-------------------

1. `tutorial__diagnostic_hooks.ipynb <https://github.com/j-haacker/cryoswath/blob/main/cryoswath/tutorials/tutorial__diagnostic_hooks.ipynb>`_
   Explore diagnostic hooks for introspecting hypsometric interpolation.
2. `tutorial__general_step-by-step.ipynb <https://github.com/j-haacker/cryoswath/blob/main/cryoswath/tutorials/tutorial__general_step-by-step.ipynb>`_
   End-to-end walkthrough from L1b to gridded trend products.
3. `tutorial__process_first_waveform.ipynb <https://github.com/j-haacker/cryoswath/blob/main/cryoswath/tutorials/tutorial__process_first_waveform.ipynb>`_
   Inspect and understand a single waveform.
4. `tutorial__process_first_swath.ipynb <https://github.com/j-haacker/cryoswath/blob/main/cryoswath/tutorials/tutorial__process_first_swath.ipynb>`_
   Process and visualize one track as swath data.
5. `tutorial__poca.ipynb <https://github.com/j-haacker/cryoswath/blob/main/cryoswath/tutorials/tutorial__poca.ipynb>`_
   Retrieve and inspect POCA solutions.

These notebooks are intended as practical guides and reference examples
for configuring your own workflows.