ポイント統計 (Spatial Analyst ツール)
サマリー
使用法
さまざまな近傍の形状と統計情報の種類から選択できます。 選択できる統計情報は、指定したフィールドのタイプによって異なります。
整数フィールドの場合、統計の種類 に有効な選択肢は、最頻値、最大、平均、中央値、最小、最少頻値、範囲、標準偏差、合計、および種類です。 浮動小数のフィールドの場合、有効な統計情報は、最大、平均、最小、範囲、標準偏差、および合計です。 最頻値、最小頻値、および種類は選択できません。
フィールド タイプが整数の場合、出力ラスターは、最頻値、最大、中央値、最小、最少頻値、範囲、合計、および種類で整数になります。 出力値は、平均および標準偏差で浮動小数になります。
浮動小数 タイプが浮動小数型の場合、出力ラスターは、すべての可能な統計タイプで浮動小数型になります。
ラスター セルの近傍内にポイントがない場合、種類 の統計情報は値 0 を割り当てます。 他の統計情報については、NoData が割り当てられます。
出力セル サイズ パラメーターは、数値で定義するか、既存のラスター データセットから取得することができます。 セル サイズがパラメーター値として明示的に指定されていない場合、セル サイズ環境が指定されていれば、そこから取得されます。 パラメーターのセル サイズまたは環境のセル サイズは指定されていないが、スナップ対象ラスター環境が設定されている場合、スナップ対象ラスターのセル サイズが使用されます。 何も指定されていない場合、セル サイズは範囲の幅および高さのうち小さい方を 250 で割った値で計算されます (範囲が環境で指定された出力座標系に存在する場合)。
数値を使用してセル サイズを指定した場合、出力ラスターではそれが直接使用されます。
ラスター データセットを使用してセル サイズを指定した場合、パラメーターにはセル サイズの値ではなく、ラスター データセットのパスが表示されます。 データセットの空間参照が出力空間参照と同じであれば、そのラスター データセットのセル サイズが解析で直接使用されます。 データセットの空間参照が出力空間参照と異なる場合、指定した セル サイズ投影法 の値に基づいて投影されます。
このツールに適用されるジオプロセシング環境の詳細については、解析環境と Spatial Analyst をご参照ください。
パラメーター
|
ラベル
|
説明
|
データ タイプ
|
|
入力ポイント フィーチャ
|
近傍演算で使用する入力ポイント。
出力セルごとに、定義された近傍の形状内にある入力ポイントが決定されます。 選択したポイントに対して、指定した属性の値が取得され、統計情報が計算されます。
入力は、ポイントとマルチポイント フィーチャクラスが使用できます。
|
Feature Layer
|
|
フィールド
|
指定された統計情報を計算するフィールド。 入力ポイント フィーチャの任意の数値フィールドを設定できます。
入力フィーチャが Z 値を含む場合、Shape フィールドを使用できます。
|
Field
|
|
出力セル サイズ
(オプション)
|
作成される出力ラスターのセル サイズ。
このパラメーターは、数値で定義するか、既存のラスター データセットから取得することができます。 セル サイズがパラメーター値として明示的に指定されていない場合、環境セル サイズの値が指定されていれば、それが使用されます。そうでない場合、その他のルールを使用してその他の入力から計算されます。 詳細については、使用法セクションをご参照ください。
|
Analysis Cell Size
|
|
近傍
(オプション)
|
入力ポイントがある各処理セル周辺のエリアは、統計情報の計算に使用されます。 さまざまな定義済みの近傍タイプから選択できます。
近傍タイプを選択すると、他のパラメーターを設定して、計測の形状、サイズ、単位を完全に定義できます。 デフォルトの近傍は、幅と高さが 3 x 3 セルの正方形です。
使用可能な近傍タイプの形式を次に示します。
ドーナツ型、内部半径、外部半径、単位の種類
内径および外径で定義されるリング (ドーナツ形状) の近傍。 半径の最小値は 1 セルで、外径は内径より大きい必要があります。 内径の最大値は 2046 セル、外径の最大値は 2047 セルです。 デフォルトのドーナツ型の内径は 1 セル、外径は 3 セルです。
円形、半径、単位の種類
指定した半径の円形の近傍。 半径の最小値は 1 セル、最大値は 2,047 セルです。 デフォルトの半径は 3 セルです。
四角形、高さ、幅、単位の種類
幅と高さで定義される四角形の近傍。 幅または高さの最小値は 1 セル、最大値は 4096 セルです。 デフォルトは、幅と高さが 3 x 3 セルの正方形です。
扇型、半径、始点角度、終点角度、単位の種類
扇形の近傍は、半径、開始角度、終了角度によって定義されます。 半径の最小値は 1 セル、最大値は 2,047 セルです。 扇形の角度は、反時計回りです。 角度は度で指定し、0 または 360 が東を表します。 負の角度も使用できます。 デフォルトの扇形は 0 〜 90 度で半径は 3 セルです。
パラメーターの距離単位は セル 単位または マップ 単位で指定できます。 セル単位がデフォルトです。
|
Neighborhood
|
|
統計の種類
(オプション)
|
計算する統計の種類を指定します。
計算は、各出力ラスター セルの指定した近傍内にあるポイントの指定したフィールド値に対して実行されます。
選択できる統計情報のタイプは、指定したフィールドの数値タイプによって決定されます。 フィールドが整数の場合、すべての統計情報の種類が使用できます。 フィールドが浮動小数点の場合、使用できる統計情報の種類は、最大、平均、最小、範囲、標準偏差、合計のみです。
平均—各近傍のフィールド値の平均値が計算されます。 これがデフォルトです。
最頻値—各近傍内で最もよく存在するフィールドが特定されます。 同数の値が複数ある場合、低い値が使用されます。
最大—各近傍の最大値が特定されます。
中央値—各近傍の中央フィールド値が計算されます。 近傍内に存在するポイントが偶数である場合、2 つの中間値の小さい方が結果になります。
最小—各近傍の最小フィールド値が特定されます。
最少頻値—各近傍内での最少フィールド頻値が特定されます。 同数の値が複数ある場合、低い値が使用されます。
範囲—各近傍のフィールド値の範囲 (最大と最小の差) が計算されます。
標準偏差—各近傍のフィールド値の標準偏差が計算されます。
合計—近傍のフィールド値の合計値が計算されます。
種類—各近傍の一意のフィールド値の数が計算されます。
|
String
|
戻り値
|
ラベル
|
説明
|
データ タイプ
|
|
出力ラスター
|
出力ポイント統計ラスター。
|
Raster
|
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 セルで、外径は内径より大きい必要があります。 内径の最大値は 2046 セル、外径の最大値は 2047 セルです。 デフォルトのドーナツ型の内径は 1 セル、外径は 3 セルです。
NbrCircle({radius}, {units}
指定した半径の円形の近傍。 半径の最小値は 1 セル、最大値は 2,047 セルです。 デフォルトの半径は 3 セルです。
NbrRectangle({width}, {height}, {units})
幅と高さで定義される四角形の近傍。 幅または高さの最小値は 1 セル、最大値は 4096 セルです。 デフォルトは、幅と高さが 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—各近傍の一意のフィールド値の数が計算されます。
|
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")
# Run PointStatistics
outPointStatistics = PointStatistics(inPointFeatures, field, cellSize,
neighborhood, "MEAN")
# Save the output
outPointStatistics.save("C:/sapyexamples/output/pointstatout")
環境
自動コミット, セル サイズ, セル サイズ投影法, 圧縮, 現在のワークスペース, 範囲, 地理座標系変換, 出力データのコンフィグレーション キーワード, 出力座標系, スクラッチ ワークスペース, スナップ対象ラスター, タイル サイズ
ライセンス情報
- Basic: Spatial Analyst が必要
- Standard: Spatial Analyst が必要
- Advanced: Spatial Analyst が必要