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 por lotes es útil cuando tiene un gran directorio de datasets ráster que no tienen pirámides.

  • Los datasets ráster con compresión de ondículas, como ECW, JPEG2000 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 porque 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 utilizando 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) cuando la compresión no esté disponible.

  • La compresión de pirámide predeterminada utilizará el tipo de compresión óptima, dependiendo del tipo de datos. Puede elegir manualmente la compresión LZ77, JPEG o sin compresión.

Parámetros

EtiquetaExplicaciónTipo de datos
Datasets ráster de entrada

Los datasets ráster para los que se crearán pirámides ráster.

Cada entrada debe tener más de 1.024 filas y 1.024 columnas.

Raster Dataset
Niveles de pirámide
(Opcional)

El número de capas de dataset de resolución reducida que se construirán. El valor predeterminado es -1, que va a construir pirámides completas. Un valor de 0 no producirá niveles de pirámide.

Long
Omitir primer nivel
(Opcional)

Especifica si se construirá el primer nivel de pirámide. Omitir el primer nivel utilizará un poco menos de espacio en disco, pero hará que el rendimiento sea más lento en esas escalas.

  • Desactivado: no se omitirá el primer nivel de pirámide; se construirá. Esta es la opción predeterminada.
  • Activado: se omitirá el primer nivel de pirámide; no se construirá.

Boolean
Técnica de remuestreo de pirámides
(Opcional)

Especifica la técnica de remuestreo que se utilizará para construir las pirámides.

  • NEARESTEl nuevo valor de una celda se basará en la celda más cercana durante el remuestreo. Esta es la opción predeterminada.
  • BILINEAREl nuevo valor de una celda se basará en el promedio de distancia ponderado de los cuatro centros de celda de entrada más cercanos.
  • CUBICEl nuevo valor de una celda se determinará ajustando una curva suave a través de los 16 centros de celdas de entrada más cercanos.
String
Tipo de compresión de pirámide
(Opcional)

Especifica el tipo de compresión que se usará al crear las pirámides.

  • DEFAULTSi 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 usará LZ77. Esta es la opción predeterminada.
  • LZ77Se utilizará el algoritmo de compresión LZ77 para construir las pirámides. LZ77 se puede utilizar para cualquier tipo de datos.
  • JPEGSe utilizará el algoritmo de compresión JPEG para construir las 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.
  • NONENo se utilizará ningún tipo de compresión para construir pirámides.
String
Calidad de compresión
(Opcional)

La calidad de compresión que se utilizará al construir pirámides con el tipo 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
Omitir existentes
(Opcional)

Especifica si las pirámides se construirán solamente si no existen, o si se construirán aunque ya existan.

  • Desactivado: se crearán pirámides, aunque ya existan, y las pirámides existentes se sobrescribirán. Esta es la opción predeterminada.
  • Activado: solo se construirán las pirámides si no existen; las pirámides existentes se omitirán.
Boolean

Salida derivada

EtiquetaExplicaciónTipo de datos
Operación Crear pirámides en lotes realizada correctamente

Devuelve si la herramienta se ejecutó correctamente o no.

Boolean

arcpy.management.BatchBuildPyramids(Input_Raster_Datasets, {Pyramid_levels}, {Skip_first_level}, {Pyramid_resampling_technique}, {Pyramid_compression_type}, {Compression_quality}, {Skip_Existing})
NombreExplicaciónTipo de datos
Input_Raster_Datasets
[Input_Raster_Datasets,...]

Los datasets ráster para los que se crearán pirámides ráster.

Cada entrada debe tener más de 1.024 filas y 1.024 columnas.

Raster Dataset
Pyramid_levels
(Opcional)

El número de capas de dataset de resolución reducida que se construirán. El valor predeterminado es -1, que va a construir pirámides completas. Un valor de 0 no producirá niveles de pirámide.

Long
Skip_first_level
(Opcional)

Especifica si se construirá el primer nivel de pirámide. Omitir el primer nivel utilizará un poco menos de espacio en disco, pero hará que el rendimiento sea más lento en esas escalas.

  • NONEActivado: no se omitirá el primer nivel de pirámide; se construirá. Esta es la opción predeterminada.
  • SKIP_FIRSTActivado: se omitirá el primer nivel de pirámide; no se construirá.
Boolean
Pyramid_resampling_technique
(Opcional)

Especifica la técnica de remuestreo que se utilizará para construir las pirámides.

  • NEARESTEl nuevo valor de una celda se basará en la celda más cercana durante el remuestreo. Esta es la opción predeterminada.
  • BILINEAREl nuevo valor de una celda se basará en el promedio de distancia ponderado de los cuatro centros de celda de entrada más cercanos.
  • CUBICEl nuevo valor de una celda se determinará ajustando una curva suave a través de los 16 centros de celdas de entrada más cercanos.
String
Pyramid_compression_type
(Opcional)

Especifica el tipo de compresión que se usará al crear las pirámides.

  • DEFAULTSi 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 usará LZ77. Esta es la opción predeterminada.
  • LZ77Se utilizará el algoritmo de compresión LZ77 para construir las pirámides. LZ77 se puede utilizar para cualquier tipo de datos.
  • JPEGSe utilizará el algoritmo de compresión JPEG para construir las 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.
  • NONENo se utilizará ningún tipo de compresión para construir pirámides.
String
Compression_quality
(Opcional)

La calidad de compresión que se utilizará al construir pirámides con el tipo 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)

Especifica si las pirámides se construirán solamente si no existen, o si se construirán aunque ya existan.

  • OVERWRITESe crearán pirámides, aunque ya existan, y las pirámides existentes se sobrescribirán. Esta es la opción predeterminada.
  • SKIP_EXISTINGSolo se construirán las pirámides si no existen; las pirámides existentes se omitirán.
Boolean

Salida derivada

NombreExplicaciónTipo de datos
Batch_Build_Pyramids_Succeeded

Devuelve si la herramienta se ejecutó correctamente o no.

Boolean

Muestra de código

Ejemplo 1 de BatchBuildPyramids (ventana de Python)

Esta es una muestra de Python para la función 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 de script de Python para la función 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

Casos especiales

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.

Temas relacionados