Summary
Uses a layer of point features and a layer of polygon features to determine which points fall within each polygon's area. After determining this point-in-polygon spatial relationship, statistics about all points in the polygon are calculated and assigned to the area.
The most basic statistic is the count of the number of points within the polygon, but you can get other statistics as well. For example, if your points represented coffee shops and each point has a TOTAL_SALES attribute, you can get statistics like the sum of all TOTAL_SALES within the polygon, or the minimum or maximum TOTAL_SALES value, or the standard deviation of all sales within the polygon.
Illustration
Usage
Aggregate Points is designed to collect and summarize point features within a set of boundaries. The input parameters must include points to be aggregated and aggregation areas.
The Keep boundaries with no points box is checked by default. When the box is checked, all of the areas used in the analysis will be included in the result, regardless of the location of points. Areas with no points will be empty and have a count of 0. When the box is unchecked, the areas with no points are completely removed from the result layer. Unchecking the box may have a significant effect on the result areas.
The difference in result layers when boundaries with no points are kept (left) or not kept (right) The most basic aggregations will calculate a count of the number of points in each boundary. Basic statistics (sum, minimum, maximum, average, and standard deviation) can also be calculated on numerical fields. The statistics will be calculated on each area separately.
Statistical calculations can also be grouped using a field with categorical values. When statistics are grouped by a field, the statistics are calculated for both the area as a whole and for each group. Both statistics can be viewed in the result layer's pop-up. The overall statistics are given numerically and the grouped statistics are given in chart form within the pop-up. A summary table listing each feature and statistic by group field value will also be created. The Add minority, majority check box will return the groups with the lowest and highest counts and the Add percentages check box will return the percentage of points in the minority and majority groups.
Point layers are summarized using only the point features within the input boundary. The results will be displayed using graduated symbols.
The figure and table below explain the statistical calculations of a point layer within a hypothetical boundary. The Population field was used to calculate the statistics (Sum, Minimum, Maximum, Average, and Std Deviation) for the layer.
Point layers are summarized using only points located within the boundary layer. An example attribute table is displayed above with values to be used in hypothetical statistic calculations. Statistic Results District A Sum
280 + 408 + 356 + 361 + 450 + 713 = 2,568Minimum
Minimum of
[280, 408, 356, 361, 450, 713] = 280Maximum
Maximum of
[280, 408, 356, 361, 450, 713] = 713Average
2,568/6 = 428Std Deviation
= 150.79
Syntax
arcpy.sfa.AggregatePoints(pointLayer, polygonLayer, outputName, {keepBoundariesWithNoPoints}, {summaryFields}, {groupByField}, {minorityMajority}, {percentPoints})| Parameter | Explanation | Data Type |
pointLayer | The point features that will be aggregated into the polygons in the polygon layer. | Feature Set |
polygonLayer | The polygon features (areas) into which the input points will be aggregated. | Feature Set |
outputName | The name of the output layer to create on your portal. | String |
keepBoundariesWithNoPoints (Optional) | Specifies whether the polygons that have no points within them should be returned in the output.
| Boolean |
summaryFields [[Field, Statistic],...] (Optional) | A list of field names and statistical summary type that you wish to calculate for all points within each polygon. The count of points within each polygon is always returned. The following statistic types are supported:
| Value Table |
groupByField (Optional) | A field name in the pointLayer. Points that have the same value for the group by field will have their own counts and summary field statistics. You can create statistical groups using an attribute in the analysis layer. For example, if you are aggregating crimes to neighborhood boundaries, you may have a Crime_type attribute with five different crime types. Each unique crime type forms a group, and the statistics you choose will be calculated for each unique value of Crime_type. When you choose a grouping attribute, two results are created: the result layer and a related table containing the statistics. | Field |
minorityMajority (Optional) | This Boolean parameter is applicable only when a groupByField is specified. If true, the minority (least dominant) or the majority (most dominant) attribute values for each group field within each boundary are calculated. Two new fields are added to the output layer prefixed with Majority_ and Minority_.
| Boolean |
percentPoints (Optional) | This Boolean parameter is applicable only when a groupByField is specified. If set to ADD_PERCENT, the percentage count of points for each unique groupByField value is calculated. A new field is added to the output group summary table containing the percentages of each attribute value within each group. If minorityMajority is true, two additional fields are added to the output containing the percentages of the minority and majority attribute values within each group.
| Boolean |
Derived Output
| Name | Explanation | Data Type |
| aggregatedLayer | The output layer. | Feature Set |
| groupSummary | The output table that summarizes the groups from the Group By Field. | Record Set |
Environments
Licensing information
- Basic: Requires your account in ArcGIS Enterprise to have the Perform Analysis privilege
- Standard: Requires your account in ArcGIS Enterprise to have the Perform Analysis privilege
- Advanced: Requires your account in ArcGIS Enterprise to have the Perform Analysis privilege