11.35. Neighbor Orientation Comparison (Bad Data)
Group (Subgroup)
Processing (Cleanup)
Description
This filter will change the value of a cell’s mask value from False to True based on the misorientation between the target
cell and it’s 6-face neighbors. This filter should be used to target isolated
voxels inside potential features (grains).
Algorithm Description
For each cell (voxel) in the input Image Geometry, if the Mask value of the target cell is FALSE,
then the misorientation between that cell and each of its 6-face
neighbor cells is calculated. If the number of misorientation values that fall below the
user defined threshold is equal to or greater than the user defined value of
Required Number of Neighbors then the current cells mask value is changed from
False to True.
The filter will iteratively reduce the required number of neighbors from 6 until it reaches the user defined number. So, if the user selects a required number of neighbors of 4, then the filter will run with a required number of neighbors of 6, then 5, then 4 before finishing.
During the algorithm since the mask array is being updated continuously, each time
the mask array is updated, any neighbors of that changed voxel are evaluated again
to check if that neighbor now has the required number of valid neighbors. If this
check ends up being true then that neighbor voxel is added to the list of voxels to check.
This can lead to a Flood Fill type of algorithm. The user should take care to examine
the output from this filter to ensure that the filter is not being overly aggressive about
changing voxels.
2D Versus 3D Note
If the user is processing a 2D data set, none of the voxels can have 6 neighbors since there are no neighbors is the +-Z directions.
Warning - Data Modification
Only the Mask value defining the cell as good or bad is changed. No other cell level array is modified.
Example Data
Example Input Image |
Example Output Image |
|---|---|
|
|
The Small IN100 data just after initial alignment filters have completed. |
The Small IN100 data just after running this filter with a Misorientation Tolerance of 5 degrees and a Required Number of Neighbors of 4. |
From the above before and after images you can see that this filter can help modify a mask that was generated through a simple threshold filter. This filter essentially uses neighbors to determine if a cell point should have had a mask value of false. The majority of cells that were changed from false or the black voxels, into valid IPF colored voxels, had a confidence index that fell just below the initial threshold applied (Confidence Index > 0.1 and Image Quality > 120). This filter determines that enough of that cell’s neighbors had a mask value of true, the misorientation was < 5 degrees and the cell had enough valid neighbors that the cell’s mask value was changed from false to true.
Input Parameter(s)
Parameter Name |
Parameter Type |
Parameter Notes |
Description |
|---|---|---|---|
Misorientation Tolerance (Degrees) |
Scalar Value |
Float32 |
Angular tolerance used to compare with neighboring Cells |
Required Number of Neighbors |
Scalar Value |
Int32 |
Minimum number of neighbor Cells that must have orientations within above tolerance to allow Cell to be changed |
Input Image Geometry
Parameter Name |
Parameter Type |
Parameter Notes |
Description |
|---|---|---|---|
Image Geometry |
Geometry Selection |
Image |
The target geometry |
Input Cell Data
Parameter Name |
Parameter Type |
Parameter Notes |
Description |
|---|---|---|---|
Cell Quaternions |
Array Selection |
Allowed Types: float32 Comp. Shape: 4 |
Specifies the orientation of the Cell in quaternion representation |
Cell Phases |
Array Selection |
Allowed Types: int32 Comp. Shape: 1 |
Specifies to which Ensemble each Cell belongs |
Input/Output Cell Data
Parameter Name |
Parameter Type |
Parameter Notes |
Description |
|---|---|---|---|
Cell Mask Array |
Array Selection |
Allowed Types: uint8, boolean Comp. Shape: 1 |
Used to define Cells as good or bad |
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 phase |
Example Pipelines
(02) Small IN100 Full Reconstruction
INL Export
04_Steiner Compact
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.