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

サマリー

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

ポイント統計ツールの仕組みの詳細

使用法

• さまざまな近傍の形状と統計情報の種類から選択できます。 使用できる統計情報の選択は、指定したフィールドのタイプによって決定されます。

• 整数フィールドの場合、[統計の種類] に有効な選択肢は、最頻値、最大、平均、中央値、最小、最少頻値、範囲、標準偏差、合計、および種類です。 浮動小数のフィールドの場合、有効な統計情報は、最大、平均、最小値、範囲、標準偏差、および合計です。 最頻値、最少頻値、および種類は使用できません。

• フィールド タイプが整数の場合、出力ラスターは、最頻値、最大、中央値、最小、最少頻値、範囲、合計、および種類で整数になります。 出力値は、平均および標準偏差で浮動小数になります。

  フィール タイプが浮動小数の場合、出力ラスターは、使用可能なすべての統計情報の種類で浮動小数になります。

• ラスター セルの近傍内にポイントがない場合、[種類] の統計情報は値 0 を割り当てます。 他の統計情報については、NoData が割り当てられます。

• [出力セル サイズ] パラメーターは、数値で定義するか、既存のラスター データセットから取得することができます。 セル サイズがパラメーター値として明示的に指定されていない場合、セル サイズ環境が指定されていれば、そこから取得されます。 パラメーターのセル サイズまたは環境のセル サイズは指定されていないが、スナップ対象ラスター環境が設定されている場合、スナップ対象ラスターのセル サイズが使用されます。 何も指定されていない場合、セル サイズは範囲の幅および高さのうち小さい方を 250 で割った値で計算されます (範囲が環境で指定された出力座標系に存在する場合)。

• 数値を使用してセル サイズを指定した場合、出力ラスターではそれが直接使用されます。

  ラスター データセットを使用してセル サイズを指定した場合、パラメーターにはセル サイズの値ではなく、ラスター データセットのパスが表示されます。 データセットの空間参照が出力空間参照と同じであれば、そのラスター データセットのセル サイズが解析で直接使用されます。 データセットの空間参照が出力空間参照と異なる場合、指定した [セル サイズ投影法] の値に基づいて投影されます。

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

パラメーター

ダイアログ

ラベル	説明	データ タイプ
入力ポイント フィーチャ	近傍演算で使用する入力ポイント。 出力セルごとに、定義された近傍の形状内にある入力ポイントが決定されます。 選択したポイントに対して、指定した属性の値が取得され、統計情報が計算されます。 入力は、ポイントとマルチポイント フィーチャクラスが使用できます。	Feature Layer
フィールド	指定された統計情報を計算するために使用するフィールド。 入力ポイント フィーチャの任意の数値フィールドを設定できます。 入力フィーチャが Z 値を含む場合、Shape フィールドを使用できます。	Field
出力セル サイズ (オプション)	作成される出力ラスターのセル サイズ。 このパラメーターは、数値で定義するか、既存のラスター データセットから取得することができます。 セル サイズがパラメーター値として明示的に指定されていない場合、環境セル サイズの値が指定されていれば、それが使用されます。そうでない場合、その他のルールを使用してその他の入力から計算されます。 詳細については、使用法セクションをご参照ください。	Analysis Cell Size
近傍 (オプション)	入力ポイントがある各処理セル周辺のエリアは、統計情報の計算に使用されます。 さまざまな定義済みの近傍タイプから選択できます。 近傍タイプを選択すると、他のパラメーターを設定して、計測の形状、サイズ、単位を完全に定義できます。 デフォルトの近傍は、幅と高さが 3 x 3 セルの正方形です。 使用可能な近傍タイプの形式を次に示します。 [ドーナツ型]、[内部半径]、[外部半径]、[単位の種類] 内径および外径で定義されるリングまたはドーナツ形状の近傍。 半径の最小値は 1 セルで、外径は内径より大きい必要があります。 内径の最大値は 2,046 セルで、外径の最大値は 2,047 セルです。 デフォルトのドーナツ型の内径は 1 セル、外径は 3 セルです。 [円形]、[半径]、[単位の種類] 指定した半径の円形の近傍。 半径の最小値は 1 セル、最大値は 2,047 セルです。 デフォルトの半径は 3 セルです。 [長方形]、[高さ]、[幅]、[単位の種類] 幅と高さで定義される長方形の近傍。 幅または高さの最小値は 1 セル、最大値は 4,096 セルです。 デフォルトは、幅と高さが 3 x 3 セルの正方形です。 [扇型]、[半径]、[始点角度]、[終点角度]、[単位の種類] 扇形の近傍は、半径、開始角度、終了角度によって定義されます。 半径の最小値は 1 セル、最大値は 2,047 セルです。 扇形の角度は、反時計回りです。 角度は度で指定し、0 または 360 が東を表します。 負の角度も使用できます。 デフォルトの扇形は 0 〜 90 度で半径は 3 セルです。 パラメーターの距離単位は [セル] 単位または [マップ] 単位で指定できます。 セル単位がデフォルトです。	Neighborhood
統計情報の種類 (オプション)	計算する統計情報の種類を指定します。 計算は、各出力ラスター セルの指定した近傍内にあるポイントの指定したフィールド値に対して実行されます。 デフォルトの統計情報タイプは [平均値] です。 選択できる統計情報の種類は、指定したフィールドの数値タイプによって決定されます。 フィールドが整数の場合、すべての統計情報の種類が使用できます。 フィールドが浮動小数点の場合、使用できる統計情報の種類は、最大、平均、最小、範囲、標準偏差、合計のみです。 平均—各近傍のフィールド値の平均値が計算されます。 最頻値—各近傍内で最もよく存在するフィールドが特定されます。 同数の値が複数ある場合、低い値が使用されます。 最大—各近傍の最大値が特定されます。 中央値—各近傍の中央フィールド値が計算されます。 近傍内に存在するポイントが偶数である場合、2 つの中間値の小さい方が結果になります。 最小—各近傍の最小フィールド値が特定されます。 最少頻値—各近傍内での最少フィールド頻値が特定されます。 同数の値が複数ある場合、低い値が使用されます。 範囲—各近傍のフィールド値の範囲 (最大と最小の差) が計算されます。 標準偏差—各近傍のフィールド値の標準偏差が計算されます。 合計—近傍のフィールド値の合計値が計算されます。 種類—各近傍の一意のフィールド値の数が計算されます。	String

