Find Biased Features (Bounding Box)¶
Group (Subgroup)¶
Generic (Spatial)
Description¶
This Filter determines which Features are biased by the outer surfaces of the sample. Larger Features are more likely to intersect the outer surfaces and thus it is not sufficient to only note which Features touch the outer surfaces of the sample. Denoting which Features are biased is important so that they may be excluded from any statistical analyses. The algorithm for determining whether a Feature is biased is as follows:
- The centroids of all Features are calculated
- All Features are tested to determine if they touch an outer surface of the sample
- The largest box is found that does not include any of the centroids of Features that intersect an outer surface of the sample
- Each Feature's centroid is checked to see whether it lies within the box.
If a Feature's centroid lies within the box, then the Feature is said to be unbiased, and if it lies outside the box, then the Feature is said to be biased.
By definition of the box, no Feature that intersects an outer surface of the sample can be considered unbiased, but it should be noted that Features that do not intersect the outer surfaces may still be considered biased. This algorithm works to determine the biased Features because all Features have one (and only one) centroid, no matter their size. Generally, this method will deem more small Features biased than the set of Features that just intersect the outer surfaces - and this corrects for the increased likelihood that larger Features will touch an outer surface.
Note: This Filter is a modification of an algorithm from Dave Rowenhorst (Naval Research Laboratory).
Parameters¶
| Name | Type | Description |
|---|---|---|
| Apply Phase by Phase | int32_t | Whether to apply the biased Features algorithm per Ensemble |
Required Geometry¶
Image
Required Objects¶
| Kind | Default Name | Type | Component Dimensions | Description |
|---|---|---|---|---|
| Feature Attribute Array | Centroids | float | (3) | X, Y, Z coordinates of Feature center of mass |
| Feature Attribute Array | SurfaceFeatures | bool | (1) | Flag of 1 if Feature touches an outer surface or of 0 if it does not |
| Feature Attribute Array | Phases | int32_t | (1) | Specifies to which Ensemble each Feature belongs. Only required if Apply Phase by Phase is checked |
Created Objects¶
| Kind | Default Name | Type | Component Dimensions | Description |
|---|---|---|---|---|
| Feature Attribute Array | BiasedFeatures | bool | (1) | Flag of 1 if Feature is biased or of 0 if it is not |
Example Pipelines¶
- (06) SmallIN100 Synthetic
License & Copyright¶
Please see the description file distributed with this Plugin
DREAM.3D Mailing Lists¶
If you need more help with a Filter, please consider asking your question on the DREAM.3D Users Google group!