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

  • La creación de pirámides mejora el rendimiento de visualización de los datasets ráster

  • El cálculo de las estadísticas permite a las aplicaciones de ArcGIS extender y simbolizar de manera adecuada los datos ráster para la visualización.

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

  • Si el espacio de trabajo incluye un dataset de mosaico, solo se incluirán las estadísticas asociadas con el dataset de mosaico, pero no se incluirán las asociadas con los elementos contenidos en él.

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

Sintaxis

arcpy.management.BuildPyramidsandStatistics(in_workspace, {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}, {sips_mode})
ParámetroExplicaciónTipo de datos
in_workspace

El espacio de trabajo que contiene todos los datasets ráster o datasets de mosaico que se van a procesar.

Si el espacio de trabajo incluye un dataset de mosaico, solo se incluirán las estadísticas asociadas con el dataset de mosaico. Las estadísticas asociadas con los elementos dentro del dataset de mosaico no se incluirán.

Text File; Workspace; Raster Layer; Mosaic Layer
include_subdirectories
(Opcional)

Especifique si desea incluir subdirectorios.

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

Si el espacio de trabajo incluye un dataset de mosaico, solo se incluirán las estadísticas asociadas con el dataset de mosaico. Las estadísticas asociadas con los elementos dentro del dataset de mosaico no se incluirán.

Boolean
build_pyramids
(Opcional)

Especifique si desea crear pirámides.

  • NONENo crea pirámides.
  • BUILD_PYRAMIDSCrea 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 crear pirámides y calcular estadísticas en los datasets ráster de origen o si desea calcular estadísticas en los elementos 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_SOURCECrea pirámides y calcula 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.

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.

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)

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.

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)

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.

  • NEARESTEn este método se 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.
  • BILINEAREste método determina el nuevo valor de una celda basado en el promedio ponderado de distancia de los cuatro centros de celdas de entrada más próximos.
  • CUBICEste método 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.

  • 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 de 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 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_EXISTINGSolo se calcularán las estadísticas 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
sips_mode
(Opcional)

Especifica si habilitar la creación de archivos de pirámide con algoritmos y procesos clave definidos en el Estándar de Procesamiento de Imágenes en Pantalla (SIPS), NGA.STND.0014.

  • NONELas pirámides se crearán con métodos de submuestreo estándar. Esta es la opción predeterminada.
  • SIPS_MODELas pirámides se crearán con el procesamiento SIPS.
Boolean

Salida derivada

NombreExplicaciónTipo de datos
out_workspace

El espacio de trabajo de salida actualizado.

Archivo de texto; Espacio de trabajo; Capa ráster; Capa de mosaico

Muestra de código

Ejemplo 1 de BuildPyramidsAndStatistics (ventana de Python)

Esta es una muestra de Python para la herramienta BuildPyramidsAndStatistics.

import arcpy
arcpy.BuildPyramidsAndStatistics_management(
     "C:/Workspace", "INCLUDE_SUBDIRECTORIES", "BUILD_PYRAMIDS",
     "CALCULATE_STATISTICS","BUILD_ON_SOURCE", "BlockField", 
     "ESTIMATE_STATISTICS", "10", "10", "0;255", "-1", "NONE",
     "BILINEAR", "JPEG", "50", "OVERWRITE")
Ejemplo 2 de BuildPyramidsAndStatistics (script independiente)

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

#Build pyramids and calculate statistics for all raster in a folder

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

inws = "folder"
includedir = "INCLUDE_SUBDIRECTORIES"
buildpy = "BUILD_PYRAMIDS"
calcstats = "CALCULATE_STATISTICS"
buildsource = "NONE"
blockfield = "#"
estimatemd = "#"
skipx = "4"
skipy = "6"
ignoreval = "0;255"
pylevel = "3"
skipfirst = "NONE"
resample = "BILINEAR"
compress = "JPEG"
quality = "80"
skipexist = "SKIP_EXISTING"

arcpy.BuildPyramidsAndStatistics_management(
     inws, includedir, buildpy, calcstats, buildsource, blockfield,
     estimatemd, skipx, skipy, ignoreval, pylevel, skipfirst,
     resample, compress, quality, skipexist)

Información de licenciamiento

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

Temas relacionados