Main Content

union

polyshape 对象的并集

全页折叠

语法

polyout = union(poly1,poly2)
polyout = union(polyvec)
[polyout,shapeID,vertexID] = union(poly1,poly2)
[polyout,shapeID,vertexID] = union(polyvec)
___ = union(___,Name=Value)

说明

示例

polyout = union(poly1,poly2) 返回一个 polyshape 对象，它的区域是两个 polyshape 对象的并集。并集包含 poly1 和 poly2（二者必须具有兼容的数组大小）的合并区域。

示例

polyout = union(polyvec) 返回一个 polyshape 对象，它的区域是向量 polyvec 中所有 polyshape 对象的几何并集。并集包含 polyvec 中所有 polyshape 对象的合并区域。

示例

[polyout,shapeID,vertexID] = union(poly1,poly2) 还会返回从 polyout 中的顶点到 poly1 和 poly2 中的顶点的顶点映射信息。仅当 poly1 和 poly2 是标量 polyshape 对象时，union 函数才支持此语法。

shapeID 元素标识 polyout 中对应的顶点是源于 poly1、poly2，还是因并集而产生的。vertexID 将 polyout 的顶点映射到 poly1、poly2 或并集的顶点。

[polyout,shapeID,vertexID] = union(polyvec) 返回从 polyout 到 polyshape 对象向量 polyvec 的每个元素的顶点映射信息。

___ = union(___,Name=Value) 支持上述语法中的任何输入参量组合，且可使用一个或多个名称-值参量指定选项。您可以使用上述语法中的任何输出参量组合。例如，polyout = union(poly1,poly2,Simplify=false) 返回一个 polyshape 对象，该对象的顶点未经修改，不管是有交集还是有不正确的嵌套。

示例

全部折叠

打开实时脚本

创建并绘制两个多边形。

poly1 = polyshape([0 0 1 1],[1 0 0 1]);
poly2 = polyshape([0.75 1.25 1.25 0.75],[0.25 0.25 0.75 0.75]);
plot(poly1)
hold on
plot(poly2)

figure

计算并绘制 poly1 和 poly2 的并集。

polyout = union(poly1,poly2)
polyout = 
  polyshape with properties:

      Vertices: [8x2 double]
    NumRegions: 1
      NumHoles: 0


plot(polyout)
xlim([-0.2 1.4]);
ylim([-0.2 1.2]);

打开实时脚本

创建一个多边形向量并绘制每个多边形。

polyarray1 = polyshape([0 0 1 1],[1 0 0 1]);
polyarray2 = polyshape([0.75 1.25 1.25 0.75],[0.25 0.25 0.75 0.75]);
polyvec = [polyarray1 polyarray2]
polyvec = 
  1x2 polyshape array with properties:

    Vertices
    NumRegions
    NumHoles


plot(polyvec(1))
hold on
plot(polyvec(2))

figure

计算并绘制两个多边形的并集。

polyout = union(polyvec)
polyout = 
  polyshape with properties:

      Vertices: [8x2 double]
    NumRegions: 1
      NumHoles: 0


plot(polyout)
xlim([-0.2 1.4]);
ylim([-0.2 1.2]);

打开实时脚本

创建两个多边形，计算并绘制其并集。显示并集的顶点坐标和相应的顶点映射信息。

poly1 = polyshape([0 0 1 1],[1 0 0 1]);
poly2 = translate(poly1,[0.5 0]);
[polyout,shapeID,vertexID] = union(poly1,poly2);
plot(polyout)
axis equal

[polyout.Vertices shapeID vertexID]
ans = 4×4

         0    1.0000    1.0000    1.0000
    1.5000    1.0000    2.0000    2.0000
    1.5000         0    2.0000    3.0000
         0         0    1.0000    4.0000

