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
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.
Esta herramienta de portal de análisis ráster está disponible cuando se inicia sesión en un ArcGIS Enterprise que tiene un ArcGIS Image Server configurado para Raster Analysis . Cuando se invoca la herramienta, ArcGIS Pro funciona como cliente y tiene lugar el procesamiento 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.
Si Ráster o entidades 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 en un ráster utilizando el tamaño de celda y la alineación de celda del Ráster de valores 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 utilizan directamente en la herramienta y no se remuestrean internamente durante ejecución 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 deseado 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 de tan alta calidad como parece, 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 Ráster o entidades de zona de entrada es una entidad de punto, es probable que haya más de un punto dentro de cualquier celda en particular 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 Ráster de valores de entrada puede ser ser entero o de punto flotante. Sin embargo, si es de tipo punto flotante, las opciones para calcular la mayoría, la minoría y la variedad no están disponibles. Cuando hay un empate en los cálculos de mayoría y minoría, la salida de la zona se basa en el más bajo de los valores coincidentes.
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 número de filas de la tabla de salida representará el número de zonas.
Sintaxis
arcpy.ra.ZonalStatisticsAsTable(inputZoneRasterOrFeatures, inputValueRaster, outputTableName, zoneField, {ignoreNodata}, {statisticType}, {percentileValues}, {processAsMultidimensional}, {percentileInterpolationType})
Parámetro | 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.
| Boolean |
statisticType (Opcional) | Especifica el tipo de estadística que se va a calcular. Las opciones disponibles si el ráster de valor es un entero son: Todo, Media, Mayoría, Máximo, Mediana, Mínimo, Minoría, Percentil, Rango, Desviación estándar, Suma, Variedad, Mínimo y máximo, Media 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.
| String |
percentileValues [percentileValues,...] (Opcional) | El percentil que se va a 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. Esta opción solo está disponible si el parámetro statisticType está establecido en PERCENTILE o ALL. | Double |
processAsMultidimensional (Opcional) | Especifica cómo se procesarán los rásteres de entrada cuando sean multidimensionales.
| Boolean |
percentileInterpolationType (Opcional) | Especifica el método de interpolación percentil que se va a utilizar cuando el número de valores del ráster de entrada calculado sea par.
| String |
Salida derivada
Nombre | Explicación | Tipo de datos |
outputTable | La tabla de salida. | Servicio de entidades sin geometría |
Muestra de código
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')
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)
Información de licenciamiento
- Basic: Requiere ArcGIS Image Server
- Standard: Requiere ArcGIS Image Server
- Advanced: Requiere ArcGIS Image Server