Estadísticas zonales como tabla (Análisis ráster)

Resumen

Calcula los valores de un ráster dentro de las zonas de otro dataset y reporta los resultados en una tabla.

Ilustración

Uso

• Esta herramienta del portal de análisis de ráster está disponible al iniciar sesión en un portal de ArcGIS Enterprise que tenga configurado ArcGIS Image Server para Análisis de ráster. Cuando se ejecuta la herramienta, ArcGIS Pro funciona como cliente y el procesamiento tiene lugar en los servidores federados con ArcGIS Enterprise. La herramienta del portal acepta las capas de su portal como entrada y crea la salida en su portal.

  La capa ráster de entrada admite una capa del portal, una URI o URL de un servicio de imágenes o la salida procedente de la herramienta Crear capa de servidor de imágenes. La capa de entidades de entrada puede ser una capa del portal o una URI o URL de un servicio de entidades. Esta herramienta no admite capas o datos ráster locales. Aunque puede usar las capas y los datos de entidades locales como entradas de esta herramienta del portal, la práctica recomendada es usar capas del portal como entrada.

• Una zona se define como todas las áreas de la entrada con el mismo valor. No es necesario que las áreas sean contiguas. Puede usar tanto rásteres como entidades para la entrada de zona.

• Si Entidades o ráster de zona de entrada (inputZoneRasterOrFeatures en Python) es un ráster, debe ser un ráster entero.

  Si la zona es una entidad, se convertirá internamente a un ráster utilizando el tamaño de celda y la alineación de celda de Ráster de valor de entrada (inputValueRaster en Python).

• Si el tamaño de celda de Ráster o entidades de zona de entrada y Ráster de valores de entrada es diferente, el tamaño de la celda de salida será el valor Máximo de entradas y el servicio de imágenes del ráster de valor se utilizará internamente como el ráster de alineación. Si el tamaño de celda es el mismo pero las celdas no están alineadas, el ráster de valor se utilizará internamente como el ráster de alineación. En ambos casos, se desencadenará un remuestreo interno antes de realizar la operación zonal.

  Cuando las entradas de zona y de valor son rásteres del mismo tamaño de celda y las celdas están alineadas, se utilizarán directamente en la herramienta y no se remuestrearán internamente durante el procesamiento de la herramienta.

• Cuando Ráster o entidades de zona de entrada es una entidad, si hay entidades de zona que no se superpongan con ningún centro de celdas del ráster de valor, dichas zonas no se convertirán en el 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 necesario de las zonas de entidad y lo especificará en el entorno de análisis. Si especifica un tamaño de celda más pequeño, se generará un ráster de salida más grande. La salida de mayor resolución no será necesariamente un resultado de tan alta calidad, ya que realmente no existen detalles adicionales en el Ráster de valores de entrada.

• Si Ráster o entidades de zona de entrada tiene entidades que se superponen, el análisis zonal se realizará para cada entidad individual.

• Si Entidades o ráster de zona de entrada es una entidad de punto, puede haber más de un punto contenido dentro de una celda concreta del ráster de valores de entrada. Para dichas celdas, el valor de zona se determina mediante el punto con el campo ObjectID más bajo (por ejemplo, OID o FID).

• Al especificar Ráster o entidades de zona de entrada, el campo de zona predeterminado será el primer campo de entero o de texto disponible. Si no existen otros campos válidos, el campo ObjectID (por ejemplo, OID o FID) será el valor predeterminado.

• El tipo de estadística compatible depende del tipo de dato de Ráster de valor de entrada y del tipo de cálculo de estadística especificado por el parámetro Calcular estadísticas circulares.

  Si el tipo de datos es un entero, el cálculo de las estadísticas aritméticas admite las opciones Valor medio, Mayoría, Recuento de mayoría, Porcentaje de mayoría, Máximo, Mediana, Mínimo, Minoría, Recuento de minoría, Porcentaje de minoría, Percentil, Rango, Desviación estándar, Suma y Variedad; el cálculo de estadísticas circulares admite las opciones Valor medio, Mayoría, Minoría, Desviación estándar y Variedad.

  Si el tipo de datos es flotante, el cálculo de las estadísticas aritméticas admite las opciones Valor medio, Máximo, Mediana, Mínimo, Percentil, Rango, Desviación estándar y Suma; el cálculo de estadísticas circulares admite las opciones Valor medio y Desviación estándar.

• Cuando hay un empate en los cálculos de mayoría y minoría, la salida será el más bajo de los valores coincidentes.

