2.6.3.4 imgMorph(Pro)

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 2*p+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.

MorphSetting.png

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:

  1. Create a new matrix and imports the image file into it.
  2. When the image is active, select Image: Arithmetic Transform: Morphological Filter from the menu to open the dialog of the X-Function.
  3. In the X-Function dialog, change the settings as the screenshot below and click OK
    to close the dialog.
    ImgMorph help English files image002.jpg
    The output image and the structure elements are created. We can see that the output image only has large squares.
ImgMorph help English files image004.jpg
ImgMorph help English files image006.jpg
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:

Erosion.png

And the output for dilation is:

Dilation2.png

where Dilation s.png is reflection of set S, is defined as

Dilation reflection.png.

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.

References

Kenneth R.Castleman.1996. Digital Image Processing. Prentice Hall, Upper Saddle River, NJ, USA.

Related X-Functions

imgUserfilter