The Zonal Geometry as Table tool calculates geometry measures for each zone in a dataset and reports the results as a table.
Learn more about how Zonal Geometry as Table works
The output is a hosted feature layer.
Examples
Example scenarios for using this tool include the following:
- Given a layer of watershed boundaries, calculate the area and perimeter of each watershed boundary.
- Given a layer of land-use types, calculate different geometry type for each land-use zone.
Usage notes
Zonal Statistics as Table includes configurations for input layers, the geometry setting, 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.
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.
If the zone input is a raster, it must be an integer raster. The zones are defined by all locations in the input that have the same cell value.
If a particular zone consists of only one cell or if the zone is a single square block of cells, the orientation of the ellipse (which, in this case, is a circle) is set to 90 degrees.
If the zone input is a feature, it will be converted to a raster internally using the analysis cell size.
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.
Zonal geometry setting
The zonal geometry setting group includes the Analysis cell size parameter, which 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:
- Output coordinate system
- Geographic transformations
- Processing extent
Note:
The default processing extent is Full extent. This default is different from Map Viewer Classic in which Use current map extent is enabled by default.
- Snap raster
- Cell size
- Mask
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 showing the result of the zonal operation.
In the output table, the value field always precedes the fields containing the zonal output calculations. The value field contains the values of the zones defined by the zone dataset and are floating point.
All the results in the output table are presented in map units, except for the orientation, which is in degrees in a range from 0 to 180. The orientation is defined as an angle between the x-axis and the major axis of the ellipse. The values of the orientation angle increase counterclockwise, starting at 0 in the east (horizontal, to the right) and going through 90 when the major axis is vertical.
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:
- Zonal Geometry as Table in ArcGIS REST API
- zonal_geometry_as_table in ArcGIS API for Python
- Zonal Geometry as Table in ArcGIS Pro with the Spatial Analyst extension