要素转点 (数据管理)

摘要

创建包含从输入要素质心生成的点或放置在输入要素内的点的要素类。

插图

要素转点工具图示

使用情况

  • 输入要素的属性将保留在输出要素类中。向输出要素类添加新字段 ORIG_FID,并设置为输入要素 ID。

参数

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

输入要素可以是多点、线、面或注记。

Feature Layer
输出要素类

输出点要素类。

Feature Class
内部
(可选)

指定输出点是位于输入要素内还是位于输入要素的质心。

  • 未选中 - 输出点将位于输入要素质心。 输出点并不总是包含在输入要素中。 这是默认设置。
  • 选中 - 输出点将位于输入要素内。

如果未选中 Inside 参数,则将按如下方式确定每个输出点的位置:

  • 多点要素 - 输出点将位于多点中所有点的 x 和 y 坐标的平均值处。
  • 折线要素 - 输出点将位于线中所有线段中点的 x 和 y 坐标的加权平均值处;其中各中点的权重为对应线段的长度。 参数(真)曲线将被增密。
  • 面要素 - 输出点将位于面的重心(质心)处。

如果选中 Inside 参数,则输入要素代表点的位置将包含在输入要素中,并由如下方式确定:

  • 多点要素 - 输出点将与多点中的一点重合。
  • 折线要素 - 输出点将位于线上。 如果线为参数(真)曲线,则输出点将位于线的中点。
  • 面要素 - 输出点将位于面的内部。

Boolean

arcpy.management.FeatureToPoint(in_features, out_feature_class, {point_location})
名称说明数据类型
in_features

输入要素可以是多点、线、面或注记。

Feature Layer
out_feature_class

输出点要素类。

Feature Class
point_location
(可选)

指定输出点是位于输入要素内还是位于输入要素的质心。

  • CENTROID输出点将位于输入要素质心。 输出点并不总是包含在输入要素中。 这是默认设置。
  • INSIDE输出点将位于输入要素内。

如果 point_location 参数设置为 CENTROID,则将按如下方式确定每个输出点的位置:

  • 多点要素 - 输出点将位于多点中所有点的 x 和 y 坐标的平均值处。
  • 折线要素 - 输出点将位于线中所有线段中点的 x 和 y 坐标的加权平均值处;其中各中点的权重为对应线段的长度。 参数(真)曲线将被增密。
  • 面要素 - 输出点将位于面的重心(质心)处。

如果 point_location 参数设置为 INSIDE,则输入要素代表点的位置将包含在输入要素中,并由如下方式确定:

  • 多点要素 - 输出点将与多点中的一点重合。
  • 折线要素 - 输出点将位于线上。 如果线为参数(真)曲线,则输出点将位于线的中点。
  • 面要素 - 输出点将位于面的内部。

Boolean

代码示例

FeatureToPoint 示例 1(Python 窗口)

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.FeatureToPoint("parcels.shp", "c:/data/output/parcels_center.shp", 
                                "CENTROID")
FeatureToPoint 示例 2(独立脚本)

以下独立脚本是演示如何在脚本环境中应用 FeatureToPoint 函数的简单示例。

# Name: FeatureToPoint_Example2.py
# Description: Use FeatureToPoint function to find a point inside each park

# import system modules 
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data"

#  Set local variables
inFeatures = "parks.shp"
outFeatureClass = "c:/output/output.gdb/parks_pt"

# Use FeatureToPoint function to find a point inside each park
arcpy.management.FeatureToPoint(inFeatures, outFeatureClass, "INSIDE")