波段集统计 (Spatial Analyst)

需要 Spatial Analyst 许可。

摘要

计算一组栅格波段的统计数据。

了解有关“波段集统计”工作原理的详细信息

使用情况

  • 将多波段栅格指定为输入栅格波段(Python 中的 in_raster_bands)之一时,将使用所有波段。

    要处理一系列来自多波段栅格的波段,可先用波段合成工具创建由这些特定波段组成的新栅格数据集,并在输入栅格波段(Python 中的 in_raster_bands)列表中使用该结果。

  • 栅格波段必须具有一个公共交集。 如果不存在公共交集,则会出现错误,且不会创建任何输出。

  • 如果栅格波段的范围不同,则统计数据将根据所有输入栅格波段的公共空间范围进行计算。 像元大小将是输入栅格的最大值。

  • 对于计算协方差和相关矩阵参数,默认未选中设置(脚本中的 BRIEF)表明将仅计算输入栅格波段的最小值、最大值、平均值以及标准差。 除了计算这些统计数据以外,要计算协方差和相关矩阵,请选中工具对话框中的此选项(或使用脚本中的 DETAILED)。

    协方差矩阵表示沿对角线从左上角到右下角的所有栅格波段的方差,以及其余条目中所有栅格波段之间的协方差。 相关矩阵提供两个输入波段的每个组合之间的相关系数。

  • 在协方差矩阵的计算中,波段的平均值可用于任何 NoData 输入像元。

  • 统计信息以 ASCII 文本格式写入输出文件。 该输出的扩展名必须为 .txt

参数

标注说明数据类型
输入栅格波段

输入栅格波段。

可为整型或浮点型。

Raster Layer
输出统计文件

包含统计信息的输出 ASCII 文件。

需要使用 .txt 扩展名。

File
计算协方差和相关矩阵
(可选)

指定是否计算协方差和相关矩阵。

  • 未选中 - 仅计算每个图层的基本统计测量值(最小值、最大值、平均值和标准差)。 这是默认设置。
  • 选中 - 除了计算的标准统计量外,还将确定协方差和相关矩阵。
Boolean

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
(可选)

指定是否计算协方差和相关矩阵。

  • BRIEF- 仅计算每个图层的基本统计测量值(最小值、最大值、平均值和标准差)。 这是默认设置。
  • DETAILED- 除了使用 {BRIEF} 计算的标准统计量外,还将确定协方差和相关矩阵。
Boolean

代码示例

BandCollectionStatistics 示例 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")
BandCollectionStatistics 示例 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"

# Execute BandCollectionStats
BandCollectionStats([inRasterBand1, inRasterBand2], outStatFile, "DETAILED")

许可信息

  • Basic: 需要 Spatial Analyst
  • Standard: 需要 Spatial Analyst
  • Advanced: 需要 Spatial Analyst

相关主题