Generar pirámides y estadísticas (Administración de datos)

Resumen

Recorre una estructura de carpeta, crea pirámides y calcula estadísticas para todos los datasets ráster que contiene. También puede crear pirámides y calcular estadísticas para todos los elementos de un dataset de mosaico.

Uso

  • Se procesarán todos los formatos de ráster compatibles.

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

Parámetros

EtiquetaExplicaciónTipo de datos
Incluir subdirectorios
(Opcional)

Especifica si se incluirán subdirectorios.

  • Desactivada: no incluye los subdirectorios.
  • Activada: incluye todos los datasets ráster dentro de los subdirectorios durante la carga. Esta es la opción predeterminada.
Boolean
Crear pirámides
(Opcional)

Especifica si se construirán las pirámides.

  • Desactivado: no se crearán pirámides.
  • Activado: se crearán pirámides. Esta es la opción predeterminada.
Boolean
Calcular estadísticas
(Opcional)

Especifique si desea calcular las estadísticas.

  • Desactivado: no se calculan las estadísticas.
  • Activado: se calculan las estadísticas. Esta es la opción predeterminada.
Boolean
Incluir datasets de origen
(Opcional)

Especifique si desea calcular estadísticas en datasets ráster de origen o calcular estadísticas en los elementos de ráster de un dataset de mosaico. Esta opción solo se aplica a los datasets de mosaico.

  • Desactivada: se calcularán las estadísticas para cada elemento de ráster del dataset de mosaico (en cada fila de la tabla de atributos). Toda función agregada al elemento de ráster se aplicará antes de generar las estadísticas. Esta es la opción predeterminada.
  • Activada: calcula estadísticas en los datos de origen del dataset de mosaico.
Boolean
Campo de bloque
(Opcional)

El nombre del campo en una tabla de atributos del dataset de mosaico que se utiliza para identificar los elementos que deberían considerarse un elemento al realizar algunos cálculos y operaciones.

String
Estimar las estadísticas del dataset de mosaico
(Opcional)

Especifique si desea calcular estadísticas para el dataset de mosaico (no para los rásteres dentro del mismo). Las estadísticas se derivan de las estadísticas existentes que se calcularon para cada ráster en el dataset de mosaico.

  • No activado: no se calculan estadísticas para el dataset de mosaico. Esta es la opción predeterminada.
  • Activada: se calcularán las estadísticas para el dataset de mosaico.
Boolean
Factor de omisión X
(Opcional)

El número de píxeles horizontales entre las muestras.

Un factor de omisión controla la porción del ráster que se utiliza cuando se calculan las estadísticas. El valor de entrada indica el factor de omisión horizontal o vertical, donde un valor de 1 utilizará cada píxel y un valor de 2 usará cada píxel de por medio. El factor de omisión solo puede oscilar entre 1 y el número de columnas o filas del ráster.

El valor debe ser mayor que cero y menor o igual que el número de columnas del ráster. El valor predeterminado es 1 o el último valor de omisión utilizado.

Long
Factor de omisión Y
(Opcional)

El número de píxeles verticales entre las muestras.

Un factor de omisión controla la porción del ráster que se utiliza cuando se calculan las estadísticas. El valor de entrada indica el factor de omisión horizontal o vertical, donde un valor de 1 utilizará cada píxel y un valor de 2 usará cada píxel de por medio. El factor de omisión solo puede oscilar entre 1 y el número de columnas o filas del ráster.

El valor debe ser mayor que cero y menor o igual que el número de filas del ráster. El valor predeterminado es 1 o el último valor de omisión y utilizado.

Long
Ignorar valores
(Opcional)

Los valores de píxel que no se incluirán en el cálculo de las estadísticas.

La opción predeterminada es sin valor.

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

El número máximo de niveles de pirámide que puede especificar es 29. Cualquier valor igual o superior a 30 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.

  • Vecino más próximoSe 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 usará LZ77. Esta es la opción predeterminada.
  • Compresión LZ77Se utilizará el algoritmo de compresión LZ77 para construir pirámides. Este tipo de compresión puede utilizarse con cualquier tipo de datos.
  • Compresión JPEGSe utilizará 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 especifica este tipo de compresión, puede establecer el valor del parámetro 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).
  • 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 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)

Especifique si desea calcular estadísticas solo donde faltan o si desea volver a generarlas aunque ya existan.

  • Activado: solo se calcularán las estadísticas si aún no existen. Esta es la opción predeterminada.
  • Desactivado: se calcularán estadísticas, aunque ya existan; las estadísticas existentes se sobrescribirán.
Boolean
Definición de consulta
(Opcional)

Expresión SQL para seleccionar los datasets ráster que se van a procesar.

SQL Expression

Salida derivada

EtiquetaExplicaciónTipo de datos
Datos de entrada actualizados

El espacio de trabajo de salida actualizado.

Text File; Workspace; Raster Layer; Mosaic Layer

arcpy.management.BuildPyramidsandStatistics({include_subdirectories}, {build_pyramids}, {calculate_statistics}, {BUILD_ON_SOURCE}, {block_field}, {estimate_statistics}, {x_skip_factor}, {y_skip_factor}, {ignore_values}, {pyramid_level}, {SKIP_FIRST}, {resample_technique}, {compression_type}, {compression_quality}, {skip_existing}, {where_clause})
NombreExplicaciónTipo de datos
include_subdirectories
(Opcional)

Especifica si se incluirán subdirectorios.

  • NONENo incluye subdirectorios.
  • INCLUDE_SUBDIRECTORIESIncluye todos los datasets ráster dentro de los subdirectorios durante la carga. Esta es la opción predeterminada.
Boolean
build_pyramids
(Opcional)

Especifica si se construirán las pirámides.

  • NONENo se crearán pirámides.
  • BUILD_PYRAMIDSSe crearán pirámides. Esta es la opción predeterminada.
Boolean
calculate_statistics
(Opcional)

Especifique si desea calcular las estadísticas.

  • NONENo se calculan las estadísticas.
  • CALCULATE_STATISTICSSe calculan las estadísticas. Esta es la opción predeterminada.
Boolean
BUILD_ON_SOURCE
(Opcional)

Especifique si desea calcular estadísticas en datasets ráster de origen o calcular estadísticas en los elementos de ráster de un dataset de mosaico. Esta opción solo se aplica a los datasets de mosaico.

  • NONESe calcularán las estadísticas para cada elemento de ráster del dataset de mosaico (en cada fila de la tabla de atributos). Toda función agregada al elemento de ráster se aplicará antes de generar las estadísticas. Esta es la opción predeterminada.
  • BUILD_ON_SOURCECalcula estadísticas en los datos de origen del dataset de mosaico.
Boolean
block_field
(Opcional)

El nombre del campo en una tabla de atributos del dataset de mosaico que se utiliza para identificar los elementos que deberían considerarse un elemento al realizar algunos cálculos y operaciones.

String
estimate_statistics
(Opcional)

Especifique si desea calcular estadísticas para el dataset de mosaico (no para los rásteres dentro del mismo). Las estadísticas se derivan de las estadísticas existentes que se calcularon para cada ráster en el dataset de mosaico.

  • NONENo se calculan las estadísticas para el dataset de mosaico. Esta es la opción predeterminada.
  • ESTIMATE_STATISTICSSe calcularán las estadísticas para el dataset de mosaico.
Boolean
x_skip_factor
(Opcional)

El número de píxeles horizontales entre las muestras.

Un factor de omisión controla la porción del ráster que se utiliza cuando se calculan las estadísticas. El valor de entrada indica el factor de omisión horizontal o vertical, donde un valor de 1 utilizará cada píxel y un valor de 2 usará cada píxel de por medio. El factor de omisión solo puede oscilar entre 1 y el número de columnas o filas del ráster.

El valor debe ser mayor que cero y menor o igual que el número de columnas del ráster. El valor predeterminado es 1 o el último valor de omisión utilizado.

Long
y_skip_factor
(Opcional)

El número de píxeles verticales entre las muestras.

