Estadísticas zonales (Spatial Analyst)

Nivel de licencia:BasicStandardAdvanced

Resumen

Calcula estadísticas sobre valores de un ráster dentro de zonas de otro dataset.

Más información acerca de cómo funcionan las Estadísticas zonales

Ilustración

Zonal Statistics illustration
OutRas = ZonalStatistics(ZoneRas, "VALUE", ValRas, "MINIMUM")

Uso

Sintaxis

ZonalStatistics (in_zone_data, zone_field, in_value_raster, {statistics_type}, {ignore_nodata})
ParámetroExplicaciónTipo 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_value_raster

El ráster que contiene los valores en los cuales se calcula una estadística.

Raster Layer
statistics_type
(Opcional)

Tipo de estadísticas a calcular.

  • MEAN Calcula la media de todas las celdas en el ráster de valores que pertenecen a la misma zona que la celda de salida.
  • MAJORITY Determina el valor que más se repite de todas las celdas en el ráster de valores que pertenecen a la misma zona que la celda de salida.
  • MAXIMUM Determina el valor más grande de todas las celdas en el ráster de valores que pertenecen a la misma zona que la celda de salida.
  • MEDIAN Determina el valor mediano de todas las celdas en el ráster de valores que pertenecen a la misma zona que la celda de salida.
  • MINIMUM Determina el valor más pequeño de todas las celdas en el ráster de valores que pertenecen a la misma zona que la celda de salida.
  • MINORITY Determina el valor que menos se repite de todas las celdas en el ráster de valores que pertenecen a la misma zona que la celda de salida.
  • RANGE Calcula la diferencia entre el mayor y el menor valor de todas las celdas en el ráster de valores que pertenecen a la misma zona que la celda de salida.
  • STD Calcula la desviación estándar de todas las celdas en el ráster de valores que pertenecen a la misma zona que la celda de salida.
  • SUM Calcula el valor total de todas las celdas en el ráster de valores que pertenecen a la misma zona que la celda de salida.
  • VARIETY Calcula el número de valores únicos de todas las celdas en el ráster de valores que pertenecen a la misma zona que la celda de salida.
String
ignore_nodata
(Opcional)

Denota si los valores NoData de la entrada de valores influenciarán los resultados de la zona a la que pertenecen.

  • DATOS Dentro de cualquier zona en concreto, sólo 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.
  • NODATA Si existen celdas NoData en el ráster de valores dentro de cualquier zona en concreto, se considerará que no hay suficiente información para realizar cálculos estadísticos para todas las celdas de esa zona, y por lo tanto, toda la zona recibirá el valor NoData en el ráster de salida.
Boolean

Valor de retorno

NombreExplicaciónTipo de datos
out_raster

El ráster de estadísticas zonales de salida.

Raster

Ejemplo de código

Ejemplo 1 de ZonalStatistics (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")
Ejemplo 2 de ZonalStatistics (secuencia de comandos independiente)

Este ejemplo determina el rango de valores de celda para cada zona en el ráster de valores de entrada.

# Name: ZonalStatistics_Ex_02.py
# Description: Calculates statistics on values of a raster 
#    within the zones of another dataset.
# 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 = "zone"
zoneField = "value"
inValueRaster = "valueraster" 

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute ZonalStatistics
outZonalStatistics = ZonalStatistics(inZoneData, zoneField, inValueRaster,
                                     "RANGE", "NODATA")

# Save the output 
outZonalStatistics.save("C:/sapyexamples/output/zonestatout2")

Entornos

Temas relacionados

Información sobre licencias

ArcGIS for Desktop Basic: Requiere Spatial Analyst
ArcGIS for Desktop Standard: Requiere Spatial Analyst
ArcGIS for Desktop Advanced: Requiere Spatial Analyst
9/11/2013