File Exchange

image thumbnail

Decimate Polygon

version 1.2.0.0 (27.7 KB) by Anton Semechko
Simplify a 2D closed contour/polygon to within user-defined boundary offset tolerance

5 Downloads

Updated 11 Feb 2018

View License

Editor's Note: This file was selected as MATLAB Central Pick of the Week

Have you ever worked with 2D boundary shape representations and noticed that the same shape can be represented with reasonable accuracy by a much smaller number of points? Did you ever need to reduce the complexity of a 2D shape while retaining as many salient features as possible? If so then DecimatePoly is the function you have been looking for.
In the attached .ZIP folder you will find the primary, self-contained function titled DecimatePoly. Additionally, in the Demos folder you will find three files demonstrating the capability and utility of this function.

DecimatePoly_demo1: Demonstrates how to use DecimatePoly to simplify a 2D contour extracted from a binary image. Three binary images are included as examples. One of the them is shown in the screenshot. This is the only demo that requires Image Processing Toolbox.

DecimatePoly_demo2: Demonstrates the effectiveness of DecimatePoly in simplifying complex shapes while retaining geometrically and visually salient features.

DecimatePoly_demo3: Demonstrates how DecimatePoly can be used to improve the run-time of an in-polygon test at the cost of minor misclassification error.

Comments and Ratings (12)

Erik Husby

A Python implementation of this function may be found here:
https://github.com/husby036/DecimatePoly

Besides the small issue I've mentioned in my previous comments (which has been corrected in the translation), this is a direct translation from MATLAB to Python.

Erik Husby

EDIT to my previous comment:

"Here, `t` is an N-by-1 array. `t<0` is only true when all elements of `t` are less than *zero*, so negative `t` values may pass. Similarly, `t` values greater than one may pass."

Erik Husby

On lines 79 and 80 of DecimatePoly.m, I believe the following statements don't work as intended:

if t<0, t(t<0)=0; end %#ok<*BDSCI>
if t>1, t(t>1)=1; end

Here, `t` is an N-by-1 array. `t<0` is only true when all elements of `t` are less than one, so negative `t` values may pass. Similarly, `t` values greater than one may pass.

From the context of the two statements and the fact that we're calculating distances, I believe the author means to "clip" the values of `t` to the range (0, 1). If this is true, the conditionals should be taken out. Those two lines would be replaced as:

t(t<0)=0;
t(t>1)=1;

If I'm correct that this is an error, lines 175 and 176 display the same flawed logic. However, `t` is a 1-by-2 array within the `RecomputeErrors` function, so the statements are not erroneous but only highly redundant.

Very useful function. I would enjoy an option on deciding if you could actually save output statistics on variables instead of directly printing them (useful when I use it inside other routines).

Great function. It's nice that it is self contained too.

Catarina

Hi Anton,
Your code was all I needed to solve problems in my codes due to too many useless points. Thanks a lot!

Andrii

Andrii (view profile)

Thank you for the link.

Anton Semechko

Not sure about Matlab implementation, but you can find C implementation if you follow the link provided on this page:
http://www.insight-journal.org/browse/publication/829

Andrii

Andrii (view profile)

It is for building extraction from aerial images. After segmentation process boundaries are zigzag-shaped with many intrusions. I would like to simplify polygons but to maintain their essential shape. It means buildings should have orthogonal angles and small extrusions should be cut off. So I am looking for some implementation algorithm in MatLab. Like this: http://img812.imageshack.us/img812/3284/exampleus.png

Anton Semechko

@ Andrii, what is it you want to achieve by orthogonalizing a set of input points? Could you clarify what this operation means or perhaps provide a reference?

Andrii

Andrii (view profile)

Hi Anton. I have tried your function.
It works very well.
Do you know about some function like your but
which can simplify and after orthogonalize input set of points?

Updates

1.2.0.0

Modified code according to suggestions made by Georgios Gkantzounis and Erik Husby

1.1.0.0

updated description

MATLAB Release Compatibility
Created with R2015a
Compatible with any release
Platform Compatibility
Windows macOS Linux
Acknowledgements

Inspired: MatClust

Discover Live Editor

Create scripts with code, output, and formatted text in a single executable document.


Learn About Live Editor