点至轨迹段 (情报)

摘要

将启用时间的输入点数据序列(例如 GPS 点)转换为一系列输出路径。

使用情况

  • 如果输入要素参数值位于投影坐标系中,则输出要素类参数值将使用相同的坐标系。 如果输入要素参数值位于地理坐标系中,则输出要素类参数值将使用 World Azimuthal Equidistant。

  • 如果输入要素参数值包含的点具有相同坐标,则在创建每条输出线时,会向第二个 y 坐标添加 1 厘米的偏移。 这是因为几何模型不允许在单个折线中出现重复的折点。

  • 输入要素点位于投影的 Web 墨卡托中,则 Shape Lengthdistance_m 字段中的值可能存在差异,因为 distance_m 字段值使用测地线长度计算,被视为更加准确。

  • 以下字段将添加到输出要素类参数值:

    字段名字段别名描述
    d_startStart Date

    起始日期和时间

    d_start_sStart Date (string)

    字符串或文本形式的起始日期和时间

    d_endEnd Date

    结束日期和时间

    d_end_sEnd Date (string)

    字符串或文本形式的结束日期和时间

    distance_mDistance (meters)

    距离(以米为单位)

    dt_secTime Delta (seconds)

    时间差(以秒为单位)

    dt_minTime Delta (minutes)

    时间差(以分钟为单位)

    speed_mpsSpeed (meters per second)

    可选。 速度(以米/秒为单位)

    speed_mphSpeed (miles per hour)

    可选。 速度(以英里/小时为单位)

    speed_kphSpeed (kilometers per hour)

    可选。 速度(以千米/小时为单位)

    speed_kntSpeed (knots)

    可选。 速度(以海里/小时为单位)

    oid_startStart ObjectID

    输入要素中起点的对象 ID

    oid_endEnd ObjectID

    输入要素中终点的对象 ID

    group_idGroup Identification

    可选。 输入要素参数中的字段组

  • 以下字段将添加到输出序列点参数值:

    字段名字段别名描述
    sequenceSequence Number

    轨迹中的点序号

    dateDate

    输入要素参数中的日期时间字段

    date_strDate (string)

    字符串形式的日期时间字段

    oid_origOriginal ObjectID

    输入要素参数中原始要素的对象 ID

    group_idGroup Identification

    可选。 输入要素参数中的字段组

    将为输出要素类输出序列点参数创建一个 .lyrx 文件(符号系统和图层设置)。 将在包含输出要素的最近的文件夹工作空间中创建这些文件。

  • 如果选中了包括速度参数且未选中重复时间戳错误参数,输出轨迹速度测量的任何重复时间戳都将为 inf,其中 inf 为无穷大,不考虑点之间的距离。

  • 不会对字段组参数值中的空值进行处理。 在输入点处理过程中,不会对空值进行排序和分组,因此将会跳过那些行。 要防止出现此问题,请在使用工具之前使用数据工程计算字段工具将空值转换为有效值。

参数

标注说明数据类型
输入要素

作为待创建轨迹上的点位置的点要素。

Feature Layer
日期字段

将用于对输入要素点进行排序的日期字段。

Field
输出要素类

输出轨迹线要素。

Feature Class
组字段
(可选)

将用于对输入点进行分组的输入要素参数中的字段。 每个唯一的组将创建一个单独的轨迹。

Field
包括速度字段
(可选)

指定输出要素类参数值中是否包括速度字段(speed_mpsspeed_mphspeed_kphspeed_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_mpsspeed_mphspeed_kphspeed_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)

环境

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