摘要
遍历文件夹结构，从而为其所包含的所有栅格数据集构建金字塔并计算统计数据。还可以为镶嵌数据集中的所有项构建金字塔并计算统计数据。
用法
语法
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})| 参数 | 说明 | 数据类型 |
in_workspace | 包含要处理的所有栅格数据集的工作空间，即镶嵌数据集或栅格目录。 如果工作空间中包含了栅格目录或者镶嵌数据集，则当工具运行时不会涉及到这些项目。 | Mosaic Dataset; Mosaic Layer; Raster Catalog Layer; Raster Dataset; Text File; Workspace |
include_subdirectories (可选) | 指定是否包含子目录。
必须将栅格目录和镶嵌数据集指定为输入工作空间。如果工作空间中包含了栅格目录或者镶嵌数据集，则当工具运行时不会涉及到这些项目。 | Boolean |
build_pyramids (可选) | 指定是否构建金字塔。
| Boolean |
calculate_statistics (可选) | 指定是否计算统计数据。
| Boolean |
BUILD_ON_SOURCE (可选) | 指定是为源栅格数据集构建金字塔并计算统计数据还是为镶嵌数据集中的栅格条目构建金字塔并计算统计数据。此选项仅适用于镶嵌数据集。
| Boolean |
block_field (可选) | 镶嵌数据集属性表中的字段名称，用于标识在执行某些计算和操作时应被视为单一项目的多个项目。 | String |
estimate_statistics (可选) | 指定是否计算镶嵌数据集（不是其中的栅格）的统计数据。这些统计数据派生自为镶嵌数据集中的每个栅格计算出的现有统计数据。
| Boolean |
x_skip_factor (可选) |
样本之间水平像素的数量。 此值必须大于零并小于等于栅格中的列数。默认值为 1 或者为上次使用的跳跃因子。 | Long |
y_skip_factor (可选) | 样本之间垂直像素的数量。 此值必须大于零并小于等于栅格中的行数。默认值为 1 或者为上次使用的 y 跳跃因子。 | Long |
ignore_values [ignore_value,...] (可选) |
排除在统计值计算之外的像素值。 默认情况下没有值。 | Long |
pyramid_level (可选) | 选择将构建的递减分辨率数据集图层的数量。默认值为 -1（将构建完整的金字塔）。值为 0 时，将不会获得金字塔等级。 可以指定的最大金字塔等级数为 29。任何大于或等于 30 的值都将创建一组完整的金字塔。 | Long |
SKIP_FIRST (可选) | 选择是否跳过第一个金字塔等级。跳过第一个等级将略微降低占用的磁盘空间大小，但将降低这些比例的性能。
| Boolean |
resample_technique (可选) | 用于构建金字塔的重采样技术。
| String |
compression_type (可选) | 构建栅格金字塔时使用的压缩类型。
| String |
compression_quality (可选) | 使用 JPEG 压缩方法构建金字塔时使用的压缩质量。该值必须处于 0 到 100 之间。值越接近 100，图像质量越高，但压缩比越低。 | Long |
skip_existing (可选) | 指定在缺少统计数据的位置进行计算，还是重新计算全部统计数据（即使已经存在仍重新计算）。
| Boolean |
代码实例
BuildPyramidsAndStatistics 示例 1（Python 窗口）
这是 BuildPyramidsAndStatistics 工具的 Python 示例。
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")
BuildPyramidsAndStatistics 示例 2（独立脚本）
这是 BuildPyramidsAndStatistics 工具的 Python 脚本示例。
#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)