12.48. Rotate Euler Reference Frame
Group (Subgroup)
Processing (Conversion)
Description
This Filter performs a passive rotation (Right hand rule) of the Euler Angles about a user defined axis. The reference frame is being rotated and thus the Euler Angles necessary to represent the same orientation must change to account for the new reference frame. The user can set an angle and an axis to define the rotation of the reference frame.
For each Euler angle triplet the filter computes g' = g · R(n, ω), where g is the orientation matrix of the input Euler angles (Bunge ZXZ convention), R(n, ω) is the rotation matrix for the user-supplied axis n and angle ω, and g' is converted back to Euler angles. For a rotation about the sample Z axis this reduces to φ1' = φ1 − ω (mod 2π) with Φ and φ2 unchanged.
Units & Conventions
The rotation angle parameter is in degrees; the Euler angle data is in radians (Bunge ZXZ convention).
The rotation axis does not need to be normalized — the filter normalizes it internally. A zero-length axis (0,0,0) is rejected during preflight.
The selected Euler angles array is modified in place (no new array is created).
Output Euler angles are canonicalized to
φ1, φ2 ∈ [0, 2π)andΦ ∈ [0, π]by the double-precision conversion, then stored asfloat32. Because adoublejust below2πrounds up to thefloat32value6.2831855, a storedφ1/φ2can be numerically equal to (or a hair above)2π; treat the upper bound as inclusive at float32 precision.
Input Parameter(s)
Parameter Name |
Parameter Type |
Parameter Notes |
Description |
|---|---|---|---|
Rotation Axis-Angle [ |
Vector of Float32 Values |
Order=i,j,k,w (Deg) |
Axis-Angle in sample reference frame to rotate about. |
Input Data
Parameter Name |
Parameter Type |
Parameter Notes |
Description |
|---|---|---|---|
Input Euler Angles |
Array Selection |
Allowed Types: float32 Comp. Shape: 3 |
Three angles defining the orientation of the Cell in Bunge convention (Z-X-Z) |
Example Pipelines
EBSD_File_Processing/Read_EDAX_Ang_File
EBSD_File_Processing/Edax_IPF_Colors
EBSD_File_Processing/CI_Histogram
EBSD_File_Processing/EBSD_Hexagonal_Data_Analysis
EBSD_File_Processing/ImportEdaxOIMData
References
D. Rowenhorst, A. D. Rollett, G. S. Rohrer, M. Groeber, M. Jackson, P. J. Konijnenberg, and M. De Graef, “Consistent representations of and conversions between 3D rotations,” Modelling and Simulation in Materials Science and Engineering, vol. 23, no. 8, p. 083501, 2015. DOI: 10.1088/0965-0393/23/8/083501
License & Copyright
Please see the description file distributed with this Plugin
DREAM3D-NX Help
If you need help, need to file a bug report or want to request a new feature, please head over to the DREAM3DNX-Issues GitHub site where the community of DREAM3D-NX users can help answer your questions.