Back to FabImage Studio website
You are here: Start » Filter Reference » Region Global Transforms » SplitRegionIntoComponents
SplitRegionIntoComponents
Splits a region into an array of regions. Operates by merging blobs in accordance to the inMaxDistance parameter.
| Name | Type | Range | Description | |
|---|---|---|---|---|
 |
inRegion | Region | Input region | |
|
inMaxDistance | Integer* | 0 -  |
|
|
inDistanceBalance | Real | -1.0 - 1.0 | Defines how much important the distance between regions in x coordinate is according to distance in y coordinate |
|
inMaxJointDiameter | Real* | 0.0 - |
|
|
inMaxJointWidth | Integer* | 0 - |
|
|
inMaxJointHeight | Integer* | 0 - |
|
|
inMinComponentArea | Integer | 0 - |
Minimal area of a resulting component |
|
inMaxComponentArea | Integer* | 0 - |
Maximal area of a resulting component |
|
inRemoveBoundaryBlobs | Bool | Flag indicating whether the blobs on border of the input region should be removed or not | |
 |
outComponents | RegionArray | ||
Description
The filter splits the input region into blobs and iteratively joins some of them into bigger components.
Only blobs that are distant from each other by at most inMaxDistance can be joined. The joining order
is determined based on modified distance between two blobs, so the closest ones are joined first.
This modified distance between two blobs is computed as follows:
- The shortest segment connecting two blobs is computed.
- The segment is scaled by \[ 0.5 \cdot (1 + inDistanceBalance) \] along the X axis and by \[ 0.5 \cdot (1 - inDistanceBalance) \] along the Y axis.
- Finally the length of the so scaled segment is computed.
Examples
 |
 |
SplitRegionIntoComponents used with inMaxDistance = 50.
Remarks
This filter is mostly used in Blob Analysis Technique please refer to our Machine Vision Guide - Blob Analysis article.
Complexity Level
This filter is available on Basic Complexity Level.
Filter Group
This filters is member of SplitRegionIntoComponents filter group.
