.. meta::
    :description lang=en:
        An in-depth look at the various functionality in the open-source TU Delft Astrodynamics toolbox (Tudat)


.. _user_guide:

******************************
User Guide
******************************
This section provides a detailed guide on how to use the functionalities of Tudat(Py).

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

    .. grid-item-card::
        :text-align: center

        **Propagation**
        ^^^

        Learn how to setup a propagation problem and simulation it with Tudat(Py).
        This includes the environment setup, dynamical models, and numerical integration of a state or state transition matrix.

        +++

        .. button-ref:: state_propagation
            :expand:
            :color: secondary
            :click-parent:

            To the propagation section

    .. grid-item-card::
        :text-align: center

        **Estimation**
        ^^^

        Learn how to setup an estimation problem with Tudat(Py).
        The section includes background information on how to setup observation models, simulate observations, load real data and perform the estimation.

        +++

        .. button-ref:: state_estimation
            :expand:
            :color: secondary
            :click-parent:

            To the estimation section

    .. grid-item-card::
        :text-align: center

        **Preliminary mission design**
        ^^^

        The preliminary mission design section introduces the transfer trajectory module of Tudat(Py).
        This includes the setup of powered and unpowered trajectories, in addition to swingby maneuvers.

        +++

        .. button-ref:: prelim_mission_design
            :expand:
            :color: secondary
            :click-parent:

            To the mission design section

    .. grid-item-card::
        :text-align: center

        **Mathematics**
        ^^^

        The mathematics section holds information about the interpolators implemented in Tudat(Py).

        +++

        .. button-ref:: mathematics
            :expand:
            :color: secondary
            :click-parent:

            To the mathematics section


The :ref:`tudatpy_submodules` section provides an overview of all modules available in TudatPy.

For more information on how to use TudatPy with other libraries, see the :ref:`optimization_pygmo` or :ref:`parallelization` sections.

.. toctree::
   :caption: Tudat(Py) user guide
   :hidden:

   /user-guide/state-propagation
   /user-guide/state-estimation
   /user-guide/prelim-mission-design
   /user-guide/mathematics
   Mathematical model definition <https://raw.githubusercontent.com/tudat-team/tudat-space/master/Tudat_mathematical_model_definition.pdf>
   /user-guide/tudatpy-submodules

.. toctree::
   :caption: Interface with other libraries
   :hidden:

   /user-guide/advanced-topics/optimization-pygmo
   /user-guide/advanced-topics/parallelization
   /user-guide/advanced-topics/post-processing-python

.. toctree::
   :caption: TudatPy Project Updates
   :hidden:

   /user-guide/project-updates/migration-guide