Calcular estadísticas (Administración de datos)

Resumen

Calcula las estadísticas para un dataset ráster o dataset de mosaico.

Las estadísticas se necesitan para que los datasets ráster y de mosaico lleven a cabo algunas tareas como la aplicación de aumento de contraste o la clasificación de los datos.

Uso

• El cálculo de las estadísticas permite a las aplicaciones de ArcGIS extender y simbolizar de manera adecuada los datos ráster para la visualización.

• Un factor de omisión controla la porción del dataset ráster que se utiliza cuando se calculan las estadísticas. El valor de entrada indica el factor de omisión horizontal o vertical, donde un valor de 1 utilizará cada píxel y un valor de 2 usará cada píxel de por medio. El factor de omisión puede ir desde 1 hasta el número de columnas o filas del dataset ráster.

• Los factores de omisión para los datasets ráster almacenados en una geodatabase de archivos o en una geodatabase de ArcSDE son bastante diferentes. Primero, si los factores de omisión x e y son diferentes, el factor de omisión más pequeño será utilizado por los factores de omisión x e y. Segundo, el factor de omisión está relacionado con el nivel de pirámide más cercano al factor de omisión elegido. Si el factor de omisión no es igual al número de píxeles en una pirámide (por ejemplo, si el factor de omisión es 5 y el nivel de pirámide más cercano es 4 x 4 píxeles, que es el nivel 2), el software redondeará hacia abajo hasta el próximo nivel de pirámide (en este caso, 2) y usará ese valor como el factor de omisión.

• No se utiliza un factor de omisión para todos los formatos ráster. Los formatos de ráster que calcularán estadísticas y aprovechan el factor de omisión incluyen TIFF, IMG, NITF, DTED, RAW, ADRG, CIB, CADRG, DIGEST, GIS, LAN, CIT, COT, ERMapper, ENVI DAT, BIL, BIP, BSQ y geodatabase.

• Cuando se utiliza esta herramienta para calcular estadísticas en un dataset de mosaico, las estadísticas se calculan para la imagen en mosaico de nivel superior, no para cada ráster que se encuentra dentro del dataset de mosaico.

• Se recomienda especificar un factor de omisión para un dataset de mosaico porque estos datasets suelen ser muy grandes.

• La opción Ignorar valores permite excluir un valor específico del cálculo de las estadísticas. Tal vez desee ignorar un valor si es un valor NoData o si distorsiona los cálculos.

• El cálculo de las estadísticas en los formatos GRID y RADARSAT2 siempre utiliza un factor de omisión de 1.

Sintaxis

CalculateStatistics_management (in_raster_dataset, {x_skip_factor}, {y_skip_factor}, {ignore_values}, {skip_existing}, {area_of_interest})

Parámetro	Explicación	Tipo de datos
in_raster_dataset	El dataset ráster de entrada o el dataset de mosaico.	Mosaic Dataset; Mosaic Layer; Raster Dataset
x_skip_factor (Opcional)	El número de píxeles horizontales entre las muestras. El valor debe ser mayor que cero y menor o igual que la cantidad de columnas del dataset ráster. El valor predeterminado es 1 o el último valor de omisión utilizado. Los factores de omisión para los datasets ráster almacenados en una geodatabase de archivos o en una geodatabase de ArcSDE son distintos. Primero, si los factores de omisión x e y son diferentes, el factor de omisión más pequeño será utilizado por los factores de omisión x e y. Segundo, el factor de omisión está relacionado con el nivel de pirámide más cercano al factor de omisión elegido. Si el valor del factor de omisión no es igual a la cantidad de píxeles en una capa de pirámide, la cantidad se redondea hacia abajo hasta el nivel de pirámide siguiente y se utilizan esas estadísticas.	Long
y_skip_factor (Opcional)	El número de píxeles verticales entre las muestras. El valor debe ser mayor que cero, y menor o igual que el número de filas del ráster. El valor predeterminado es 1 o el último valor de omisión y utilizado. Los factores de omisión para los datasets ráster almacenados en una geodatabase de archivos o en una geodatabase de ArcSDE son distintos. Primero, si los factores de omisión x e y son diferentes, el factor de omisión más pequeño será utilizado por los factores de omisión x e y. Segundo, el factor de omisión está relacionado con el nivel de pirámide más cercano al factor de omisión elegido. Si el valor del factor de omisión no es igual a la cantidad de píxeles en una capa de pirámide, la cantidad se redondea hacia abajo hasta el nivel de pirámide siguiente y se utilizan esas estadísticas.	Long
ignore_values [ignore_value,...] (Opcional)	Los valores de píxel que no se incluirán en el cálculo de las estadísticas. La opción predeterminada es ningún valor, o los valores usados por última vez para Ignorar valores.	Long
skip_existing (Opcional)	Especifique si desea calcular estadísticas solo donde faltan o si desea volver a generarlas incluso si existen. OVERWRITE —Las estadísticas se calcularán incluso si ya existen. Por lo tanto, se sobrescribirán las estadísticas existentes. Esta es la opción predeterminada. SKIP_EXISTING —Se calcularán las estadísticas solamente si aún no existen.	Boolean
area_of_interest (Opcional)	Especifique una clase de entidad que represente el área en el dataset desde donde desea que se calculen las estadísticas, de modo que no se generen de todo el dataset.	Feature Set

Ejemplo de código

Ejemplo 1 de CalculateStatistics (ventana de Python)

Esta es una muestra de Python para CalculateStatistics.

import arcpy
arcpy.CalculateStatistics_management(
     "C:/data/image.tif", "5", "5", "0;255", 
     "SKIP_EXISTING", "c:/data/aoi.shp")

Ejemplo 2 de CalculateStatistics (secuencia de comandos independiente)

Esta es una muestra de la secuencia de comandos de Python para CalculateStatistics.

# Calculate Statistics for single raster dataset

import arcpy
arcpy.env.workspace = "C:/Workspace"
    
arcpy.CalculateStatistics_management("image.tif", "4", "6", "0;255;21")

Entornos

Espacio de trabajo actual, Espacio de trabajo temporal