You are here: Start » Filter Reference » Image Segmentation » SegmentImage_Gray

SegmentImage_Gray

Segments an image into blobs examining differences between neighbouring pixels values.

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	Region Array		Blobs extracted from the input image

Applications

Detection of objects of undefined shape, but characterized by uniform brightness and good contrast to the background.

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

Description of usage of this filter can be found in examples and tutorial: Mounts (Segmentation).

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 here: Error Handling

Error type	Description
DomainError	Not supported difference measure in SegmentImage_Gray.

Complexity Level

This filter is available on Advanced Complexity Level.

Filter Group

This filters is member of SegmentImage filter group.