并集的第一个和最后一个顶点源于 poly1，因为 shapeID 中的对应值为 1。这些顶点分别是属性 poly1.Vertices 中的第一个和第四个顶点，因为 vertexID 中的对应值分别为 1 和 4。同样，并集的第二个和第三个顶点源于 poly2，它们分别是属性 poly2.Vertices 中的第二个和第三个顶点。

输入参数

全部折叠

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

数据类型: polyshape

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

数据类型: polyshape

polyshape 向量。

数据类型: polyshape

名称-值参数

将可选的参量对组指定为 Name1=Value1,...,NameN=ValueN，其中 Name 是参量名称，Value 是对应的值。名称-值参量必须出现在其他参量之后，但参量对组的顺序无关紧要。

示例: polyout = union(poly1,poly2,Simplify=false)

在 R2021a 之前，使用逗号分隔每个名称和值，并用引号将 Name 引起来。

示例: polyout = union(poly1,poly2,"Simplify",false)

将共线点保留为顶点，指定为以下数值或逻辑值之一：

  • 1 (true) - 保留所有共线点作为顶点。

  • 0 (false) - 删除共线点，使输出 polyshape 包含定义边界所需的最少顶点。

如果未指定 KeepCollinearPoints 名称-值参量，则该函数将根据在创建输入 polyshape 对象期间使用的值对其赋值。

  • 如果每个输入 polyshape 在创建期间将共线点保留为顶点，则该函数将 KeepCollinearPoints 设置为 true。

  • 如果每个输入 polyshape 在创建期间删除了共线点，则该函数将 KeepCollinearPoints 设置为 false。

  • 如果输入 polyshape 对象的共线点被区别对待，则该函数将 KeepCollinearPoints 设置为 false。

修改要简化的多边形顶点，指定为以下数值或逻辑值之一：

  • 1 (true) - 当输出顶点产生交集或不正确嵌套时，修改多边形顶点以生成明确定义的多边形。

  • 0 (false) - 即使有交集或不正确嵌套，也不修改输出顶点。使用未明确定义的多边形进行计算可能会产生不准确或意想不到的结果。

输出参量

全部折叠

输出 polyshape，以标量、向量、矩阵或多维数组形式返回。

  • 如果输入两个 polyshape 参量，则它们必须具有兼容的大小。例如，如果两个输入 polyshape 向量具有不同的长度 M 和 N，则它们必须有不同的方向（一个必须是行向量，一个必须是列向量）。polyout 则是 M×N 或 N×M，具体取决于每个输入向量的方向。有关兼容的数组大小的详细信息，请参阅基本运算的兼容数组大小。

  • 如果您提供单个输入参量 polyvec，则 polyout 是一个标量 polyshape 对象。

形状 ID，以列向量形式返回，其各个元素表示并集中顶点的来源。

  • shapeID 的长度等于输出 polyshape 的 Vertices 属性中的行数。

  • shapeID 的元素取决于输入参量的数量：

    • 如果您提供两个输入参量 poly1 和 poly2，则它们必须是标量 polyshape 对象。如果输出 polyshape 的顶点是因并集而产生的，则 shapeID 中的对应元素的值为 0。当顶点源于 poly1 时，对应元素为 1，当顶点源于 poly2 时，对应元素为 2。

    • 如果您提供一个输入参量 polyvec（polyshape 对象向量），则 shapeID 包含作为输出顶点来源的对应 polyvec 元素的索引。如果对应顶点是因并集而产生的，则元素的值为 0。

数据类型: double

顶点 ID，以列向量形式返回，其元素将输出 polyshape 中的顶点映射到来源的 polyshape 中的顶点。vertexID 的元素包含输入 polyshape 的 Vertices 属性中对应顶点的行号。如果输出 polyshape 的顶点是因并集而产生的，则对应元素为 0。

vertexID 的长度等于输出 polyshape 的 Vertices 属性中的行数。如果您提供两个输入 polyshape 对象，则 union 仅在它们都是标量时才支持此输出参量。

数据类型: double

扩展功能

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

版本历史记录

在 R2017b 中推出

全部展开

另请参阅

| |