8.47. Compute Surface Features
Group (Subgroup)
Generic (Spatial)
Description
This Filter determines whether a Feature touches an outer surface of the sample. This is accomplished by simply querying the Feature owners of the Cells that sit at either . Any Feature that owns one of those Cells is said to touch an outer surface and all other Features are said to not touch an outer surface of the sample.
This Filter determines whether a Feature touches an outer Surface of the sample volume. A Feature is considered touching the Surface of the sample if either of the following conditions are met:
Any cell location is xmin, xmax, ymin, ymax, zmin or zmax
Any cell has Feature ID = 0 as a neighbor.
The output of this filter is a Feature level array of booleans where 0=Interior/Not touching and 1=Surface/Touching.
WARNING - Feature ID=0 Voxels
If there are voxels within the volume that have Feature ID=0 then any feature touching those voxels will be considered a Surface feature.
WARNING - Fixed bugs
The version of this filter in legacy DREAM3D-NX (version 6.x) had two bugs: one that indexed into neighboring features incorrectly DREAM3D-NX repo issue #988, and another that incorrectly labeled feature 0 as a surface feature when feature 0 exists in the feature ids array DREAM3D-NX repo issue #989. Both of these bugs have been fixed in this new version.
2D Image Geometry
If the structure/data is actually 2D, then the dimension that is planar is not considered and only the Features touching the edges are considered surface Features.
Example Output
|
|
Example showing features touching Feature ID=0 (Black voxels) “Mark Feature 0 Neighbors” is ON |
Example showing features touching the outer surface of the bounding box |
Input Parameter(s)
Parameter Name |
Parameter Type |
Parameter Notes |
Description |
|---|---|---|---|
Mark Feature 0 Neighbors |
Bool |
Marks features that are neighbors with feature 0. If this option is off, only features that reside on the edge of the geometry will be marked. |
Input Cell Data
Parameter Name |
Parameter Type |
Parameter Notes |
Description |
|---|---|---|---|
Feature Geometry |
Geometry Selection |
Image |
The geometry in which to find surface features |
Cell Feature Ids |
Array Selection |
Allowed Types: int32 Comp. Shape: 1 |
Specifies to which feature each cell belongs. |
Input Cell Feature Data
Parameter Name |
Parameter Type |
Parameter Notes |
Description |
|---|---|---|---|
Feature Attribute Matrix |
AttributeMatrixSelection |
The path to the cell feature attribute matrix associated with the input feature ids array |
Output Feature Data
Parameter Name |
Parameter Type |
Parameter Notes |
Description |
|---|---|---|---|
Surface Features |
DataObjectName |
The created surface features array. Flag of 1 if Feature touches an outer surface or of 0 if it does not |
Example Pipelines
(06) SmallIN100 Synthetic
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.