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

Nivel de licencia:BasicStandardAdvanced

Resumen

Atraviesa 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 en un catálogo de ráster o dataset de mosaico.

Uso

Sintaxis

BuildPyramidsAndStatistics_management (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})
ParámetroExplicaciónTipo de datos
in_workspace

El espacio de trabajo que contiene todos los datasets ráster que se procesan, un dataset de mosaico o un catálogo de ráster.

Si el espacio de trabajo incluye un catálogo de ráster o un dataset de mosaico, estos elementos no se incluirán cuando se ejecute la herramienta.

Mosaic Dataset; Mosaic Layer; Raster Catalog Layer; Raster Dataset; Text File; Workspace
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.

Los catálogos de ráster y los datasets de mosaico se deben especificar como el espacio de trabajo de entrada. Si el espacio de trabajo incluye un catálogo de ráster o un dataset de mosaico, estos elementos no se incluirán cuando se ejecute la herramienta.

Boolean
build_pyramids
(Opcional)

Especifique si desea crear pirámides.

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

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.

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 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 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 calcular estadísticas solo donde faltan o si desea volver a generarlas incluso si existen.

  • SKIP_EXISTINGSe calcularán las estadísticas solamente si aún no existen. Esta es la opción predeterminada.
  • OVERWRITELas estadísticas se calcularán incluso si ya existen. Por lo tanto, se sobrescribirán las estadísticas existentes.
Boolean

Ejemplo 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 (secuencia de comandos independiente)

Esta es una muestra de secuencia de comandos 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)

Entornos

Temas relacionados

Información sobre licencias

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