2.6.3.4 imgMorph(Pro)

1 Menu Information
2 Brief Information
3 Additional Information
4 Command Line Usage
5 X-Function Execution Options
6 Variables
7 Description
8 Examples
9 Algorithm
10 References
11 Related X-Functions

Menu Information

Image: Arithmetic Transform: Morphological Filter

Brief Information

Apply morphological filter to matrix or image

Additional Information

This feature is for OriginPro only.

Command Line Usage

1. imgMorph op:=open emode:=diamond r:=5;

2. imgMorph op:=erosion emode:=rec col:=5 row:=4;

X-Function Execution Options

Please refer to the page for additional option switches when accessing the x-function from script

Variables

Display Name	Variable Name	I/O and Type	Default Value	Description
Input Image	im	Input MatrixObject	<active>	Specifies the input image, which should be a numeric matrix, a grayscale image or a binary image. The default input is the active image.
Output Image	om	Output MatrixObject	<new>	Specifies the output image. By default, a new image will be created and used as output. See the syntax here.
Operation	op	Input int	open	Specifies the morphological operation to perform. Option list dilation:Dilation Incorporates each object all the background points that are in contact of it, causing the object to grow in size. This operation can be used to removing holes in segmented objects. erosion:Erosion Decreases the size of the objects by one pixel all around its perimeter. This operation can be used to remove objects that are too small. open:Open Performs erosion and then dilation on the objects. Small and thin objects can be removed, without significantly changing the areas of the larger objects. close:Close Performs dilation and then erosion on the objects. Small holes in objects can be filled and nearby objects can be connected. However, the areas of the objects are not affected significantly.
Flat Element	flat	Input int	1	Specifies whether or not to use a flat structuring element.
Height Matrix	hm	Input MatrixObject	<optional>	This variable is available only when Flat Element is set to 0. It specifies the matrix that has the heights of the structuring element.
Create Element	emode	Input int	rec	Specifies the structuring element. Option list arb:Arbitrary Uses a matrix object to represent the structuring element. You can specify this matrix object with the Element variable. diamond:Diamond Creates a diamond-shaped object. You can specify its radius with the Radius variable. line:Line Creates a line object. You can specify its length and angle with two variables: Length and Angle. octagon:Octagon Creates an octagonal object. You can specify its radius with the Radius variable. pair:Pair Creates a structuring element containing a pair of dots. One dot locates in the center; the other one's location is determined by two variables: Row Offset and Column offset. pl:Periodicline Creates a structuring element that contains 2p+1 dots, where p is determined by the Points in One Side variable. The relative positions of the dots are determined by another two variables: Row Offset and Column offset. rec:Rectangle* Creates a rectangle object. You can specify its width and height with two variables: Column and Row. square:Square Creates a square object. You can specify its width with the Width variable.
Element Matrix	em	Input/Output MatrixObject	<optional>	This variable is available only when the Create Element variable is set to Arbitrary. You can use it to specify a matrix object that represents the structuring element.
Column	col	Input int	3	This variable is available only when the Create Element variable is set to Rectangle. It specifies the width of the rectangle.
Row	row	Input int	3	This variable is available only when the Create Element variable is set to Rectangle. It specifies the height of the rectangle.
Width	w	Input int	3	This variable is available only when the Create Element variable is set to Square. It specifies the width of the square.
Radius	r	Input int	3	This variable is available only when the Create Element variable is set to either Diamond or Octagon. It specifies the radius of the structuring object.
Row Offset	roffset	Input int	0	This variable is available only when the Create Element variable is set to either Periodicline or Pair. It specifies the row offset between two adjacent members.
Column Offset	coffset	Input int	0	This variable is available only when the Create Element variable is set to either Periodicline or Pair. It specifies the column offset between two adjacent members.
Length	len	Input int	5	This variable is available only when the Create Element variable is set to line. It specifies the length of the line object.
Angle (in degrees)	deg	Input int	5	This variable is available only when the Create Element variable is set to line. It specifies the angle for the line object. The unit is degree.
Points in One Side	np	Input int	5	This variable is available only when the Create Element variable is set to Periodicline. It specifies a number p. And then, there will be 2*p+1 dots in the structuring element.

Description

This X-Function is a tool for morphological image processing. It can be used on numeric matrices, grayscale images and binary images.

Generally speaking, morphological image processing is performed by passing a structuring element over the image in a convolution-like operation. The output image is determined by the size and shape of the structuring element, as well as the operation chosen. Morphological Filter is a very important tool widely used in suppressing noise, image segmentation, etc.

A structuring element can be of any shape and any size. It is a matrix consisting of only 0's and 1's, where the 1's defines the neighborhood. Using different shapes of structuring elements is likely to have different effects. And the selection of shape should be determined on a case-by-case basis. The rule of thumb is to choose a shape that is close to the geometric shape of the object of interest. The size of the structuring element is also influential. For example, in erosion operation, if you specify a larger size, only some larger elements in the image are preserved and more small elements are eliminated. If you specify a smaller size, the smaller elements and the details of the image will be more likely to be retained.

Four morphological operations are available in this tool. They are dilation, erosion, open and close. Erosion decreases the size of the objects in the input image, while dilation increases the object sizes. Opening eliminates small and thin objects, leaving the large objects without significant changes in area. Closing fills small holes in objects and smoothes the object boundaries, but it does not change the area of the objects in a significant way. You can choose among these operations according to your need.

Examples

In this example, the input image contains several square objects with different sizes. We use the imgMorph X-Function to remove the small objects from it. The procedure is as follows:

Create a new matrix and imports the image file into it.
When the image is active, select Image: Arithmetic Transform: Morphological Filter from the menu to open the dialog of the X-Function.
In the X-Function dialog, change the settings as the screenshot below and click OK
to close the dialog.

The output image and the structure elements are created. We can see that the output image only has large squares.


Input Image	Output Image

Structuring Element

ImgMorph help English files image008.jpg

Note: OriginPro includes the ability to automatically recalculate the analysis result of the Morphological Filter operation any time you change the parameters or update your source data. In addition, the settings for the analysis routine can be saved to an analysis theme for later use with similar data.

Algorithm

To perform morphological filter on the input image, the structuring element is passed over the image. Let B be the input image and S be the structuring element. We denote by Sxy the translated structuring element whose origin is located at the point (x,y).

The output for erosion can be expressed as follows:

And the output for dilation is:

where is reflection of set S, is defined as

Open operation is carried out by performing erosion once and then dilation once. And closing is carried out by performing dilation once and then erosion once.