Acceleration of transfer between relative frames
================================================

Imagine two reference frames, one of which is fixed (:math:`S`) and the other one is moving (:math:`S'`). The motion of
a body stationary in moving frame :math:`S'` due to the motion of the frame itself is called transfer motion.
The acceleration related to such motion is called transfer acceleration. It is composed of the acceleration
of the moving frame relative to the fixed frame, centripetal acceleration and the acceleration due to uneven
rotation of the moving frame. The transfer acceleration only depends on the motion of frame :math:`S'` relative to
stationary frame :math:`S`, so its physical meaning would be that it is the acceleration in :math:`S` of a point stationary
in :math:`S'`.

**Links:**

#. `Wikipedia <https://ru.wikipedia.org/wiki/%D0%A1%D0%BB%D0%BE%D0%B6%D0%BD%D0%BE%D0%B5_%D0%B4%D0%B2%D0%B8%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5#%D0%A3%D1%81%D0%BA%D0%BE%D1%80%D0%B5%D0%BD%D0%B8%D0%B5>`__.

..
    TODO find English link

.. py:currentmodule:: symplyphysics.laws.kinematics.vector.acceleration_of_transfer_between_relative_frames



.. py:function:: transfer_acceleration_law(moving_frame_acceleration_, centripetal_acceleration_, rotation_acceleration_)

    Transfer acceleration as a sum of accelerations.

    Law:
        :code:`a_tr = a_0 + a_cp + a_rot`

    Latex:
        .. math::
            {\vec a}_\text{tr} = {\vec a}_0 + {\vec a}_\text{cp} + {\vec a}_\text{rot}

    :param moving\_frame\_acceleration\_: acceleration of :math:`S'` relative to :math:`S`

        Symbol: :code:`a_0`

        Latex: :math:`{\vec a}_0`

        Dimension: *acceleration*

    :param centripetal\_acceleration\_: centripetal acceleration of body in :math:`S'`

        Symbol: :code:`a_cp`

        Latex: :math:`{\vec a}_\text{cp}`

        Dimension: *acceleration*

    :param rotation\_acceleration\_: acceleration caused by non-uniform rotation of :math:`S'`

        Symbol: :code:`a_rot`

        Latex: :math:`{\vec a}_\text{rot}`

        Dimension: *acceleration*

    :return: transfer acceleration of body

        Symbol: :code:`a_tr`

        Latex: :math:`{\vec a}_\text{tr}`

        Dimension: *acceleration*


.. py:function:: moving_frame_acceleration_law(transfer_acceleration_, centripetal_acceleration_, rotation_acceleration_)

    Acceleration of :math:`S'` relative to :math:`S`.

    Law:
        :code:`a_0 = a_tr - (a_cp + a_rot)`

    Latex:
        .. math::
            {\vec a}_0 = {\vec a}_\text{tr} - ({\vec a}_\text{cp} + {\vec a}_\text{rot})

    :param transfer\_acceleration\_: transfer acceleration of body

        Symbol: :code:`a_tr`

        Latex: :math:`{\vec a}_\text{tr}`

        Dimension: *acceleration*

    :param centripetal\_acceleration\_: centripetal acceleration of body in :math:`S'`

        Symbol: :code:`a_cp`

        Latex: :math:`{\vec a}_\text{cp}`

        Dimension: *acceleration*

    :param rotation\_acceleration\_: acceleration caused by non-uniform rotation of :math:`S'`

        Symbol: :code:`a_rot`

        Latex: :math:`{\vec a}_\text{rot}`

        Dimension: *acceleration*

    :return: acceleration of :math:`S'` relative to :math:`S`

        Symbol: :code:`a_0`

        Latex: :math:`{\vec a}_0`

        Dimension: *acceleration*


.. py:function:: centripetal_acceleration_law(transfer_acceleration_, moving_frame_acceleration_, rotation_acceleration_)

    Centripetal acceleration in :math:`S'`.

    Law:
        :code:`a_cp = a_tr - (a_0 + a_rot)`

    Latex:
        .. math::
            {\vec a}_\text{cp} = {\vec a}_\text{tr} - ({\vec a}_0 + {\vec a}_\text{rot})

    :param transfer\_acceleration\_: transfer acceleration of body

        Symbol: :code:`a_tr`

        Latex: :math:`{\vec a}_\text{tr}`

        Dimension: *acceleration*

    :param moving\_frame\_acceleration\_: acceleration of :math:`S'` relative to :math:`S`

        Symbol: :code:`a_0`

        Latex: :math:`{\vec a}_0`

        Dimension: *acceleration*

    :param rotation\_acceleration\_: acceleration caused by non-uniform rotation of :math:`S'`

        Symbol: :code:`a_rot`

        Latex: :math:`{\vec a}_\text{rot}`

        Dimension: *acceleration*

    :return: centripetal acceleration of body in :math:`S'`

        Symbol: :code:`a_cp`

        Latex: :math:`{\vec a}_\text{cp}`

        Dimension: *acceleration*


.. py:function:: rotation_acceleration_law(transfer_acceleration_, moving_frame_acceleration_, centripetal_acceleration_)

    Acceleration due to non-uniform rotation of :math:`S'`.

    Law:
        :code:`a_rot = a_tr - (a_0 + a_cp)`

    Latex:
        .. math::
            {\vec a}_\text{rot} = {\vec a}_\text{tr} - ({\vec a}_0 + {\vec a}_\text{cp})

    :param transfer\_acceleration\_: transfer acceleration of body

        Symbol: :code:`a_tr`

        Latex: :math:`{\vec a}_\text{tr}`

        Dimension: *acceleration*

    :param moving\_frame\_acceleration\_: acceleration of :math:`S'` relative to :math:`S`

        Symbol: :code:`a_0`

        Latex: :math:`{\vec a}_0`

        Dimension: *acceleration*

    :param centripetal\_acceleration\_: centripetal acceleration of body in :math:`S'`

        Symbol: :code:`a_cp`

        Latex: :math:`{\vec a}_\text{cp}`

        Dimension: *acceleration*

    :return: acceleration caused by non-uniform rotation of :math:`S'`

        Symbol: :code:`a_rot`

        Latex: :math:`{\vec a}_\text{rot}`

        Dimension: *acceleration*