构建金字塔 (Pyramid) 和统计数据 (数据管理)

摘要

遍历文件夹结构，从而为其所包含的所有栅格数据集构建金字塔和计算统计数据。还可以为栅格目录或镶嵌数据集中的所有项构建金字塔和计算统计数据。

用法

• 构建金字塔可以改善栅格数据集的显示性能。

• 通过计算统计值，ArcGIS 应用程序能适当地对显示的栅格数据进行拉伸和符号化操作。

• 将处理所有支持的栅格格式。

• 必须将栅格目录和镶嵌数据集指定为输入工作空间。如果工作空间中包含了栅格目录或者镶嵌数据集，则当工具运行时不会涉及到这些项目。

• 它不计算镶嵌数据集本身的统计数据，只计算其中所包含的栅格。要计算镶嵌数据集的统计数据，可使用计算统计数据工具。

• 小波压缩栅格数据集（如 ECW 和 MrSID）无需构建金字塔。这些格式具有编码时创建的内部金字塔。

• 跳跃因子和金字塔重采样可在地理处理环境栅格存储设置中进行设置。

语法

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

参数	说明	数据类型
in_workspace	包含要处理的所有栅格数据集的工作空间。 必须将栅格目录和镶嵌数据集指定为输入工作空间。如果工作空间中包含了栅格目录或者镶嵌数据集，则当工具运行时不会涉及到这些项目。	Mosaic Dataset; Raster Catalog Layer; Raster Dataset; Workspace
include_subdirectories （可选）	指定是否包含子目录。 NONE —不包括子目录。 INCLUDE_SUBDIRECTORIES —加载时包括子目录中的所有栅格数据集。这是默认设置。 必须将栅格目录和镶嵌数据集指定为输入工作空间。如果工作空间中包含了栅格目录或者镶嵌数据集，则当工具运行时不会涉及到这些项目。	Boolean
build_pyramids （可选）	指定是否构建金字塔。 NONE —不构建金字塔。 BUILD_PYRAMIDS —构建金字塔。这是默认设置。	Boolean
calculate_statistics （可选）	指定是否计算统计数据。 NONE —不计算统计数据。 CALCULATE_STATISTICS —计算统计数据。这是默认设置。	Boolean
build_on_source （可选）	指定是为源栅格数据集构建金字塔并计算统计数据还是为镶嵌数据集中的栅格条目构建金字塔并计算统计数据。此选项仅适用于镶嵌数据集。 NONE —为镶嵌数据集中的每个栅格条目（对应于属性表中的每一行）计算统计数据。在生成统计数据前，将应用为栅格条目添加的所有函数。这是默认设置。 BUILD_ON_SOURCE —为镶嵌数据集的源数据构建金字塔并计算统计数据。	Boolean

代码示例

BuildPyramidsandStatistics 示例 1（Python 窗口）

这是 BuildPyramidsandStatistics 工具的 Python 示例。

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")

BuildPyramidsandStatistics 示例 2（独立脚本）

这是 BuildPyramidsandStatistics 工具的 Python 脚本示例。

##====================================
##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()

环境

金字塔, 栅格统计, 当前工作空间, 临时工作空间

许可信息

ArcView: 是

ArcEditor: 是

ArcInfo: 是