The Summarize Categorical Raster tool generates a table containing the pixel count for each category in each slice of an input multidimensional categorical raster.
The output is a table.
Example
Calculate the number of pixels in each land cover class for a multidimensional raster containing 30 years of land cover data.
Usage notes
Summarize Categorical Raster includes configurations for the input layer, summary areas, and the result table.
Input layer
The Input layer group includes the following parameters:
- Input categorical raster specifies the categorical raster to be summarized. The input raster must be of integer type.
If a raster attribute table exists, the tool will use the unique values in the table to compute pixel count. If a raster attribute table does not exist, the tool will scan pixels to find unique values. If the input raster has a raster attribute table with a Class_Name or ClassName field, the output table will use the names listed in that field. Otherwise, the output table will use class values from the Class_Value or ClassValue field. The field names are not case sensitive.
- Dimension specifies the dimension used to summarize the input raster. If there is more than one dimension and no value is specified, all slices will be summarized using all combinations of dimension values.
Summary areas
The Summary areas group includes the following parameters:
- Area of interest specifies the polygon feature layer containing the area or areas of interest to use when calculating the pixel count per category. If no area of interest is specified, the entire raster dataset is used in the analysis.
- Field specifies the field in the polygon feature layer that defines each area of interest.
Result layer
The Result layer group includes the following parameters:
- Output summary table is the name of the output table. The name must be unique. If a table with the same name already exists in your organization, the tool will fail and you will be prompted to use a different name.
- Save in folder specifies the name of a folder in My content where the result will be saved.
Environments
Analysis environment settings are additional parameters that affect a tool's results. You can access the tool's analysis environment settings from the Environment settings parameter group.
This tool honors the Processing extent analysis environment.
Note:
The default processing extent for raster analysis tools and raster functions is Display extent. This default is different from other types of analysis.
Credits
This tool consumes credits.
Use Estimate credits to calculate the number of credits that will be required to run the tool. For more information, see Understand credits for spatial analysis.
Outputs
The output is a table that contains the pixel count for each category.
Licensing requirements
This tool requires the following user type and configurations:
- Professional or Professional Plus user type
- Publisher, Facilitator, or Administrator role, or an equivalent custom role with the Imagery Analysis privilege
Resources
Use the following resources to learn more:
- Summarize Categorical Raster in ArcGIS REST API
- summarize_categorical_raster in ArcGIS API for Python
- Summarize Categorical Raster in ArcGIS Pro