10.26. Compute Feature Centroids
Group (Subgroup)
Generic (Morphological)
Description
This Filter calculates the centroid of each Feature by determining the average X, Y, and Z position (in physical coordinates) of all the Cells belonging to the Feature. The per-cell coordinates are accumulated using Kahan compensated summation to limit floating-point round-off on features with large cell counts. An Is Periodic option is available: when enabled, a Feature that spans the full extent of an axis (touching both opposing faces of the Image Geometry) is treated as wrapping around to the opposite face, and its centroid on that axis is shifted by half the physical distance between the first and last cell centers. When Is Periodic is disabled, Features that intersect the outer surfaces of the sample will still have centroids calculated, but they will be centroids of the truncated part of the Feature that lies inside the sample.
A Feature with no Cells (an unused Feature Id) keeps a centroid of (0, 0, 0).
Input Cell Data
Parameter Name |
Parameter Type |
Parameter Notes |
Description |
|---|---|---|---|
Selected Image Geometry |
Geometry Selection |
Image |
The target geometry whose Features’ centroids will be calculated |
Cell Feature Ids |
Array Selection |
Allowed Types: int32 Comp. Shape: 1 |
Specifies to which feature each cell belongs. |
Input Feature Data
Parameter Name |
Parameter Type |
Parameter Notes |
Description |
|---|---|---|---|
Feature Attribute Matrix |
AttributeMatrixSelection |
The cell feature attribute matrix |
Output Feature Data
Parameter Name |
Parameter Type |
Parameter Notes |
Description |
|---|---|---|---|
Centroids |
DataObjectName |
DataPath to create the ‘Centroids’ output array |
|
Is Periodic |
Bool |
Should segment features wrap around the image data |
Example Pipelines
(03) Small IN100 Morphological Statistics
InsertTransformationPhase
(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.