沿线生成点 (数据管理)

摘要

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

使用情况

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

参数

对话框

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

Python

arcpy.management.GeneratePointsAlongLines(Input_Features, Output_Feature_Class, Point_Placement, {Distance}, {Percentage}, {Include_End_Points})

名称	说明	数据类型
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

代码示例

GeneratePointsAlongLines 示例 1（Python 窗口）

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

import arcpy
arcpy.env.workspace = 'C:/data/base.gdb'
arcpy.GeneratePointsAlongLines_management('rivers', 'distance_intervals', 'DISTANCE', Distance='500 meters')
arcpy.GeneratePointsAlongLines_management('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'

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

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

环境

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

特殊情况

许可信息

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