: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 `__