Crear pirámides (Gestión de datos)

Nivel de licencia:BasicStandardAdvanced

Resumen

Construye pirámides ráster para un 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

Crear pirámides

Uso

Sintaxis

BuildPyramids_management (in_raster_dataset, {pyramid_level}, {SKIP_FIRST}, {resample_technique}, {compression_type}, {compression_quality}, {skip_existing})
ParámetroExplicaciónTipo de datos
in_raster_dataset

El dataset ráster de entrada.

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 va a construir 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 se 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.

  • NONESe construirá el primer nivel de pirámide. Esta es la opción predeterminada.
  • SKIP_FIRSTNo se construirá el primer nivel de pirámide.
Boolean
resample_technique
(Opcional)

La técnica de remuestreo que se utiliza para construir las pirámides.

  • NEARESTEl 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.
  • BILINEAREl 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.
  • CUBICEl 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
compression_type
(Opcional)

El tipo de compresión a utilizar al construir las pirámides de ráster.

  • POR DEFECTOSi 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.
  • LZ77Se utilizará el algoritmo de compresión LZ77 para construir las pirámides. LZ77 se puede utilizar para cualquier tipo de datos.
  • JPEGEl 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.
  • JPEG_YCbCrUna compresión con pérdida de información mediante los componentes del espacio de colores luma (Y) y croma (Cb y Cr).
  • NONENo 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 entre 0 y 100. Los valores más cercanos a 100 producirían una mejor calidad de imagen, 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.

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

Ejemplo de código

Ejemplo 1 de BuildPyramids (ventana de Python)

Esta es una muestra de Python para BuildPyramids.

import arcpy
arcpy.BuildPyramids_management(
     "C:/data/image.tif", "3", "NONE", 
     "BILINEAR", "JPEG", "50", "SKIP_EXISTING")
Ejemplo 2 de BuildPyramids (secuencia de comandos independiente)

Esta es una muestra de secuencia de comandos de Python para BuildPyramids.

#Build Pyramids for single Raster Dataset
#Define the type and compression of pyramids in the tool
#Skip if dataset already has pyramids

import arcpy
arcpy.env.workspace = "C:/Workspace"

inras = "image.tif"
pylevel = "3"
skipfirst = "NONE"
resample = "BILINEAR"
compress = "JPEG"
quality = "80"
skipexist = "SKIP_EXISTING"

arcpy.BuildPyramids_management(inras, pylevel, skipfirst, resample, 
                               compress, quality, skipexist)

Entornos

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

Información sobre licencias

ArcGIS for Desktop Basic: Sí
ArcGIS for Desktop Standard: Sí
ArcGIS for Desktop Advanced: Sí
5/12/2014