Potential energy of electric dipole in uniform electric field
=============================================================

An electric dipole placed in an external uniform electric field possesses potential energy. The
less the angle between the dipole and the electric field is, the less is its potential energy.

**Conditions:**

#. The electric field must be spatially uniform across the small region occupied by the dipole.

**Links:**

#. `Wikipedia <https://en.wikipedia.org/wiki/Electric_dipole_moment#Energy_and_torque>`__.

.. py:currentmodule:: symplyphysics.laws.electricity.vector.potential_energy_of_electric_dipole_in_uniform_electric_field

.. py:data:: potential_energy

    :symbols;`potential_energy` of the electric dipole.

Symbol:
    :code:`U`

Latex:
    :math:`U`

Dimension:
    :code:`energy`


.. py:data:: electric_dipole_moment

    Vector of the :attr:`~symplyphysics.symbols.electrodynamics.electric_dipole_moment`.

Symbol:
    :code:`p`

Latex:
    :math:`{\vec p}`

Dimension:
    :code:`charge*length`


.. py:data:: electric_field

    Vector of the electric field. See :attr:`~symplyphysics.symbols.electrodynamics.electric_field_strength`.

Symbol:
    :code:`E`

Latex:
    :math:`{\vec E}`

Dimension:
    :code:`voltage/length`


.. py:data:: law

    :code:`U = -dot(p, E)`


    Latex:
        .. math::
            U = - \left( {\vec p}, {\vec E} \right)