simplify

简化 polyshape 边界

全页折叠

语法

polyout = simplify(polyin)

polyout = simplify(polyin,'KeepCollinearPoints',TF)

说明

polyout = simplify(polyin) 返回一个 polyshape 对象，此对象由删除所有重复顶点之后的多边形 polyin 的边界组成，而且所有边界交集和不正确嵌套问题均已解决。

示例

polyout = simplify(polyin,'KeepCollinearPoints',TF) 指定是保留还是删除 polyout 中的共线点。

示例

全部折叠

相交边界

打开实时脚本

创建并绘制包含边界交集的多边形。

P = [0 0; 1 1; 1 0; 0.5 0.5; 0 1; 0 0];
polyin = polyshape(P,'Simplify',false)

polyin = 
  polyshape with properties:

      Vertices: [5×2 double]
    NumRegions: 1
      NumHoles: 0

plot(polyin)

Figure contains an axes object. The axes object contains an object of type polygon.

使用 simplify 函数删除交集，生成一个明确定义的多边形。简化多边形会保持边界的形状，但会将多边形分成两个不同的区域。

polyout = simplify(polyin)

polyout = 
  polyshape with properties:

      Vertices: [7×2 double]
    NumRegions: 2
      NumHoles: 0

输入参数

全部折叠

`polyin` — 输入 `polyshape`
标量 | 向量 | 矩阵 | 多维数组

输入 polyshape，指定为标量、向量、矩阵或多维数组。

数据类型: polyshape

`TF` — 共线顶点指示符
`false` | `true`

共线顶点指示符，指定为 false 或 true：

false - 删除共线点，使输出 polyshape 包含定义边界所需的最少顶点。
true - 保留所有共线点作为顶点。

如果未指定 'KeepCollinearPoints' 参数，则其值将自动设置为在创建输入 polyshape 时使用的值。

数据类型: logical

扩展功能

全部展开

C/C++ 代码生成
使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

用法说明和限制：

必须启用动态内存分配才能进行代码生成。
名称-值对组必须为编译时常量。

基于线程的环境
使用 MATLAB® `backgroundPool` 在后台运行代码或使用 Parallel Computing Toolbox™ `ThreadPool` 加快代码运行速度。

版本历史记录

在 R2017b 中推出

全部展开

R2024b: 改进了简化具有许多边界的 `polyshape` 对象时的性能

simplify 函数在对具有许多边界的 polyshape 对象执行运算时表现出了更好的性能。例如，以下代码会简化一个具有 11,100 个顶点的 polyshape 对象。该代码比上一版本大约快 23 倍。

function t = timingTest
n = 300;
x = (1:n)'*[sind(0:10:360),NaN];
y = (1:n)'*[cosd(0:10:360),NaN];
p = polyshape(x(:),y(:),Simplify=false);

f = @() simplify(p);

t = timeit(f);
end

大致的执行时间是：

R2024a：0.28 秒

R2024b：0.012 秒

此代码是在运行 Windows^® 11 的 AMD EPYC™ 74F3 24 核处理器 @ 3.19 GHz 测试系统上通过调用 timingTest 函数计时的。

另请参阅

issimplified | polyshape

simplify

语法

说明

示例

相交边界

输入参数

polyin — 输入 polyshape 标量 | 向量 | 矩阵 | 多维数组

TF — 共线顶点指示符 false | true