ブロック統計 (Spatial Analyst ツール)
サマリー
入力を重複しないブロックに分割し、各ブロック内での値の統計を計算します。 算出されたそれぞれのブロックにおける値は、出力の各ブロック内にあるすべてのセルに割り当てられます。
ブロック統計ツールの詳細
図
OutRas = BlockStatistics(InRas1, NbrRectangle(3,3,"CELL"), "MAXIMUM", "DATA")
使用法
さまざまな近傍の形状と統計の種類から選択できます。 選択できる統計は、入力ラスターのタイプによって異なります。
使用できる近傍形状は、ドーナツ型 (ドーナツまたはリング)、円、四角形、扇形です。 カスタム近傍形状はカーネル ファイルを使用して定義できます。
円形、ドーナツ形、または扇形の近傍が指定された場合、近傍のサイズによっては、X 軸または Y 軸と垂直でないセルは計算に考慮されません。 ただし、これらのセル位置は、これら円形の近傍タイプの最小境界範囲 (出力ブロック) 内にあるため、近傍の計算から得た値を受け取ります。
近傍 の種類が不規則および加重の場合、カーネル ファイル の値を指定する必要があります。 カーネル ファイルは、近傍の値と形状を指定する ASCII テキスト ファイルです。 ファイルは任意のプレーン テキスト エディターで作成できます。 ファイルには .txt 拡張子を付ける必要があり、ファイル名にスペースを含めることはできません。
カーネル ファイルの作成と使用の詳細については、ブロック統計 (Block Statistics) ツールの仕組み の不規則/加重のセクションをご参照ください。
整数の入力ラスターの場合、統計の種類 に有効な選択肢は、最頻値、最大、平均、中央値、最小、最少頻値、範囲、標準偏差、合計、および種類です。 浮動小数の入力ラスターの場合、有効な統計情報は、最大、平均、最小、範囲、標準偏差、および合計です。 最頻値、中央値、最少頻値、および種類は使用できません。
入力ラスターが整数の場合、出力ラスターは、最頻値、最大、中央値、最小、最少頻値、範囲、合計、および種類で整数になります。 出力値は、平均および標準偏差で浮動小数になります。
入力ラスターのデータ タイプが浮動小数点数の場合は、使用可能なすべての統計の種類で出力ラスターも浮動小数点数になります。
中央値の計算で、ブロック近傍内のセルの数が奇数の場合は、これらの値がランク付けされ、中央の値が中央値として報告されます。 ブロック内のセルの数が偶数の場合は、これらの値がランク付けされ、中央の 2 つの値のうち小さい方の値が選択されます。
最頻値と最少頻値の計算では、同一頻度の値が複数ある場合、同一頻度の値の中で最も小さい値が出力されます。
近傍 パラメーターは、統計の種類が 平均、標準偏差、および 合計 の場合にのみ、加重 に設定できます。
このツールに適用されるジオプロセシング環境の詳細については、解析環境と Spatial Analyst をご参照ください。
パラメーター
|
ラベル
|
説明
|
データ タイプ
|
|
入力ラスター
|
セルのブロックの統計が計算されるラスター。
|
Raster Layer
|
|
近傍
(オプション)
|
統計の計算に使用される処理ブロックのセルです。 さまざまな定義済みの近傍タイプから選択できます。または、カスタム カーネルを定義できます。
近傍タイプを選択すると、他のパラメーターを設定して、計測の形状、サイズ、単位を完全に定義できます。 デフォルトの近傍は、幅と高さが 3 x 3 セルの正方形です。
使用可能な近傍タイプの形式を次に示します。
ドーナツ型、内部半径、外部半径、単位の種類
内径および外径で定義されるリング (ドーナツ形状) の近傍。 半径の最小値は 1 セルで、外径は内径より大きい必要があります。 内径の最大値は 2046 セル、外径の最大値は 2047 セルです。 デフォルトのドーナツ型の内径は 1 セル、外径は 3 セルです。
円形、半径、単位の種類
指定した半径の円形の近傍。 半径の最小値は 1 セル、最大値は 2,047 セルです。 デフォルトの半径は 3 セルです。
四角形、高さ、幅、単位の種類
幅と高さで定義される四角形の近傍。 幅または高さの最小値は 1 セル、最大値は 4096 セルです。 デフォルトは、幅と高さが 3 x 3 セルの正方形です。
扇型、半径、始点角度、終点角度、単位の種類
扇形の近傍は、半径、開始角度、終了角度によって定義されます。 半径の最小値は 1 セル、最大値は 2,047 セルです。 扇形の角度は、反時計回りです。 角度は度で指定し、0 または 360 が東を表します。 負の角度も使用できます。 デフォルトの扇形は 0 〜 90 度で半径は 3 セルです。
不規則、カーネル ファイル
特定されたカーネル テキスト ファイルで仕様を設定するカスタム近傍です。 カーネルの幅または高さの最小値は 1 セル、最大値は 4096 セルです。
加重、カーネル ファイル
特定されたカーネル テキスト ファイルで仕様を設定するカスタム近傍です。近傍のメンバーに加重を適用します。 カーネルの幅または高さの最小値は 1 セル、最大値は 4096 セルです。
ドーナツ型、円形、四角形、扇形の近傍タイプの場合、パラメーターの距離単位は、セル 単位または マップ 単位で指定できます。 セル単位がデフォルトです。
カーネル近傍の場合、カーネル ファイルの最初の行は、セル数の近傍の幅と高さを定義します。 次の行は、カーネル内でその位置に対応する入力値の処理方法を示しています。 不規則な近傍または重み付けされた近傍のカーネル ファイルの値が 0 の場合、対応する位置が計算に含まれないことを示しています。 不規則な近傍のカーネル ファイルの値が 1 の場合、対応する入力セルが演算に含まれることを示しています。 重み付けされた近傍の各位置の値は、対応する入力セル値に乗算する数値を示しています。 正の値、負の値、および 10 進数値を使用できます。
|
Neighborhood
|
|
統計の種類
(オプション)
|
計算する統計の種類を指定します。
デフォルトの統計情報タイプは 平均 です。
入力ラスターが整数の場合、すべての統計の種類が使用できます。 入力ラスターが浮動小数点数の場合、使用できる統計の種類は、平均、最大、最小、範囲、標準偏差、および 合計 のみです。
平均—近傍のセルの平均値が計算されます。
最頻値—近傍のセルの最頻値 (最も頻繁に発生する値) が特定されます。
最大—近傍のセルの最大値が特定されます。
中央値—近傍のセルの中央値が計算されます。
最小—近傍のセルの最小値が特定されます。
最少頻値—近傍のセルの最少頻値 (発生数が最も少ない値) が特定されます。
範囲—近傍のセルの範囲 (最大値と最小値の差) が計算されます。
標準偏差—近傍のセルの標準偏差が計算されます。
合計—近傍のセルの合計値が計算されます。
種類—近傍のセルの種類 (個別値の数) が計算されます。
|
String
|
|
計算時に NoData を除外
(オプション)
|
統計計算で NoData 値を無視するかどうかを指定します。
|
Boolean
|
戻り値
|
ラベル
|
説明
|
データ タイプ
|
|
出力ラスター
|
出力ブロック統計ラスター。
|
Raster
|
BlockStatistics(in_raster, {neighborhood}, {statistics_type}, {ignore_nodata})
|
名前
|
説明
|
データ タイプ
|
|
in_raster
|
セルのブロックの統計が計算されるラスター。
|
Raster Layer
|
|
neighborhood
(オプション)
|
統計の計算に使用される処理ブロックのセルです。 さまざまな定義済みの近傍タイプから選択できます。または、カスタム カーネルを定義できます。
近傍タイプを選択すると、他のパラメーターを設定して、計測の形状、サイズ、単位を完全に定義できます。 デフォルトの近傍は、幅と高さが 3 x 3 セルの正方形です。
近傍の形状は、Neighborhood クラスによって定義されます。 使用できる近傍タイプは、NbrAnnulus、NbrCircle、NbrRectangle、NbrWedge、NbrIrregular ,、および NbrWeight です。
使用可能な近傍タイプの形式を次に示します。
NbrAnnulus({innerRadius}, {outerRadius}, {units})
内径および外径で定義されるリング (ドーナツ形状) の近傍。 半径の最小値は 1 セルで、外径は内径より大きい必要があります。 内径の最大値は 2046 セル、外径の最大値は 2047 セルです。 デフォルトのドーナツ型の内径は 1 セル、外径は 3 セルです。
NbrCircle({radius}, {units}
指定した半径の円形の近傍。 半径の最小値は 1 セル、最大値は 2,047 セルです。 デフォルトの半径は 3 セルです。
NbrRectangle({width}, {height}, {units})
幅と高さで定義される四角形の近傍。 幅または高さの最小値は 1 セル、最大値は 4096 セルです。 デフォルトは、幅と高さが 3 x 3 セルの正方形です。
NbrWedge({radius}, {startAngle}, {endAngle}, {units})
扇形の近傍は、半径、開始角度、終了角度によって定義されます。 半径の最小値は 1 セル、最大値は 2,047 セルです。 扇形の角度は、反時計回りです。 角度は度で指定し、0 または 360 が東を表します。 負の角度も使用できます。 デフォルトの扇形は 0 〜 90 度で半径は 3 セルです。
NbrIrregular(inKernelFile)
特定されたカーネル テキスト ファイルで仕様を設定するカスタム近傍です。 カーネルの幅または高さの最小値は 1 セル、最大値は 4096 セルです。
NbrWeight(inKernelFile)
特定されたカーネル テキスト ファイルで仕様を設定するカスタム近傍です。近傍のメンバーに加重を適用します。 カーネルの幅または高さの最小値は 1 セル、最大値は 4096 セルです。
NbrAnnulus、Nbrcircle、NbrRectangle、NbrWedge の近傍の場合、パラメーターの距離単位は CELL 単位または MAP 単位で指定できます。 セル単位がデフォルトです。
カーネル近傍の場合、カーネル ファイルの最初の行は、セル数の近傍の幅と高さを定義します。 次の行は、カーネル内でその位置に対応する入力値の処理方法を示しています。 不規則な近傍または重み付けされた近傍のカーネル ファイルの値が 0 の場合、対応する位置が計算に含まれないことを示しています。 不規則な近傍のカーネル ファイルの値が 1 の場合、対応する入力セルが演算に含まれることを示しています。 重み付けされた近傍の各位置の値は、対応する入力セル値に乗算する数値を示しています。 正の値、負の値、および 10 進数値を使用できます。
|
Neighborhood
|
|
statistics_type
(オプション)
|
計算する統計の種類を指定します。
デフォルトの統計情報タイプは MEAN です。
入力ラスターが整数の場合、すべての統計の種類が使用できます。 入力ラスターが浮動小数点数の場合、使用できる統計の種類は、MEAN、MAXIMUM、MINIMUM、RANGE、STD、および SUM のみです。
MEAN—近傍のセルの平均値が計算されます。
MAJORITY—近傍のセルの最頻値 (最も頻繁に発生する値) が特定されます。
MAXIMUM—近傍のセルの最大値が特定されます。
MEDIAN—近傍のセルの中央値が計算されます。
MINIMUM—近傍のセルの最小値が特定されます。
MINORITY—近傍のセルの最少頻値 (発生数が最も少ない値) が特定されます。
RANGE—近傍のセルの範囲 (最大値と最小値の差) が計算されます。
STD—近傍のセルの標準偏差が計算されます。
SUM—近傍のセルの合計値が計算されます。
VARIETY—近傍のセルの種類 (個別値の数) が計算されます。
|
String
|
|
ignore_nodata
(オプション)
|
統計計算で NoData 値を無視するかどうかを指定します。
DATA—ブロックの近傍内に NoData 値が存在する場合、NoData 値を無視します。 出力値の計算には、近傍内のデータ値を持つセルだけが使用されます。 これがデフォルトです。
NODATA—ブロック近傍内に NoData 値のセルが存在する場合、対応するブロック内の各セルの出力は NoData になります。 NoData 値が存在すると、近傍の統計値を決定するのに十分な情報がないことを意味します。
|
Boolean
|
戻り値
|
名前
|
説明
|
データ タイプ
|
|
out_raster
|
出力ブロック統計ラスター。
|
Raster
|
コードのサンプル
BlockStatistics 例 1 (Python ウィンドウ)
次のサンプルでは、入力ラスター内で重複していない各ドーナツ形状の近傍内における最小セル値を算出しています。
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
nbr = NbrAnnulus(1, 3, "MAP")
outBlockStat = BlockStatistics("block", nbr, "MINIMUM", "")
outBlockStat.save("C:/sapyexamples/output/blockstat")
BlockStatistics 例 2 (スタンドアロン スクリプト)
次のサンプルでは、入力 GRID ラスター内で重複していない各ドーナツ形状の近傍内における最小セル値を算出しています。
# Name: BlockStatistics_Ex_02.py
# Description: Calculates statistics for a nonoverlapping
# neighborhood.
# 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
inRaster = "block"
nbr = NbrAnnulus(1, 3, "MAP")
# Run BlockStatistics
outBlockStat = BlockStatistics(inRaster, nbr, "MINIMUM", "NODATA")
# Save the output
outBlockStat.save("C:/sapyexamples/output/blockstat")
環境
自動コミット, セル サイズ, セル サイズ投影法, 圧縮, 現在のワークスペース, 範囲, 地理座標系変換, マスク, 出力データのコンフィグレーション キーワード, 出力座標系, スクラッチ ワークスペース, スナップ対象ラスター, タイル サイズ
ライセンス情報
- Basic: Spatial Analyst が必要
- Standard: Spatial Analyst が必要
- Advanced: Spatial Analyst が必要