• Para calcular estadísticas circulares, active el parámetro Calcular estadísticas circulares (circularCalculation = "CIRCULAR" en Python) y especifique un número para Valor de envoltura circular (circularWrapValue en Python).

• Se creará un campo o una serie de campos en la tabla de salida, en función del valor del parámetro Tipo de estadística (statisticType en Python).

  El nombre del campo es el mismo que el valor de Tipo de estadísticas al calcular estadísticas aritméticas. Esta es la opción predeterminada.

  Sin embargo, en el caso de las estadísticas circulares, el nombre del campo aparecerá precedido por C_, seguido de la estadística especificada. Por ejemplo, el nombre de campo será Median para la estadística de mediana aritmética y C_Median para la estadística de mediana circular.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Entidades o ráster de zona de entrada	Entrada que define las zonas. Tanto los datos de ráster como los de entidades se pueden utilizar para la entrada de zona.	Raster Layer; Feature Layer
Ráster de valor de entrada	Ráster que contiene los valores en los cuales se resume una estadística.	Raster Layer
Nombre de tabla de salida	El nombre de la tabla de salida. Si la tabla ya existe, se le pedirá que indique otro nombre.	String
Campo de zona	El campo que define cada zona. Puede ser un campo de enteros o de cadenas de caracteres del dataset zonal.	String
Ignorar los NoData en los cálculos (Opcional)	Especifica si los valores NoData de la entrada de valores se ignorarán en los resultados de la zona a la que pertenecen. Activado: dentro de cualquier zona en concreto, solo se utilizarán para determinar el valor de salida de dicha zona las celdas que tienen un valor en el ráster de valores de entrada. Las celdas NoData del ráster de valores se ignorará en el cálculo estadístico. Esta es la opción predeterminada. Desactivado: si existen celdas NoData en el ráster de valores dentro de cualquier zona, no se ignorarán y su existencia indica que no hay suficiente información para realizar cálculos estadísticos para todas las celdas de esa zona. Por consiguiente, toda la zona recibirá el valor NoData en el ráster de salida.	Boolean
Tipo de estadística (Opcional)	Especifica el tipo de estadísticas que se calcularán. Las opciones disponibles cuando el ráster de valor es entero son Todos, Valor medio, Mayoría, Recuento de mayoría, Porcentaje de mayoría, Valor de mayoría, recuento y porcentaje, Máximo, Mediana, Mínimo, Minoría, Recuento de minoría, Porcentaje de minoría, Valor de minoría, recuento y porcentaje, Percentil, Rango, Desviación estándar, Suma, Variedad, Mínimo y máximo, Valor medio y desviación estándar y Mínimo, máximo y valor medio. Si el ráster de valor es flotante, las opciones son Todo, Media, Máximo, Mediana, Percentil, Mínimo, Rango, Desviación estándar y Suma. Todo—Se calcularán todas las estadísticas para un ráster de valor de tipo entero. Se calcularán todas las estadísticas excepto Mediana y Percentil para un ráster de valor de tipo punto flotante. Esta es la opción predeterminada. Valor medio—Se calcula la media de todas las celdas de la capa ráster que se desea resumir y que pertenecen a la misma zona que la celda de salida. Mayoría—Se calculará el valor que más se repite de todas las celdas de la capa ráster que se va a resumir que pertenecen a la misma zona que la celda de salida. Recuento de mayoría—Se calculará la frecuencia de todas las celdas que contienen el valor mayoritario en el ráster de valores que pertenecen a la misma zona que la celda de salida. Porcentaje de mayoría—Se calculará el porcentaje de todas las celdas que contienen el valor mayoritario en el ráster de valores que pertenecen a la misma zona que la celda de salida. Máximo—Se calculará el valor máximo de todas las celdas de la capa ráster que se va a resumir que pertenecen a la misma zona que la celda de salida. Mediana—Se calculará la mediana de todas las celdas de la capa ráster que se va a resumir que pertenecen a la misma zona que la celda de salida. Mínimo—Se calculará el valor mínimo de todas las celdas de la capa ráster que se va a resumir que pertenecen a la misma zona que la celda de salida. Minoría—Se calculará el valor que menos se repite de todas las celdas de la capa ráster que se va a resumir que pertenecen a la misma zona que la celda de salida. Recuento de minoría—Se calculará la frecuencia de todas las celdas que contienen el valor minoritario en el ráster de valores que pertenecen a la misma zona que la celda de salida. Porcentaje de minoría—Se calculará el porcentaje de todas las celdas que contienen el valor minoritario en el ráster de valores que pertenecen a la misma zona que la celda de salida. Percentil—Se calcula el percentil de todas las celdas del ráster de valor que pertenecen a la misma zona que la celda de salida. El 90.º percentil se calcula de forma predeterminada. Puede especificar otros valores (del 0 al 100) con el parámetro Valores de percentil. Rango—Se calculará la diferencia entre valor máximo y mínimo de todas las celdas de la capa ráster que se va a resumir que pertenecen a la misma zona que la celda de salida. Desviación estándar—Se calculará la desviación estándar de todas las celdas de la capa ráster que se va a resumir que pertenecen a la misma zona que la celda de salida. Suma—Se calculará el valor total de todas las celdas de la capa ráster que se va a resumir que pertenecen a la misma zona que la celda de salida. Variedad—Se calculará el número de valores únicos de todas las celdas de la capa ráster que se va a resumir que pertenecen a la misma zona que la celda de salida. Mínimo y máximo—Se calculan tanto la estadística de mínimo como la de máximo. Valor medio y Desviación estándar—Se calculan las estadísticas de valor medio y de desviación estándar. Mínimo, Máximo y Valor medio—Se calculan las estadísticas de mínimo, máximo y valor medio. Valor, recuento y porcentaje de mayoría—Se calcularán las estadísticas de valor mayoritario, recuento y porcentaje. Valor, recuento y porcentaje de minoría—Se calcularán las estadísticas de valor minoritario, recuento y porcentaje.	String
Valores de percentil (Opcional)	El percentil que se calculará. El valor predeterminado es 90 e indica el percentil 90º. Los valores pueden variar de 0 a 100. El percentil 0º equivale en esencia a la estadística mínima, mientras que el percentil 100º equivale a la estadística máxima. El valor de 50 generará en esencia el mismo resultado que la estadística mediana. Este parámetro solo está disponible en el cálculo de percentil.	Double
Procesar como multidimensional (Opcional)	Especifica cómo se procesarán los rásteres de entrada cuando sean multidimensionales. Desactivado: se calculan estadísticas de la parte actual del dataset multidimensional de entrada. Esta es la opción predeterminada. Activado: se calculan estadísticas correspondientes a todas las dimensiones (tales como el tiempo o la profundidad) de todas las partes de los rásteres de entrada multidimensional.	Boolean
Tipo de interpolación percentil (Opcional)	Especifica el método de interpolación que se va a utilizar si el valor de percentil se encuentra entre dos valores de celda del ráster de valores de entrada. Detección automática—Si el ráster de valor de entrada es de tipo de píxel entero, se utilizará el método Más cercano. Si el ráster de valor de entrada es de tipo de píxel de punto flotante, se utiliza el método Lineal. Esta es la opción predeterminada. Más cercano—Se utilizará el valor disponible más cercano para el percentil deseado. Lineal—Se utilizará la media ponderada de los dos valores circundantes del percentil deseado.	String
Calcular estadísticas circulares (Opcional)	Especifica cómo se calcula el tipo de estadística. Desactivado: se calculan estadísticas aritméticas. Esta es la opción predeterminada. Activado: se calculan estadísticas circulares adecuadas para magnitudes cíclicas, como rumbo de brújula en grados, horas del día y fracciones de números reales.	Boolean
Valor de ajuste circular (Opcional)	El valor más alto posible (límite superior) de los datos cíclicos. Es un número real positivo y su valor predeterminado es 360. Este valor también representa la misma cantidad que el valor más bajo posible (límite más bajo). Este parámetro solo se aplica al calcular estadísticas circulares.	Double

