标注 | 说明 | 数据类型 |
输入点要素 | 表示运动轨迹点的点要素。 可以启用图层的时间。 | Feature Layer |
输入面要素 | 表示感兴趣区域的面要素,用于标识唯一运动轨迹点标识符。 可以启用图层的时间。 | Feature Layer |
输出要素类 | 输出面要素类。 输出将包含输入面要素几何以及来自面要素名称字段和点要素名称字段参数的唯一标识符。 如果输入点要素和输入面要素参数值均已启用时间,并且关系设置为位置和时间,则将仅返回与几何和时间跨度匹配的要素。 | Feature Layer |
点要素名称字段 | 此字段包含运动轨迹点的唯一标识符。 该字段可以是数值型或字符串型字段。 | Field |
面要素名称字段 | 此字段包含感兴趣区域的唯一标识符。 该字段可以是数值型或字符串型字段。 | Field |
关系 | 指定输入之间的关系。
| String |
时间差 (可选) | 如果输入点要素和输入面要素参数值之间允许的时间在空间关系之前,则该时间视为无效。 当关系参数设置为位置和时间并且两个输入均已启用时间时,此参数处于活动状态。 | Time Unit |
时间关系 (可选) | 指定输入点要素和输入面要素参数值之间的时间关系。 当关系参数设置为位置和时间并且两个输入均已启用时间时,此参数处于活动状态。 如果指定了近前或近后选项,则只会评估位于指定时间窗内的输入点要素参数值,以将其包含在输出要素类参数值中。
| String |
包括时间统计数据 (可选) | 用于指定是否将添加时间统计数据字段。
| Boolean |
摘要
用于比较多个已知感兴趣区域中的运动点轨迹。
使用情况
该工具用于查找在已知区域中运行的唯一点轨迹标识的数量。 要根据位置和时间比较区域,必须在输入点要素和输入面要素参数的值(图层)上启用时间。
如果关系参数设置为位置和时间,则时间关系参数可支持指定某些时间关系。 您可以使用邻近、近前或近后选项,根据时差参数指定的值过滤要素。
输出要素类参数将返回一个面要素类,其中包含输入几何以及来自点要素名称字段和面要素名称字段参数的唯一标识符。
如果选中了包括时间统计数据参数,则以下字段将添加到输出要素类参数值中:
- enter_time - 在给定区域要素的指定轨迹中,第一次观察到的时间实例
- exit_time - 在给定区域要素的指定轨迹中,最后一次观察到的时间实例
- duration - 在给定区域要素的指定轨迹中,从第一次观察到最后一次观察的时长(以秒为单位)
参数
arcpy.intelligence.CompareAreas(in_point_features, in_area_features, out_featureclass, point_id_field, area_id_field, relationship, {time_difference}, {time_relationship}, {include_time_statistics})
名称 | 说明 | 数据类型 |
in_point_features | 表示运动轨迹点的点要素。 可以启用图层的时间。 | Feature Layer |
in_area_features | 表示感兴趣区域的面要素,用于标识唯一运动轨迹点标识符。 可以启用图层的时间。 | Feature Layer |
out_featureclass | 输出面要素类。 输出将包含 in_area_features 几何以及来自 area_id_field 和 point_id_field 参数的唯一标识符。 如果 in_point_features 和 in_area_features 参数值均已启用时间,并且 relationship 设置为 LOCATION_TIME,则将仅返回与几何和时间跨度匹配的要素。 | Feature Layer |
point_id_field | 此字段包含运动轨迹点的唯一标识符。 该字段可以是数值型或字符串型字段。 | Field |
area_id_field | 此字段包含感兴趣区域的唯一标识符。 该字段可以是数值型或字符串型字段。 | Field |
relationship | 指定输入之间的关系。
| String |
time_difference (可选) | 如果 in_point_features 和 in_area_features 参数值之间允许的时间在空间关系之前,则该时间视为无效。 当将 relationship 参数设置为 LOCATION_TIME 并且两个输入均已启用时间时,此参数处于启用状态。 | Time Unit |
time_relationship (可选) | 指定 in_point_features 和 in_area_features 参数值之间的时间关系。 仅当将 relationship 参数设置为 LOCATION_TIME 并且两个输入均已启用时间时,此参数处于启用状态。 如果指定了 NEAR_BEFORE 或 NEAR_AFTER 选项,则只会评估位于指定时间窗内的 in_point_features 参数值,以将其包含在 out_featureclass 参数值中。
| String |
include_time_statistics (可选) | 用于指定是否将添加时间统计数据字段。
| Boolean |
代码示例
以下 Python 脚本演示了如何在独立脚本中使用 CompareAreas 函数。
# Name: CompareAreas.py
# Description: Identify unique movement point track identifiers in known areas of interest.
# Import system modules
import arcpy
arcpy.env.workspace = "C:/data/Tracks.gdb"
# Set local variables
point_features = "Movement_Points"
area_features = "Areas_Of_Interest"
out_features = "Compare_Areas"
point_id_field = "Created_By"
area_id_field = "Name"
relationship = "LOCATION_TIME"
time_difference = "2 Hours"
# Run tool
arcpy.intelligence.CompareAreas(point_features,
area_features,
out_features,
point_id_field,
area_id_field,
relationship,
time_difference)