toqito.states.trine
===================

.. py:module:: toqito.states.trine

.. autoapi-nested-parse::

   Trine states are states of linear polarization separated by 60°.





Module Contents
---------------

.. py:function:: trine()

   Produce the set of trine states (Slide 6 of [@Yard_2017_Lecture11]).

   The trine states are formally defined as:

   \[
       u_1 = |0\rangle, \quad
       u_1 = -\frac{1}{2}\left(|0\rangle + \sqrt{3}|1\rangle\right), \quad \text{and} \quad
       u_2 = -\frac{1}{2}\left(|0\rangle - \sqrt{3}|1\rangle\right).
   \]

   .. rubric:: Examples

   Generating the trine states can be done by simply invoking the function:

   ```python exec="1" source="above"
   from toqito.states import trine
   print(trine())
   ```

   :returns: Vector of trine states.