标注 | 说明 | 数据类型 |
输入要素 | 将用于构造线的点要素。 | Feature Layer |
输出要素类 | 将通过输入点创建的线要素类。 | Feature Class |
线字段 (可选) | 将用于标识唯一属性值的字段,以便可以使用具有相同值的点来构造线要素。 如果未指定字段,则将在不使用唯一属性值的情况下构造线。 这是默认设置。 | Field |
排序字段 (可选) | 用于对点进行排序的字段。 如果未指定字段,则用于创建输出线要素的点将按照点被发现的顺序进行使用。 这是默认设置。 | Field |
闭合线 (可选) | 指定输出线要素是否闭合。
| Boolean |
线构造方法 (可选) | 指定将用于构建线要素的方法。
| String |
属性源 (可选) | 指定传输指定属性的方式。
| String |
传输字段 (可选) | 包含将从源点传输到输出线的值的字段。 如果未选择任何字段,则不会传输任何属性。 如果将属性源参数值指定为无,则该参数将处于非活动状态。 | Field |
摘要
根据点创建线要素。
插图
使用情况
仅当线要素包含两个或更多折点时才会写入输出。
如果将字段指定为线字段参数值,则将仅使用字段中唯一值的点来构造线要素。 该字段将包含在输出要素类中。
如果将字段指定为排序字段参数值,则点将按字段的升序排序。
可以先选中闭合线参数来创建闭合线要素,以从输入点创建面。 然后,使用输出线要素类作为要素转面工具的输入,以创建面要素。
线构造方法参数用于指定线要素的构造方式。 可以通过连续连接点或在排序时连接两个连续点来创建线要素。 例如,如果输入包含三个线字段值为 A 的点,四个线字段值为 B 的点,则选项预期会出现以下行为:
- 构造连续线 - 将创建两条输出线,一条包含两条线段,一条包含三条线段。 如果选中闭合线参数,则将添加一条连接格线要素最后一点和起点的附加线段,以形成闭合线。
- 构造两点线 - 将创建 5 条输出线,每条线均位于具有相同线字段值的连续点之间。 如果选中闭合线参数,则将添加连接具有相同线字段值的每组输入点的最后一个点和起点的附加线要素,以形成闭合形状。
-
通过属性源参数,可以指定是否将由传输字段参数指定的输入点的属性传输到输出线,及其传输方式。 参数源参数支持以下选项:
- 无 - 不传输任何属性。
- 从起点和终点 - 将从每条线的起点和终点传输属性。 输出字段名和别名将以 START_ 和 END_ 为前缀,例如 START_FIELD1 (START_ALIAS1)、END_FIELD1 (END_ALIAS1) 等。
- 从起点 - 将从每条线的起点传输属性。
- 从终点 - 将从每条线的终点传输属性。
使用传输字段参数来标识将从输入传输的字段。 字段值将根据属性源参数值进行传输。 如果为该参数指定了无值,则不会传输任何属性。
参数
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 (可选) | 指定输出线要素是否闭合。
| Boolean |
Line_Construction_Method (可选) | 指定将用于构建线要素的方法。
| String |
Attribute_Source (可选) | 指定传输指定属性的方式。
| String |
Transfer_Fields [Transfer_Fields,...] (可选) | 包含将从源点传输到输出线的值的字段。 如果未选择任何字段,则不会传输任何属性。 如果将 Attribute_Source 参数值指定为 NONE,则该参数将被禁用。 | Field |
代码示例
以下 Python 窗口脚本演示了如何在即时模式下使用 PointsToLine 函数。
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.PointsToLine("calibration_points.shp",
"C:/output/output.gdb/out_lines",
"ROUTE1", "MEASURE")
以下独立脚本演示了如何使用 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 函数。
# 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)
环境
许可信息
- Basic: 是
- Standard: 是
- Advanced: 是