Summarize Within (Standard Feature Analysis)

Summary

Finds the point, line, or polygon features (or portions of these features) that are within the boundaries of polygons in another layer.

For example

  • Given a layer of watershed boundaries and a layer of land-use boundaries by land-use type, calculate total acreage of land-use type for each watershed.
  • Given a layer of parcels in a county and a layer of city boundaries, summarize the average value of vacant parcels within each city boundary.
  • Given a layer of counties and a layer of roads, summarize the total mileage of roads by road type within each county.

Illustration

Summarize Within illustration

Usage

  • You can think of Summarize Within as taking two layers and stacking them on top of each other. Imagine that the features in one of the layers, the input polygons layer, are all colored red. The other layer, the input summary features, can be any feature type—point, line, or polygon. After stacking these layers on top of each other, you peer down through the stack and count the number of features in the input summary features layer that fall within the polygons with the red boundaries (the input polygons). Not only can you count the number of features, you can calculate simple statistics about the attributes of the features in the input summary features layer, such as sum, mean, minimum, maximum, and so on.

Parameters

LabelExplanationData Type
Input Polygons

Features, or portions of features, in the input summary features that fall within the boundaries of these polygons will be summarized.

Feature Set
Input Summary Features

The point, line, or polygon features that will be summarized for each input polygon.

Feature Set
Output Name

The name of the output layer to create on your portal.

String
Add shape summary attributes
(Optional)

Calculate statistics based on the shape of the input summary features, such as the length of lines or areas of polygons of the input summary features within each input polygon.

  • Checked—Calculate the shape summary attributes. This is the default.
  • Unchecked—Do not calculate the shape summary attributes.

Boolean
Shape Unit
(Optional)

If summarizing the shape of the input summary features, specify the units of the shape summary.

When the input summary features are polygons, the valid options are acres, hectares, square meters, square kilometers, square feet, square yards, and square miles.

When the input summary features are lines, the valid options are meters, kilometers, feet, yards, and miles.

  • MilesMiles
  • FeetFeet
  • KilometersKilometers
  • MetersMeters
  • YardsYards
  • AcresAcres
  • HectaresHectares
  • Square metersSquare meters
  • Square kilometersSquare kilometers
  • Square feetSquare feet
  • Square yardsSquare yards
  • Square milesSquare miles
String
Summary Fields
(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:

  • Sum—The total value.
  • Minimum—The smallest value.
  • Max—The largest value.
  • Mean—The average or mean value.
  • Standard deviation—The standard deviation.

Value Table
Group By Field
(Optional)

This is a field from the input summary features that you can use to calculate statistics separately for each unique attribute value. For example, suppose the input summary features contain point locations of businesses that store hazardous materials, and one of the fields is HazardClass containing codes that describe the type of hazardous material stored. To calculate summaries by each unique value of HazardClass, use it as the group by field.

Field
Add minority and majority attributes
(Optional)

This only applies when using a group by field. If checked, 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_.

  • Unchecked—Do not add minority and majority fields. This is the default.
  • Checked—Add minority and majority fields.

Boolean
Add group percentages
(Optional)

This only applies when using a group by field. If checked, the percentage of each unique group value is calculated for each input polygon.

  • Unchecked—Do not add percentage fields. This is the default.
  • Checked—Add percentage fields.

Boolean

Derived Output

LabelExplanationData Type
Output Feature Service

The output summarized layer.

Feature Set
Output Group Table

If a group by field was provided, the tool will output a table that contains the calculated statistics for each unique group.

Record Set

arcpy.sfa.SummarizeWithin(sumWithinLayer, summaryLayer, outputName, {sumShape}, {shapeUnits}, {summaryFields}, {groupByField}, {minorityMajority}, {percentShape})
NameExplanationData Type
sumWithinLayer

Features, or portions of features, in the input summary features that fall within the boundaries of these polygons will be summarized.

Feature Set
summaryLayer

The point, line, or polygon features that will be summarized for each input polygon.

Feature Set
outputName

The name of the output layer to create on your portal.

String
sumShape
(Optional)

Calculate statistics based on the shape of the input summary features, such as the length of lines or areas of polygons of the input summary features within each input polygon.

  • ADD_SHAPE_SUMCalculate the shape summary attributes. This is the default.
  • NO_SHAPE_SUMDo not calculate the shape summary attributes.
Boolean
shapeUnits
(Optional)

If summarizing the shape of the input summary features, specify the units of the shape summary.

When the input summary features are polygons, the valid options are acres, hectares, square meters, square kilometers, square feet, square yards, and square miles.

When the input summary features are lines, the valid options are meters, kilometers, feet, yards, and miles.

  • MILESMiles
  • FEETFeet
  • KILOMETERSKilometers
  • METERSMeters
  • YARDSYards
  • ACRESAcres
  • HECTARESHectares
  • SQUAREMETERSSquare meters
  • SQUAREKILOMETERSSquare kilometers
  • SQUAREFEETSquare feet
  • SQUAREYARDSSquare yards
  • SQUAREMILESSquare miles
String
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:

  • SUM—The total value.
  • MIN—The smallest value.
  • MAX—The largest value.
  • MEAN—The average or mean value.
  • STD—The standard deviation.

Value Table
groupByField
(Optional)

This is a field from the input summary features that you can use to calculate statistics separately for each unique attribute value. For example, suppose the input summary features contain point locations of businesses that store hazardous materials, and one of the fields is HazardClass containing codes that describe the type of hazardous material stored. To calculate summaries by each unique value of HazardClass, use it as the group by field.

Field
minorityMajority
(Optional)

This only applies when using a group by field. If you specify ADD_MIN_MAJ, 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_.

  • NO_MIN_MAJDo not add minority and majority fields. This is the default.
  • ADD_MIN_MAJAdd minority and majority fields.
Boolean
percentShape
(Optional)

This only applies when using a group by field. If checked, the percentage of each unique group value is calculated for each input polygon.

  • NO_PERCENTDo not add percentage fields. This is the default.
  • ADD_PERCENTAdd percentage fields.
Boolean

Derived Output

NameExplanationData Type
outputLayer

The output summarized layer.

Feature Set
groupBySummaryLayer

If a group by field was provided, the tool will output a table that contains the calculated statistics for each unique group.

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

Related topics