.. _user_guide:


============
User Guide
============

This section provides comprehensive guidance for using SunPeek, from tutorials to technical reference.


Tutorials
---------

Step-by-step guides to get you started with SunPeek.

.. grid:: 1 2 2 2
    :gutter: 3

    .. grid-item-card:: WebUI Tutorial
        :link: webui_tutorial
        :link-type: ref

        Learn to use SunPeek through the web interface.
        Set up plants, upload data, and run Power Check analysis.

    .. grid-item-card:: Python Tutorial
        :link: python_tutorial
        :link-type: ref

        Use SunPeek programmatically with Python.
        From basic usage to advanced analysis workflows.


Reference
---------

In-depth documentation on SunPeek components and algorithms.

.. grid:: 1 2 2 2
    :gutter: 3

    .. grid-item-card:: Technical Reference
        :link: technical_reference
        :link-type: ref

        Detailed documentation on fluids, collectors, and algorithms.

    .. grid-item-card:: Operations
        :link: operations
        :link-type: ref

        Troubleshooting, database configuration, and automation.


.. seealso::

    - :doc:`API Reference </api_reference/index>` for Python API documentation
    - :ref:`contributing` for development and contribution guidelines



.. toctree::
    :maxdepth: 2
    :hidden:

    webui_tutorial/index
    python_tutorial/index
    technical_reference/index
    operations/index