.. _basics_label:

Introductory Tutorials
~~~~~~~~~~~~~~~~~~~~~~

In this section we will introduce how to create your first simple TESPy models.
In the intro part you learn about the modeling concept of TESPy. The other
subsections are step by step walkthroughs for well-known thermodynamic
applications.

If you want to learn more about the details of the different parts of the
software, you should also have a look at this
:ref:`documentation section <building_blocks_label>` after the first steps. If
you have any questions please reach out to the
:ref:`TESPy community <community_label>`. There are regular online
meetings as well as a discussion forum on GitHub.


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

    .. grid-item-card::  Introduction: Learn the basic modeling concept of TESPy
        :link: basics_intro_label
        :link-type: ref

        .. image:: /_static/images/thumbnails/getting_started/modeling_concept.svg
            :align: center
            :class: only-light

        .. image:: /_static/images/thumbnails/getting_started/modeling_concept_darkmode.svg
            :align: center
            :class: only-dark

    .. grid-item-card::  Heat Pump
        :link: basics_heat_pump_label
        :link-type: ref

        .. image:: /_static/images/thumbnails/getting_started/heat_pump.svg
            :class: only-light

        .. image:: /_static/images/thumbnails/getting_started/heat_pump_darkmode.svg
            :class: only-dark

    .. grid-item-card::  Clausius Rankine Cycle
        :link: basics_rankine_cycle_label
        :link-type: ref

        .. image:: /_static/images/thumbnails/getting_started/rankine_cycle.svg
            :class: only-light

        .. image:: /_static/images/thumbnails/getting_started/rankine_cycle_darkmode.svg
            :class: only-dark

    .. grid-item-card::  Gas Turbine
        :link: basics_gas_turbine_label
        :link-type: ref

        .. image:: /_static/images/thumbnails/getting_started/gas_turbine.svg
            :class: only-light

        .. image:: /_static/images/thumbnails/getting_started/gas_turbine_darkmode.svg
            :class: only-dark

    .. grid-item-card::  District Heating System
        :link: basics_district_heating_label
        :link-type: ref

        .. image:: /_static/images/thumbnails/getting_started/district_heating.svg
            :class: only-light

        .. image:: /_static/images/thumbnails/getting_started/district_heating_darkmode.svg
            :class: only-dark

..  toctree::
    :maxdepth: 1
    :hidden:

    basic_tutorials/intro
    basic_tutorials/heat_pump
    basic_tutorials/rankine_cycle
    basic_tutorials/gas_turbine
    basic_tutorials/district_heating