Skip to main content

Summarize Categorical Raster

License:

Available with Image Server

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.

Examples

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 will use class values from the Class_Value or ClassValue field. 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.

  • 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

This tool honors the following analysis environments:

Note:

The default processing extent for raster analysis tools and raster functions is Display extent. This default is different from other types of analysis.

Outputs

The output is a table that contains the pixel count for each category.

Usage Requirements

This tool requires the following user type and configurations:

  • Creator, Professional, or Professional Plus user type

  • Publisher or Administrator role, or an equivalent custom role

  • ArcGIS Image Server configured for raster analysis

Resources