摘要

　　計算一組柵格波段的統計資訊。

　　用法

　　· 柵格波段必須具有一個公共交集。如果不存在公共交集，則會出現錯誤，且不會建立任何輸出。

　　· 如果柵格波段的範圍不同，統計資料將以所有輸入柵格波段的共同的空間範圍來計算。預設情況下，像元大小為輸入柵格的最大像元的大小;否則，將取決於柵格分析環境設定。

　　· 計算矩陣引數(在指令碼中為 BRIEF，在工具對話方塊中為未選中狀態)的預設設定是僅計算輸入柵格波段的最小值、最大值、平均值以及標準差。要計算這些統計資料以及其協方差和相關矩陣，需要在指令碼中將引數設定為 DETAILED，或在工具對話方塊中選中。協方差矩陣列出所有沿左上到右下的對角線的所有柵格波段的方差，以及剩餘條目中所有柵格波段間的協方差。相關矩陣提供每兩個輸入波段對的相關係數。

　　· 在協方差矩陣的計算中，每個波段的平均值用於任何 NoData 輸入像元。

　　· 統計資料以 ASCII 文字格式寫入輸出檔案。該輸出的副檔名必須為 .txt。

　　· 如果輸入為建立自多波段柵格(超過三個波段)的圖層，則操作將會考慮與源資料集相關聯的所有波段，而不僅僅是由圖層載入(符號化)的三個波段。

　　· 您可以使用多種方式將多波段柵格的波段子集指定為工具的輸入。

　　· 如果要使用工具對話方塊，則通過輸入柵格波段旁邊的按鈕導航至多波段柵格，開啟柵格並選擇所需波段。

　　· 如果多波段柵格是內容列表中的圖層，則可以使用建立柵格圖層工具來建立一個新的只包含所需波段的多波段圖層。

　　· 您還可以用波段合成來建立一個只包含所需波段的新資料集，並將生成的資料集用作工具的輸入。

　　· 在 Python 中，可以在工具引數中以列表形式直接指定所需波段。

　　語法

　　BandCollectionStats (in_raster_bands, out_stat_file, {compute_matrices})

　　程式碼例項

　　波段集統計 (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"

　　# Check out the ArcGIS Spatial Analyst extension license

　　arcpy.checkOutExtension("Spatial")

　　# Execute BandCollectionStats

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