You are here: Start » Filter Reference » Computer Vision » Image Segmentation » SegmentImage_Gray_Tiled

SegmentImage_Gray_Tiled

Module:	FoundationPro

Segments an image into blobs examining differences between pixels values, first pass is tiled.

Applications

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

Name	Type	Range	Description
inImage	Image		Input image
inRoi	Region *		Range of pixels to be processed
inMergingMethod	BlobMergingMethod		Defines a criterion by which two pixels can be merged into one blob
inConnectivity	RegionConnectivity
inMaxDifference	Integer	0 -	Maximal tonal difference that allows two pixels to be merged into one blob
inHysteresis	Integer		Change of MaxDifference between first and second iteration
inTonalDrift	Bool		When 'True' blobs can be merged even if the illumination is not even
inDirectional	Bool		When 'True' the filter can segment results of GradientDirAndPresenceImage
inMinArea	Integer	0 -	Minimal area of a blob that may be accepted
inMaxArea	Integer *		Minimal area of a blob that may be accepted
outBlobs	Region Array

Requirements

For input inImage only pixel formats are supported: 1⨯uint8, 3⨯uint8.

Read more about pixel formats in Image documentation.

Description

The filter segments the inImage image in two phases. In the first step segmentation is done within tiles, while in the second step blobs are merged between consecutive tiles.

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	Directional method only supports single-channel images.
DomainError	Not supported inImage pixel format in SegmentImage_Gray_Tiled. Supported formats: 1xUInt8, 3xUInt8.

Complexity Level

This filter is available on Advanced Complexity Level.

Filter Group

This filter is member of SegmentImage filter group.