Spatial Analyst のライセンスで利用可能。
サマリー
ラスター バンドの統計情報を計算します。
使用法
-
ラスター バンドは共通の交差部を持つ必要があります。ない場合は、エラーが発生し、出力は作成されません。
ラスター バンドの範囲が同じでない場合、すべての入力ラスター バンドの共通の空間範囲に対して統計情報が計算されます。デフォルトでは、セル サイズは入力ラスター バンドの最大セル サイズになります。それ以外の場合は、[ラスター解析] 環境設定によって変わります。
[共分散と相関行列を計算] パラメーターでデフォルトのオフの設定 (スクリプトでは BRIEF) を選択すると、入力ラスター バンドの最小値、最大値、平均値、および標準偏差のみが計算されます。これらの統計情報に加えて共分散と相関行列を計算するには、ツール ダイアログ ボックスでこのオプションをオンにします (または、スクリプトで DETAILED を使用します)。
共分散行列は、左上から右下の対角線に沿ったすべてのラスター バンドの分散と、残りのエントリにあるすべてのラスター バンド間の分散を提供します。相関行列は、2 つの入力バンドのそれぞれの組み合わせの相関係数を提供します。
共分散行列の計算では、NoData の入力セルに、バンドの平均値が使用されます。
統計情報は、ASCII テキスト形式の出力ファイルに書き込まれます。出力の拡張子は、「*.txt」にする必要があります。
-
入力が、4 バンド以上のマルチバンド ラスターから作成したレイヤーである場合、この操作では、レイヤーによって読み込まれた (シンボル表示された) 3 つのバンドだけでなく、ソース データセットに関連付けられたバンドがすべて考慮されます。
マルチバンド ラスターからバンドのサブセットを指定し、ツールの入力として使用するには、いくつかの方法があります。
- ツールのダイアログ ボックスを使用する場合は、[入力ラスター バンド] の横にある参照 ボタンを使用してマルチバンド ラスターを参照し、ラスターを開いて、使用するバンドを選択します。
- マルチバンド ラスターが [コンテンツ] ウィンドウ内のレイヤーである場合、[ラスター レイヤーの作成 (Make Raster Layer)] ツールを使用して、目的のバンドのみが含まれる新しいマルチバンド レイヤーを作成できます。
- [コンポジット バンド (Composite Bands)] を使用して、目的のバンドだけを含む新しいデータセットを作成し、結果のデータセットをツールの入力として使用することもできます。
- Python では、使用するバンドをツール パラメーターでリストとして直接指定できます。
構文
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 |
コードのサンプル
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")
環境
ライセンス情報
- ArcGIS Desktop Basic: 次のものが必要 Spatial Analyst
- ArcGIS Desktop Standard: 次のものが必要 Spatial Analyst
- ArcGIS Desktop Advanced: 次のものが必要 Spatial Analyst