Spatial Analyst のライセンスで利用可能。
概要
各出力セルの近傍内にあるポイントの統計情報を計算します。
使用法
[出力セル サイズ] は、数値で定義するか、既存のラスター データセットから取得できます。セル サイズがパラメーター値として明示的に指定されていない場合、[セル サイズ] 環境が指定されていれば、そこから取得されます。パラメーターのセル サイズも環境のセル サイズも指定されておらず、[スナップ対象ラスター] 環境が設定されている場合には、スナップ ラスターのセル サイズが使用されます。何も指定されていない場合、セル サイズは範囲の幅または高さ (どちらか短い方) を 250 で割って求められます。この範囲は環境で指定された [出力座標系] にあります。
セル サイズが数値によって指定されている場合、このツールは出力ラスターに対してこの値を直接使用します。
セル サイズがラスター データセットを使用して指定されている場合、パラメーターはセル サイズの値ではなくラスター データセットのパスを示します。データセットの空間参照が出力空間参照と同じである場合、解析ではラスター データセットのセル サイズが直接使用されます。データセットの空間参照が出力空間参照と異なる場合は、選択された [セル サイズ投影法] に基づいて投影されます。
指定したフィールドが整数の場合、使用できるオーバーレイ統計情報は、[平均]、[最頻値]、[最大値]、[中央値]、[最小値]、[最少頻値]、[範囲]、[標準偏差]、[合計]、および [種類] です。フィールドが浮動小数点の場合、使用できる統計情報は、[平均]、[最大値]、[最小値]、[範囲]、[標準偏差]、[合計] のみです。
[統計の種類] が [最頻値]、[最大値]、[中央値]、[最小値]、[最少頻値]、[範囲] および [合計] の場合、ラスターの出力データ タイプは入力フィールド タイプと同じになります。[統計の種類] が [中央値] と [標準偏差] の場合、出力ラスターは必ず浮動小数になります。[種類] の場合、出力ラスターは必ず整数になります。
ラスター セルの近傍内にポイントがない場合、[種類] の統計情報は値 0 を割り当てます。他の統計情報については、NoData が割り当てられます。
このツールに適用されるジオプロセシング環境の詳細については、「解析環境と Spatial Analyst」をご参照ください。
構文
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 (オプション) | Neighborhood クラスは、統計情報の計算に使用する各入力ポイント周辺のエリアの形状を指定します。 使用可能な近傍タイプは、NbrAnnulus、NbrCircle、NbrRectangle,、NbrWedge です。 近傍の形式は以下のとおりです。
デフォルトの近傍は、幅と高さが 3 x 3 セルの正方形の NbrRectangle です。 | Neighborhood |
statistics_type (オプション) | 計算する統計情報の種類を指定します。 計算は、各出力ラスター セルの近傍内にあるポイント入力の指定したフィールド値に対して実行されます。
選択できる統計情報のタイプは、指定したフィールドの数値タイプによって決定されます。 | 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")
環境
ライセンス情報
- Basic: 次のものが必要 Spatial Analyst
- Standard: 次のものが必要 Spatial Analyst
- Advanced: 次のものが必要 Spatial Analyst