描述
计算通过轨迹中连续排列的要素之间的差异计算得来的值。新线要素类将被创建以表示追踪间隔,并存储计算所得的值(距离、持续时间、速度和路线)。
插图
使用方法
要使用此工具,输入要素类或图层的日期和时间信息必须包含在单个时间字段中(数据类型可为文本、短整型、长整型、浮点型、双精度型或日期)。如果时间字段数据类型为日期,则工具会自动检测格式。如果时间字段数据类型为除日期外的其他任何类型,则需要指定时间字段格式(如果时间字段数据类型为文本则可能还需要其他信息)才能正确分析数据值。
如果选择的时间字段为文本、短整型、长整型、浮点型或双精度型,可以从支持的时间字段格式列表中选择时间字段格式,也可以定义自定义时间字段格式来解释文本字段中的自定义日期和/或时间值。有关文本字段自定义格式的详细信息,请参阅将字符串时间值转换为日期格式。
此工具自动生成存储输出要素类中计算所得值的输出字段名称,并且自动生成的名称包括所使用单位的缩写。
语法
arcpy.ta.TrackIntervalsToLine(in_features, out_feature_class, time_field, {track_id_field}, {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 |
out_feature_class | 将被创建的输出线要素类。 | Feature Class |
time_field | 输入要素类或图层中含有日期和时间信息的字段。此工具要求日期和时间信息包含在同一字段中,并且字段的数据类型必须为短整型、长整型、浮点型、双精度型、文本型或日期型。 | Field |
track_id_field (可选) | 包含用于将输入要素分组为轨迹的数据值的字段。字段的数据类型可为短整型、长整型、浮点型、双精度型、文本型或 OID。 | Field |
time_field_format (可选) | 如果时间字段的数据类型为除日期型外的其他任何类型,则此参数可确定用于解释时间字段中数据值的格式。格式的一些示例如下:
如果时间字段的数据类型为文本类型,那么既可以使用标准 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 (可选) | 指定将用于输出距离字段中的距离单位。
| String |
distance_field_name (可选) | 指定将添加到输入要素类或图层的距离字段的名称。如果不指定字段名称,则将自动选择名称。 | String |
duration_field_units (可选) | 指定将用于输出持续时间字段中的时间单位。
| String |
duration_field_name (可选) | 指定将添加到输入要素类或图层的持续时间字段的名称。如果不指定字段名称,则将自动选择名称。 | String |
speed_field_units (可选) | 指定将用于输出速度字段中的速度单位。
| String |
speed_field_name (可选) | 指定将添加到输入要素类或图层的速度字段的名称。如果不指定字段名称,则将自动选择名称。 | String |
course_field_units (可选) | 指定将用于输出路线字段中的路线单位。
| String |
course_field_name (可选) | 指定将添加到输入要素类或图层的路线字段的名称。如果不指定字段名称,则将自动选择名称。 | String |
代码示例
使用日期字段和默认单位以及输出字段名称的 TrackIntervalsToLine 示例
此示例显示如何通过使用默认单位和输出字段名称的日期字段,对要素类运行该工具。
import arcpy
arcpy.CheckOutExtension("tracking")
in_features = "C:\Data\Vehicles.gdb\Planes"
out_feature_class = "C:\Data\Vehicles.gdb\Plane_Intervals"
time_field = "DATE_TIME"
track_id_field = "ACID"
arcpy.TrackIntervalsToLine_ta(in_features, out_feature_class, time_field, track_id_field)
使用文本日期字段、自定义单位和自定义字段名称的 TrackIntervalsToLine 示例
此示例显示如何通过数据类型文本的日期字段对要素类运行该工具,以指定自定义单位和字段名称。
import arcpy
arcpy.CheckOutExtension("tracking")
in_features = "C:\Data\Vehicles.gdb\Planes"
out_feature_class = "C:\Data\Vehicles.gdb\Plane_Intervals_2"
time_field = "DATE_TEXT"
track_id_field = "ACID"
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.TrackIntervalsToLine_ta(in_features, out_feature_class, time_field, track_id_field, 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