.. _howtos:

#####################################
:octicon:`terminal;2em;green` Recipes
#####################################

Practical step-by-step guides to help you achieve a specific goal. Most useful when you're trying to get something done.


.. grid:: 1 2 2 2

    .. grid-item-card::
        :shadow: md
        :margin: 2 2 0 0

        :octicon:`rocket;3em;green` **Velocity Definitions and Rest Frames**

        How to change velocity definitions and reference frames

        .. button-link:: examples/velocity_frames.html
            :color: primary
            :outline:
            :click-parent:

            Velocity & Frames


    .. grid-item-card::
        :shadow: md
        :margin: 2 2 0 0

        :octicon:`file;3em;green` **Metadata Management**

        How to interact with the metadata of an SDFITS file

        .. button-link:: examples/metadata_management.html
            :color: primary
            :outline:
            :click-parent:

            Metadata Management


    .. grid-item-card::
        :shadow: md
        :margin: 2 2 0 0

        :octicon:`pulse;3em;green` **Smoothing**

        How to smooth data

        .. button-link:: examples/smoothing.html
            :color: primary
            :outline:
            :click-parent:

            Smoothing

    .. grid-item-card::
        :shadow: md
        :margin: 2 2 0 0

        :material-outlined:`save;3em;green` **Data IO**

        How to read and save data

        .. button-link:: examples/dataIO.html
            :color: primary
            :outline:
            :click-parent:

            Data IO

    .. grid-item-card::
        :shadow: md
        :margin: 2 2 0 0

        :material-outlined:`compare_arrows;3em;green` **Align Spectra**


        How to align spectra


        .. button-link:: examples/align_spectra.html
            :color: primary
            :outline:
            :click-parent:

            Align Spectra

    .. grid-item-card::
        :shadow: md
        :margin: 2 2 0 0

        :material-outlined:`flag;3em;green` **Flagging**

        How to flag data


        .. button-link:: examples/flagging.html
            :color: primary
            :outline:
            :click-parent:

            Flagging

    .. grid-item-card::
        :shadow: md
        :margin: 2 2 0 0

        :material-outlined:`balance;3em;green` **Spectral Weights**

        How to set and use spectral weights


        .. button-link:: examples/using_spectral_weights.html
            :color: primary
            :outline:
            :click-parent:

            Spectral Weights

    .. grid-item-card::
        :shadow: md
        :margin: 2 2 0 0

        :material-outlined:`123;3em;green` **Repeated Scan Numbers**

        How to work with repeated scan numbers


        .. button-link:: examples/repeated_scans.html
            :color: primary
            :outline:
            :click-parent:

            Repeated Scans

    .. grid-item-card::
        :shadow: md
        :margin: 2 2 0 0

        :material-outlined:`troubleshoot;3em;green` **Gaussian Fitting**

        How to fit Gaussian profiles


        .. button-link:: examples/gauss_fit.html
            :color: primary
            :outline:
            :click-parent:

            Gaussian Fitting

    .. grid-item-card::
        :shadow: md
        :margin: 2 2 0 0

        :material-outlined:`line_curve;3em;green` **Custom Baseline Fitting**

        How to fit a custom baseline model


        .. button-link:: examples/custom_baseline.html
            :color: primary
            :outline:
            :click-parent:

            Custom Baseline Fitting

    .. grid-item-card::
        :shadow: md
        :margin: 2 2 0 0

        :octicon:`versions;3em;green` **Merging SDFITS**

        How to merge SDFITS files


        .. button-link:: examples/merge_sdfits.html
            :color: primary
            :outline:
            :click-parent:

            Merging SDFITS Files

    .. grid-item-card::
        :shadow: md
        :margin: 2 2 0 0

        :material-outlined:`network_ping;3em;green` **Aperture Efficiency and Surface Error**

        How to provide aperture efficiency or surface error


        .. button-link:: examples/apeff_surferr.html
            :color: primary
            :outline:
            :click-parent:

            How to provide aperture efficiency or surface error


    .. grid-item-card::
        :shadow: md
        :margin: 2 2 0 0

        :material-outlined:`query_stats;3em;green` **Data Quality Checks**

        How to use data quality functions


        .. button-link:: examples/quality.html
            :color: primary
            :outline:
            :click-parent:

            How to use data quality functions

    .. grid-item-card::
        :shadow: md
        :margin: 2 2 0 0

        :material-outlined:`align_vertical_bottom;3em;green` **Spectral Line Search**

        Search for potential spectral lines


        .. button-link:: examples/line_search.html
            :color: primary
            :outline:
            :click-parent:

            How to use search for potential spectral lines, including within
            a given Spectrum.

.. toctree::
   :maxdepth: 4
   :hidden:

   examples/velocity_frames
   examples/metadata_management
   examples/smoothing
   examples/dataIO
   examples/align_spectra
   examples/flagging
   examples/using_spectral_weights
   examples/repeated_scans
   examples/gauss_fit
   examples/custom_baseline
   examples/merge_sdfits
   examples/apeff_surferr
   examples/quality
   examples/line_search