Tabulate Area

The Tabulate Area tool calculates the cross-tabulated areas between two datasets and reports the results as a table.

The output is a hosted feature layer.

Examples

Example scenarios for using this tool include the following:

  • Given a layer of watershed boundaries and a layer of land-use boundaries by land-use type, calculate the total area of land-use type for each watershed.
  • Given a layer of parcels in a county and a layer of city boundaries, summarize the area of vacant parcels within each city boundary.

Usage notes

Tabulate Area includes configurations for input layers, area settings, and the result layer.

Input layers

The Input layers group includes the following parameters:

  • Input zone raster or features specifies the input that defines the boundaries of the zones. A zone is defined as all areas in the input that have the same value. The input can be an integer raster or feature data. The areas do not need to be contiguous.

    The zones can be defined by an integer raster or a feature.

    You can choose a layer using the Layer button, or you can create a sketch layer to use as the input using the Draw input features button. For feature inputs, a count of features is displayed below the layer name. The count includes all features in the layer, except features that have been removed using a filter. Environment settings, such as Processing extent, are not reflected in the feature count.

  • Zone field specifies the field that contains the values that define each zone.

    It can be an integer or a string field of the zone layer.

    When specifying the zone input, the default zone field will be the first available integer or text field. If no other valid fields exist, the ObjectID field (for example, OID or FID) will be the default. If the zone input is a raster without a raster attribute table, the zone field will be Value by default.

  • Input class raster or features specifies the input that defines the classes that will have their area summarized within each zone.

    The classes can be defined by an integer raster or a feature.

    You can choose a layer using the Layer button, or you can create a sketch layer to use as the input using the Draw input features button. For feature inputs, a count of features is displayed below the layer name. The count includes all features in the layer, except features that have been removed using a filter. Environment settings, such as Processing extent, are not reflected in the feature count.

  • Class field specifies the field that contains the values that define each class.

    It can be an integer or a string field of the class layer.

    Similar to the zone field, the default class field will be the first available integer or text field. If no other valid fields exist, the ObjectID field (for example, OID or FID) will be the default. If the class input is a raster without a raster attribute table, the class field will be Value by default.

Interactions between the Input layers group parameters are listed below.

  • When the zone and class inputs are both rasters of the same cell size and the cells are aligned, they will be used directly in the tool and will not be resampled internally.

  • When the cell size of the zone raster and the class raster is different, the output cell size will be the maximum of the input, and the class raster will be used as the snap raster internally.

    If the cell size is the same but the cells are not aligned, the class raster will be used as the snap raster internally.

    Both of these cases will cause an internal resampling before the zonal operation is performed.

  • If either of the input datasets is a feature class, it is converted internally to a raster before the analysis is performed using the Analysis cell size parameter value if specified or the cell size and the cell alignment of the other input raster.

  • If point or line data is used as the input feature, the area intersected by those features will be reported.

  • If the input has overlapping features, the zonal analysis will be performed for each individual feature.

  • If a particular zone does not overlap any cell centers of the class raster, those zones will not be converted to the internal zone raster. As a result, those zones will not be represented and will become NoData in the output.

    You can manage this by first determining an appropriate raster resolution that will retain the detail of the zone input; then use this resolution as the Analysis cell size parameter value.

    Specifying a smaller cell size will generate a higher resolution raster. The higher resolution output will not necessarily be as high quality a result, since the additional detail does not exist.

  • The Processing extent environment setting will affect how the input layers are analyzed. In the Environment settings, if Processing extent is set to Use current map extent, only the elements in the Input zone raster or features layer and the Input class raster or features layer that are visible within the current map extent will be analyzed.

    If the Processing extent environment is set to the Default option, all of the elements in both the zone layer and the class layer will be analyzed, even if they are outside the current map extent.

Tabulate area settings

The tabulate area settings group includes the following parameters:

  • Classes as rows in output table specifies whether the values from the input class raster will be represented as rows in the output table. When classes are represented in rows, the table output can be related and queried to extract area information by zone or class rasters.

    If checked, classes will be represented as rows.

    If unchecked, classes will be represented as fields. This is the default.

  • Analysis cell size specifies the cell size of the analysis raster. It is defined by a numeric value. The available units are feet, miles, kilometers, and meters.

    If the cell size hasn’t been explicitly specified as the parameter value, it will be derived from the Cell Size environment if it has been specified.

    If the parameter cell size or the environment cell size has not been specified, the default output cell size will be determined by the cell size of the analysis raster. If the input dataset is a feature and the Snap Raster environment has been set, the cell size of the snap raster will be used. If no snap raster is set, the cell size will be calculated from the shorter of the width or height of the extent divided by 250 in which the extent is in the output coordinate system specified in the environment.

Result layer

The Result layer group includes the following parameters:

  • Output table name is the name of the output table layer that will be created and added to the map.

    The name must be unique. If a layer 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 following analysis environments:

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.

Output

The output is a table layer that will contain the summary of the area of each class in each zone.

In this table, when the Classes as rows in output table parameter is unchecked, the following are true:

  • There will be a record for each unique value of the zone dataset.
  • There will be a field for each unique value of the class dataset.
  • Each record will store the area of each class within each zone.

When the Classes as rows in output table parameter is checked, the following are true:

  • There will be a record for each unique value of the zone dataset that has a unique value of the class dataset.
  • There will be individual fields that identify the zone field, the class field, the count, and the area of each class within each zone.

Usage 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: