Disponible con una licencia de Spatial Analyst.
Resumen
Calcula, para cada zona de un dataset, las medidas de geometría (área, perímetro, grosor y características de la elipse) y muestra los resultados como una tabla.
Ilustración
VALUE AREA PERIMETER THICKNESS XCENTROID YCENTROID MAJORAXIS MINORAXIS ORIENTATION 0 5.0 14.0 0.5 2.300 2.100 2.338 0.681 60.714 1 5.0 14.0 0.5 1.900 2.100 2.668 0.596 126.061 2 3.0 8.0 0.5 3.167 2.167 1.286 0.743 135.000 4 2.0 6.0 0.5 0.500 1.000 1.128 0.564 90.000
Uso
Una zona se define como todas las áreas de la entrada que tienen el mismo valor. No es necesario que las áreas sean contiguas. Puede usar tanto rásteres como entidades para la entrada de zona.
Si los datos de zona de entrada son un dataset de entidad, se debe establecer un tamaño de celda por el entorno Procesar tamaño de celda o Tamaño de celda.
Los cálculos para cada zona se registran en la tabla de salida.
Si los Datos de zonas de entidad o ráster de entrada (in_zone_data en Python) tienen polígonos que se superponen, el análisis zonal no se realizará para cada polígono individual. Debido a que la entrada de entidades se convierte a ráster, cada ubicación puede tener sólo un valor.
Un método alternativo es procesar la operación zonal con iteración para cada una de las zonas poligonales e intercalar los resultados.
Al especificar los Datos de zonas de entidad o ráster de entrada (in_zone_data en Python), el campo de zona predeterminado será el primer campo entero o de texto disponible. Si no existen otros campos válidos, el campo ObjectID (por ejemplo, OID o FID) será el valor predeterminado.
En la tabla de salida, el campo de valor siempre precede a los campos que contienen los cálculos de salida zonal. El campo de valor contiene los valores de las zonas definidos por el dataset de zona.
Los valores para los cálculos zonales serán de punto flotante.
Todos los resultados de la tabla de salida se presentan en unidades de mapa, excepto para el elemento ORIENTATION, que se presenta en grados en un rango de 0 a 180. La orientación se define como un ángulo entre el eje x y el eje mayor de la elipse. Los valores del ángulo de orientación aumentan en sentido contrario a las agujas del reloj, comenzando en 0 en el Este (horizontal, a la derecha) y llegando a 90 cuando el eje mayor es vertical.
Si una zona determinada consiste de sólo una celda o si la zona es un sólo bloque cuadrado de celdas, la orientación de la elipse (la cual, en este caso un círculo), se establece a 90 grados.
Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento válidos para esta herramienta.
Sintaxis
ZonalGeometryAsTable (in_zone_data, zone_field, out_table, {processing_cell_size})
Parámetro | Explicación | Tipo de datos |
in_zone_data | El dataset que define las zonas. Las zonas pueden definirse mediante un ráster entero o una capa de entidades. | Raster Layer; Feature Layer |
zone_field | El campo que mantiene los valores que definen cada zona. Debe ser un campo de entero del dataset zonal. | Field |
out_table | Tabla de salida que contendrá el resumen de los valores de cada zona. El formato de la tabla está determinado por la ubicación y la ruta de salida. De forma predeterminada, la salida será una tabla de geodatabase. Si la ruta no está en una geodatabase, el formato lo determinará la extensión. Si la extensión es .dbf, tendrá el formato de dBASE. Si no se especifica una extensión, la salida será una tabla INFO. | Table |
processing_cell_size (Opcional) | Tamaño de celda de procesamiento de la operación zonal. Este es el valor del entorno si se lo establece específicamente. Si no se establece el entorno, el tamaño de celda predeterminado se determina según el tipo de datos zonales como se informa a continuación:
| Analysis Cell Size |
Muestra de código
Ejemplo 1 de ZonalGeometryAsTable (ventana de Python)
Este ejemplo determina las mediciones de geometría para cada zona definida por el shapefile del polígono de entrada.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outZonalGeometryAsTable = ZonalGeometryAsTable("zones.shp", "Classes", "zonalgeomout", 0.2)
Ejemplo 2 de ZonalGeometryAsTable (secuencia de comandos independiente)
Este ejemplo determina las mediciones de geometría para cada zona definida por el shapefile del polígono de entrada.
# Name: ZonalGeometryAsTable_Ex_02.py
# Description:Calculates for each zone in a dataset the specified geometry
# measure (area, perimeter, thickness, or the characteristics
# of ellipse) and reports the results as a table.
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Set environment settings
env.workspace = "C:/sapyexamples/data"
# Set local variables
inZoneData = "zones.shp"
zoneField = "Classes"
outTable = "zonalgeomout02.dbf"
processingCellSize = 0.2
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute ZonalGeometryAsTable
outZonalGeometryAsTable = ZonalGeometryAsTable(inZoneData, zoneField, "AREA", cellSize)
Entornos
- Auto ejecución
- Tamaño de celda
- Compresión
- Espacio de trabajo actual
- Extensión
- Transformaciones geográficas
- Máscara
- Palabra clave CONFIG de salida
- Sistema de coordenadas de salida
- Nombres de campos calificados
- Espacio de trabajo temporal
- Alinear ráster
- Tamaño de tesela
- Transferir descripciones de dominio de campo
Información sobre licencias
- ArcGIS Desktop Basic: Requiere Spatial Analyst
- ArcGIS Desktop Standard: Requiere Spatial Analyst
- ArcGIS Desktop Advanced: Requiere Spatial Analyst