ポイント統計(Point Statistics) (Spatial Analyst)

ライセンス レベル:BasicStandardAdvanced

サマリ

各出力セルの近傍内にあるポイントの統計情報を計算します。

[ポイント統計(Point Statistics)] ツールの仕組みの詳細

使用法

構文

PointStatistics (in_point_features, field, {cell_size}, {neighborhood}, {statistics_type})
パラメータ説明データ タイプ
in_point_features

各出力セルの近傍内の統計情報を計算する入力ポイント フィーチャ。

入力は、ポイントとマルチポイント フィーチャクラスが使用できます。

Feature Layer
field

フィールドは、入力ポイント フィーチャの任意の数値フィールドにできます。

入力フィーチャが Z 値を含む場合、Shape フィールドを使用できます。

Field
cell_size
(オプション)

出力ラスタ データセットのセル サイズ

環境設定で特定の値が指定されている場合、その値を使用します。設定されていない場合は、出力空間参照において、入力フィーチャ データセットの範囲の幅または高さ(どちらか短い方)を 250 で割った値になります。

Analysis Cell Size
neighborhood
(オプション)

Neighborhood クラスは、統計情報の計算に使用する各入力ポイント周辺のエリアの形状を指定します。

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

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

  • NbrAnnulus({内径}, {外径}, {CELL | MAP})
  • NbrCircle({半径}, {CELL | MAP}
  • NbrRectangle ({幅}, {高さ}, {CELL | MAP})
  • NbrWedge ({半径}, {開始角度}, {終了角度}, {CELL | MAP})

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

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

Neighborhood
statistics_type
(オプション)

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

計算は、各出力ラスタ セルの近傍内にあるポイント入力の指定したフィールド値に対して実行されます。

  • MEAN 各近傍のフィールド値の平均値を計算します。
  • MAJORITY 各近傍内で最もよく起きるフィールドを求めます。同数の値が複数ある場合、低い値が使用されます。
  • MAXIMUM 各近傍の最大値を求めます。
  • MEDIAN 各近傍の中央フィールド値を求めます。近傍内に存在するポイントが偶数である場合、2 つの中間値の小さい方が結果になります。
  • MINIMUM 各近傍の最小フィールド値を求めます。
  • MINORITY 各近傍内での最少フィールド頻値を判別します。同数の値が複数ある場合、低い値が使用されます。
  • RANGE 各近傍のフィールド値の範囲(最大と最小の差)を計算します。
  • STD 各近傍のフィールド値の標準偏差を計算します。
  • SUM 各近傍のフィールド値の合計を計算します。
  • VARIETY 各近傍の一意のフィールド値の数を計算します。
String

戻り値

名前説明データ タイプ
out_raster

出力ポイント統計ラスタ。

Raster

コードのサンプル

PointStatistics(ポイント統計)の例 1(Python ウィンドウ)

次の例では、各出力ラスタ セルの円形の近傍内にある入力シェープファイル ポイント フィーチャの統計情報(合計値)を求めています。

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outPointStats = PointStatistics("ca_ozone_pts.shp", "OZONE", 500, 
                                NbrCircle(10000, "MAP"), "SUM")
outPointStats.save("C:/sapyexamples/output/pointstatsout")
PointStatistics(ポイント統計)の例 2(スタンドアロン スクリプト)

次の例では、各出力ラスタ セルの円形の近傍内にある入力シェープファイル ポイント フィーチャの統計情報(平均値)を求めています。

# Name: PointStatistics_Ex_02.py
# Description: Calculates a statistic on points over a specified 
#    neighborhood outputting a raster.
# 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
inPointFeatures = "ca_ozone_pts.shp"
field = "OZONE"
cellSize = 500
neighborhood = NbrCircle(6000, "MAP")

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

# Execute PointStatistics
outPointStatistics = PointStatistics(inPointFeatures, field, cellSize,
                                     neighborhood, "MEAN")

# Save the output 
outPointStatistics.save("C:/sapyexamples/output/pointstatout")

環境

関連トピック

ライセンス情報

ArcGIS for Desktop Basic: 次のものが必要 Spatial Analyst
ArcGIS for Desktop Standard: 次のものが必要 Spatial Analyst
ArcGIS for Desktop Advanced: 次のものが必要 Spatial Analyst
9/17/2013