Incident Path

Summary

Creates linking lines between two layers based on unique IDs. Can be used for one-to-one relationships (for example, motor vehicle theft to recovery locations) or one-to-many (for example, spider diagrams-gang member addresses to gang turf).

Usage

  • Generates a line feature class connecting Input Origin Point or Polygon Features to Input Destination Point Features based on a common identifier field. Origin identifier and destination identifier field names do not have to be identical but should both contain identical values that would connect the origin features with the destination features.
  • Input Origin Point or Polygon Features and Input Destination Point Features should be two different feature classes.
  • The output line feature class will contain new field with the same name as the Origin Identifier Field, Destination Y, Destination X, Origin Y, and Origin X fields:
    • Origin Identifier Field output—The origin identifier value from the Input Origin Point Features. This field can be used to join the output lines back to the origin or destination points for further analysis.
    • Destination and origin X and Y fields contain the coordinate pairs based on the linear unit of the Input Destination Point Features.

Syntax

IncidentPath_crime (Input_Origin_Point_or_Polygon_Features, Input_Destination_Point_or_Polygon_Features, Output_Feature_Class, Origin_ID, Destination_ID, {Summary_Statistic_Field}, {Statistic_Type})

Parameter Explanation Data Type
Input Origin Point or Polygon Features

Origin point or polygon features.

Example: Vehicle theft points or gang turf polygons.

Feature Layer
Input Destination Point or Polygon Features

Destination point or polygon features.

Example: Vehicle recovery locations or gang member homes.

Feature Layer
Output Feature Class Line feature class showing directional path between origin and destination point features. Feature Class
Origin Identifier Field Field identifying unique origin point features. Field
Destination Identifier field Field in destination points containing corresponding unique identifier from origin point or polygon features. Field
Summary Statistic Field (Optional) Numeric field used to generate a statistical summary line feature class. When used an additional incident path feature class will be generated containing the summary statistic value. Line features that are identical to one another will be dissolved into a single feature. Field
Statistic Type (Optional) Statistical calculation type Available statistics types are as follows:
  • Sum - Adds the total value for the specified field.
  • Mean - Calculates the average for the specified field.
  • Minimum - Finds the smallest value for all records of the specified field.
  • Maximum - Finds the largest value for all records of the specified field.
  • Range - Finds the range of values (maximum minus minimum) for the specified field.
  • Standard Deviation - Finds the standard deviation on values in the specified field.
  • Median - Calculates the median for all records of the specified field.
  • Variance - Calculates the variance for all records of the specified field.
String

Licensing information

  • ArcGIS Desktop Basic: Yes
  • ArcGIS Desktop Standard: Yes
  • ArcGIS Desktop Advanced: Yes
Top