| 标注 | 说明 | 数据类型 |
输入要素 | 用于创建点的 3D 线要素。 | Feature Layer |
输出要素类 | 从输入线创建的 3D 点要素。 | Feature Class |
点放置 | 指定用于沿 3D 线要素采样点的方法。
| String |
距离 (可选) | 点将放置于距离要素始点的间隔。 当点放置参数设置为按距离时，此参数处于活动状态。 | Linear Unit |
百分比 (可选) | 点将放置于距离要素始点的百分比。 例如，如果已使用 40%，则点将放置于要素距离的 40% 和 80% 位置。 当点放置参数设置为按百分比时，此参数处于活动状态。 | Double |
包括端点 (可选) | 指定是否在要素的开始点和结束点包括其他点。
| Boolean |
添加累积距离和序列字段 (可选) | 指定是否将累积距离和序列字段添加到输出中。
| Boolean |
距离字段 (可选) | 将用于放置输出点的输入要素中的字段。 如果该字段为数值类型，则字段值将用于以该间隔放置点。 如果该字段为字符串类型，则字段值必须组织为以分号分隔的距离字符串。 将在这些距离处放置点。 将忽略零值或负值的字段值。 将忽略超出要素长度的该要素的字段值。 距离将采用输入空间参考的线性单位。 当点放置参数设置为按距离字段时，此参数处于活动状态。 | Field |
摘要
使用三维距离，沿 3D 线创建 3D 点要素。
使用情况
此工具通过测量要创建点的距离（使用三维距离），沿 3D 线生成 3D 点要素。 如果需要使用基于 x,y 平面的二维距离来计算从 3D 线采样的点，请改用沿线生成点工具。
可以按固定间隔为所有要素放置点，也可以按要素长度的百分比沿要素放置点。 还可以使用输入中的字段来放置点；该字段可以表示每个要素的固定间隔或者每个要素的特定距离。
可以使用点放置参数来指定工具将用于放置输出点的方法。
The attributes of the input features will be maintained in the output feature class. A new field, ORIG_FID, will be added to the output feature class and set to the input feature IDs.
如果选中添加累积距离和序列字段参数，则将添加以下字段：
- ORIG_LEN - 从线的起点到该点的沿线累积距离。 距离值相加，单位为输入要素值的空间参考单位。
- ORIG_SEQ - 每个点的序列号，按从每条输入线创建的点的顺序排列。
参数
arcpy.ddd.GeneratePointsAlong3DLines(in_feature, out_features, point_placement, {distance}, {percentage}, {include_end_points}, {add_chainage_fields}, {distance_field})| 名称 | 说明 | 数据类型 |
in_feature | 用于创建点的 3D 线要素。 | Feature Layer |
out_features | 从输入线创建的 3D 点要素。 | Feature Class |
point_placement | 指定用于沿 3D 线要素采样点的方法。
| String |
distance (可选) | 点将放置于距离要素始点的间隔。 当 point_placement 参数设置为 DISTANCE_FIELD 时，此参数处于活动状态。 | Linear Unit |
percentage (可选) | 点将放置于距离要素始点的百分比。 例如，如果已使用 40%，则点将放置于要素距离的 40% 和 80% 位置。 当 point_placement 参数设置为 PERCENTAGE 时，此参数处于活动状态。 | Double |
include_end_points (可选) | 指定是否在要素的开始点和结束点包括其他点。
| Boolean |
add_chainage_fields (可选) | Boolean | |
distance_field (可选) | 将用于放置输出点的输入要素中的字段。 如果该字段为数值类型，则字段值将用于以该间隔放置点。 如果该字段为字符串类型，则字段值必须组织为以分号分隔的距离字符串。 将在这些距离处放置点。 将忽略零值或负值的字段值。 将忽略超出要素长度的该要素的字段值。 距离将采用输入空间参考的线性单位。 当 point_placement 参数设置为 DISTANCE_FIELD 时，此参数处于活动状态。 | Field |
代码示例
下面的示例演示了如何在 Python 窗口中使用此工具。
import arcpy
arcpy.env.workspace = 'C:/data'
arcpy.ddd.GeneratePointsAlong3DLines("hiking_trail.shp", "evaluation_points.shp", "PERCENTAGE"
percentage=5, add_chainage_fields="ADD_CHAINAGE")