沿线生成点 (数据管理)

摘要

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

使用情况

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

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

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

参数

对话框

标注	说明	数据类型
输入要素	用于转换为点的线或面要素。	Feature Layer
输出要素类	将基于输入要素创建的点要素类。	Feature Class
点放置	指定用于创建点的方法。 按百分比—将使用百分比参数值按百分比沿要素放置点。 按距离—将使用距离参数值将按固定距离沿要素放置点。 这是默认设置。	String
距离 (可选)	点将放置于距离要素始点的间隔。	Linear Unit
百分比 (可选)	点将放置于距离要素始点的百分比。 例如，如果已使用 40%，则点将放置于要素距离的 40% 和 80% 位置。	Double
包括端点 (可选)	指定是否在要素的开始点和结束点包括其他点。 选中 - 将在要素的开始点和结束点包括其他点。 未选中 - 不在要素的开始点和结束点包括其他点。 这是默认设置。	Boolean
添加累积距离和序列字段 (可选)	指定是否将累积距离和序列字段添加到输出中。 选中 - 将累积距离 (ORIG_LEN) 和序列字段 (ORIG_SEQ) 添加到输出中。 距离值相加，单位为输入要素值的空间参考单位。 未选中 - 不会将累积距离或序列字段添加到输出中。 这是默认设置。	Boolean

Python

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')

环境

当前工作空间, 输出配置关键字, 输出包含 M 值, 输出包含 Z 值

许可信息

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