Selects movement tracks based on an area of interest.
Usage
The tool selects tracks identified by the Track ID Field parameter value, from the Input Features parameter value that intersect the features of the Area Of Interest parameter value. If the Before, After, or Before and after option is specified for the Time Relationship parameter, the results will only include the unique track identifiers and features that meet the time requirement defined in the Selection Time parameter.
Time must be set on the Input Features parameter value if the Time Relationship parameter is set to the Before, After, or Before and after option.
The features that will be compared with the Area Of Interest parameter value to identify unique tracks and select the relevant tracks.
Feature Layer
Track 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 Of Interest
The feature or features that will be compared with the Input Features value to determine the tracks to select.
Feature Set
Time Relationship
Specifies the time relationship between the Input Features and Area Of Interest parameter values. If the Before, After, or Before and after option is specified, only features that are present in the Area Of Interest value within the specified time window will be included in the output selection.
Before and after—When a feature's time is before the first time identified and after the last time identified for the Area Of Interest value but within the specified range of time from the first identified time and the last identified time, the time relationship will be before and after the selection time.
Before—When a feature's time is before the first time identified for the Area Of Interest value but within the specified range of time from the first identified time, the time relationship will be before the selection time.
After—When a feature's time is after the last time identified for the Area Of Interest value but within the specified range of time from the last identified time, the time relationship will be after the selection time.
None—All tracks associated with the unique identifier specified in Track ID Field that are present in the Area Of Interest value will be returned.
String
Selection Time
The time frame that will be used to select features if Before, After, or Before and after is specified for the Time Relationship parameter.
If Before or Before and after is specified, the earliest time selected will be the first identified time of the features selected from the initial selection generated from the Input Features and Area Of Interest parameters, subtracting the time value specified. If After or Before and after is specified, the selection time will be added to the latest time from the initial selection to determine the selected features.
The features that will be compared with the area_of_interest parameter value to identify unique tracks and select the relevant tracks.
Feature Layer
track_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_of_interest
The feature or features that will be compared with the in_features value to determine the tracks to select.
Feature Set
time_relationship
Specifies the time relationship between the in_features and area_of_interest parameter values. If the BEFORE, AFTER, or BEFORE_AFTER option is specified, only features that are present in the area_of_interest value within the specified time window will be included in the output selection.
BEFORE_AFTER—When a feature's time is before the first time identified and after the last time identified for the Area Of Interest value but within the specified range of time from the first identified time and the last identified time, the time relationship will be before and after the selection time.
BEFORE—When a feature's time is before the first time identified for the Area Of Interest value but within the specified range of time from the first identified time, the time relationship will be before the selection time.
AFTER—When a feature's time is after the last time identified for the Area Of Interest value but within the specified range of time from the last identified time, the time relationship will be after the selection time.
NONE—All tracks associated with the unique identifier specified in Track ID Field that are present in the Area Of Interest value will be returned.
String
selection_time
The time frame that will be used to select features if BEFORE, AFTER, or BEFORE_AFTER is specified for the time_relationship parameter.
If BEFORE or BEFORE_AFTER is specified, the earliest time selected will be the first identified time of the features selected from the initial selection generated from the in_features and area_of_interest parameters, subtracting the time value specified. If AFTER or BEFORE_AFTER is specified, the selection time will be added to the latest time from the initial selection to determine the selected features.
Time Unit
Derived output
Name
Explanation
Data type
updated_featureclass
The updated input features.
Feature Layer
Code sample
SelectMovementTracks (stand-alone script)
The following Python script demonstrates how to use the SelectMovementTracks function in a stand-alone script.
# SelectMovementTracks.py
# Description: Select movement tracks that are identified in a known area 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"
arcpy.management.MakeFeatureLayer(point_features, "lyr")
arcpy.intelligence.SelectMovementTracks("lyr",
"created_user",
area_features,
"NONE")
Environments
This tool does not use any geoprocessing environments.