Geometría por zonas como tabla (Spatial Analyst)
Resumen
Calcula, para cada zona en un dataset, las medidas de geometría (área, perímetro, grosor y las características de elipse) e informa los resultados como una tabla.
Más información acerca de cómo funciona la Geometría por zonas
Ilustración
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. Tanto los datasets ráster como los de entidades se pueden utilizar 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.
Al especificar los datos de zona de entrada, el campo de zona predeterminada será el primer campo válido disponible. Si no existen otros campos válidos, el campo ObjectID (por ejemplo, OID o FID) será el valor predeterminado.
Si un campo reservado (por ejemplo, OBECTID, FID u OID) se selecciona para el campo Zona, entonces esto puede provocar cierta ambigüedad en el resultado. El resultado incluye el nombre del campo reservado en particular para el tipo de formato de salida determinado, así como el campo de Zona especificado. Si el campo especificado tiene el mismo nombre que el campo reservado para el formato de salida determinado, en la salida el nombre para el campo de zona se alterará de forma tal que todos los nombres de campo en el resultado sean únicos.
Nota:Para hacer un campo de valores únicos, el cual no tiene un nombre reservado, utilice las herramientas de geoprocesamiento Agregar campo y Calcular campo.
-
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.
-
A excepción del elemento ORIENTATION, todos los resultados en la tabla de salida se presentan en unidades de mapa. Los valores del elemento ORIENTATION se presentan en grados, con un rango posible de 0 a 180. ORIENTATION 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.
Sintaxis
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. | Table |
processing_cell_size (Opcional) | Tamaño de celda de procesamiento para 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 |
Ejemplo de código
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)
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)