沿线生成点 (数据管理)

摘要

沿线或面以固定间隔或要素长度百分比创建点要素。

使用情况

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

    如果选中添加累积距离和序列字段参数,则将添加以下字段:

    • ORIG_LEN - 从线的起点到该点的沿线累积距离。 距离值相加,单位为输入要素值的空间参考单位。
    • ORIG_SEQ - 每个点的序列号,按从每条输入线创建的点的顺序排列。

参数

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

用于转换为点的线或面要素。

Feature Layer
输出要素类

将基于输入要素创建的点要素类。

Feature Class
点放置

指定用于创建点的方法。

  • 按百分比将使用百分比参数值按百分比沿要素放置点。
  • 按距离将使用距离参数值将按固定距离沿要素放置点。 这是默认设置。
String
距离
(可选)

点将放置于距离要素始点的间隔。

Linear Unit
百分比
(可选)

点将放置于距离要素始点的百分比。 例如,如果已使用 40%,则点将放置于要素距离的 40% 和 80% 位置。

Double
包括端点
(可选)

指定是否在要素的开始点和结束点包括其他点。

  • 选中 - 将在要素的开始点和结束点包括其他点。
  • 未选中 - 不在要素的开始点和结束点包括其他点。 这是默认设置。
Boolean
添加累积距离和序列字段
(可选)

指定是否将累积距离和序列字段添加到输出中。

  • 选中 - 将累积距离 (ORIG_LEN) 和序列字段 (ORIG_SEQ) 添加到输出中。 距离值相加,单位为输入要素值的空间参考单位。
  • 未选中 - 不会将累积距离或序列字段添加到输出中。 这是默认设置。
Boolean

arcpy.management.GeneratePointsAlongLines(Input_Features, Output_Feature_Class, Point_Placement, {Distance}, {Percentage}, {Include_End_Points}, {Add_Chainage_Fields})
名称说明数据类型
Input_Features

用于转换为点的线或面要素。

Feature Layer
Output_Feature_Class

将基于输入要素创建的点要素类。

Feature Class
Point_Placement

指定将用于创建点的方法。

  • PERCENTAGE将使用 Percentage 参数值按百分比沿要素放置点。
  • DISTANCE将使用 Distance 参数值将按固定距离沿要素放置点。 这是默认设置。
String
Distance
(可选)

点将放置于距离要素始点的间隔。

Linear Unit
Percentage
(可选)

点将放置于距离要素始点的百分比。 例如,如果已使用 40%,则点将放置于要素距离的 40% 和 80% 位置。

Double
Include_End_Points
(可选)

指定是否在要素的开始点和结束点包括其他点。

  • END_POINTS将在要素的开始点和结束点包括其他点。
  • NO_END_POINTS不在要素的开始点和结束点包括其他点。 这是默认设置。
Boolean
Add_Chainage_Fields
(可选)

指定是否将累积距离和序列字段添加到输出中。

  • ADD_CHAINAGE将累积距离 (ORIG_LEN) 和序列字段 (ORIG_SEQ) 添加到输出中。 距离值相加,单位为 Input_Features 值的空间参考单位。
  • NO_CHAINAGE不会将累积距离或序列字段添加到输出中。 这是默认设置。
Boolean

代码示例

GeneratePointsAlongLines 示例 1(Python 窗口)

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

import arcpy
arcpy.env.workspace = 'C:/data/base.gdb'
arcpy.management.GeneratePointsAlongLines('rivers', 'distance_intervals', 'DISTANCE', Distance='500 meters')
arcpy.management.GeneratePointsAlongLines('rivers', 'percentage_intervals', 'PERCENTAGE', Percentage=10)
GeneratePointsAlongLines 示例 2(独立脚本)

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

# Description: Convert point features to line features

import arcpy

# Set environment settings
arcpy.env.workspace = 'C:/data/base.gdb'

# Set local variables
in_features = 'rivers'
out_fc_1 = 'distance_intervals'
out_fc_2 = 'percentage_intervals'

# Run GeneratePointsAlongLines by distance
arcpy.management.GeneratePointsAlongLines(in_features, out_fc_1, 'DISTANCE',
                                          Distance='500 meters')

# Run GeneratePointsAlongLines by percentage
arcpy.management.GeneratePointsAlongLines(in_features, out_fc_2, 'PERCENTAGE',
                                          Percentage=10,
                                          Include_End_Points='END_POINTS')

许可信息

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

相关主题