栅格统计（环境设置）

依据“栅格统计”环境的工具控制为输出栅格数据集构建统计数据的方式。

“统计数据”选项使您能够为输出栅格数据集构建统计数据。使用栅格数据集在 ArcMap 或 ArcCatalog 中执行某些任务（例如应用对比度拉伸或分类数据）时，需要为栅格数据集构建统计数据。如果尚未计算统计数据，也不必构建统计数据，因为会在首次需要时进行计算。然而，如果要使用某些需要统计数据的要素，建议在使用栅格数据集之前计算统计数据。

用法说明

• 在应用程序中执行某些任务时（如应用对比度拉伸或分类数据等），需要对栅格数据集进行统计。
• 如果要使用某些需要统计数据的要素，建议在使用统计数据之前为栅格数据集计算统计数据。
• 跳跃因子允许通过跳过像素来加速计算统计数据的过程。
• 忽略值适用于不会参与统计数据计算的值。通常，可能需要忽略背景的值。
• 对于储存在文件地理数据库或 ArcSDE 地理数据库中的栅格数据集，它们的跳跃因子并不相同。首先，如果 x 和 y 跳跃因子不同，则使用两者中较小的一个来作为 x 和 y 共同的跳跃因子。其次，跳跃因子同与其最接近的金字塔等级相关联。如果跳跃因子值不等于金字塔图层中的像素数量，则数量下舍入下一级金字塔等级，且会使用统计数据。
• 有关使用此设置可控制哪些栅格存储格式的信息，请参阅栅格存储矩阵。

对话框语法

• 计算统计数据 - 要计算统计数据，请选中此复选框。
• 统计数据跳跃因子
  • X 跳跃因子 - 样本之间水平方向像素的数量。此值必须大于零，并且小于等于栅格数据集中的列数。默认值为 1 或最近一次使用的跳跃因子。
  • Y 跳跃因子 - 样本之间垂直方向像素的数量。此值必须大于零并小于等于栅格数据集中的行数。默认值为 1 或最近一次使用的跳跃因子。
• 统计数据忽略值 - 不会参与统计数据计算的一个或多个忽略值，例如背景值。多个值之间需要用分号分隔。

脚本语法

arcpy.env.rasterStatistics = "calculate_statistics {x_skip_factor} {y_skip_factor} {statistics_ignore_value}"

参数	说明
calculate_statistics（必填）	要计算统计数据，使用 STATISTICS；否则，指定 NONE。
x_skip_factor（可选）	X 轴的跳跃因子。
y_skip_factor（可选）	Y 轴的跳跃因子。
statistics_ignore_value（可选）	不会参与统计数据计算的一个或多个忽略值，例如背景值。多个值之间需要用空格分隔。

rasterStatistics 语法

import arcpy

# Statistics using a skip factor of 100 for x and y, and 
# ignore values of 0 and 255.
arcpy.env.rasterStatistics = 'STATISTICS 100 100 (0 255)'