描述
用于提取点轨迹数据集中以用户定义的间隔在空间和时间中移动的唯一标识符。
使用方法
该工具将从输入要素中识别在要素之间相距指定时间和距离间隔内移动的唯一标识符。输入要素必须启用时间。
有关如何启用数据集的时间的信息，请参阅设置数据的时间属性。
选择要用作唯一标识符的字段时，可选择包含整数或文本的字段。这将允许对要素进行更有效的分组并返回最佳输出。
时间和空间分隔间隔越小，处理速度越快。例如，10 分钟时间差和 100 米空间间隔的处理速度明显比 1 小时时间差和 1 千米空间间隔的处理速度快。
输出要素表示同行要素的位置。除了其他描述性字段外，还将向输出要素添加两个字段，用于指示旅行者和可能的同行者之间的时间和空间间隔。
输出要素将包含以下字段：
- traveler_id - 旅行要素的唯一标识符。该标识符与同行要素一起移动，可视为源要素。
- cotraveler_id - 同行要素的唯一标识符。该标识符与旅行要素同行，可视为目标要素。
- X - 旅行要素的 x 坐标。该坐标采用输入要素的投影单位。
- Y - 旅行要素的 y 坐标。该坐标采用输入要素的投影单位。
- X_cotraveler - 同行要素的 x 坐标。该坐标采用输入要素的投影单位。
- Y_cotraveler - 同行要素的 y 坐标。该坐标采用输入要素的投影单位。
- traveler_time - 旅行要素的日期和时间。
- cotraveler_time - 同行要素的日期和时间。
- distance_difference - 在输入要素中标识的要素与评估的同行者之间的距离。该距离采用输入要素的线性单位。
- time_difference - 在输入要素中标识的要素与评估的同行者之间的时间间隔。时间差以秒为单位，可以是正数，也可以是负数。正数表示标识为在旅行者之后出现的要素。负数表示标识为在旅行者之前出现的要素。
- cotraveling_pair_id - 为每个唯一的旅行要素对生成的唯一标识符。对于 (A, B) 和 (B, A)，两个旅行要素 (A, B) 将共享相同的 cotraveling_pair_id。
可以根据输出要素创建一个可选的汇总表。汇总表将包含以下字段：
- unique_pair_id - 为每个唯一的旅行要素对生成的唯一标识符。对于 (A, B) 和 (B, A)，两个旅行要素 (A, B) 将共享相同的 unique_pair_id。
- traveler_id - 旅行要素的唯一标识符。该标识符与同行要素一起移动，可视为源要素。
- cotraveler_id - 同行要素的唯一标识符。该标识符与旅行要素同行，可视为目标要素。
- time_diff_max - 旅行者和同行者之间的最大时间间隔。
- time_diff_min - 旅行者和同行者之间的最小时间间隔。
- time_diff_mean - 旅行者和同行者之间的平均时间间隔。
- time_diff_std - 旅行者和同行者之间时间间隔的标准差。
- dist_diff_max - 旅行者和同行者之间的最大距离间隔。
- dist_diff_min - 旅行者和同行者之间的最小距离间隔。
- dist_diff_mean - 旅行者和同行者之间的平均距离间隔。
- dist_diff_std - 旅行者和同行者之间距离间隔的标准差。
- unique_pair_id_count - 标识为 unique_pair_id 同行的要素总数。
语法
arcpy.intelligence.FindCotravelers(input_features, out_featureclass, id_field, {search_distance}, {time_difference}, {input_type}, {secondary_features}, {secondary_id_field}, {create_summary_table}, {out_summary_table})| 参数 | 说明 | 数据类型 |
input_features | 启用时间的要素，表示将用于查找同行者的已知标识符。唯一标识符、时间戳和位置将传输到输出图层，以帮助计算时间和空间间隔。 | Feature Layer |
out_featureclass | 该输出要素类将包含标识为与输入源图层同行的点轨迹段。该要素类将包含与指定点轨迹段关联的源。将为每个点轨迹要素计算时间和空间间隔。 | Feature Class |
id_field | 输入要素中的字段，用于获取每个点轨迹的唯一标识符。该字段将复制到输出要素类。 | Field |
search_distance （可选） | 在要素不被视为同行要素之前可以分隔的最大距离。默认值为 100 英尺。 | Linear Unit |
time_difference （可选） | 在要素不被视为同行要素之前可以分隔的最大时间差。默认值为 10 秒。 | Time Unit |
input_type （可选） | 指定将在一个要素类中还是在两个要素类之间标识同行者。
| String |
secondary_features （可选） | 用于标识同行者的第二个要素类。将使用以下内容来评估潜在同行者：
| Feature Layer |
secondary_id_field （可选） | 次要要素中的字段，用于获取每个点轨迹的唯一标识符。该字段将复制到输出要素类。 | Field |
create_summary_table （可选） | 指定是否创建输出汇总表。
| Boolean |
out_summary_table （可选） | 将存储汇总信息的输出表。仅当创建汇总表参数值设置为 True 时，才会启用此选项。 | Table |
代码示例
以下 Python 脚本演示了如何在不含输出汇总表，仅包含一个输入要素类的独立脚本中使用 FindCotravelers 函数。
# Name: FindCotravelers.py
# Description: Identify cotravelers in a point track dataset.
# Import system modules
import arcpy
arcpy.env.workspace = "C:/data/Tracks.gdb"
# Set local variables
source_features = "Known_Tracks"
output_point_features = "Cotravelers"
id_field = "device_id"
# Execute tool
arcpy.FindCotravelers_intelligence(source_features,
output_point_features,
id_field)以下 Python 脚本演示了如何在含有输出汇总表和两个输入要素类的独立脚本中使用 FindCotravelers 函数。
# Name: FindCotravelers.py
# Description: Identify cotravelers in a point track dataset.
# Import system modules
import arcpy
arcpy.env.workspace = "C:/data/Tracks.gdb"
# Set local variables
source_features = "Known_Tracks"
unknown_features = "Unknown_Tracks"
output_point_features = "Cotravelers"
id_field_name = "device_id"
unknown_id_field = "MMSI"
search_distance = "75 Feet"
time_difference = "5 Seconds"
summary_table = "CREATE_SUMMARY_TABLE"
summary_table_name = "Tracks_Summary_Table"
# Execute tool
arcpy.FindCotravelers_intelligence(source_features,
output_point_features,
id_field_name,
search_distance,
time_difference,
"TWO_FEATURECLASSES",
unknown_features,
unknown_id_field,
summary_table,
summary_table_name)许可信息
- Basic: 否
- Standard: 否
- Advanced: 是