Salida derivada

Etiqueta	Explicación	Tipo de datos
Tabla de Salida	La tabla de salida.	Feature service without geometry

Python

arcpy.ra.ZonalStatisticsAsTable(inputZoneRasterOrFeatures, inputValueRaster, outputTableName, zoneField, {ignoreNodata}, {statisticType}, {percentileValues}, {processAsMultidimensional}, {percentileInterpolationType}, {circularCalculation}, {circularWrapValue})

Nombre	Explicación	Tipo de datos
inputZoneRasterOrFeatures	Entrada que define las zonas. Tanto los datos de ráster como los de entidades se pueden utilizar para la entrada de zona.	Raster Layer; Feature Layer
inputValueRaster	Ráster que contiene los valores en los cuales se resume una estadística.	Raster Layer
outputTableName	El nombre de la tabla de salida. Si la tabla ya existe, se le pedirá que indique otro nombre.	String
zoneField	El campo que define cada zona. Puede ser un campo de enteros o de cadenas de caracteres del dataset zonal.	String
ignoreNodata (Opcional)	Especifica si los valores NoData de la entrada de valores se ignorarán en los resultados de la zona a la que pertenecen. DATA—Dentro de cualquier zona en concreto, para determinar el valor de salida de dicha zona solo se utilizarán las celdas que tienen un valor en el ráster de valores de entrada. Las celdas NoData del ráster de valores se ignorará en el cálculo estadístico. Esta es la opción predeterminada. NODATA—Si existen celdas NoData en el ráster de valores dentro de cualquier zona, no se ignorarán y su existencia indica que no hay suficiente información para realizar cálculos estadísticos para todas las celdas de esa zona. Por consiguiente, toda la zona recibirá el valor NoData en el ráster de salida.	Boolean
statisticType (Opcional)	Especifica el tipo de estadísticas que se calcularán. Las opciones disponibles cuando el ráster de valor es entero son ALL, MEAN, MAJORITY, MAJORITY_COUNT, MAJORITY_PERCENT, MAJORITY_VALUE_COUNT_PERCENT, MAXIMUM, MEDIAN, MINIMUM, MINORITY, MINORITY_COUNT, MINORITY_PERCENT, MINORITY_VALUE_COUNT_PERCENT, PERCENTILE, RANGE, STD, SUM, VARIETY, MINI_MAX, MEAN_SD y MIN_MAX_MEAN. Si el ráster de valor es flotante, las opciones son ALL, MEAN, MAXIMUM, MEDIAN, MINIMUM, PERCENTILE, RANGE, STD y SUM. ALL—Se calcularán todas las estadísticas para un ráster de valor de tipo entero. Se calcularán todas las estadísticas excepto Mediana y Percentil para un ráster de valor de tipo punto flotante. Esta es la opción predeterminada. MEAN—Se calcula la media de todas las celdas de la capa ráster que se desea resumir y que pertenecen a la misma zona que la celda de salida. MAJORITY—Se calculará el valor que más se repite de todas las celdas de la capa ráster que se va a resumir que pertenecen a la misma zona que la celda de salida. MAJORITY_COUNT—Se calculará la frecuencia de todas las celdas que contienen el valor mayoritario en el ráster de valores que pertenecen a la misma zona que la celda de salida. MAJORITY_PERCENT—Se calculará el porcentaje de todas las celdas que contienen el valor mayoritario en el ráster de valores que pertenecen a la misma zona que la celda de salida. MAXIMUM—Se calculará el valor máximo de todas las celdas de la capa ráster que se va a resumir que pertenecen a la misma zona que la celda de salida. MEDIAN—Se calculará la mediana de todas las celdas de la capa ráster que se va a resumir que pertenecen a la misma zona que la celda de salida. MINIMUM—Se calculará el valor mínimo de todas las celdas de la capa ráster que se va a resumir que pertenecen a la misma zona que la celda de salida. MINORITY—Se calculará el valor que menos se repite de todas las celdas de la capa ráster que se va a resumir que pertenecen a la misma zona que la celda de salida. MINORITY_COUNT—Se calculará la frecuencia de todas las celdas que contienen el valor minoritario en el ráster de valores que pertenecen a la misma zona que la celda de salida. MINORITY_PERCENT—Se calculará el porcentaje de todas las celdas que contienen el valor minoritario en el ráster de valores que pertenecen a la misma zona que la celda de salida. PERCENTILE—Se calcula el percentil de todas las celdas del ráster de valor que pertenecen a la misma zona que la celda de salida. El 90.º percentil se calcula de forma predeterminada. Puede especificar otros valores (del 0 al 100) con el parámetro Valores de percentil. RANGE—Se calculará la diferencia entre valor máximo y mínimo de todas las celdas de la capa ráster que se va a resumir que pertenecen a la misma zona que la celda de salida. STD—Se calculará la desviación estándar de todas las celdas de la capa ráster que se va a resumir que pertenecen a la misma zona que la celda de salida. SUM—Se calculará el valor total de todas las celdas de la capa ráster que se va a resumir que pertenecen a la misma zona que la celda de salida. VARIETY—Se calculará el número de valores únicos de todas las celdas de la capa ráster que se va a resumir que pertenecen a la misma zona que la celda de salida. MIN_MAX—Se calculan tanto la estadística de mínimo como la de máximo. MEAN_STD—Se calculan las estadísticas de valor medio y de desviación estándar. MIN_MAX_MEAN—Se calculan las estadísticas de mínimo, máximo y valor medio. MAJORITY_VALUE_COUNT_PERCENT—Se calcularán las estadísticas de valor mayoritario, recuento y porcentaje. MINORITY_VALUE_COUNT_PERCENT—Se calcularán las estadísticas de valor minoritario, recuento y porcentaje.	String
percentileValues [percentileValues,...] (Opcional)	El percentil que se calculará. El valor predeterminado es 90 e indica el percentil 90º. Los valores pueden variar de 0 a 100. El percentil 0º equivale en esencia a la estadística mínima, mientras que el percentil 100º equivale a la estadística máxima. El valor de 50 generará en esencia el mismo resultado que la estadística mediana. Este parámetro solo está disponible en el cálculo de percentil.	Double
processAsMultidimensional (Opcional)	Especifica cómo se procesarán los rásteres de entrada cuando sean multidimensionales. CURRENT_SLICE—Se calcularán estadísticas de la parte actual del dataset multidimensional de entrada. Esta es la opción predeterminada. ALL_SLICES—Se calcularán estadísticas de todas las dimensiones del dataset multidimensional de entrada.	Boolean
percentileInterpolationType (Opcional)	Especifica el método de interpolación que se va a utilizar si el valor de percentil se encuentra entre dos valores de celda del ráster de valores de entrada. AUTO_DETECT—Si el ráster de valor de entrada es de tipo de píxel entero, se utilizará el método NEAREST. Si el ráster de valor de entrada es de tipo de píxel de punto flotante, se utiliza el método LINEAR. Esta es la opción predeterminada. NEAREST—Se utilizará el valor disponible más cercano para el percentil deseado. LINEAR—Se utilizará la media ponderada de los dos valores circundantes del percentil deseado.	String
circularCalculation (Opcional)	Especifica cómo se calcula el tipo de estadística. ARITHMETIC—Se calculan estadísticas aritméticas. Esta es la opción predeterminada. CIRCULAR—Se calculan estadísticas circulares adecuadas para magnitudes cíclicas, como rumbo de brújula en grados, horas del día y fracciones de números reales.	Boolean
circularWrapValue (Opcional)	El valor más alto posible (límite superior) de los datos cíclicos. Es un número real positivo y su valor predeterminado es 360. Este valor también representa la misma cantidad que el valor más bajo posible (límite más bajo). Este parámetro solo se aplica al calcular estadísticas circulares.	Double

