Resumen
Recorre una estructura de carpeta, crea pirámides y calcula estadísticas para todos los datasets ráster que contiene. También puede crear pirámides y calcular estadísticas para todos los elementos de un dataset de mosaico.
Uso
La creación de pirámides mejora el rendimiento de visualización de los datasets ráster
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.
Se procesarán todos los formatos de ráster compatibles.
Si el espacio de trabajo incluye un dataset de mosaico, solo se incluirán las estadísticas asociadas con el dataset de mosaico, pero no se incluirán las asociadas con los elementos contenidos en él.
Los datasets ráster con compresión de ondículas, como ECW y MrSID, no necesitan crear pirámides. Estos formatos tienen pirámides internas que se crean en el momento de la codificación.
Sintaxis
arcpy.management.BuildPyramidsandStatistics(in_workspace, {include_subdirectories}, {build_pyramids}, {calculate_statistics}, {BUILD_ON_SOURCE}, {block_field}, {estimate_statistics}, {x_skip_factor}, {y_skip_factor}, {ignore_values}, {pyramid_level}, {SKIP_FIRST}, {resample_technique}, {compression_type}, {compression_quality}, {skip_existing}, {where_clause}, {sips_mode})
Parámetro | Explicación | Tipo de datos |
in_workspace | El espacio de trabajo que contiene todos los datasets ráster o datasets de mosaico que se van a procesar. Si el espacio de trabajo incluye un dataset de mosaico, solo se incluirán las estadísticas asociadas con el dataset de mosaico. Las estadísticas asociadas con los elementos dentro del dataset de mosaico no se incluirán. | Text File; Workspace; Raster Layer; Mosaic Layer |
include_subdirectories (Opcional) | Especifique si desea incluir subdirectorios.
Si el espacio de trabajo incluye un dataset de mosaico, solo se incluirán las estadísticas asociadas con el dataset de mosaico. Las estadísticas asociadas con los elementos dentro del dataset de mosaico no se incluirán. | Boolean |
build_pyramids (Opcional) | Especifique si desea crear pirámides.
| Boolean |
calculate_statistics (Opcional) | Especifique si desea calcular las estadísticas.
| Boolean |
BUILD_ON_SOURCE (Opcional) | Especifique si desea crear pirámides y calcular estadísticas en los datasets ráster de origen o si desea calcular estadísticas en los elementos ráster de un dataset de mosaico. Esta opción solo se aplica a los datasets de mosaico.
| Boolean |
block_field (Opcional) | El nombre del campo en una tabla de atributos del dataset de mosaico que se utiliza para identificar los elementos que deberían considerarse un elemento al realizar algunos cálculos y operaciones. | String |
estimate_statistics (Opcional) | Especifique si desea calcular estadísticas para el dataset de mosaico (no para los rásteres dentro del mismo). Las estadísticas se derivan de las estadísticas existentes que se calcularon para cada ráster en el dataset de mosaico.
| Boolean |
x_skip_factor (Opcional) | El número de píxeles horizontales entre las muestras. Un factor de omisión controla la porción del 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 solo puede oscilar entre 1 y el número de columnas o filas del ráster. Un factor de omisión controla la porción del 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 solo puede oscilar entre 1 y el número de columnas o filas del ráster. El valor debe ser mayor que cero y menor o igual que el número de columnas del ráster. El valor predeterminado es 1 o el último valor de omisión utilizado. | Long |
y_skip_factor (Opcional) | El número de píxeles verticales entre las muestras. Un factor de omisión controla la porción del 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 solo puede oscilar entre 1 y el número de columnas o filas del ráster. Un factor de omisión controla la porción del 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 solo puede oscilar entre 1 y el número de columnas o filas del ráster. 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. | 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 sin valor. | Long |
pyramid_level (Opcional) | Elija el número de capas de dataset de resolución reducida que se construirá. El valor predeterminado es -1, que creará pirámides completas. Un valor de 0 no producirá niveles de pirámide. El número máximo de niveles de pirámide que puede especificar es 29. Cualquier valor igual o superior a 30 creará un conjunto completo de pirámides. | Long |
SKIP_FIRST (Opcional) | Elija si desea omitir el primer nivel de pirámides. Omitir el primer nivel utilizará un poco menos de espacio en disco, pero hará que el rendimiento sea más lento en esas escalas.
| Boolean |
resample_technique (Opcional) | La técnica de remuestreo que se utiliza para construir las pirámides.
| String |
compression_type (Opcional) | El tipo de compresión a utilizar al construir las pirámides de ráster.
| String |
compression_quality (Opcional) | La calidad de compresión que se va a utilizar al construir pirámides con el método de compresión JPEG. El valor debe estar comprendido entre 0 y 100. Los valores más cercanos a 100 producirán una calidad de imagen superior, pero la relación de compresión sería menor. | Long |
skip_existing (Opcional) | Especifique si desea calcular estadísticas solo donde faltan o si desea volver a generarlas aunque ya existan.
| Boolean |
where_clause (Opcional) | Expresión SQL para seleccionar los datasets ráster que se van a procesar. | SQL Expression |
sips_mode (Opcional) | Especifica si habilitar la creación de archivos de pirámide con algoritmos y procesos clave definidos en el Estándar de Procesamiento de Imágenes en Pantalla (SIPS), NGA.STND.0014.
| Boolean |
Salida derivada
Nombre | Explicación | Tipo de datos |
out_workspace | El espacio de trabajo de salida actualizado. | Archivo de texto; Espacio de trabajo; Capa ráster; Capa de mosaico |
Muestra de código
Esta es una muestra de Python para la herramienta BuildPyramidsAndStatistics.
import arcpy
arcpy.BuildPyramidsAndStatistics_management(
"C:/Workspace", "INCLUDE_SUBDIRECTORIES", "BUILD_PYRAMIDS",
"CALCULATE_STATISTICS","BUILD_ON_SOURCE", "BlockField",
"ESTIMATE_STATISTICS", "10", "10", "0;255", "-1", "NONE",
"BILINEAR", "JPEG", "50", "OVERWRITE")
Esta es una muestra del script de Python para la herramienta BuildPyramidsAndStatistics.
#Build pyramids and calculate statistics for all raster in a folder
import arcpy
arcpy.env.workspace = "C:/Workspace"
inws = "folder"
includedir = "INCLUDE_SUBDIRECTORIES"
buildpy = "BUILD_PYRAMIDS"
calcstats = "CALCULATE_STATISTICS"
buildsource = "NONE"
blockfield = "#"
estimatemd = "#"
skipx = "4"
skipy = "6"
ignoreval = "0;255"
pylevel = "3"
skipfirst = "NONE"
resample = "BILINEAR"
compress = "JPEG"
quality = "80"
skipexist = "SKIP_EXISTING"
arcpy.BuildPyramidsAndStatistics_management(
inws, includedir, buildpy, calcstats, buildsource, blockfield,
estimatemd, skipx, skipy, ignoreval, pylevel, skipfirst,
resample, compress, quality, skipexist)
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí