Resumen
Crea pirámides para varios datasets ráster.
Uso
La creación de pirámides mejora el rendimiento de visualización de los datasets ráster.
La creación de pirámides por lotes resulta útil cuando se tiene un gran directorio de datasets ráster que no contienen pirámides o para crear pirámides en los elementos de un dataset de mosaico (arrástrelos al cuadro de diálogo).
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.
Las pirámides no se crearán para los datasets ráster que tengan menos de 1024 píxeles en la fila o columna. Las pirámides no son necesarias ya que el dataset ráster es lo suficientemente pequeño, y la creación de pirámides no ayudará a mejorar el rendimiento.
No se pueden crear pirámides para catálogos de ráster, pero sí se pueden crear para cada elemento del catálogo de ráster.
Puede elegir el tipo de compresión para el archivo de vista general de pirámide en los Entornos de Almacenamiento de rásteres. La compresión creará un archivo .ovr más pequeño. El formato IMAGINE y las versiones anteriores de ArcGIS crearán archivos de dataset de resolución reducida (.rrd), donde la compresión no está disponible.
La compresión de pirámide predeterminada utilizará el tipo de compresión óptima, según el tipo de datos. Puede elegir manualmente tener la compresión LZ77, JPEG o ninguna.
Sintaxis
arcpy.management.BatchBuildPyramids(Input_Raster_Datasets, {Pyramid_levels}, {Skip_first_level}, {Pyramid_resampling_technique}, {Pyramid_compression_type}, {Compression_quality}, {Skip_Existing})
Parámetro | Explicación | Tipo de datos |
Input_Raster_Datasets [input_raster_dataset,...] | Los datasets ráster para los que desea crear pirámides ráster. Cada entrada debe tener más de 1024 filas y 1024 columnas. | Raster Dataset |
Pyramid_levels (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. | Long |
Skip_first_level (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 |
Pyramid_resampling_technique (Opcional) | La técnica de remuestreo que se utiliza para construir las pirámides.
| String |
Pyramid_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 crear pirámides solo cuando falten o si desea volver a generarlas incluso si existen.
| Boolean |
Salida derivada
Nombre | Explicación | Tipo de datos |
Batch_Build_Pyramids_Succeeded | Devuelve si la herramienta se ejecutó correctamente o no. | Booleano |
Muestra de código
Ejemplo 1 de BatchBuildPyramids (ventana de Python)
Esta es una muestra de Python para la herramienta BatchBuildPyramids.
import arcpy
arcpy.BatchBuildPyramids_management(
"C:/data/img1.tif;C:/data/img2.img", "6", "SKIP_FIRST",
"BILINEAR", "JPEG", "50", "SKIP_EXISTING")
Ejemplo 2 de BatchBuildPyramids (script independiente)
Esta es una muestra del script de Python para la herramienta BatchBuildPyramids.
#Build Pyramids for multiple raster datasets in the workspace
#Skip the dataset that already has pyramid
#Build pyramids with compression and level setting
import arcpy
arcpy.env.workspace = "C:/Workspace"
inras = "image1.tif;image2.img;fgdb.gdb/image3"
pylevels = "6"
skipfirst = "SKIP_FIRST"
resample = "BILINEAR"
compress = "JPEG"
quality = "80"
skipexist = "SKIP_EXISTING"
arcpy.BatchBuildPyramids_management(
inras, pylevels, skipfirst, resample, compress,
quality, skipexist)
Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí