ブロック統計 (Block Statistics) (Spatial Analyst)

Spatial Analyst のライセンスで利用可能。

概要

入力を重複しないブロックに分割し、各ブロック内での値の統計情報を計算します。算出されたそれぞれのブロックにおける値は、出力の各ブロック内にあるすべてのセルに割り当てられます。

ブロック統計 (Block Statistics) ツールの詳細

図

OutRas = BlockStatistics(InRas1, NbrRectangle(3,3,MAP), "MAXIMUM", "")

使用法

• 入力ラスターが浮動小数点の場合は、平均値、最大値、最小値、範囲、標準偏差、合計の統計情報が使用できます。最頻値、最少頻値、平均値、種類の統計情報は計算されません。入力ラスターが整数の場合、すべての統計情報が使用できます。

• 入力ラスターが浮動小数点タイプの場合、出力は、すべての統計情報の種類で浮動小数になります。

  入力ラスターが整数の場合、ほとんどの統計情報の種類の出力は整数になります。統計の種類が [平均] と [標準偏差] の出力は、必ず浮動小数点になります。

• 円形、ドーナツ形、または扇形の近傍が指定された場合、近傍のサイズによっては、X 軸または Y 軸と垂直でないセルは計算に考慮されません。ただし、これらのセル位置は、これら円形の近傍タイプの最小境界範囲 (出力ブロック) 内にあるため、近傍の計算から得た値を受け取ります。

• [近傍解析] の種類が [不規則] および [加重] の場合、[カーネル ファイル] を指定する必要があります。カーネル ファイルの拡張子は「.txt」にします。

  カーネル ファイルの作成と使用の詳細については、「[ブロック統計 (Block Statistics)] ツールの詳細」の不規則/加重のセクションをご参照ください。

• 統計情報の種類が [中間値] のとき、ブロック内のセルの数が奇数の場合、値はランク付けされ、中央の値 (整数) が平均値として報告されます。ブロック内のセルの数が偶数の場合、値はランク付けされ、中央の 2 つの値の平均値に最も近い整数となります。

• 統計情報の種類が [最頻値] のとき、単一の最頻値がない場合、つまりブロック内でその値を持つセルが最も多いという値が複数ある場合、セルには NoData が割り当てられます。統計情報の種類が [最少頻値] のとき、単一の最頻値のない場合のセルにも NoData が割り当てられます。

• [統計の種類] が [平均]、[最少頻値]、[標準偏差]、[合計] の場合、[近傍解析] の種類を [加重] に設定できます。

• このツールに適用されるジオプロセシング環境の詳細については、「解析環境と Spatial Analyst」をご参照ください。

構文

BlockStatistics(in_raster, {neighborhood}, {statistics_type}, {ignore_nodata})

パラメーター	説明	データ タイプ
in_raster	ブロック統計の計算を実行するラスター。	Raster Layer
neighborhood (オプション)	Neighborhood クラスは、統計情報の計算に使用する各セル周辺のエリアの形状を指定します。 使用できる近傍タイプは、NbrAnnulus、NbrCircle、NbrRectangle、NbrWedge、NbrIrregular,、NbrWeight です。 近傍の形式は以下のとおりです。 NbrAnnulus({innerRadius}, {outerRadius}, {units}) NbrCircle({radius}, {units} NbrRectangle({width}, {height}, {units}) NbrWedge({radius}, {startAngle}, {endAngle}, {units}) NbrIrregular(inKernelFile) NbrWeight(inKernelFile) デフォルトの近傍は、幅と高さが 3 x 3 セルの正方形の NbrRectangle です。	Neighborhood
statistics_type (オプション)	計算する統計情報の種類を指定します。 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 ウィンドウ)

次のサンプルでは、入力 GRID ラスター内で重複していない各ドーナツ形状の近傍内における最小セル値を算出しています。

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

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