:topic: Orientation Utility

.. index::
   pair: DREAM3D; Orientation Utility;

.. _OrientationUtility:

Orientation Utility
########################

Description
========================

This **Utility** allows the user to compute alternate representations of
an orientation based on a another representation. The supported
representations are:

-  Euler Angles
-  Axis Angle
-  Cubochoric
-  Homochoric
-  Orientation Matrix
-  Quaternion
-  Rodrigues
-  Stereographic Coordinates

To access the utility, go to the **Tools** menu in the menu bar and
click on **Orientation Utility**.

.. figure:: Images/OrientationUtility.png
   :alt: Orientation Utility

   The Orientation Utility User Interface

To use the utility, simply start entering values for a representation.
The other representations will be instantly calculated as shown in
figure 1 below. 

**The Axis-Angle and Rodrigues vectors are automatically normalized for the user.**

.. figure:: Images/OrientationUtility_1.png
   :alt: Orientation Utility where the user has entered an Axis-Angle representation.

If the user enters invalid values for a representation, an error message
will be displayed and all input fields will be marked with the **NaN**
symbol as show in figure 2 below.

.. figure:: Images/OrientationUtility_2.png
   :alt: User has entered an out of range angle for the Axis-Angle pair.


References
========================

`Consistent representations of and conversions between 3D rotations D
Rowenhorst, A D Rollett, G S Rohrer, M Groeber, M Jackson, P J
Konijnenberg, and M De Graef Published 5 October 2015 2015 IOP
Publishing Ltd Modelling and Simulation in Materials Science and
Engineering, Volume 23, Number
8 <http://iopscience.iop.org/article/10.1088/0965-0393/23/8/083501>`__
