Compare Areas (Intelligence)

Summary

Compares movement point tracks across multiple known areas of interest.

Usage

  • The tool is used to find the number of unique point track identities operating in known areas. To compare areas across location and time, time must be enabled on the values (layers) of both the Input Point Features and Input Area Features parameters.

    Learn more about setting time properties on data

  • The Output Feature Class parameter will return an area feature class with the input geometries and the unique identifiers from the Point Features Name Field and Area Features Name Field parameters.

Syntax

arcpy.intelligence.CompareAreas(in_point_features, in_area_features, out_featureclass, point_id_field, area_id_field, relationship, {time_difference})
ParameterExplanationData Type
in_point_features

The point features representing the movement track points. The layer can be time enabled.

Feature Layer
in_area_features

The area features representing the areas of interest that will be used to identify unique movement track point identifiers. The layer can be time enabled.

Feature Layer
out_featureclass

The output area feature class. The output will contain a copy of the in_area_features geometry and the unique identifiers from the area_id_field and point_id_field parameters.

If both the in_point_features and in_area_features parameter values are time enabled and relationship is set to LOCATION_TIME, only the features matching the geometry and the time span will be returned.

Feature Layer
point_id_field

The field containing the unique identifiers for the movement track points. The field can be either a number or a string.

Field
area_id_field

The field containing the unique identifiers for the areas of interest. The field can be either a number or a string.

Field
relationship

Specifies the relationship between the inputs.

  • LOCATION_ONLY Points and area features will be evaluated based on spatial co-occurrence.
  • LOCATION_TIME Points and area features will be evaluated based on spatial and temporal co-occurrence.
String
time_difference
(Optional)

The time allowed between the in_point_features and in_point_features parameter values before a spatial relationship is considered invalid. This parameter is enabled when the relationship parameter is set to LOCATION_TIME and both inputs are time enabled.

Time Unit

Code sample

CompareAreas example (stand-alone script)

The following Python script demonstrates how to use the CompareAreas function in a stand-alone script.

# 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"

# Execute tool
arcpy.CompareAreas_intelligence(point_features,
                                area_features,
                                out_features,
                                point_id_field,
                                area_id_field,
                                relationship,
                                time_difference)

Licensing information

  • Basic: No
  • Standard: No
  • Advanced: Yes

Related topics