描述
遍历文件夹结构,从而为其所包含的所有栅格数据集构建金字塔并计算统计数据。 也可以为镶嵌数据集中的所有项目构建金字塔并计算统计值。
使用方法
语法
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})
参数 | 说明 | 数据类型 |
in_workspace | 包含要处理的所有栅格数据集的工作空间,即镶嵌数据集或栅格目录。 如果工作空间中包含了栅格目录或者镶嵌数据集,则当工具运行时不会涉及到这些项目。 | Text File; Mosaic Dataset; Workspace; Raster Catalog Layer; Raster Dataset; Mosaic Layer |
include_subdirectories (可选) | 指定是否包含子目录。
必须将栅格目录和镶嵌数据集指定为输入工作空间。 如果工作空间中包含了栅格目录或者镶嵌数据集,则当工具运行时不会涉及到这些项目。 | Boolean |
build_pyramids (可选) | 指定是否构建金字塔。
| Boolean |
calculate_statistics (可选) | 指定是否计算统计数据。
| Boolean |
BUILD_ON_SOURCE (可选) | 指定是为源栅格数据集构建金字塔并计算统计数据还是为镶嵌数据集中的栅格条目构建金字塔并计算统计数据。 此选项仅适用于镶嵌数据集。
| Boolean |
block_field (可选) | 镶嵌数据集属性表中的字段名称,用于标识在执行某些计算和操作时应被视为单一项目的多个项目。 | String |
estimate_statistics (可选) | 指定是否计算镶嵌数据集(不是其中的栅格)的统计数据。 统计数据派生于已为镶嵌数据集中每个栅格计算的现有统计数据。
| Boolean |
x_skip_factor (可选) |
样本之间水平像素的数量。 在计算统计值时使用的那部分栅格由跳跃因子控制。特定输入值可指示水平或垂直跳跃因子,值为 1 时使用每个像素,值为 2 时则每隔一个像素使用一个。此跳跃因子的取值范围只能从 1 至栅格中列/行的数量。 此值必须大于零并小于等于栅格中的列数。默认值为 1 或者为上次使用的跳跃因子。 | Long |
y_skip_factor (可选) | 样本之间垂直像素的数量。 在计算统计值时使用的那部分栅格由跳跃因子控制。特定输入值可指示水平或垂直跳跃因子,值为 1 时使用每个像素,值为 2 时则每隔一个像素使用一个。此跳跃因子的取值范围只能从 1 至栅格中列/行的数量。 此值必须大于零并小于等于栅格中的行数。默认值为 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 |
where_clause (可选) | 用于选择要处理的栅格数据集的 SQL 表达式。 | SQL Expression |
派生输出
名称 | 说明 | 数据类型 |
out_workspace | 更新的输出工作空间。 | Text File; Workspace; Raster Layer; Mosaic Layer |
代码示例
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)
环境
许可信息
- Basic: 是
- Standard: 是
- Advanced: 是