Resumen
Construye pirámides ráster para el dataset ráster.
Esta herramienta también se puede utilizar para eliminar pirámides. Para eliminar pirámides, establezca el parámetro Niveles de pirámides en 0.
Ilustración
Uso
La creación de pirámides mejora el rendimiento de visualización de los datasets ráster.
Solo necesita construir pirámides una vez por dataset. Se accederá a las pirámides cada vez que visualiza el dataset ráster.
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.
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.
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.
La compresión de JPEG solo se puede utilizar con formatos de archivos que puedan almacenar datos según las especificaciones de JPEG. En Formatos de archivo de dataset ráster compatibles se enumeran las especificaciones compatibles con el formato JPEG.
Sintaxis
arcpy.management.BuildPyramids(in_raster_dataset, {pyramid_level}, {SKIP_FIRST}, {resample_technique}, {compression_type}, {compression_quality}, {skip_existing})
Parámetro | Explicación | Tipo de datos |
in_raster_dataset | Dataset ráster de entrada para el que desea crear pirámides. La entrada debe tener más de 1024 filas y 1024 columnas. | Raster Dataset; Raster Layer |
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. Para eliminar pirámides, establezca el número de niveles en 0. El número máximo de niveles de pirámide que puede especificar es 29. Cualquier valor igual o superior a 30 se convertirá en un valor -1, que 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 construir pirámides solo cuando no existen o regenerarlas incluso si ya existen.
| Boolean |
Salida derivada
Nombre | Explicación | Tipo de datos |
out_raster | El dataset ráster de salida. | Dataset ráster |
Muestra de código
Ejemplo 1 de BuildPyramids (ventana de Python)
Esta es una muestra de Python para la herramienta BuildPyramids.
import arcpy
arcpy.BatchBuildPyramids_management(
"C:/data/img1.tif;C:/data/img2.img", "6", "SKIP_FIRST",
"BILINEAR", "JPEG", "50", "SKIP_EXISTING")
Ejemplo 2 de BuildPyramids (script independiente)
Esta es una muestra del script de Python para la herramienta BuildPyramids.
#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í