8.112. Require Minimum Number of Neighbors
Group (Subgroup)
Processing (Cleanup)
Description
This Filter sets the minimum number of contiguous neighboring Features a Feature must have to remain in the structure. Entering zero results in nothing changing. Entering a number larger than the maximum number of neighbors of any Feature generates an error (since all Features would be removed). The user needs to proceed conservatively here when choosing the value for the minimum to avoid accidentally exceeding the maximum. After Features are removed for not having enough neighbors, the remaining Features are coarsened iteratively, one Cell per iteration, until the gaps left by the removed Features are filled. Effectively, this is an isotropic Feature growth in the regions around removed Features.
The Filter can be run in a mode where the minimum number of neighbors is applied to a single Ensemble. The user can select to apply the minimum to one specific Ensemble.
WARNING: Feature Data Will Become Invalid
By modifying the cell level data, any feature data that was previously computed will most likely be invalid at this point. Filters that compute feature level data should be rerun to ensure accurate final results from your pipeline.
WARNING: NeighborList Removal
If the Cell Feature AttributeMatrix contains any NeighborList data arrays, those arrays will be REMOVED because those lists are now invalid. Re-run the Find Neighbors filter to re-create the lists.
Input Parameter(s)
Parameter Name |
Parameter Type |
Parameter Notes |
Description |
|---|---|---|---|
Minimum Number Neighbors |
Scalar Value |
UInt64 |
Number of neighbors a Feature must have to remain as a Feature |
Apply to Single Phase Only |
Bool |
Whether to apply minimum to single ensemble or all ensembles |
|
Phase Index |
Scalar Value |
UInt64 |
Which Ensemble to apply minimum to. Only needed if Apply to Single Phase Only is checked |
Input Cell Data
Parameter Name |
Parameter Type |
Parameter Notes |
Description |
|---|---|---|---|
Image Geometry |
Geometry Selection |
Image |
The target geometry |
Cell Feature Ids |
Array Selection |
Allowed Types: int32 Comp. Shape: 1 |
Specifies to which Feature each Element belongs |
Input Feature Data
Parameter Name |
Parameter Type |
Parameter Notes |
Description |
|---|---|---|---|
Number of Neighbors |
Array Selection |
Allowed Types: int32 Comp. Shape: 1 |
Number of contiguous neighboring Features for each Feature |
Feature Phases |
Array Selection |
Allowed Types: int32 Comp. Shape: 1 |
Specifies to which Ensemble each Feature belongs. Only required if Apply to Single Phase Only is checked |
Cell Arrays to Ignore |
MultiArraySelection |
The arrays to ignore when applying the minimum neighbors algorithm |
Example Pipelines
(10) SmallIN100 Full Reconstruction
(06) SmallIN100 Postsegmentation Processing
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.