Crear pirámides en lotes (Administración de datos)

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.

• 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. NONE —Se construirá el primer nivel de pirámide. Esta es la opción predeterminada. SKIP_FIRST —No se construirá el primer nivel de pirámide.	Boolean
Pyramid_resampling_technique (Opcional)	La técnica de remuestreo que se utiliza para construir las pirámides. NEAREST —El método de remuestreo de vecino más cercano utiliza el valor de la celda más cercana para asignar un valor a la celda de salida durante el remuestreo. Esta es la opción predeterminada. BILINEAR —El método de remuestreo de interpolación bilineal determina el nuevo valor de una celda basándose en el promedio de distancia ponderada de los cuatro centros de celdas de entrada más cercanos. CUBIC —El método de remuestreo de convolución cúbica, determina el nuevo valor de una celda basándose en el ajuste de una curva suave a través de los 16 centros de celdas de entrada más cercanos.	String
Pyramid_compression_type (Opcional)	El tipo de compresión a utilizar al construir las pirámides de ráster. DEFAULT —Si los datos de origen se comprimen con una compresión de ondículas; se construirán pirámides con el tipo de compresión JPEG; de lo contrario, se utilizará LZ77. Este es el método de compresión predeterminado. LZ77 —Se utilizará el algoritmo de compresión LZ77 para construir las pirámides. LZ77 se puede utilizar para cualquier tipo de datos. JPEG —El algoritmo de compresión JPEG para construir pirámides. Solo los datos que se ajusten a la especificación de compresión JPEG pueden utilizar este tipo de compresión. Si se elige JPEG, puede establecer la calidad de compresión. NONE —No se utilizará ningún tipo de compresión para construir pirámides.	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. OVERWRITE —Las pirámides se construirán incluso si ya existen. Por lo tanto, las pirámides existente se sobrescribirán. Esta es la opción predeterminada. SKIP_EXISTING —Solo se construirán las pirámides si no 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

Espacio de trabajo actual, Pirámide, Espacio de trabajo temporal

Pirámide

El nivel de pirámide, la compresión de pirámide y el método de remuestreo no se aplican al formato IMG.

Información de licenciamiento

• Basic: Sí
• Standard: Sí
• Advanced: Sí