10.5. Compute Feature Average Orientations

Group (Subgroup)

Statistics (Crystallographic)

Description

This Filter determines the average orientation of each Feature by the following algorithm:

  1. Gather all Elements that belong to the Feature

  2. Using the symmetry operators of the phase of the Feature, rotate the quaternion of the Feature’s first Element into the Fundamental Zone nearest to the origin

  3. Rotate each subsequent Elements’s quaternion (with same symmetry operators) looking for the quaternion closest to the quaternion selected in Step 2

  4. Average the rotated quaternions for all Elements and store as the average for the Feature

Note: The process of finding the nearest quaternion in Step 3 is to account for the periodicity of orientation space, which would cause problems in the averaging if all quaternions were forced to be rotated into the same Fundamental Zone

Note: The quaternions can be averaged with a simple average because the quaternion space is not distorted like Euler space.

Input Cell Data

Parameter Name

Parameter Type

Parameter Notes

Description

Cell Feature Ids

Array Selection

Allowed Types: int32 Comp. Shape: 1

Specifies to which Feature each Cell belongs.

Cell Phases

Array Selection

Allowed Types: int32 Comp. Shape: 1

Specifies to which Ensemble each Cell belongs

Cell Quaternions

Array Selection

Allowed Types: float32 Comp. Shape: 4

Specifies the orientation of the Cell in quaternion representation

Input Ensemble Data

Parameter Name

Parameter Type

Parameter Notes

Description

Crystal Structures

Array Selection

Allowed Types: uint32 Comp. Shape: 1

Enumeration representing the crystal structure for each Ensemble

Input Feature Data

Parameter Name

Parameter Type

Parameter Notes

Description

Feature Attribute Matrix

AttributeMatrixSelection

The path to the cell feature attribute matrix

Output Feature Data

Parameter Name

Parameter Type

Parameter Notes

Description

Average Quaternions

DataObjectName

The name of the array specifying the average orientation of the Feature in quaternion representation

Average Euler Angles

DataObjectName

The name of the array specifying the orientation of each Feature in Bunge convention (Z-X-Z)

Example Pipelines

  • (10) SmallIN100 Full Reconstruction

  • InsertTransformationPhase

  • (06) SmallIN100 Postsegmentation Processing

  • (05) SmallIN100 Crystallographic Statistics

  • (06) SmallIN100 Synthetic

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.