比较区域 (情报)

摘要

用于比较多个已知感兴趣区域中的运动点轨迹。

使用情况

  • 该工具用于查找在已知区域中运行的唯一点轨迹标识的数量。 要根据位置和时间比较区域,必须在输入点要素输入面要素参数的值(图层)上启用时间。

    了解有关设置数据的时间属性的详细信息

  • 如果关系参数设置为位置和时间,则时间关系参数可支持指定某些时间关系。 您可以使用邻近近前近后选项,根据时差参数指定的值过滤要素。

  • 输出要素类参数将返回一个面要素类,其中包含输入几何以及来自点要素名称字段面要素名称字段参数的唯一标识符。

  • 如果选中了包括时间统计数据参数,则以下字段将添加到输出要素类参数值中:

    • enter_time - 在给定区域要素的指定轨迹中,第一次观察到的时间实例
    • exit_time - 在给定区域要素的指定轨迹中,最后一次观察到的时间实例
    • duration - 在给定区域要素的指定轨迹中,从第一次观察到最后一次观察的时长(以秒为单位)

参数

标注说明数据类型
输入点要素

表示运动轨迹点的点要素。 可以启用图层的时间。

Feature Layer
输入面要素

表示感兴趣区域的面要素,用于标识唯一运动轨迹点标识符。 可以启用图层的时间。

Feature Layer
输出要素类

输出面要素类。 输出将包含输入面要素几何以及来自面要素名称字段点要素名称字段参数的唯一标识符。

如果输入点要素输入面要素参数值均已启用时间,并且关系设置为位置和时间,则将仅返回与几何和时间跨度匹配的要素。

Feature Layer
点要素名称字段

此字段包含运动轨迹点的唯一标识符。 该字段可以是数值型或字符串型字段。

Field
面要素名称字段

此字段包含感兴趣区域的唯一标识符。 该字段可以是数值型或字符串型字段。

Field
关系

指定输入之间的关系。

  • 仅位置点和面要素将基于空间共现进行评估。
  • 位置和时间点和面要素将基于时空共现进行评估。
String
时间差
(可选)

如果输入点要素输入面要素参数值之间允许的时间在空间关系之前,则该时间视为无效。 当关系参数设置为位置和时间并且两个输入均已启用时间时,此参数处于活动状态。

Time Unit
时间关系
(可选)

指定输入点要素输入面要素参数值之间的时间关系。

关系参数设置为位置和时间并且两个输入均已启用时间时,此参数处于活动状态。 如果指定了近前近后选项,则只会评估位于指定时间窗内的输入点要素参数值,以将其包含在输出要素类参数值中。

  • 邻近当点要素时间位于面要素时间的指定时间范围内时,则点要素时间处于面要素时间的临近位置。
  • 近前当点要素时间早于面要素时间但与加入时间的间隔位于指定时间范围内时,点要素时间将处于面要素时间的近前位置。
  • 近后当点要素时间晚于面要素时间但与加入时间的间隔位于指定时间范围内时,点要素时间将处于面要素时间的近后位置。
  • 邻近当点要素时间位于面要素时间的指定时间范围内时,则点要素时间处于面要素时间的临近位置。
  • 近前当点要素时间早于面要素时间但与加入时间的间隔位于指定时间范围内时,点要素时间将处于面要素时间的近前位置。
  • 近后当点要素时间晚于面要素时间但与加入时间的间隔位于指定时间范围内时,点要素时间将处于面要素时间的近后位置。
String
包括时间统计数据
(可选)

用于指定是否将添加时间统计数据字段。

  • 包括时间统计数据时间统计数据字段将被添加到输出中。
  • 排除时间统计数据时间统计数据字段将不被添加到输出中。
Boolean

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_fieldpoint_id_field 参数的唯一标识符。

如果 in_point_featuresin_area_features 参数值均已启用时间,并且 relationship 设置为 LOCATION_TIME,则将仅返回与几何和时间跨度匹配的要素。

Feature Layer
point_id_field

此字段包含运动轨迹点的唯一标识符。 该字段可以是数值型或字符串型字段。

Field
area_id_field

此字段包含感兴趣区域的唯一标识符。 该字段可以是数值型或字符串型字段。

Field
relationship

指定输入之间的关系。

  • LOCATION_ONLY点和面要素将基于空间共现进行评估。
  • LOCATION_TIME点和面要素将基于时空共现进行评估。
String
time_difference
(可选)

如果 in_point_featuresin_area_features 参数值之间允许的时间在空间关系之前,则该时间视为无效。 当将 relationship 参数设置为 LOCATION_TIME 并且两个输入均已启用时间时,此参数处于启用状态。

Time Unit
time_relationship
(可选)

指定 in_point_featuresin_area_features 参数值之间的时间关系。

仅当将 relationship 参数设置为 LOCATION_TIME 并且两个输入均已启用时间时,此参数处于启用状态。 如果指定了 NEAR_BEFORENEAR_AFTER 选项,则只会评估位于指定时间窗内的 in_point_features 参数值,以将其包含在 out_featureclass 参数值中。

  • NEAR当点要素时间位于面要素时间的指定时间范围内时,则点要素时间处于面要素时间的临近位置。
  • NEAR_BEFORE当点要素时间早于面要素时间但与加入时间的间隔位于指定时间范围内时,点要素时间将处于面要素时间的近前位置。
  • NEAR_AFTER当点要素时间晚于面要素时间但与加入时间的间隔位于指定时间范围内时,点要素时间将处于面要素时间的近后位置。
String
include_time_statistics
(可选)

用于指定是否将添加时间统计数据字段。

  • TIME_STATISTICS时间统计数据字段将被添加到输出中。
  • NO_TIME_STATISTICS时间统计数据字段将不被添加到输出中。
Boolean

代码示例

CompareAreas 示例(独立脚本)

以下 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)