Disponible con una licencia de Spatial Analyst.
Resumen
Calcula áreas tabuladas entre dos datasets y genera como salida una tabla.
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. Puede usar tanto rásteres como entidades para la entrada de zona.
Si alguna de las entradas son rásteres, debe ser un ráster de número entero.
Si ambas entradas son rásteres y sus celdas no están alineadas, las entradas se remuestrearán durante el análisis. Si el entorno Ráster de alineación no se ha especificado explícitamente, las celdas se alinean internamente usando Datos de clase de entidad o ráster de entrada (in_class_data en Python). Si ambos rásteres tienen el mismo tamaño de celda y las celdas están alineadas, el remuestreo no se producirá.
Si alguno de los datasets de entrada es una clase de entidad, se convierte internamente a un ráster antes de realizar el análisis.
En el caso de que los Datos de zonas de entidad o ráster de entrada (in_zone_data en Python) sean una entidad, si hay entidades de zona que no se superpongan con ningún centro de celdas del ráster de clase, dichas zonas no se convertirán al ráster de zona interno. Como resultado, las zonas no se representan en la salida. Puede administrar esta configuración determinando un valor adecuado para el entorno Tamaño de celda, que conservará el nivel de detalle deseado de las zonas de entidad y lo especificará en el entorno de análisis.
Si se utilizan datos de líneas o puntos como los Datos de clase de entidad o ráster de entrada (in_class_data en Python), se reportará el área intersecada por esas entidades.
Si las entradas tienen polígonos que se superponen, el análisis no se realizará para cada polígono individual del área de superposición. 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 clase o zona de entrada, el campo 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.
La salida de esta herramienta es una tabla.
En esta tabla:
- Habrá un registro para cada valor único del dataset de zona.
- Habrá un campo para cada valor único del dataset de clase.
- Cada registro almacenará el área de cada clase dentro de cada zona.
El Tamaño de celda de procesamiento se puede definir mediante un valor numérico u obtenerse desde un dataset ráster existente. Si el tamaño de celda no se ha especificado explícitamente como el valor del parámetro, se deriva del entorno Tamaño de celda si se ha especificado. Si no se ha especificado el tamaño de celda del parámetro o el tamaño de celda del entorno, el tamaño de celda de salida predeterminado se determina según el tipo de dataset de entrada de la siguiente manera:
- Si el dataset de entrada es un ráster, se usa el tamaño de celda del dataset.
- Si el dataset de entrada es una entidad y se ha configurado el entorno Ráster de alineación, se usa el tamaño de celda del ráster de alineación. Si no se ha configurado un ráster de alineación, el tamaño de celda se calcula a partir de la anchura o la altura de la extensión dividido por 250, donde la extensión se encuentra en el Sistema de coordenadas de salida especificado en el entorno.
Si el tamaño de celda se especifica usando un valor numérico, la herramienta lo usa directamente para el ráster de salida.
Si el tamaño de celda se especifica mediante un dataset ráster, el parámetro muestra la ruta del dataset ráster en lugar del valor del tamaño de celda. El tamaño de celda de ese dataset ráster se usa directamente en el análisis, siempre que la referencia espacial del dataset sea la misma que la referencia espacial de salida. Si la referencia espacial del dataset es diferente a la referencia espacial de salida, se proyecta en función del Método de proyección de tamaño de celda seleccionado.
Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento que se aplican a esta herramienta.
Sintaxis
TabulateArea(in_zone_data, zone_field, in_class_data, class_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. Puede ser un campo de enteros o de cadenas de caracteres del dataset zonal. | Field |
in_class_data | El dataset que define las clases que tendrán su área resumida dentro de cada zona. La entrada de clase puede ser una capa de ráster entero o una capa de entidad. | Raster Layer; Feature Layer |
class_field | El campo que contiene los valores de clase. Puede ser un campo de enteros o de cadenas de caracteres de los datos de la clase de entrada. | Field |
out_table | Tabla de salida que contendrá el resumen del área de cada clase en 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) | El tamaño de celda del ráster de salida que se va a crear. Este parámetro se puede definir mediante un valor numérico u obtenerse desde un dataset ráster existente. Si el tamaño de celda no se ha especificado explícitamente como valor de parámetro, se usa el valor del tamaño de celda del entorno si se ha especificado; de lo contrario, se utilizan reglas adicionales para calcularlo a partir de las otras entradas. Consulte su uso para obtener más detalles. | Analysis Cell Size |
Muestra de código
Ejemplo 1 de TabulateArea (ventana de Python)
Este ejemplo devuelve una tabla con el área de cada valor de clase contenida en cada zona.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
TabulateArea("zonedata.shp", "IDStr", "valueraster", "VALUE",
"C:/sapyexamples/output/areatable.dbf", 2)
Ejemplo 2 de TabulateArea (secuencia de comandos independiente)
Este ejemplo devuelve una tabla con el área de cada valor de clase contenida en cada zona.
# Name: TabulateArea_Ex_02.py
# Description: Calculates cross tabulated areas between two datasets.
# 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"
env.extent = "classgrid"
env.snapRaster = "classgrid"
# Set local variables
inZoneData = "zonedata.shp"
zoneField = "IDStr"
inClassData = "valueraster"
classField = "VALUE"
outTable = "C:/sapyexamples/output/areatable02.dbf"
processingCellSize = 2
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute TabulateArea
TabulateArea(inZoneData, zoneField, inClassData, classField, outTable,
processingCellSize)
Entornos
- Auto ejecución
- Tamaño de celda
- Método de proyección de 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
- Basic: Requiere Spatial Analyst
- Standard: Requiere Spatial Analyst
- Advanced: Requiere Spatial Analyst