戻り値

ラベル	説明	データ タイプ
出力ラスター	出力ポイント統計ラスター。	Raster

Python

PointStatistics(in_point_features, field, {cell_size}, {neighborhood}, {statistics_type})

名前	説明	データ タイプ
in_point_features	近傍演算で使用する入力ポイント。 出力セルごとに、定義された近傍の形状内にある入力ポイントが決定されます。 選択したポイントに対して、指定した属性の値が取得され、統計情報が計算されます。 入力は、ポイントとマルチポイント フィーチャクラスが使用できます。	Feature Layer
field	指定された統計情報を計算するために使用するフィールド。 入力ポイント フィーチャの任意の数値フィールドを設定できます。 入力フィーチャが Z 値を含む場合、Shape フィールドを使用できます。	Field
cell_size (オプション)	作成される出力ラスターのセル サイズ。 このパラメーターは、数値で定義するか、既存のラスター データセットから取得することができます。 セル サイズがパラメーター値として明示的に指定されていない場合、環境セル サイズの値が指定されていれば、それが使用されます。そうでない場合、その他のルールを使用してその他の入力から計算されます。 詳細については、使用法セクションをご参照ください。	Analysis Cell Size
neighborhood (オプション)	入力ポイントがある各処理セル周辺のエリアは、統計情報の計算に使用されます。 さまざまな定義済みの近傍タイプから選択できます。 近傍タイプを選択すると、他のパラメーターを設定して、計測の形状、サイズ、単位を完全に定義できます。 デフォルトの近傍は、幅と高さが 3 x 3 セルの正方形です。 各入力ポイント周辺の近傍の形状は、Neighborhood によって定義されます。 使用可能な近傍タイプは、NbrAnnulus、NbrCircle、NbrRectangle,、NbrWedge です。 使用可能な近傍タイプの形式を次に示します。 NbrAnnulus({innerRadius}, {outerRadius}, {units}) 内径および外径で定義されるリングまたはドーナツ形状の近傍。 半径の最小値は 1 セルで、外径は内径より大きい必要があります。 内径の最大値は 2,046 セルで、外径の最大値は 2,047 セルです。 デフォルトのドーナツ型の内径は 1 セル、外径は 3 セルです。 NbrCircle({radius}, {units} 指定した半径の円形の近傍。 半径の最小値は 1 セル、最大値は 2,047 セルです。 デフォルトの半径は 3 セルです。 NbrRectangle({width}, {height}, {units}) 幅と高さで定義される長方形の近傍。 幅または高さの最小値は 1 セル、最大値は 4,096 セルです。 デフォルトは、幅と高さが 3 x 3 セルの正方形です。 NbrWedge({radius}, {startAngle}, {endAngle}, {units}) 扇形の近傍は、半径、開始角度、終了角度によって定義されます。 半径の最小値は 1 セル、最大値は 2,047 セルです。 扇形の角度は、反時計回りです。 角度は度で指定し、0 または 360 が東を表します。 負の角度も使用できます。 デフォルトの扇形は 0 〜 90 度で半径は 3 セルです。 パラメーターの距離単位は CELL 単位または MAP 単位で指定できます。 セル単位がデフォルトです。 デフォルトの近傍タイプは、高さと幅が 3 x 3 セルの NbrRectangle です。	Neighborhood
statistics_type (オプション)	計算する統計情報の種類を指定します。 計算は、各出力ラスター セルの指定した近傍内にあるポイントの指定したフィールド値に対して実行されます。 MEAN—各近傍のフィールド値の平均値が計算されます。 MAJORITY—各近傍内で最もよく存在するフィールドが特定されます。 同数の値が複数ある場合、低い値が使用されます。 MAXIMUM—各近傍の最大値が特定されます。 MEDIAN—各近傍の中央フィールド値が計算されます。 近傍内に存在するポイントが偶数である場合、2 つの中間値の小さい方が結果になります。 MINIMUM—各近傍の最小フィールド値が特定されます。 MINORITY—各近傍内での最少フィールド頻値が特定されます。 同数の値が複数ある場合、低い値が使用されます。 RANGE—各近傍のフィールド値の範囲 (最大と最小の差) が計算されます。 STD—各近傍のフィールド値の標準偏差が計算されます。 SUM—近傍のフィールド値の合計値が計算されます。 VARIETY—各近傍の一意のフィールド値の数が計算されます。 デフォルトの統計情報タイプは MEAN です。 選択できる統計情報の種類は、指定したフィールドの数値タイプによって決定されます。 フィールドが整数の場合、すべての統計情報の種類が使用できます。 フィールドが浮動小数点の場合、使用できる統計情報の種類は、最大、平均、最小、範囲、標準偏差、合計のみです。	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")

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

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

環境

自動コミット, セル サイズ, セル サイズ投影法, 圧縮, 現在のワークスペース, 範囲, 地理座標系変換, 出力データのコンフィグレーション キーワード, 出力座標系, テンポラリ ワークスペース, スナップ対象ラスター, タイル サイズ