Start » Filter Reference » Computer Vision » Image Segmentation » SegmentImage_Gray
Module: | FoundationPro |
---|
Segments an image into blobs examining differences between neighbouring pixels values.
Applications
Detection of objects of undefined shape, but characterized by uniform brightness and good contrast to the background.
Name | Type | Range | Description | |
---|---|---|---|---|
![]() |
inImage | Image | Image from which blobs are extracted | |
![]() |
inRoi | Region* | Range of pixels to be processed | |
![]() |
inMaxDifference | Real | 0.0 - ![]() |
Maximal difference between two neighbouring blobs to be merged |
![]() |
inDifferenceMeasure | BlobsDifferenceMeasure | Measure of blobs difference | |
![]() |
inMinArea | Integer | 0 - ![]() |
Minimal area of a blob |
![]() |
inMaxArea | Integer* | 0 - ![]() |
Maximal area of a blob |
![]() |
outBlobs | RegionArray | Blobs extracted from the input image |
Description
The filter segments the inImage image into blobs of adjacent pixels which gray values do not differ too much. The classification is different depending on the inDifferenceMeasure method:
- if Mean is selected, pixel is considered to belong to an adjacent blob when its value differs by at most inMaxDifference from the mean value of this blob's pixels
- if Neighbour is selected, two adjacent pixels are considered to belong to the same blob when their values differ by at most inMaxDifference
Examples
![]() |
![]() |
SegmentImage_Gray performed on the sample image with inMaxDifference = 55, inDifferenceMeasure = Mean and inMinArea = 50.
Errors
This filter can throw an exception to report error. Read how to deal with errors in Error Handling.
List of possible exceptions:
Error type | Description |
---|---|
DomainError | Not supported difference measure in SegmentImage_Gray. |
Complexity Level
This filter is available on Advanced Complexity Level.
See Also
- SegmentImage_Edges – Segments an image into blobs using image edges as their borders.
- SegmentImage_Watersheds – Computes dark or bright watershed basins of an image.