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

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

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

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

• No calcula las estadísticas en el propio dataset de mosaico, sino en los rásteres incluidos dentro de este. Para calcular las estadísticas en el dataset de mosaico, utilice la herramienta Calcular estadísticas.

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

• El remuestreo de pirámides y los factores de omisión se pueden establecer en el entorno de geoprocesamiento Configuración de almacenamiento de rásteres.

Sintaxis

BuildPyramidsandStatistics_management (in_workspace, {include_subdirectories}, {build_pyramids}, {calculate_statistics}, {build_on_source})

Parámetro	Explicación	Tipo de datos
in_workspace	Espacio de trabajo que contiene todos los datasets ráster que se procesarán. 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.	Mosaic Dataset; Raster Catalog Layer; Raster Dataset; Workspace
include_subdirectories (Opcional)	Especifique si desea incluir subdirectorios. NINGUNO —No incluye subdirectorios. INCLUDE_SUBDIRECTORIES —Incluye 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. NONE —No crea pirámides. BUILD_PYRAMIDS —Crea pirámides. Esta es la opción predeterminada.	Boolean
calculate_statistics (Opcional)	Especifique si desea calcular las estadísticas. NINGUNO —No se calculan las estadísticas. CALCULATE_STATISTICS —Se 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 sólo se aplica a los datasets de mosaico. NINGUNO —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. BUILD_ON_SOURCE —Crea pirámides y calcula estadísticas en los datos de origen del dataset de mosaico.	Boolean

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

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

Entornos

Pirámide, Estadísticas de ráster, Espacio de trabajo actual, Espacio de trabajo temporal