opencv/doc/tutorials/imgproc/erosion_dilatation/erosion_dilatation.markdown
Adeel Ahmad bc7f6fc44c Merge pull request #8253 from adl1995:master
* Update linux_install.markdown

Grammar improvements, fixed typos.

* Update tutorials.markdown

Improvements in grammar.

* Update table_of_content_calib3d.markdown

* Update camera_calibration_square_chess.markdown

Improvements in grammar. Added answer.

* Update tutorials.markdown

* Update erosion_dilatation.markdown

* Update table_of_content_imgproc.markdown

* Update warp_affine.markdown

* Update camera_calibration_square_chess.markdown

Removed extra space.

* Update gpu_basics_similarity.markdown

Grammatical improvements, fixed typos.

* Update trackbar.markdown

Improvement for better understanding.
2017-03-01 18:44:34 +00:00

6.2 KiB

Eroding and Dilating

Goal

In this tutorial you will learn how to:

  • Apply two very common morphological operators: Erosion and Dilation. For this purpose, you will use the following OpenCV functions:
    • @ref cv::erode
    • @ref cv::dilate

Interesting fact

@note The explanation below belongs to the book Learning OpenCV by Bradski and Kaehler.

Morphological Operations

  • In short: A set of operations that process images based on shapes. Morphological operations apply a structuring element to an input image and generate an output image.

  • The most basic morphological operations are: Erosion and Dilation. They have a wide array of uses, i.e. :

    • Removing noise
    • Isolation of individual elements and joining disparate elements in an image.
    • Finding of intensity bumps or holes in an image
  • We will explain dilation and erosion briefly, using the following image as an example:

Dilation

  • This operations consists of convolving an image \f$A\f$ with some kernel (\f$B\f$), which can have any shape or size, usually a square or circle.

  • The kernel \f$B\f$ has a defined anchor point, usually being the center of the kernel.

  • As the kernel \f$B\f$ is scanned over the image, we compute the maximal pixel value overlapped by \f$B\f$ and replace the image pixel in the anchor point position with that maximal value. As you can deduce, this maximizing operation causes bright regions within an image to "grow" (therefore the name dilation). Take the above image as an example. Applying dilation we can get:

The background (bright) dilates around the black regions of the letter.

To better grasp the idea and avoid possible confusion, in this other example we have inverted the original image such as the object in white is now the letter. We have performed two dilatations with a rectangular structuring element of size 3x3.

Left image: original image inverted, right image: resulting dilatation

The dilatation makes the object in white bigger.

Erosion

  • This operation is the sister of dilation. It computes a local minimum over the area of given kernel.

  • As the kernel \f$B\f$ is scanned over the image, we compute the minimal pixel value overlapped by \f$B\f$ and replace the image pixel under the anchor point with that minimal value.

  • Analagously to the example for dilation, we can apply the erosion operator to the original image (shown above). You can see in the result below that the bright areas of the image (the background, apparently), get thinner, whereas the dark zones (the "writing") gets bigger.

In similar manner, the corresponding image results by applying erosion operation on the inverted original image (two erosions with a rectangular structuring element of size 3x3):

Left image: original image inverted, right image: resulting erosion

The erosion makes the object in white smaller.

Code

This tutorial's code is shown below. You can also download it here @include samples/cpp/tutorial_code/ImgProc/Morphology_1.cpp

Explanation

-# Most of the material shown here is trivial (if you have any doubt, please refer to the tutorials in previous sections). Let's check the general structure of the program:

-   Load an image (can be BGR or grayscale)
-   Create two windows (one for dilation output, the other for erosion)
-   Create a set of two Trackbars for each operation:
    -   The first trackbar "Element" returns either **erosion_elem** or **dilation_elem**
    -   The second trackbar "Kernel size" return **erosion_size** or **dilation_size** for the
        corresponding operation.
-   Every time we move any slider, the user's function **Erosion** or **Dilation** will be
    called and it will update the output image based on the current trackbar values.

Let's analyze these two functions:

-# erosion: @snippet cpp/tutorial_code/ImgProc/Morphology_1.cpp erosion

-   The function that performs the *erosion* operation is @ref cv::erode . As we can see, it
    receives three arguments:
    -   *src*: The source image
    -   *erosion_dst*: The output image
    -   *element*: This is the kernel we will use to perform the operation. If we do not
        specify, the default is a simple `3x3` matrix. Otherwise, we can specify its
        shape. For this, we need to use the function cv::getStructuringElement :
        @snippet cpp/tutorial_code/ImgProc/Morphology_1.cpp kernel

        We can choose any of three shapes for our kernel:

        -   Rectangular box: MORPH_RECT
        -   Cross: MORPH_CROSS
        -   Ellipse: MORPH_ELLIPSE

        Then, we just have to specify the size of our kernel and the *anchor point*. If not
        specified, it is assumed to be in the center.

-   That is all. We are ready to perform the erosion of our image.

@note Additionally, there is another parameter that allows you to perform multiple erosions (iterations) at once. However, We haven't used it in this simple tutorial. You can check out the reference for more details.

-# dilation:

The code is below. As you can see, it is completely similar to the snippet of code for **erosion**.
Here we also have the option of defining our kernel, its anchor point and the size of the operator
to be used.
@snippet cpp/tutorial_code/ImgProc/Morphology_1.cpp dilation

Results

Compile the code above and execute it with an image as argument. For instance, using this image:

We get the results below. Varying the indices in the Trackbars give different output images, naturally. Try them out! You can even try to add a third Trackbar to control the number of iterations.