Crear pirámides (Administración de datos)

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

Crear pirámides

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 la lista de formatos de archivo de dataset ráster compatibles se indica la especificación compatible con el formato JPEG.

Parámetros

EtiquetaExplicaciónTipo de datos
Dataset ráster de entrada

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
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 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
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.

  • Más cercanoSe utilizará el valor del píxel más cercano para asignar un valor al píxel de salida durante el remuestreo. Esta es la opción predeterminada.
  • BilinealEl nuevo valor de un píxel se basará en el promedio de distancia ponderado de los cuatro centros de píxel de entrada más cercanos.
  • CúbicoEl nuevo valor de un píxel se basará en el ajuste de una curva suave a través de los 16 centros de píxeles 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 ráster.

  • PredeterminadoSi 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 se utilizará 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, se puede definir la calidad de compresión.
  • Jpeg Luma y CromaSe utilizará una compresión con pérdida de información con los componentes de espacio de color luma (Y) y croma (Cb y Cr) para construir pirámides.
  • Sin compresiónNo se utilizará ningún tipo de compresión para construir pirámides.
String
Calidad de compresión (1-100)
(Opcional)

La calidad de compresión que se 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
Omitir existentes
(Opcional)

Especifica si se construirán pirámides solo donde faltan o si se generarán nuevamente, 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.
Boolean

Salida derivada

EtiquetaExplicaciónTipo de datos
Ráster de entrada actualizado

El dataset ráster de salida.

Dataset ráster

arcpy.management.BuildPyramids(in_raster_dataset, {pyramid_level}, {SKIP_FIRST}, {resample_technique}, {compression_type}, {compression_quality}, {skip_existing})
NombreExplicaciónTipo 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)

El número de capas de dataset de resolución reducida que se construirán. 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)

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
resample_technique
(Opcional)

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

  • NEARESTSe utilizará el valor del píxel más cercano para asignar un valor al píxel de salida durante el remuestreo. Esta es la opción predeterminada.
  • BILINEAREl nuevo valor de un píxel se basará en el promedio de distancia ponderado de los cuatro centros de píxel de entrada más cercanos.
  • CUBICEl nuevo valor de un píxel se basará en el ajuste de una curva suave a través de los 16 centros de píxeles de entrada más cercanos.
String
compression_type
(Opcional)

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

  • 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 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 se utilizará 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, se puede definir la calidad de compresión.
  • JPEG_YCbCrSe utilizará una compresión con pérdida de información con los componentes de espacio de color luma (Y) y croma (Cb y Cr) para construir pirámides.
  • 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 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)

Especifica si se construirán pirámides solo donde faltan o si se generarán nuevamente, 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 pirámides si aún no existen.
Boolean

Salida derivada

NombreExplicaciónTipo 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

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.

Factor de procesamiento en paralelo

Solo se admite para el formato CRF.

Información de licenciamiento

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

Temas relacionados