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 redimensionar y simbolizar de manera adecuada los datos ráster para la vista.
Se procesarán todos los formatos de ráster compatibles.
Los catálogos de ráster y los datasets de mosaico se deben especificar como el espacio de trabajo de entrada. Si el espacio de trabajo incluye un catálogo de ráster o un dataset de mosaico, estos elementos no se incluirán cuando se ejecute la herramienta.
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})| Parámetro | Explicación | Tipo de datos |
in_workspace | El espacio de trabajo que contiene todos los datasets ráster que se van a procesar, un dataset de mosaico o un catálogo de ráster. Si el espacio de trabajo incluye un catálogo de ráster o un dataset de mosaico, estos elementos no se incluirán cuando se ejecute la herramienta. | Text File; Mosaic Dataset; Workspace; Raster Catalog Layer; Raster Dataset; Mosaic Layer |
include_subdirectories (Opcional) | Especifique si desea incluir subdirectorios.
Los catálogos de ráster y los datasets de mosaico se deben especificar como el espacio de trabajo de entrada. Si el espacio de trabajo incluye un catálogo de ráster o un dataset de mosaico, estos elementos no se incluirán cuando se ejecute la herramienta. | 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. 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. 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 |
Salida derivada
| Nombre | Explicación | Tipo de datos |
| out_workspace | El espacio de trabajo de salida actualizado. | Text File; Workspace; Raster Layer; Mosaic Layer |
Muestra de código
Ejemplo 1 de BuildPyramidsAndStatistics (ventana de Python)
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")
Ejemplo 2 de BuildPyramidsAndStatistics (script independiente)
Esta es una muestra de 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)
Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí