| 标注 | 说明 | 数据类型 |
输入栅格波段 | 输入栅格波段。 可为整型或浮点型。 | Raster Layer |
输出统计文件 | 包含统计信息的输出 ASCII 文件。 需要使用 .txt 扩展名。 | File |
计算协方差和相关矩阵 (可选) | 指定是否计算协方差和相关矩阵。
| Boolean |
需要 Spatial Analyst 许可。
使用情况
将多波段栅格指定为输入栅格波段（Python 中的 in_raster_bands）之一时，将使用所有波段。
要处理一系列来自多波段栅格的波段，可先用波段合成工具创建由这些特定波段组成的新栅格数据集，并在输入栅格波段（Python 中的 in_raster_bands）列表中使用该结果。
栅格波段必须具有一个公共交集。 如果不存在公共交集，则会出现错误，且不会创建任何输出。
如果栅格波段的范围不同，则统计数据将根据所有输入栅格波段的公共空间范围进行计算。 像元大小将是输入栅格的最大值。
对于计算协方差和相关矩阵参数，默认未选中设置（脚本中的 BRIEF）表明将仅计算输入栅格波段的最小值、最大值、平均值以及标准差。 除了计算这些统计数据以外，要计算协方差和相关矩阵，请选中工具对话框中的此选项（或使用脚本中的 DETAILED）。
协方差矩阵表示沿对角线从左上角到右下角的所有栅格波段的方差，以及其余条目中所有栅格波段之间的协方差。 相关矩阵提供两个输入波段的每个组合之间的相关系数。
在协方差矩阵的计算中，波段的平均值可用于任何 NoData 输入像元。
统计信息以 ASCII 文本格式写入输出文件。 该输出的扩展名必须为 .txt。
参数
BandCollectionStats(in_raster_bands, out_stat_file, {compute_matrices})| 名称 | 说明 | 数据类型 |
in_raster_bands [in_raster_band,...] | 输入栅格波段。 可为整型或浮点型。 | Raster Layer |
out_stat_file | 包含统计信息的输出 ASCII 文件。 需要使用 .txt 扩展名。 | File |
compute_matrices (可选) | 指定是否计算协方差和相关矩阵。
| Boolean |
代码示例
此示例可计算一组栅格波段的统计数据。
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
BandCollectionStats("redlands", "c:/sapyexamples/output/redbandstats.txt", "BRIEF")此示例可计算一组栅格波段的统计数据。
# Name: BandCollectionStats_Ex_02.py
# Description: Calculates the statistics for a set of raster bands.
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Set environment settings
env.workspace = "C:/sapyexamples/data"
# Set local variables
inRasterBand1 = "sb/sbc1"
inRasterBand2 = "sb/sbc2"
outStatFile = "C:/sapyexamples/output/bandstatfile.txt"
# Execute BandCollectionStats
BandCollectionStats([inRasterBand1, inRasterBand2], outStatFile, "DETAILED")