波段集统计 (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。
除了直方图之外，此工具计算的所有统计数据都将显示在地理处理历史记录窗格中。如果创建，则直方图表和图表将显示在内容窗格的独立表中。有关详细信息，请参阅在地图中使用独立表。

标注	说明	数据类型
输入栅格波段	输入栅格波段。可为整型或浮点型。	Raster Layer
输出统计数据文件	包含统计数据的输出文本或 Markdown 文件。需要使用 `.txt`、`.md`、`.csv` 或 `.asc` 扩展名。默认值为 `.txt`。除非指定 `.md` 扩展名，否则输出统计数据文件将使用 CSV 格式。在本例中，输出文件将采用 Markdown 格式。	File
计算协方差和相关矩阵（可选）	指定是否将计算协方差和相关矩阵。选中—除了未选中此参数时计算的基础统计度量之外，还将计算协方差和相关矩阵。未选中—- 仅计算每个图层的基本统计测量值（最小值、最大值、平均值和标准差）。这是默认设置。	Boolean
计算直方图（可选）	指定是否将计算直方图统计数据。当选中此参数时，将支持直方图条柱的数量、输出直方图表和输出直方图名称参数。当未选中此参数时，将不支持这些其他参数。选中—将计算直方图统计数据。未选中—将不会计算直方图统计数据。这是默认设置。	Boolean
直方图条柱的数量（可选）	指定将用于直方图计算中的直方图条柱的数量。默认值为 256。最小允许值为 1。最大允许值为 4096。应根据输入数据和分析应用来设置此参数的值。	Long
输出直方图表（可选）	将包含所有输入波段的直方图统计数据的输出表。表的格式由输出位置和路径确定。默认情况下，如果在地理数据库工作空间中，则输出将是一个地理数据库表；如果在文件工作空间中，则输出将为 dBASE 表（`.dbf` 文件）。要创建输出直方图表，必须选中计算直方图参数。	Table
输出直方图名称（可选）	用于显示的输出直方图的名称。将在内容窗格的独立表下列出直方图。要创建输出直方图，必须指定输出直方图表参数值。	String

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 （可选）	指定是否将计算协方差和相关矩阵。 `DETAILED`—除了使用 `BRIEF` 选项计算基础统计度量之外，还将计算协方差和相关矩阵。 `BRIEF`—- 仅计算每个图层的基本统计测量值（最小值、最大值、平均值和标准差）。这是默认设置。	Boolean
compute_histogram （可选）	指定是否将计算直方图统计数据。当此参数设置为 `COMPUTE_HISTOGRAM` 时，将支持 `number_bins`、`out_histogram_table` 和 `out_histogram` 参数。当此参数设置为 `NO_HISTOGRAM` 时，将不支持其他参数。 `COMPUTE_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

代码示例

BandCollectionStats 示例 1（Python 窗口）

此示例可计算一组栅格波段的统计数据。

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")

BandCollectionStats 示例 2（独立脚本）

此示例可计算一组栅格波段的统计数据。

# 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"

# Run BandCollectionStats
BandCollectionStats([inRasterBand1, inRasterBand2], outStatFile, "DETAILED", "COMPUTE_HISTOGRAM", "256", outHistTable)

环境

像元大小, 像元大小投影方法, 当前工作空间, 范围, 地理变换, 掩膜, 输出坐标系, 并行处理因子, 临时工作空间, 捕捉栅格

许可信息

基本: 需要 Spatial Analyst
标准: 需要 Spatial Analyst
高级: 需要 Spatial Analyst

波段集统计 (Spatial Analyst 工具)

汇总

用法

参数

环境

许可信息

相关主题