ArcMap

要素追踪间隔

描述

计算通过轨迹中连续排列的要素之间的差异计算得来的值。新字段被添加到输入要素类或图层，以存储计算所得的值（距离、持续时间、速度和路线）。

插图

要素追踪间隔插图

使用方法

  • 要使用此工具，输入要素类或图层的日期和时间信息必须包含在单个时间字段中（数据类型可为文本、短整型、长整型、浮点型、双精度型或日期）。如果时间字段数据类型为日期，则工具会自动检测格式。如果时间字段数据类型为除日期外的其他任何类型，则需要指定时间字段格式（如果时间字段数据类型为文本则可能还需要其他信息）才能正确分析数据值。

  • 如果选择的时间字段为文本、短整型、长整型、浮点型或双精度型，可以从支持的时间字段格式列表中选择时间字段格式，也可以定义自定义时间字段格式来解释文本字段中的自定义日期和/或时间值。有关文本字段自定义格式的详细信息，请参阅将字符串时间值转换为日期格式。

  • 选择输出字段名称的操作是可选操作。如果您不输入输出字段名称，则工具将自动生成包括单位缩写的输出字段名称。

语法

arcpy.ta.TrackIntervalsToFeature(in_features, time_field, {track_id_field}, {calculation_method}, {time_field_format}, {locale_id}, {am_designator}, {pm_designator}, {distance_field_units}, {distance_field_name}, {duration_field_units}, {duration_field_name}, {speed_field_units}, {speed_field_name}, {course_field_units}, {course_field_name})
参数说明数据类型
in_features

输入要素类或图层。

Feature Layer
time_field

输入要素类或图层中含有日期和时间信息的字段。此工具要求日期和时间信息包含在同一字段中，并且字段的数据类型必须为短整型、长整型、浮点型、双精度型、文本型或日期型。

Field
track_id_field
（可选）

包含用于将输入要素分组为轨迹的数据值的字段。字段的数据类型可为短整型、长整型、浮点型、双精度型、文本型或 OID。

Field
calculation_method
（可选）

指定用于计算每个要素值的间隔。

  • PREVIOUS_AND_CURRENT_FEATURE —使用轨迹中每个要素与上一要素之间的间隔来计算值。
  • CURRENT_AND_NEXT_FEATURE —使用轨迹中每个要素与下一要素之间的间隔来计算值。
String
time_field_format
（可选）

如果时间字段的数据类型为除日期型外的其他任何类型，则此参数可确定用于解释时间字段中数据值的格式。以下是一些格式的示例：

  • "yyyyMMdd"（适用于文本类型或数值时间字段的标准格式）
  • "yyyy/MM/dd HH:mm:ss"（适用于文本类型时间字段的标准格式）
  • "MM-dd-yyyy hh:mm:ss tt"（适用于文本类型时间字段的自定义格式）

如果时间字段的数据类型为文本类型，那么既可以使用标准 Esri 文本时间格式也可以指定自定义格式。但是，如果将存储策略指定为 KEEP_ON_DISK，则无法使用自定义格式。如果时间字段的数据类型为数值（短整型、长整型、浮点型或双精度型），那么只可以使用标准 Esri 数值时间格式。如果时间字段的数据类型为日期型，则无需使用此参数。

String
locale_id
（可选）

如果时间字段的数据类型为文本型，则此参数可确定用于解释时间字段中数据值的区域设置。对于除文本型外的所有时间字段数据类型，均无需使用此参数。如果未输入区域设置，则将使用操作系统当前的区域设置。打开该工具的对话框并展开该下拉列表便可获得系统支持的可用区域设置的列表。将区域设置作为参数输入时，建议您仅使用 Microsoft 指定的可按照长整型形式输入的区域设置 ID (LCID)，例如 1033。也可将区域设置的完整字符串表达形式作为参数输入，例如 "01033-English_(United_States)"，但必须用下划线字符代替空格。

Long
am_designator
（可选）

如果时间字段数据类型为文本型并且时间格式为包含时间标记（“t”或“tt”）的 12 小时制表达形式，则此参数可确定用于指示时间字段数据值中 AM 的字符（“t”）或者字符（“tt”）。如果输入内容为空，则将使用所选区域设置的默认 AM 指示符。对于除文本型外的所有时间字段数据类型，均无需使用此参数。

