标注 | 说明 | 数据类型 |
输入要素 | 作为待创建轨迹上的点位置的点要素。 | Feature Layer |
日期字段 | 将用于对输入要素点进行排序的日期字段。 | Field |
输出要素类 | 输出轨迹线要素。 | Feature Class |
组字段 (可选) | 将用于对输入点进行分组的输入要素参数中的字段。 每个唯一的组将创建一个单独的轨迹。 | Field |
包括速度字段 (可选) | 指定输出要素类参数值中是否包括速度字段(speed_mps、speed_mph、speed_kph 和 speed_knt)。
| Boolean |
输出序列点 (可选) | 输出点要素。 输出将包含一个 SEQUENCE 字段,其中包含输出要素类参数中创建的路径将使用的顺序。 | Feature Class |
重复时间戳错误 (可选) | 指定日期字段参数值或字段组参数值的各个组中的重复时间戳将被接受还是导致工具运行失败。
| Boolean |
保留输入字段 (可选) | 指定是否将字段从输入要素参数值传输到输出序列点参数值。
| Boolean |
摘要
将启用时间的输入点数据序列(例如 GPS 点)转换为一系列输出路径。
使用情况
如果输入要素参数值位于投影坐标系中,则输出要素类参数值将使用相同的坐标系。 如果输入要素参数值位于地理坐标系中,则输出要素类参数值将使用 World Azimuthal Equidistant。
如果输入要素参数值包含的点具有相同坐标,则在创建每条输出线时,会向第二个 y 坐标添加 1 厘米的偏移。 这是因为几何模型不允许在单个折线中出现重复的折点。
当输入要素点位于投影的 Web 墨卡托中,则 Shape Length 和 distance_m 字段中的值可能存在差异,因为 distance_m 字段值使用测地线长度计算,被视为更加准确。
以下字段将添加到输出要素类参数值:
字段名 字段别名 描述 d_start Start Date 起始日期和时间
d_start_s Start Date (string) 字符串或文本形式的起始日期和时间
d_end End Date 结束日期和时间
d_end_s End Date (string) 字符串或文本形式的结束日期和时间
distance_m Distance (meters) 距离(以米为单位)
dt_sec Time Delta (seconds) 时间差(以秒为单位)
dt_min Time Delta (minutes) 时间差(以分钟为单位)
speed_mps Speed (meters per second) 可选。 速度(以米/秒为单位)
speed_mph Speed (miles per hour) 可选。 速度(以英里/小时为单位)
speed_kph Speed (kilometers per hour) 可选。 速度(以千米/小时为单位)
speed_knt Speed (knots) 可选。 速度(以海里/小时为单位)
oid_start Start ObjectID 输入要素中起点的对象 ID
oid_end End ObjectID 输入要素中终点的对象 ID
group_id Group Identification 可选。 输入要素参数中的字段组值
以下字段将添加到输出序列点参数值:
字段名 字段别名 描述 sequence Sequence Number 轨迹中的点序号
date Date 输入要素参数中的日期时间字段
date_str Date (string) 字符串形式的日期时间字段
oid_orig Original ObjectID 输入要素参数中原始要素的对象 ID
group_id Group Identification 可选。 输入要素参数中的字段组值
将为输出要素类和输出序列点参数创建一个 .lyrx 文件(符号系统和图层设置)。 将在包含输出要素的最近的文件夹工作空间中创建这些文件。
如果选中了包括速度参数且未选中重复时间戳错误参数,输出轨迹速度测量的任何重复时间戳都将为 inf,其中 inf 为无穷大,不考虑点之间的距离。
不会对字段组参数值中的空值进行处理。 在输入点处理过程中,不会对空值进行排序和分组,因此将会跳过那些行。 要防止出现此问题,请在使用工具之前使用数据工程或计算字段工具将空值转换为有效值。
参数
arcpy.intelligence.PointsToTrackSegments(in_features, date_field, out_feature_class, {group_field}, {include_velocity}, {out_point_feature_class}, {error_on_duplicate_timestamps}, {keep_input_fields})
名称 | 说明 | 数据类型 |
in_features | 作为待创建轨迹上的点位置的点要素。 | Feature Layer |
date_field | 将用于对 in_features 点进行排序的日期字段。 | Field |
out_feature_class | 输出轨迹线要素。 | Feature Class |
group_field (可选) | 将用于对输入点进行分组的 in_features 参数中的字段。 每个唯一的组将创建一个单独的轨迹。 | Field |
include_velocity (可选) | 指定 out_feature_class 参数值中是否包括速度字段(speed_mps、speed_mph、speed_kph 和 speed_knt)。
| Boolean |
out_point_feature_class (可选) | 输出点要素。 输出将包含一个 SEQUENCE 字段,其中包含 out_feature_class 参数中创建的路径将使用的顺序。 | Feature Class |
error_on_duplicate_timestamps (可选) | 指定 date_field 参数值或 group_field 参数值的各个组中的重复时间戳将被接受还是导致工具运行失败。
| Boolean |
keep_input_fields (可选) | 指定是否将字段从 in_features 参数值传输到 out_point_feature_class 参数值。
| Boolean |
代码示例
以下 Python 窗口脚本演示了如何在即时模式下使用 PointsToTrackSegments 函数:
import arcpy
arcpy.intelligence.PointsToTrackSegments("C:/data/mtracks.gdb/source_pts",
"DateTime",
"C:/data/mtracks.gdb/tracklines",
"Name",
"INCLUDE_VELOCITY",
"C:/data/mtracks.gdb/seqpoints")
以下 Python 脚本演示了如何在独立脚本中使用 PointsToTrackSegments 函数:
# Name: PointsToTrackSegments_Example2.py
# Description: Convert points to track segments.
# Import system modules
import arcpy
# Set local variables
in_features = "C:/data/mtracks.gdb/source_pts"
date_time = "DateTime"
out_feature_class = "C:/data/mtracks.gdb/tracklines"
group_field = "Name"
out_points = "C:/data/mtracks.gdb/seqpoints"
# Run PointsToTrackSegments
arcpy.intelligence.PointsToTrackSegments(in_features, date_time,
out_feature_class, group_field,
"INCLUDE_VELOCITY", out_points)