Un factor de omisión controla la porción del ráster que se utiliza cuando se calculan las estadísticas. El valor de entrada indica el factor de omisión horizontal o vertical, donde un valor de 1 utilizará cada píxel y un valor de 2 usará cada píxel de por medio. El factor de omisión solo puede oscilar entre 1 y el número de columnas o filas del ráster.

El valor debe ser mayor que cero y menor o igual que el número de filas del ráster. El valor predeterminado es 1 o el último valor de omisión y utilizado.

Long
ignore_values
[ignore_value,...]
(Opcional)

Los valores de píxel que no se incluirán en el cálculo de las estadísticas.

La opción predeterminada es sin valor.

Long
pyramid_level
(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.

El número máximo de niveles de pirámide que puede especificar es 29. Cualquier valor igual o superior a 30 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 usará LZ77. Esta es la opción predeterminada.
  • LZ77Se utilizará el algoritmo de compresión LZ77 para construir pirámides. Este tipo de compresión puede utilizarse con cualquier tipo de datos.
  • JPEGSe utilizará 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 especifica este tipo de compresión, puede establecer el valor del parámetro 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).
  • 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)

Especifique si desea calcular estadísticas solo donde faltan o si desea volver a generarlas aunque ya existan.

  • SKIP_EXISTINGSe calcularán las estadísticas solamente si aún no existen. Esta es la opción predeterminada.
  • OVERWRITESe calcularán estadísticas, aunque ya existan; las estadísticas existentes se sobrescribirán.
Boolean
where_clause
(Opcional)

Expresión SQL para seleccionar los datasets ráster que se van a procesar.

SQL Expression

Salida derivada

NombreExplicaciónTipo de datos
out_workspace

El espacio de trabajo de salida actualizado.

Text File; Workspace; Raster Layer; Mosaic Layer

Muestra de código

Ejemplo 1 de BuildPyramidsAndStatistics (ventana de Python)

Esta es una muestra de Python para la herramienta BuildPyramidsAndStatistics.

import arcpy
from arcpy import env
env.workspace = "c:/data"
arcpy.env.pyramid = "PYRAMIDS 3 BILINEAR JPEG"
arcpy.env.rasterStatistics = "STATISTICS 4 6 (0)"
arcpy.BuildPyramidsandStatistics_management("folder", "INCLUDE_SUBDIRECTORIES",
                                            "BUILD_PYRAMIDS", "CALCULATE_STATISTICS")
Ejemplo 2 de BuildPyramidsAndStatistics (script independiente)

Esta es una muestra de script de Python para la herramienta BuildPyramidsAndStatistics.

##====================================
##Build Pyramids and Statistics
##Usage: BuildPyramidsandStatistics_management in_workspace {INCLUDE_SUBDIRECTORIES
##                                                 | NONE} {BUILD_PYRAMIDS | NONE}
##                                                 {CALCULATE_STATISTICS | NONE}
    
try:
    import arcpy
    arcpy.env.workspace = r"C:/Workspace"

    ##Define parameters for build pyramids and calculate statitics in environment setting
    arcpy.env.pyramid = "PYRAMIDS 3 BILINEAR JPEG"
    arcpy.env.rasterStatistics = "STATISTICS 4 6 (0)"
    
    ##Build pyramids and calculate statistics for all raster in a folder
    arcpy.BuildPyramidsandStatistics_management("folder", "INCLUDE_SUBDIRECTORIES",
                                                "BUILD_PYRAMIDS", "CALCULATE_STATISTICS")
    
    ##Build pyramids and calculate statistics for all raster in a GDB
    arcpy.BuildPyramidsandStatistics_management("fgdb.gdb", "INCLUDE_SUBDIRECTORIES",
                                                "BUILD_PYRAMIDS", "CALCULATE_STATISTICS")
    
    ##Build pyramids and calculate statistics for all raster in a Mosaic Dataset
    arcpy.BuildPyramidsandStatistics_management("fgdb.gdb/md", "INCLUDE_SUBDIRECTORIES",
                                                "BUILD_PYRAMIDS", "CALCULATE_STATISTICS")

except:
    print "Build Pyramids and Statistics example failed."
    print arcpy.GetMessages()

Temas relacionados