Back to Aurora Vision Studio website
	
                
                    
	
		
	You are here: 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.
 

 Advanced