Salida derivada

Nombre	Explicación	Tipo de datos
outputTable	La tabla de salida.	Feature service without geometry

Muestra de código

Ejemplo 1 de ZonalStatisticsAsTable (ventana de Python)

En este ejemplo se determina la media de los valores de celda que se van a resumir en la capa ráster de cada zona.

import arcpy
arcpy.ra.ZonalStatisticsAsTable('https://MyPortal.esri.com/server/rest/services/Hosted/landuse/ImageServer',
                           	'https://MyPortal.esri.com/server/rest/services/Hosted/elevation/ImageServer',
    				'outTable', 'Landuse', '', 'MEAN')

Ejemplo 2 de ZonalStatisticsAsTable (secuencia de comandos independiente)

En este ejemplo se determinan los valores estadísticos que se desea resumir en la capa ráster de cada zona.

#-------------------------------------------------------------------------------
# Name: ZonalStatisticsAsTable_Ex_02.py
# Description: Calculates all statistics with defined percentile values  
#              for sea-surface temperature defined by ecological zones.
# Requirements: ArcGIS Image Server

# Import system modules
import arcpy

# Set local variables
inputZoneRasterOrFeatures = 'https://MyPortal.esri.com/server/rest/services/Hosted/zones/ImageServer'
inputValueRaster = 'https://MyPortal.esri.com/server/rest/services/Hosted/seaSurfaceTemperature/ImageServer'
outputTableName = 'outZSAT'
zoneField = 'temperature'
ignoreNodata = '' 
statisticType = 'PERCENTILE'
percentileValues = [25,75,90]
processAsMultidimensional = 'ALL_SLICES'
percentileInterpolationType = 'NEAREST'

# Execute Multidimensional Zonal Statistics as Table
arcpy.ra.ZonalStatisticsAsTable(inputZoneRasterOrFeatures, inputValueRaster, outputTableName, zoneField,
                                ignoreNodata, statisticType, percentileValues, processAsMultidimensional, 
                                percentileInterpolationType)

Entornos

Tamaño de celda, Extensión, Máscara, Sistema de coordenadas de salida, Alinear ráster

Información de licenciamiento

• Basic: Requiere ArcGIS Image Server
• Standard: Requiere ArcGIS Image Server
• Advanced: Requiere ArcGIS Image Server