追踪要素间隔 (Tracking Analyst)

许可等级:BasicStandardAdvanced

摘要

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

插图

Track Intervals To Feature illustration

用法

语法

TrackIntervalsToFeature_TA (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分米
String
distance_field_name
(可选)

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

String
duration_field_units
(可选)

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

  • MILLISECONDS毫秒
  • SECONDS
  • MINUTES分钟
  • HOURS小时
  • DAYS
  • WEEKS
  • MONTHS
  • YEARS
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
String
speed_field_name
(可选)

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

String
course_field_units
(可选)

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

  • DEGREES
  • RADIANS弧度
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)

环境

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

相关主题

许可信息

ArcGIS for Desktop Basic: 需要 Tracking Analyst
ArcGIS for Desktop Standard: 需要 Tracking Analyst
ArcGIS for Desktop Advanced: 需要 Tracking Analyst
5/10/2014