9.32. Compute Feature Neighborhoods

Group (Subgroup)

Statistics (Morphological)

Description

For each feature, determine how many other features are within a user defined multiple of the average Equivalent Sphere Diameter of the centroid of the feature.

The algorithm for determining the number of Features is given below:

  1. Compute the average equivalent diameter for all features in a given phase

  2. Define a sphere centered at the Feature’s centroid and with radius equal to the average equivalent sphere diameter multiplied by the user defined multiple

  3. Check every other Feature’s centroid to see if it lies within the sphere and keep count and list of those that satisfy

  4. Repeat 2. & 3. for all Features

Output Notes

There are 2 outputs from this filter:

  • The “Number of Neighbors” for each feature

  • The list of “neighbor” features for each neighbor

Input Parameter(s)

Parameter Name

Parameter Type

Parameter Notes

Description

Multiples of Average Diameter

Scalar Value

Float32

Defines the search radius to use when looking for ‘neighboring’ Features

Selected Image Geometry

Geometry Selection

Image

The target geometry

Input Feature Data

Parameter Name

Parameter Type

Parameter Notes

Description

Equivalent Diameters

Array Selection

Allowed Types: float32 Comp. Shape: 1

Path to the array specifying the diameter of a sphere with the same volume as the Feature

Phases

Array Selection

Allowed Types: int32 Comp. Shape: 1

Path to the array specifying to which Ensemble each Feature belongs

Centroids

Array Selection

Allowed Types: float32 Comp. Shape: 3

Path to the array specifying the X, Y, Z coordinates of Feature center of mass

Output Feature Data

Parameter Name

Parameter Type

Parameter Notes

Description

Neighborhoods

DataObjectName

Number of Features that have their centroid within the user specified multiple of equivalent sphere diameters from each Feature

Neighborhood List

DataObjectName

List of the Features whose centroids are within the user specified multiple of equivalent sphere diameter from each Feature

Example Pipelines

  • (03) Small IN100 Morphological Statistics

  • InsertTransformationPhase

  • (06) SmallIN100 Synthetic

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.