DREAM3D User Manual
Find Field Average Orientations

Group (Subgroup)

Statistics Filters (Crystallographic)

Description

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

  1. Gather all Cells that belong to the Field
  1. Using the symmetry operators of the phase of the Field, rotate the quaternion of the Field's first Cell into the Fundamental Zone nearest to the origin.
  2. Rotate each subsequent Cell's quaternion (with same symmetry operators) looking for the quaternion closest to the quaternion selected in Step 2.
  1. Average the rotated quaternions for all Cells and store as the average for the Field

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.

Parameters

None

Required DataContainers

Voxel

Required Arrays

Type Default Name Description Comment Filters Known to Create Data
Cell GrainIds Ids (ints) that specify to which Field each Cell belongs. Values should be present from segmentation of experimental data or synthetic generation and cannot be determined by this filter. Not having these values will result in the filter to fail/not execute. Segment Fields (Misorientation, C-Axis Misorientation, Scalar) (Reconstruction), Read Dx File (IO), Read Ph File (IO), Pack Primary Phases (SyntheticBuilding), Insert Precipitate Phases (SyntheticBuilding), Establish Matrix Phase (SyntheticBuilding)
Cell Quats Five (5) values (floats) that specify the orientation of the Cell in quaternion representation Filter will calculate the quaternion for each Cell if it is not already calculated. Find Cell Quaternions (Generic)
Cell CellPhases Phase Id (int) specifying the phase of the Cell Values should be present from experimental data or synthetic generation and cannot be determined by this filter. Not having these values will result in the filter to fail/not execute. Read H5Ebsd File (IO), Pack Primary Phases (SyntheticBuilding), Insert Precipitate Phases (SyntheticBuilding), Establish Matrix Phase (SyntheticBuilding)
Ensemble CrystalStructures Enumeration (int) specifying the crystal structure of each Ensemble/phase (Hexagonal=0, Cubic=1, Orthorhombic=2) Values should be present from experimental data or synthetic generation and cannot be determined by this filter. Not having these values will result in the filter to fail/not execute. Read H5Ebsd File (IO), Read Ensemble Info File (IO), Initialize Synthetic Volume (SyntheticBuilding)

Created Arrays

Type Default Name Comment
Field AvgQuats Four (4) values (floats) defining the average orientation of the Field in quaternion representation (<x,y,z>, w)
Field FieldEulerAngles Three (3) angles (floats) defining the orientation of each Field in Bunge convention (Z-X-Z)

Authors

Copyright: 2012 Michael A. Groeber (AFRL),2012 Michael A. Jackson (BlueQuartz Software)

Contact Info: dream.nosp@m.3d@b.nosp@m.luequ.nosp@m.artz.nosp@m..net

Version: 1.0.0

License: See the License.txt file that came with DREAM3D.

See a bug? Does this documentation need updated with a citation? Send comments, corrections and additions to The DREAM3D development team