Spatial Analyst のライセンスで利用可能。
概要
各入力セル位置について、指定した近傍内の値の統計情報を計算します。
図
使用法
入力ラスターが整数の場合、すべての統計情報が使用できます。入力ラスターが浮動小数点の場合は、平均値、最大値、平均値、最小値、パーセンタイル、範囲、標準偏差、合計の統計情報だけが使用できます。最頻値、最少頻値、種類の統計情報は計算されません。
円形、ドーナツ形、または扇形の近傍が指定された場合、セルの中心は近傍に囲まれている必要があるため、一部の外側の対角セルは、計算に考慮されない場合があります。
[近傍解析] の種類が [不規則] および [加重] の場合、[カーネル ファイル] を指定する必要があります。カーネル ファイルの拡張子は「.txt」にします。
カーネル ファイルの作成と使用の詳細については、「フォーカル統計 (Focal Statistics) ツールの詳細」の不規則/加重のセクションをご参照ください。
[近傍] タイプは、平均値、標準偏差、および合計値の統計情報の種類でのみ [加重] を設定できます。
近傍内のセルのうち最低 1 つが有効な値を持つ場合、[計算時に NoData を除外] パラメーターをオンにすると、入力 NoData セルは、出力に値を受け取る場合があります。
このツールに適用されるジオプロセシング環境の詳細については、「解析環境と Spatial Analyst」をご参照ください。
構文
FocalStatistics(in_raster, {neighborhood}, {statistics_type}, {ignore_nodata}, {percentile_value})
パラメーター | 説明 | データ タイプ |
in_raster | フォーカル統計を計算するラスター。 | Raster Layer |
neighborhood (オプション) | Neighborhood クラスは、統計情報の計算に使用する各セル周辺のエリアの形状を指定します。 使用できる近傍タイプは、NbrAnnulus、NbrCircle、NbrRectangle、NbrWedge、NbrIrregular,、NbrWeight です。 近傍の形式は以下のとおりです。
デフォルトの近傍は、幅と高さが 3 x 3 セルの正方形の NbrRectangle です。 | Neighborhood |
statistics_type (オプション) | 計算する統計情報の種類を指定します。
デフォルトの統計情報タイプは [MEAN] です。 入力ラスターが整数の場合、すべての統計情報が使用できます。入力ラスターが浮動小数点数の場合、使用できる統計情報は、[MEAN]、[MAXIMUM]、[MEDIAN]、[MINIMUM]、[PERCENTILE]、[RANGE]、[STD]、および [SUM] のみです。 | String |
ignore_nodata (オプション) | 統計計算で NoData 値を無視するかどうかを指定します。
| Boolean |
percentile_value (オプション) | 計算するパーセンタイル。デフォルトは 90 です。これは、90 番目のパーセンタイルです。 値の範囲は 0 ~ 100 です。0 番目のパーセンタイルは、基本的に最小値の統計情報と同じであり、100 番目のパーセンタイルは最大値と同じです。値が 50 の場合、基本的に中央値の統計情報と同じ結果になります。 このオプションは、statistics_type パラメーターが percentile に設定されている場合のみ適用されます。 | Double |
戻り値
名前 | 説明 | データ タイプ |
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")
環境
ライセンス情報
- Basic: 次のものが必要 Spatial Analyst
- Standard: 次のものが必要 Spatial Analyst
- Advanced: 次のものが必要 Spatial Analyst