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 el valor del parámetro Datos de zonas de entidad o ráster de entrada (in_zone_data en Python) es un ráster, debe ser un ráster entero.
Si el valor del parámetro Datos de zonas de entidad o ráster de entrada es una entidad, se convertirá internamente en un ráster utilizando el tamaño de celda y la alineación de celda del parámetro Ráster de valor de entrada (in_value_raster en Python).
Si el tamaño de celda, la alineación de celdas o la referencia espacial de los valores de los parámetros Datos de zonas de entidad o ráster de entrada y Ráster de valores de entrada son diferentes, el valor de Ráster de valores de entrada se utilizará internamente como Tamaño de celda, Ráster de ajuste y Sistema de coordenadas de salida. Cualquiera de estos casos 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 utilizan directamente en la herramienta y no se remuestrean internamente durante el procesamiento de la herramienta.
En el caso de que el valor de parámetro Datos de zonas de entidad o ráster de entrada sea 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 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 el valor de Datos de zonas de entidad o ráster de entrada es una entidad de punto, puede haber más de un punto en cualquier 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).
Si el valor de Datos de zonas de entidad o ráster de entrada tiene polígonos superpuestos, el análisis zonal no se realizará para cada polígono individual. Debido a que la entrada de entidades se convierte en un ráster, cada ubicación puede tener solo 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 el valor del parámetro Datos de zonas de entidad o ráster de entrada, 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.
El tipo de estadística compatible depende del tipo de dato del valor de Ráster de valores 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 entero, el cálculo de estadísticas aritméticas admite las opciones Media, 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 Media, Mayoría, Minoría, Desviación estándar y Variedad.
Si el tipo de datos es flotante, el cálculo de estadísticas aritméticas admite las opciones Media, 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 (circular_calculation = "CIRCULAR" en Python) y especifique un valor para el parámetro Valor de envoltura circular (circular_wrap_value en Python).
Entre los tipos de dataset ráster multidimensional admitidos se incluyen la capa ráster multidimensional, mosaico, servicio de imágenes y CRF de Esri.
El tipo de datos (entero o flotante) de la salida depende del cálculo zonal que se realiza y del tipo de ráster de valores de entrada. Consulte Cómo funcionan las herramientas de estadísticas zonales para conocer el comportamiento específico de cualquier estadística.
De forma predeterminada, esta herramienta utilizará hasta el 80 % de todos los procesadores multinúcleo disponibles.
Para un gran número de zonas, utilice menos núcleos para el procesamiento. Para utilizar un número diferente de núcleos, utilice la configuración del entorno Factor de procesamiento en paralelo.
Cuando el formato de ráster de salida es .crf, esta herramienta admite el entorno de almacenamiento ráster Pirámide. De forma predeterminada, se crearán pirámides en la salida. Para cualquier otro formato de salida, este entorno no es compatible y no se crearán pirámides.
Consulte Entornos de análisis y Spatial Analyst para obtener detalles adicionales sobre los entornos de geoprocesamiento válidos para esta herramienta.
|
Etiqueta
|
Explicación
|
Tipo de datos
|
|
Datos de zonas de entidad o ráster de entrada
|
Dataset que define las zonas.
Las zonas pueden definirse mediante un ráster entero o una capa de entidades.
|
Raster Layer; Feature Layer
|
|
Campo de zona
|
El campo que contiene los valores que definen cada zona.
Puede ser un campo de enteros o de cadenas de caracteres del dataset zonal.
|
Field
|
|
Ráster de valor de entrada
|
El ráster que contiene los valores para los que se calculará una estadística.
|
Raster Layer
|
|
Tipo de estadísticas
(Opcional)
|
Especifica el tipo de estadística que se calculará.
Valor medio—Se calcula el promedio de todas las celdas del ráster de valor que pertenecen a la misma zona que la celda de salida. Esta es la configuración predeterminada.
Mayoría—Se calcula el valor que se produzca con más frecuencia en todas las celdas del ráster de valores que pertenezcan a la misma zona que la celda de salida.
Recuento de mayoría—Se calcula 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 calcula el porcentaje de 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 calcula el mayor valor de todas las celdas del ráster de valores que pertenezcan a la misma zona que la celda de salida.
Mediana—Se calcula el valor mediano de todas las celdas del ráster de valores que pertenezcan a la misma zona que la celda de salida.
Mínimo—Se calcula el valor más pequeño de todas las celdas del ráster de valores que pertenezcan a la misma zona que la celda de salida.
Minoría—Se calcula el valor que se produzca con menor frecuencia en todas las celdas del ráster de valores que pertenezcan a la misma zona que la celda de salida.
Recuento de minoría—Se calcula 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 calcula el porcentaje de 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 calcula la diferencia entre el valor mayor y el menor de todas las celdas del ráster de valores que pertenezcan a la misma zona que la celda de salida.
Desviación estándar—Se calcula la desviación estándar de todas las celdas del ráster de valores que pertenezcan a la misma zona que la celda de salida.
Suma—Se calcula el valor total de todas las celdas del ráster de valores que pertenezcan a la misma zona que la celda de salida.
Variedad—Se calcula el número de valores únicos de todas las celdas del ráster de valores que pertenezcan a la misma zona que la celda de salida.
|
String
|
|
Ignorar 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, 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án 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.
|
Boolean
|
|
Procesar como multidimensional
(Opcional)
|
Especifica cómo se calculan los rásteres de entrada si son multidimensionales.
Activado—Se calcularán estadísticas de todas las dimensiones del dataset multidimensional de entrada.
Desactivado—Se calcularán estadísticas de la parte actual del dataset multidimensional de entrada. Esta es la opción predeterminada.
|
Boolean
|
|
Valor de percentil
(Opcional)
|
El percentil que se calcula. El valor predeterminado es 90, que indica el 90.º percentil.
Los valores pueden variar de 0 a 100. El 0.º percentil equivale en esencia a la estadística mínimo, mientras que el 100.º percentil equivale a la estadística máximo. Un valor de 50 generará en esencia el mismo resultado que la estadística mediana.
Este parámetro solo está disponible si el parámetro Tipo de estadísticas está establecido en Percentil.
|
Double
|
|
Tipo de interpolación de percentil
(Opcional)
|
Especifica el método de interpolación que se utilizará cuando el valor del percentil caiga 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 píxel entero, se utiliza el método Más cercano. Si el ráster de valor de entrada es de tipo píxel de punto flotante, se utiliza el método Lineal. Esta es la opción predeterminada.
Más cercano—Se utiliza el valor disponible más cercano para el percentil deseado. En este caso, el tipo de píxel de salida es el mismo que el del ráster de valor de entrada.
Lineal—Se utiliza la media ponderada de los dos valores circundantes del percentil deseado. En este caso, el tipo de píxel de salida es un punto flotante.
|
String
|
|
Calcular estadísticas circulares
(Opcional)
|
Especifica cómo se procesará el ráster de entrada para los datos circulares.
Activado—Se calculan las estadísticas de ángulos u otras magnitudes cíclicas, como la dirección de la brújula en grados, las horas del día y las partes fraccionarias de números reales.
Desactivado—Se calculan estadísticas lineales ordinarias. Esta es la opción predeterminada.
|
Boolean
|
|
Valor de envoltura circular
(Opcional)
|
El valor que se utiliza para redondear un valor lineal al rango de una estadística circular dada. Debe ser un entero positivo o un valor de punto flotante. El valor predeterminado es 360 grados.
Este parámetro solo se admite si el parámetro Calcular estadísticas circulares está activado.
|
Double
|
Valor de retorno
|
Etiqueta
|
Explicación
|
Tipo de datos
|
|
Ráster de salida
|
El ráster de estadísticas zonales de salida.
|
Raster
|
ZonalStatistics(in_zone_data, zone_field, in_value_raster, {statistics_type}, {ignore_nodata}, {process_as_multidimensional}, {percentile_value}, {percentile_interpolation_type}, {circular_calculation}, {circular_wrap_value})
|
Nombre
|
Explicación
|
Tipo de datos
|
|
in_zone_data
|
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 contiene los valores que definen cada zona.
Puede ser un campo de enteros o de cadenas de caracteres del dataset zonal.
|
Field
|
|
in_value_raster
|
El ráster que contiene los valores para los que se calculará una estadística.
|
Raster Layer
|
|
statistics_type
(Opcional)
|
Especifica el tipo de estadística que se calculará.
MEAN—Se calcula el promedio de todas las celdas del ráster de valor que pertenecen a la misma zona que la celda de salida. Esta es la configuración predeterminada.
MAJORITY—Se calcula el valor que se produzca con más frecuencia en todas las celdas del ráster de valores que pertenezcan a la misma zona que la celda de salida.
MAJORITY_COUNT—Se calcula 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 calcula el porcentaje de 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 calcula el mayor valor de todas las celdas del ráster de valores que pertenezcan a la misma zona que la celda de salida.
MEDIAN—Se calcula el valor mediano de todas las celdas del ráster de valores que pertenezcan a la misma zona que la celda de salida.
MINIMUM—Se calcula el valor más pequeño de todas las celdas del ráster de valores que pertenezcan a la misma zona que la celda de salida.
MINORITY—Se calcula el valor que se produzca con menor frecuencia en todas las celdas del ráster de valores que pertenezcan a la misma zona que la celda de salida.
MINORITY_COUNT—Se calcula 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 calcula el porcentaje de 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 percentile_value.
RANGE—Se calcula la diferencia entre el valor mayor y el menor de todas las celdas del ráster de valores que pertenezcan a la misma zona que la celda de salida.
STD—Se calcula la desviación estándar de todas las celdas del ráster de valores que pertenezcan a la misma zona que la celda de salida.
SUM—Se calcula el valor total de todas las celdas del ráster de valores que pertenezcan a la misma zona que la celda de salida.
VARIETY—Se calcula el número de valores únicos de todas las celdas del ráster de valores que pertenezcan a la misma zona que la celda de salida.
|
String
|
|
ignore_nodata
(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án 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.
|
Boolean
|
|
process_as_multidimensional
(Opcional)
|
Especifica cómo se calculan los rásteres de entrada si son multidimensionales.
ALL_SLICES—Se calcularán estadísticas de todas las dimensiones del dataset multidimensional de entrada.
CURRENT_SLICE—Se calcularán estadísticas de la parte actual del dataset multidimensional de entrada. Esta es la opción predeterminada.
|
Boolean
|
|
percentile_value
(Opcional)
|
El percentil que se calcula. El valor predeterminado es 90, que indica el 90.º percentil.
Los valores pueden variar de 0 a 100. El 0.º percentil equivale en esencia a la estadística mínimo, mientras que el 100.º percentil equivale a la estadística máximo. Un valor de 50 generará en esencia el mismo resultado que la estadística mediana.
Este parámetro solo está disponible si el parámetro statistics_type está establecido en PERCENTILE.
|
Double
|
|
percentile_interpolation_type
(Opcional)
|
Especifica el método de interpolación que se utilizará cuando el valor del percentil caiga 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 píxel entero, se utiliza el método NEAREST. Si el ráster de valor de entrada es de tipo píxel de punto flotante, se utiliza el método LINEAR. Esta es la opción predeterminada.
NEAREST—Se utiliza el valor disponible más cercano para el percentil deseado. En este caso, el tipo de píxel de salida es el mismo que el del ráster de valor de entrada.
LINEAR—Se utiliza la media ponderada de los dos valores circundantes del percentil deseado. En este caso, el tipo de píxel de salida es un punto flotante.
|
String
|
|
circular_calculation
(Opcional)
|
Especifica cómo se procesará el ráster de entrada para los datos circulares.
CIRCULAR—Se calculan las estadísticas de ángulos u otras magnitudes cíclicas, como la dirección de la brújula en grados, las horas del día y las partes fraccionarias de números reales.
ARITHMETIC—Se calculan estadísticas lineales ordinarias. Esta es la opción predeterminada.
|
Boolean
|
|
circular_wrap_value
(Opcional)
|
El valor que se utiliza para redondear un valor lineal al rango de una estadística circular dada. Debe ser un entero positivo o un valor de punto flotante. El valor predeterminado es 360 grados.
Este parámetro solo está disponible si el parámetro circular_calculation está establecido en CIRCULAR.
|
Double
|
Valor de retorno
|
Nombre
|
Explicación
|
Tipo de datos
|
|
out_raster
|
El ráster de estadísticas zonales de salida.
|
Raster
|
Muestra de código
ZonalStatistics ejemplo 1 (ventana de Python)
Este ejemplo determina el rango de valores de celda para cada zona en el ráster de valores de entrada.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outZonalStats = ZonalStatistics("zone", "value", "valueraster", "RANGE",
"NODATA")
outZonalStats.save("C:/sapyexamples/output/zonestatout")
ZonalStatistics ejemplo 2 (script independiente)
Este ejemplo crea una salida zonal multidimensional calculando el valor máximo del ráster de valor multidimensional de entrada para cada zona.
# Name: ZonalStatistics_Ex_standalone.py
# Description: Summarizes values of a multidimensional raster within the zones
# of another dataset.
# Requirements: Spatial Analyst extension
# Import system modules
import arcpy
from arcpy.sa import *
# Set the analysis environments
arcpy.env.workspace = "C:/sapyexamples/data"
# Set the local variables
inZoneData = "zones.shp"
zoneField = "sampleID"
inValueRaster = "multidimensional_valueraster.crf"
# Run ZonalStatistics
outZonalStatistics = ZonalStatistics(inZoneData, zoneField, inValueRaster,
"MAXIMUM", "NODATA", "ALL_SLICES")
# Save the output
outZonalStatistics.save("C:/sapyexamples/output/zonestatout2.crf")
