Tutorials
=========

Step-by-step notebooks covering the main use cases of ``spectroxide``, from a
quick-start introduction through advanced dark-sector and observational
constraint analyses.

.. toctree::
   :maxdepth: 1

   01_getting_started
   02_energy_injection
   03_new_physics
   04_custom_scenarios
   05_observational_constraints
   06_greens_table

.. list-table::
   :widths: 5 40
   :header-rows: 0

   * - **01**
     - **Getting started** --- Green's function basics, first PDE runs, PDE vs GF comparison.
   * - **02**
     - **Energy injection** --- Decaying particles, DM annihilation (s-wave, p-wave), amplitude scaling.
   * - **03**
     - **New physics** --- Dark photon oscillation, monochromatic photon injection, :math:`\mu` sign flip.
   * - **04**
     - **Custom scenarios** --- Tabulated heating histories, custom injection closures.
   * - **05**
     - **Observational constraints** --- FIRAS/PIXIE limits, :math:`\mu`--:math:`y` exclusion plane, mock PIXIE observation.
   * - **06**
     - **Green's function tables** --- Precomputed PDE-based tables for fast convolution.