String
pm_designator
（可选）

如果时间字段数据类型为文本型并且时间格式为包含时间标记（“t”或“tt”）的 12 小时制表达形式，则此参数可确定用于指示时间字段数据值中 PM 的字符（“t”）或者字符（“tt”）。如果输入内容为空，则将使用所选区域设置的默认 PM 指示符。对于除文本型外的所有时间字段数据类型，均无需使用此参数。

String
distance_field_units
（可选）

指定将用于输出距离字段中的距离单位。

  • INCHES —英寸
  • FEET —英尺
  • YARDS —码
  • MILES —英里
  • NAUTICAL_MILES —海里
  • MILLIMETERS —毫米
  • CENTIMETERS —厘米
  • METERS —米
  • KILOMETERS —千米
  • DECIMETERS —分米
  • DECIMAL_DEGREES —十进制度
  • UNKNOWN_UNITS —单位未知
  • SKIP —跳过此参数
String
distance_field_name
（可选）

指定将添加到输入要素类或图层的距离字段的名称。如果不指定字段名称，则将自动选择名称。

String
duration_field_units
（可选）

指定将用于输出持续时间字段中的时间单位。

  • MILLISECONDS —毫秒
  • SECONDS —秒
  • MINUTES —分钟
  • HOURS —小时
  • DAYS —天
  • WEEKS —周
  • MONTHS —月
  • YEARS —年
  • SKIP —跳过此参数
String
duration_field_name
（可选）

指定将添加到输入要素类或图层的持续时间字段的名称。如果不指定字段名称，则将自动选择名称。

String
speed_field_units
（可选）

指定将用于输出速度字段中的速度单位。

  • MILES_PER_HOUR —英里/小时
  • FEET_PER_HOUR —英尺/小时
  • KILOMETERS_PER_HOUR —千米/小时
  • MILES_PER_SECOND —英里/秒
  • FEET_PER_SECOND —英尺/秒
  • METERS_PER_SECOND —米/秒
  • KNOTS —节
  • SKIP —跳过此参数
String
speed_field_name
（可选）

指定将添加到输入要素类或图层的速度字段的名称。如果不指定字段名称，则将自动选择名称。

String
course_field_units
（可选）

指定将用于输出路线字段中的路线单位。

  • DEGREES —度
  • RADIANS —弧度
  • SKIP —跳过此参数
String
course_field_name
（可选）

指定将添加到输入要素类或图层的路线字段的名称。如果不指定字段名称，则将自动选择名称。

String

代码示例

使用日期字段和默认单位以及输出字段名称的 TrackIntervalsToFeature 示例

此示例显示如何通过使用默认单位和输出字段名称的日期字段，对要素类运行该工具。

import arcpy
arcpy.CheckOutExtension("tracking")
in_features = "C:\Data\Vehicles.gdb\Planes"
time_field = "DATE_TIME"
track_id_field = "ACID"
arcpy.TrackIntervalsToFeature_ta(in_features, time_field, track_id_field)
使用文本日期字段、自定义单位和自定义字段名称的 TrackIntervalsToFeature 示例

此示例显示如何通过数据类型文本的日期字段对要素类运行该工具，以指定自定义单位和字段名称。

import arcpy
arcpy.CheckOutExtension("tracking")
in_features = "C:\Data\Vehicles.gdb\Planes"
time_field = "DATE_TEXT"
track_id_field = "ACID"
calculation_method = "CURRENT_AND_NEXT_FEATURE"
time_field_format = "MM/dd/yyyy HH:mm:ss"
distance_field_units = "MILES"
distance_field_name = "DISTANCE"
duration_field_units = "SECONDS"
duration_field_name = "DURATION"
speed_field_units = "KILOMETERS_PER_HOUR"
speed_field_name = "SPEED"
course_field_units = "DEGREES"
course_field_name = "HEADING"
arcpy.TrackIntervalsToFeature_ta(in_features, time_field, track_id_field, calculation_method, time_field_format, "", "", "", distance_field_units, distance_field_name, duration_field_units, duration_field_name, speed_field_units, speed_field_name, course_field_units, course_field_name)

环境

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

许可信息

  • Basic: 需要 Tracking Analyst
  • Standard: 需要 Tracking Analyst
  • Advanced: 需要 Tracking Analyst

相关主题