标注 | 说明 | 数据类型 |
输入要素 | 用于转换为点的线或面要素。 | Feature Layer |
输出要素类 | 将基于输入要素创建的点要素类。 | Feature Class |
点放置 | 指定用于创建点的方法。
| String |
距离 (可选) | 点将放置于距离要素始点的间隔。 | Linear Unit |
百分比 (可选) | 点将放置于距离要素始点的百分比。 例如,如果已使用 40%,则点将放置于要素距离的 40% 和 80% 位置。 | Double |
包括端点 (可选) | 指定是否在要素的开始点和结束点包括其他点。
| Boolean |
添加累积距离和序列字段 (可选) | 指定是否将累积距离和序列字段添加到输出中。
| Boolean |
摘要
沿线或面以固定间隔或要素长度百分比创建点要素。
使用情况
输入要素的属性将保留在输出要素类中。向输出要素类添加新字段 ORIG_FID,并设置为输入要素 ID。
如果选中添加累积距离和序列字段参数,则将添加以下字段:
- ORIG_LEN - 从线的起点到该点的沿线累积距离。 距离值相加,单位为输入要素值的空间参考单位。
- ORIG_SEQ - 每个点的序列号,按从每条输入线创建的点的顺序排列。
参数
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 | 指定将用于创建点的方法。
| String |
Distance (可选) | 点将放置于距离要素始点的间隔。 | Linear Unit |
Percentage (可选) | 点将放置于距离要素始点的百分比。 例如,如果已使用 40%,则点将放置于要素距离的 40% 和 80% 位置。 | Double |
Include_End_Points (可选) | 指定是否在要素的开始点和结束点包括其他点。
| Boolean |
Add_Chainage_Fields (可选) | 指定是否将累积距离和序列字段添加到输出中。
| Boolean |
代码示例
以下 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 函数。
# 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: 是