フォーカル統計(Focal Statistics) (Spatial Analyst)

サマリ

各入力セル位置について、指定した近傍内の値の統計情報を計算します。

[フォーカル統計(Focal Statistics)] ツールの仕組みの詳細

Focal Statistics illustration
OutRas = FocalStatistics(InRas1, NbrRectangle(3,3,MAP), "SUM", "")

使用法

構文

FocalStatistics (in_raster, {neighborhood}, {statistics_type}, {ignore_nodata})
パラメータ説明データ タイプ
in_raster

フォーカル統計計算を実行するラスタ。

Raster Layer
neighborhood
(オプション)

Neighborhood クラスは、統計情報の計算に使用する各セル周辺のエリアの形状を指定します。

利用可能な近傍のタイプは、NbrAnnulusNbrCircleNbrRectangleNbrWedgeNbrIrregularNbrWeight です。

近傍の形式は以下のとおりです。

  • NbrAnnulus({内径}, {外径}, {CELL | MAP})
  • NbrCircle({半径}, {CELL | MAP}
  • NbrRectangle ({幅}, {高さ}, {CELL | MAP})
  • NbrWedge ({半径}, {開始角度}, {終了角度}, {CELL | MAP})
  • NbrIrregular(カーネル ファイル)
  • NbrWeight(カーネル ファイル)

{CELL | MAP} パラメータは距離単位をセル単位またはマップ単位と定義します。

デフォルトの近傍は、幅と高さが 3 x 3 セルの正方形の NbrRectangle です。

Neighborhood
statistics_type
(オプション)

計算する統計情報の種類。

  • MEAN 近傍のセルの平均値を計算します。
  • MAJORITY 近傍のセルの最頻値(最も頻繁に発生する値)を計算します。
  • MAXIMUM 近傍のセルの最大値を計算します。
  • MEDIAN 近傍のセルの中央値を計算します
  • MINIMUM 近傍のセルの最小値を計算します。
  • MINORITY 近傍のセルの最小頻値(発生数が最も少ない値)を計算します。
  • RANGE 近傍のセルの範囲(最大値と最小値の差)を計算します。
  • STD 近傍のセルの標準偏差を計算します。
  • SUM 近傍のセルの合計値(すべての値の合計)を計算します。
  • VARIETY 近傍のセルの種類(個別値の数)を計算します。

デフォルトの統計情報タイプは [MEAN] です。

String
ignore_nodata
(オプション)

統計計算で NoData 値を無視するかどうかを示します。

  • DATA 近傍内に NoData 値が存在する場合、NoData 値を無視します。出力値の計算には、近傍内のデータ値を持つセルだけが使用されます。これがデフォルトです。
  • NODATA近傍内に NoData 値のセルが存在する場合、処理セルの出力は NoData になります。このオプションを選択した場合、NoData 値が存在すると、近傍の統計値を決定するのに十分な情報がないことを意味します。
Boolean

リターン

名前説明データ タイプ
out_raster

出力フォーカル統計ラスタ。

Raster

コードのサンプル

FocalStatistics(フォーカル統計)の例 1(Python ウィンドウ)

次の例では、入力ラスタの各セルについて、ドーナツ形状の近傍内の最少頻値を計算しています。


import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outFocalStat = FocalStatistics("elevation", NbrAnnulus(5, 10, "CELL"), 
                               "MINORITY", "NODATA")
outFocalStat.save("C:/sapyexamples/output/focalstat01")
FocalStatistics(フォーカル統計)の例 2(スタンドアロン スクリプト)

次の例では、入力ラスタの各セルについて、10 x 10 の近傍内の最少頻値を判定しています。

# Name: FocalStatistics_Ex_02.py
# Description: Calculates a statistic on a raster over a specified
#    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 = "elevation"
neighborhood = NbrRectangle(10, 10, "CELL")

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute FocalStatistics
outFocalStatistics = FocalStatistics(inRaster, neighborhood, "MINORITY",
                                     "")

# Save the output 
outFocalStatistics.save("C:/sapyexamples/output/focalstatout")

環境

関連項目

ライセンス情報

ArcView: 必須 Spatial Analyst
ArcEditor: 必須 Spatial Analyst
ArcInfo: 必須 Spatial Analyst

7/10/2012