.. _orientationdifference:

orientationdifference
*********************


**Syntax:** :code:`orientationdifference(phi, theta, alpha, phim, thetam)`

For each pixel :math:`x`, calculates angle between :math:`(\phi(x), \theta(x))` and :math:`(\phi_m, \theta_m)` and assigns that to the output image.This command does the same calculation than what :ref:`mainorientationcolor` command does, but outputs the angular difference values instead of color map, and does not weight the output values by the original geometry in any way.

This command can be used in the distributed processing mode. Use :ref:`distribute` command to change processing mode from local to distributed.

Arguments
---------

phi [input]
~~~~~~~~~~~

**Data type:** float32 image

The azimuthal angle of the local orientation direction. The angle is given in radians and measured from positive :math:`x`-axis towards positive :math:`y`-axis and is given in range :math:`[-\pi, \pi]`.

theta [input]
~~~~~~~~~~~~~

**Data type:** float32 image

The polar angle of the local orientation direction. The angle is given in radians and measured from positive :math:`z`-axis towards :math:`xy`-plane. The values are in range :math:`[0, \pi]`.

alpha [output]
~~~~~~~~~~~~~~

**Data type:** float32 image

The output image. The values are in range :math:`[0, \pi/2]`.

phim [input]
~~~~~~~~~~~~

**Data type:** real

The azimuthal angle of the main orientation direction in radians.

thetam [input]
~~~~~~~~~~~~~~

**Data type:** real

The polar angle of the main orientation direction in radians.

See also
--------

:ref:`cylindricality`, :ref:`cylinderorientation`, :ref:`plateorientation`, :ref:`mainorientationcolor`, :ref:`axelssoncolor`, :ref:`orientationdifference`