点集转线 (数据管理)

摘要

根据点创建线要素。

插图

使用情况

• 仅当线要素包含两个或更多折点时才会写入输出。

• 如果将字段指定为线字段参数值，则将仅使用字段中唯一值的点来构造线要素。 该字段将包含在输出要素类中。

• 如果将字段指定为排序字段参数值，则点将按字段的升序排序。

• 可以先选中闭合线参数来创建闭合线要素，以从输入点创建面。 然后，使用输出线要素类作为要素转面工具的输入，以创建面要素。

• 线构造方法参数用于指定线要素的构造方式。 可以通过连续连接点或在排序时连接两个连续点来创建线要素。 例如，如果输入包含三个线字段值为 A 的点，四个线字段值为 B 的点，则选项预期会出现以下行为：

  • 构造连续线 - 将创建两条输出线，一条包含两条线段，一条包含三条线段。 如果选中闭合线参数，则将添加一条连接格线要素最后一点和起点的附加线段，以形成闭合线。
  • 构造两点线 - 将创建 5 条输出线，每条线均位于具有相同线字段值的连续点之间。 如果选中闭合线参数，则将添加连接具有相同线字段值的每组输入点的最后一个点和起点的附加线要素，以形成闭合形状。

• 通过属性源参数，可以指定是否将由传输字段参数指定的输入点的属性传输到输出线，及其传输方式。 参数源参数支持以下选项：

  • 无 - 不传输任何属性。
  • 从起点和终点 - 将从每条线的起点和终点传输属性。 输出字段名和别名将以 START_ 和 END_ 为前缀，例如 START_FIELD1 (START_ALIAS1)、END_FIELD1 (END_ALIAS1) 等。
  • 从起点 - 将从每条线的起点传输属性。
  • 从终点 - 将从每条线的终点传输属性。

• 使用传输字段参数来标识将从输入传输的字段。 字段值将根据属性源参数值进行传输。 如果为该参数指定了无值，则不会传输任何属性。

参数

对话框

标注	说明	数据类型
输入要素	将用于构造线的点要素。	Feature Layer
输出要素类	将通过输入点创建的线要素类。	Feature Class
线字段 (可选)	将用于标识唯一属性值的字段，以便可以使用具有相同值的点来构造线要素。 如果未指定字段，则将在不使用唯一属性值的情况下构造线。 这是默认设置。	Field
排序字段 (可选)	用于对点进行排序的字段。 如果未指定字段，则用于创建输出线要素的点将按照点被发现的顺序进行使用。 这是默认设置。	Field
闭合线 (可选)	指定输出线要素是否闭合。 选中 - 对于连续线，将包含连接最后一个点和第一个点的附加线段，以形成闭合线。 对于两点线，将包含连接最后一个点和第一个点的附加线要素，以形成闭合形状。 未选中 - 不会创建额外的线段或线来确保闭合线或闭合形状。 这是默认设置。	Boolean
线构造方法 (可选)	指定将用于构建线要素的方法。 构造连续线—将通过连续连接点来创建线要素。 这是默认设置。 构造两点线—将通过连接两个连续点来创建线要素。	String
属性源 (可选)	指定传输指定属性的方式。 无—不会转移任何属性。 这是默认设置。 起点和终点—将传输线的起点和终点属性。 起点—将传输线的起点属性。 终点—将传输线的终点属性。	String
传输字段 (可选)	包含将从源点传输到输出线的值的字段。 如果未选择任何字段，则不会传输任何属性。 如果将属性源参数值指定为无，则该参数将处于非活动状态。	Field

Python

arcpy.management.PointsToLine(Input_Features, Output_Feature_Class, {Line_Field}, {Sort_Field}, {Close_Line}, {Line_Construction_Method}, {Attribute_Source}, {Transfer_Fields})

名称	说明	数据类型
Input_Features	将用于构造线的点要素。	Feature Layer
Output_Feature_Class	将通过输入点创建的线要素类。	Feature Class
Line_Field (可选)	将用于标识唯一属性值的字段，以便可以使用具有相同值的点来构造线要素。 如果未指定字段，则将在不使用唯一属性值的情况下构造线。 这是默认设置。	Field
Sort_Field (可选)	用于对点进行排序的字段。 如果未指定字段，则用于创建输出线要素的点将按照点被发现的顺序进行使用。 这是默认设置。	Field
Close_Line (可选)	指定输出线要素是否闭合。 CLOSE—对于连续线，将包含连接最后一个点和第一个点的附加线段，以形成闭合线。 对于两点线，将包含连接最后一个点和第一个点的附加线要素，以形成闭合形状。 NO_CLOSE—不会创建额外的线段或线来确保闭合线或闭合形状。 这是默认设置。	Boolean
Line_Construction_Method (可选)	指定将用于构建线要素的方法。 CONTINUOUS—将通过连续连接点来创建线要素。 这是默认设置。 TWO_POINT—将通过连接两个连续点来创建线要素。	String
Attribute_Source (可选)	指定传输指定属性的方式。 NONE—不会转移任何属性。 这是默认设置。 BOTH_ENDS—将传输线的起点和终点属性。 START—将传输线的起点属性。 END—将传输线的终点属性。	String
Transfer_Fields [Transfer_Fields,...] (可选)	包含将从源点传输到输出线的值的字段。 如果未选择任何字段，则不会传输任何属性。 如果将 Attribute_Source 参数值指定为 NONE，则该参数将被禁用。	Field

代码示例

PointsToLine 示例（Python 窗口）

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.PointsToLine("calibration_points.shp",
                              "C:/output/output.gdb/out_lines",
                              "ROUTE1", "MEASURE")

PointsToLine 示例 2（独立脚本）

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

# Description: Convert point features into line features

# Import system modules
import arcpy

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

# Set local variables
inFeatures = "calibration_points.shp"
outFeatures = "C:/output/output.gdb/out_lines"
lineField = "ROUTE1"
sortField = "MEASURE"

# Run PointsToLine 
arcpy.management.PointsToLine(inFeatures, outFeatures, lineField, sortField)

PointsToLine 示例 3（独立脚本）

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

# Description: Convert point features into line features

# Import system modules
import arcpy

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

# Set local variables
inFeatures = "in_points"
outFeatures = "out_lines"
lineField = "lineID"
sortField = "stopID"
transFields = ["OBJECTID", "stopID"]

# Run PointsToLine 
arcpy.management.PointsToLine(inFeatures, outFeatures, lineField, sortField,
                              "NO_CLOSE", "TWO_POINT", "BOTH_ENDS", transFields)

环境

当前工作空间, 临时工作空间, XY 分辨率, XY 容差, 输出包含 M 值, M 分辨率, M 容差, 输出包含 Z 值, 默认输出 Z 值, Z 分辨率, Z 容差, 限定的字段名, 输出配置关键字, 自动提交, 输出 XY 值域, 输出 M 值域, 输出 Z 值域

许可信息

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