12.8. Compute Feature Neighbor C-Axis Misalignments
Group (Subgroup)
Statistics (Crystallography)
Description
This Filter computes the C-axis misalignment angle between each Feature (grain) and its neighbors in hexagonal materials. The C-axis misalignment is the angular difference between the C-axis directions of two neighboring grains – it measures how closely their unique crystallographic axes are aligned.
This is distinct from a full misorientation, which considers the complete rotational difference between two crystal orientations. C-axis misalignment only considers the alignment of the [001] direction, which is often the most mechanically significant axis in hexagonal materials.
Flexible Neighbor Definition
The neighbor list is supplied by the user and can come from any filter that produces neighbor relationships. For example:
Compute Feature Neighbors – neighbors that physically share a boundary
Compute Feature Neighborhoods – neighbors within a specified radius
Any other custom filter that generates a neighbor list
The filter also optionally computes the average misalignment across all of a feature’s neighbors.
Hexagonal Materials Only
Only Features with identical phase values and a crystal structure of Hexagonal_High (6/mmm) or Hexagonal_Low (Hexagonal 6/m (C6h)) are compared. If two Features have different phases or a non-hexagonal crystal structure, a value of NaN is stored for the misalignment. See the Compute Average C-Axis Orientations documentation for an explanation of why C-axis calculations are restricted to hexagonal materials.
Note
Results from this filter may differ from the original DREAM.3D 6.5 version by approximately 0.0001 degrees due to the use of double precision and Eigen for matrix operations.
Required Input Sources
Neighbor List – produced by Compute Feature Neighbors or Compute Feature Neighborhoods.
Average Quaternions – produced by Compute Average Orientations.
Feature Phases – produced by Compute Feature Phases.
Crystal Structures – ensemble-level array read from EBSD data or created by Create Ensemble Info.
Input Parameter(s)
Parameter Name |
Parameter Type |
Parameter Notes |
Description |
|---|---|---|---|
Find Average Misalignment Per Feature |
Bool |
Whether the average of the C-axis misalignments with the neighboring Features should be stored for each Feature |
Input Feature Data
Parameter Name |
Parameter Type |
Parameter Notes |
Description |
|---|---|---|---|
Neighbor List |
NeighborListSelection |
List of the contiguous neighboring Features for a given Feature |
|
Average Quaternions |
Array Selection |
Allowed Types: float32 Comp. Shape: 4 |
Defines the average orientation of the Feature in quaternion representation |
Phases |
Array Selection |
Allowed Types: int32 Comp. Shape: 1 |
Specifies to which Ensemble each Feature belongs |
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 |
Output Feature Data
Parameter Name |
Parameter Type |
Parameter Notes |
Description |
|---|---|---|---|
Feature C-Axis Misalignment NeighborList |
DataObjectName |
NeighborList of the C-axis misalignment angles (in degrees) with the contiguous neighboring Features for a given Feature |
|
Feature Average C-Axis Misalignments |
DataObjectName |
Number weighted average of neighbor C-axis misalignments. Only created if Find Average Misalignment Per Feature is checked |
Example Pipelines
EBSD_Hexagonal_Data_Analysis
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.