创建泰森多边形 (分析)

在 Advanced 许可等级下可用。

摘要

根据点要素创建泰森多边形。

每个泰森多边形只包含一个点输入要素。 泰森多边形中的任何位置距其关联点的距离都比到任何其他点输入要素的距离近。

插图

泰森图示

使用情况

  • 此工具用于将输入点要素覆盖的区域划分为泰森区域或邻近区域。 这些区域表示其中任何位置到其关联点的距离都比到任何其他点输入要素的距离近的全部区域。

  • 抢先版本:

    创建泰森多边形的理论背景如下所示:

    • S 是坐标或欧氏空间 (x,y) 中点的集合,对于该空间中的任意点 pS 中有一个与 p 相距最近的点,除非点 pS 中的两个或多个点的距离相等。
    • 由到 S 中的单个点的距离最近的所有点 p 定义单个邻近多边形(Voronoi 像元),即所有点 pS 中的给定点的距离比到 S 中的任何其他点的距离都近的全部区域。
  • 按照以下步骤构造泰森邻近多边形:

    • 在所有点中划分出符合 Delaunay 准则的不规则三角网 (TIN)。
    • 三角形各边的垂直平分线即可形成泰森多边形的边。 各平分线的交点决定泰森多边形折点的位置。
  • 输出泰森多边形要素类的外部边界是点输入要素的范围另加 10%。 如果范围环境设置为特定的范围窗口,则该工具将使用环境设置来设置其外部边界。

  • 警告:

    因为工具使用的 Delaunay 三角测量方法最适用于投影坐标系中的数据,所以对于地理坐标系中的数据该工具可能会产生意外的结果。

参数

标注说明数据类型
输入要素

生成泰森多边形所依据的点输入要素。

Feature Layer
输出要素类

包含根据点输入要素生成的泰森多边形的输出要素类。

Feature Class
输出字段
(可选)

指定将输入要素的哪些字段传递到输出要素类。

  • 仅要素 ID仅输入要素的 FID 字段将传递到输出要素类。 这是默认设置。
  • 所有字段输入要素的所有字段都将传递到输出要素类。
String

arcpy.analysis.CreateThiessenPolygons(in_features, out_feature_class, {fields_to_copy})
名称说明数据类型
in_features

生成泰森多边形所依据的点输入要素。

Feature Layer
out_feature_class

包含根据点输入要素生成的泰森多边形的输出要素类。

Feature Class
fields_to_copy
(可选)

指定将输入要素的哪些字段传递到输出要素类。

  • ONLY_FID仅输入要素的 FID 字段将传递到输出要素类。 这是默认设置。
  • ALL输入要素的所有字段都将传递到输出要素类。
String

代码示例

CreateThiessenPolygons 示例 1(Python 窗口)

以下 Python 窗口脚本演示了如何在即时模式下使用 CreateThiessenPolygons 函数。

import arcpy
arcpy.env.workspace = "C:/data/data.gdb"
arcpy.analysis.CreateThiessenPolygons("schools", "c:/output/output.gdb/thiessen1", "ALL")
CreateThiessenPolygons 示例 2(独立脚本)

以下独立脚本演示了如何使用 CreateThiessenPolygons 函数。

# Name: CreateThiessenPolygons_Example2.py
# Description: Creates Thiessen polygons
 
# Import system modules
import arcpy
 
# Set environment settings
arcpy.env.workspace = "C:/data/data.gdb"
 
# Set local variables
inFeatures = "schools"
outFeatureClass = "c:/output/output.gdb/thiessen1"
outFields = "ALL"
 
# Execute CreateThiessenPolygons
arcpy.analysis.CreateThiessenPolygons(inFeatures, outFeatureClass, outFields)

许可信息

  • Basic: 否
  • Standard: 否
  • Advanced: 是

相关主题