| 标注 | 说明 | 数据类型 |
输入栅格波段 | 输入栅格波段。 可为整型或浮点型。 | Raster Layer |
输出统计数据文件 | 包含统计数据的输出文本或 Markdown 文件。 需要使用 .txt、.md、.csv 或 .asc 扩展名。 默认为 .txt。 除非指定 .md 扩展名，否则输出统计数据文件将使用 CSV 格式。 在本例中，输出文件将采用 Markdown 格式。 | File |
计算协方差和相关矩阵 (可选) | 指定是否将计算协方差和相关矩阵。
| Boolean |
计算直方图 (可选) | 指定是否将计算直方图统计数据。
当选中此参数时，将为其他选项启用直方图条柱的数量、输出直方图表和输出直方图名称参数。 | Boolean |
直方图条柱的数量 (可选) | 指定将用于直方图计算中的直方图条柱的数量。 默认值为 256。 最小允许值为 1。 最大允许值为 4096。 应根据输入数据和分析应用来设置此参数的值。 | Long |
输出直方图表 (可选) | 将包含所有输入波段的直方图统计数据的输出表。 表的格式由输出位置和路径确定。 默认情况下，如果在地理数据库工作空间中，则输出将是一个地理数据库表；如果在文件工作空间中，则输出将为 dBASE 表（.dbf 文件）。 要创建输出直方图表，必须选中计算直方图参数。 | Table |
输出直方图名称 (可选) | 用于显示的输出直方图的名称。 将在内容窗格的独立表下列出直方图。 要创建输出直方图，必须指定输出直方图表参数值。 | String |
需要 Spatial Analyst 许可。
使用情况
将多波段栅格指定为输入栅格波段（Python 中的 in_raster_bands）之一时，将使用所有波段。
要处理一系列来自多波段栅格的波段，可先用波段合成工具创建由这些特定波段组成的新栅格数据集，并在输入栅格波段（Python 中的 in_raster_bands）列表中使用该结果。
栅格波段必须具有一个公共交集。 如果不存在公共交集，则会出现错误，且不会创建任何输出。
如果栅格波段的范围不同，则统计数据将根据所有输入栅格波段的公共空间范围进行计算。 像元大小将是输入栅格的最大值。
对于计算协方差和相关矩阵参数，默认未选中设置（脚本中的 BRIEF）表明将仅计算输入栅格波段的最小值、最大值、平均值以及标准差。 除了计算这些统计数据以外，要计算协方差和相关矩阵，请选中工具对话框中的此参数（或者在脚本中使用 DETAILED）。
协方差矩阵表示沿对角线从左上角到右下角的所有栅格波段的方差，以及其余条目中所有栅格波段之间的协方差。 相关矩阵提供两个输入波段的每个组合之间的相关系数。
在协方差矩阵的计算中，波段的平均值可用于任何 NoData 输入像元。
当选中计算直方图参数时，直方图统计数据将添加至输出统计数据文件。 或者，如果指定输出直方图和输出直方图，则可以创建这些输出。
在输出直方图表中，l<n>_count 字段用于记录位于特定条柱范围中的图层 <n> 中的像元计数。 l<n>_percent 字段用于记录计数字段中报告的像元对于分析区域中图层 <n> 的像元总数的百分比。
统计数据将以逗号分隔值 (CSV) 格式或 Markdown 格式写入输出文件。 输出的扩展名必须为 .txt、.md、.csv 或 .asc。
除了直方图之外，此工具计算的所有统计数据都将显示在地理处理历史记录窗格中。 如果创建，则直方图和图表将显示在内容窗格的独立表中。 有关详细信息，请参阅在地图中使用独立表。
参数
BandCollectionStats(in_raster_bands, out_stat_file, {compute_matrices}, {compute_histogram}, {number_bins}, {out_histogram_table}, {out_histogram})| 名称 | 说明 | 数据类型 |
in_raster_bands [in_raster_band,...] | 输入栅格波段。 可为整型或浮点型。 | Raster Layer |
out_stat_file | 包含统计数据的输出文本或 Markdown 文件。 需要使用 .txt、.md、.csv 或 .asc 扩展名。 默认为 .txt。 除非指定 .md 扩展名，否则输出统计数据文件将使用 CSV 格式。 在本例中，输出文件将采用 Markdown 格式。 | File |
compute_matrices (可选) | 指定是否将计算协方差和相关矩阵。
| Boolean |
compute_histogram (可选) | 指定是否将计算直方图统计数据。
当此参数设置为 COMPUTE_HISTOGRAM 时，将支持 number_bins、out_histogram_table 和 out_histogram 参数。 当此参数设置为 NO_HISTOGRAM 时，将不支持其他参数。 | Boolean |
number_bins (可选) | 指定将用于直方图计算中的直方图条柱的数量。 默认值为 256。 最小允许值为 1。 最大允许值为 4096。 应根据输入数据和分析应用来设置此参数的值。 | Long |
out_histogram_table (可选) | 将包含所有输入波段的直方图统计数据的输出表。 表的格式由输出位置和路径确定。 默认情况下，如果在地理数据库工作空间中，则输出将是一个地理数据库表；如果在文件工作空间中，则输出将为 dBASE 表（.dbf 文件）。 要创建输出直方图表，必须将 compute_histogram 参数设置为 COMPUTE_HISTOGRAM。 | Table |
out_histogram (可选) | 用于显示的输出直方图的名称。 要创建输出直方图，必须指定 out_histogram_table 参数值。 | String |
代码示例
此示例可计算一组栅格波段的统计数据。
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
BandCollectionStats("redlands", "c:/sapyexamples/output/redbandstats.txt", "BRIEF", "COMPUTE_HISTOGRAM", "256", "c:/sapyexamples/output/outtable01.dbf", "histogram01")此示例可计算一组栅格波段的统计数据。
# 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"
outHistTable = "C:/sapyexamples/output/output.gdb/outtable01"
# Execute BandCollectionStats
BandCollectionStats([inRasterBand1, inRasterBand2], outStatFile, "DETAILED", "COMPUTE_HISTOGRAM", "256", outHistTable)许可信息
- Basic: 需要 Spatial Analyst
- Standard: 需要 Spatial Analyst
- Advanced: 需要 Spatial Analyst