点至轨迹段 (AllSource 工具)

汇总

将启用时间的输入点数据序列（例如 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 为无穷大，不考虑点之间的距离。
不会对字段组参数值中的空值进行处理。在输入点处理过程中，不会对空值进行排序和分组，因此将会跳过那些行。要防止出现此问题，请在使用工具之前使用数据工程或计算字段工具将空值转换为有效值。

标注	说明	数据类型
输入要素	作为待创建轨迹上的点位置的点要素。	Feature Layer
日期字段	将用于对输入要素点进行排序的日期字段。	Field
输出要素类	输出轨迹线要素。	Feature Class
分组字段（可选）	将用于对输入点进行分组的输入要素参数中的字段。每个唯一的组将创建一个单独的轨迹。	Field
包括速度字段（可选）	指定是否在输出要素类参数值中包含输出速度字段（`speed_mps`、`speed_mph`、`speed_kph` 和 `speed_knt`）。选中—输出中将包括输出速度字段。这是默认设置。未选中—输出中不会包括输出速度字段。	Boolean
输出序列点（可选）	输出点要素。输出将包含一个 `SEQUENCE` 字段，其中包含输出要素类参数中创建的路径将使用的顺序。	Feature Class
重复时间戳错误（可选）	指定日期字段参数值或字段组参数值的各个组中的重复时间戳将被接受还是导致工具运行失败。选中—重复的时间戳将导致工具运行失败。这是默认设置。未选中—重复的时间戳将被接受。重复时间戳的序列将基于 `ObjectID` 值。	Boolean
保留输入字段（可选）	指定是否将字段从输入要素参数值传输到输出序列点参数值。选中—字段将从输入要素参数值传输到输出序列点参数值。未选中—字段将不会从输入要素参数值传输到输出序列点参数值。这是默认设置。	Boolean

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`）。 `INCLUDE_VELOCITY`—输出中将包括输出速度字段。这是默认设置。 `EXCLUDE_VELOCITY`—输出中不会包括输出速度字段。	Boolean
out_point_feature_class （可选）	输出点要素。输出将包含一个 `SEQUENCE` 字段，其中包含 `out_feature_class` 参数中创建的路径将使用的顺序。	Feature Class
error_on_duplicate_timestamps （可选）	指定 `date_field` 参数值或 `group_field` 参数值的各个组中的重复时间戳将被接受还是导致工具运行失败。 `ERROR_DUPLICATE_TIMESTAMPS`—重复的时间戳将导致工具运行失败。这是默认设置。 `ALLOW_DUPLICATE_TIMESTAMPS`—重复的时间戳将被接受。重复时间戳的序列将基于 `ObjectID` 值。	Boolean
keep_input_fields （可选）	指定是否将字段从 `in_features` 参数值传输到 `out_point_feature_class` 参数值。 `KEEP_INPUT_FIELDS`—字段将从 `in_features` 参数值传输到 `out_point_feature_class` 参数值。 `DISCARD_INPUT_FIELDS`—字段将不会从 `in_features` 参数值传输到 `out_point_feature_class` 参数值。这是默认设置。	Boolean

代码示例

PointsToTrackSegments 示例 1（Python 窗口）

以下 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")

PointsToTrackSegments 示例 2（独立脚本）

以下 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)

环境

此工具不使用任何地理处理环境。

许可信息

基本: 是
标准: 是
高级: 是

点至轨迹段 (AllSource 工具)

汇总

用法

参数

环境

许可信息

相关主题