Label | Explanation | Data Type |
Input Features | The input features to which coincident point counts will be calculated. | Feature Layer |
Input Summary Features
| The point features coincident with the input features. | Feature Layer |
Output Feature Class
| The output choropleth count feature class, symbolized by total count. | Feature Class |
Search Radius
(Optional) | The maximum distance from an Input Features point or line that a point feature will be considered coincident. This parameter is not active when the Input Features is a polygon. | Linear Unit |
Group Field (Optional) | A field containing the value used to split point counts. Additional fields containing counts for each unique value in the group field will be generated. | Field |
Summary
Creates a feature class with coincident point counts. Coincident point counts for line and point features are determined by a specified maximum distance. Point counts for polygon features are determine by whether point features or portions of features overlap with the polygon feature.
Usage
The TOTAL_CNT field is created by the tool and includes a total count of all unique values for the Input Summary Features that are coincident with the Input Features.
A field is created for each unique value found in the Group Field when the Group Field parameter is used. Each field contains a count of Input Summary Features that are coincident with the Input Features and have a matching unique value.
The output feature class is symbolized using the TOTAL_CNT field.
When the Group Field parameter is used, additional <value name>_CNT fields are created. The tool will generate a unique field name for every unique value of the attribute. If null values exist the None_CNT field is created.
Parameters
arcpy.ca.SummarizeIncidentCount(in_features, in_sum_features, out_feature_class, {search_radius}, {group_field})
Name | Explanation | Data Type |
in_features | The input features to which coincident point counts will be calculated. | Feature Layer |
in_sum_features | The point features coincident with the input features. | Feature Layer |
out_feature_class | The output choropleth count feature class, symbolized by total count. | Feature Class |
search_radius (Optional) | The maximum distance from an Input Features point or line that a point feature will be considered coincident. This parameter is not active when the Input Features is a polygon. | Linear Unit |
group_field (Optional) | A field containing the value used to split point counts. Additional fields containing counts for each unique value in the group field will be generated. | Field |
Code sample
The following Python script demonstrates how to use the SummarizeIncidentCount function in immediate mode.
import arcpy
arcpy.env.workspace = r"C:/data/city_pd.gdb"
arcpy.ca.SummarizeIncidentCount("Precincts",
"Arrests",
"arrests_by_precinct_offense_type",
None,
"OFFENDESC")
The following Python script demonstrates how to use the SummarizeIncidentCount function in a stand-alone script.
# Name: SummarizeIncidentCount.py
# Description: Creates a polygon feature class containing the total number of
# crimes committed, the total number of each type of crime
# committed, within each precinct.
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = r"C:\data\city_pd.gdb"
# Execute SummarizeIncidentCount
arcpy.ca.SummarizeIncidentCount("Precincts", "Crimes",
"crimes_by_precinct_offense_type", "OFFENDESC")
Environments
Licensing information
- Basic: Yes
- Standard: Yes
- Advanced: Yes