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.
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})
Parameter | Explanation | Data 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.
| 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
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