近傍要約統計量 (Neighborhood Summary Statistics) (空間統計)

サマリー

各フィーチャの周囲のローカル近傍を使用して、1 つ以上の数値フィールドの要約統計量を計算します。ローカル統計には、平均値、中央値、標準偏差、四分位範囲、歪度、および四位分位不均衡が含まれます。また、カーネルを使用してすべての統計を地理的に重み付けし、フォーカル フィーチャに近い近傍ほど影響を強くすることができます。使用できる近隣タイプには、距離バンド、近傍数、ポリゴン隣接、ドローネ三角形分割、空間ウェイト マトリックス (*.swm) ファイルなど、さまざまなタイプがあります。また、要約統計量は各フィーチャの近傍までの距離に対して計算されます。

近傍要約統計量 (Neighborhood Summary Statistics) ツールの詳細

平均値は近傍を使用して計算されます。
フォーカル フィーチャの周囲の平均値は、近傍を使用して計算されます。

使用法

  • 指定した分析フィールドに加え、各フィーチャに対して近傍までの距離に基づく統計が計算されます。このため、たとえば各近傍までの距離の平均と標準偏差を計算し、近傍がフォーカル フィーチャから一般的に近いか遠いかを確認することができます。近傍までの距離の統計を計算する際、フォーカル フィーチャは距離が常に 0 になるため使用されません。また、これらの統計は、同じ距離に基づいて距離値を重み付けする意味がないため、地理的に重み付けされません。

  • [近傍タイプ] パラメーターに [ドローネ三角形分割] を選択した場合、出力フィーチャクラスはボロノイ マップと呼ばれます。

  • 入力フィーチャがポリゴンの場合、ポリゴン間の距離はすべてポリゴンの重心間の距離で定義されます。

  • ローカル統計は、[近傍タイプ] パラメーターが [近傍数] または [距離バンド] に指定されている場合にのみ、地理的に重み付けできます。これは、ポリゴン隣接またはドローネ三角形分割に基づく近傍が、重心間の距離によって重み付けしてはいけないためです。[近傍タイプ] パラメーターを [空間ウェイトをファイルから取得] に指定した場合、空間ウェイト ファイルに定義されたウェイトが地理的な重み付けに自動的に使用されます。

  • 出力座標系環境が緯度および経度の座標を含む地理座標系に設定されている場合、すべての距離は弦距離を使用して計算されます。それ以外の場合、すべての距離は直線 (ユークリッド) 距離を使用して計算されます。

  • [計算で NULL 値を無視] パラメーターを使用して NULL 値を無視することを選択した場合、近傍の検索後に分析フィールドに NULL 値を含む近傍は除外されます。このため、近傍数が予測よりも少なくなる可能性があり、複数の分析フィールドを指定した場合、一部の分析フィールドで他の分析フィールドとは異なる数の近傍が使用されることがあります。これは、[近傍タイプ] パラメーターに [近傍数] オプションを指定した場合に特に顕著です。

パラメーター

ラベル説明データ タイプ
入力フィーチャ

ローカル統計の計算に使用するポイント フィーチャまたはポリゴン フィーチャ。

Feature Layer
出力フィーチャ

ローカル統計をフィールドとして含む出力ポイント フィーチャクラス。各分析フィールドの統計は、個別のフィールドとして保存されます。

Feature Class
分析フィールド
(オプション)

ローカル統計を計算する 1 つ以上のフィールド。分析フィールドが指定されていない場合、近傍までの距離に基づくローカル統計のみが計算されます。

Field
ローカル要約統計量
(オプション)

各分析フィールドに対して計算するローカル要約統計量を指定します。

  • すべてすべてのローカル統計が計算されます。これがデフォルトです。
  • 平均ローカル平均値が計算されます。
  • 中央値 ローカル中央値が計算されます。
  • 標準偏差ローカル標準偏差が計算されます。
  • 四分位範囲 ローカル四分位範囲が計算されます。
  • 歪度 ローカル歪度が計算されます。
  • 四位分位不均衡 ローカル四位分位不均衡が計算されます。
String
計算にフォーカル フィーチャを含める
(オプション)

各フィーチャのローカル統計を計算する際に、フォーカル フィーチャを含めるかどうかを指定します。

  • オン - ローカル統計を計算する際に、フォーカル フィーチャとそのすべての近傍を含めます。これがデフォルトです。
  • オフ - ローカル統計を計算する際に、フォーカル フィーチャを含めません。フォーカル フィーチャの近傍のみが含まれます。

Boolean
計算で NULL 値を無視
(オプション)

分析フィールドの NULL 値を計算に含めるか無視するかを指定します。

  • オン - 分析フィールドの NULL 値は無視され、NULL 値でない値のみを使用して統計が計算されます。これがデフォルトです。
  • オフ - 分析フィールドの NULL 値が計算に含まれ、計算に使用した値のいずれかが NULL の場合、ローカル統計は NULL として計算されます。

Boolean
近傍タイプ
(オプション)

各入力フィーチャに対する近傍の選択方法を指定します。ローカル統計を計算するには、各入力フィーチャに対して近傍フィーチャを特定する必要があり、これらの近傍フィーチャは各フィーチャのローカル統計の計算に使用されます。ポイント フィーチャの場合、デフォルトは [ドローネ三角形分割] です。ポリゴン フィーチャの場合、デフォルトは [隣接エッジ コーナー] です。

  • 距離バンド指定された各フィーチャの臨界距離内にあるフィーチャが近傍として含められます。
  • 近傍数 最も近いフィーチャが近傍として含められます。
  • 隣接エッジのみ エッジを共有するポリゴン フィーチャが近傍として含められます。
  • 隣接エッジ コーナー エッジまたはコーナーを共有するポリゴン フィーチャが近傍として含められます。ポリゴン フィーチャに対するデフォルトの設定です。
  • ドロネー三角形分割ドローネ三角形分割でエッジを共有するフィーチャが近傍として含められます。これは、ポイント フィーチャに対するデフォルトの設定です。
  • 空間ウェイトをファイルから取得 近傍およびウェイトは、指定した空間ウェイト ファイルによって定義されます。
String
距離バンド
(オプション)

この距離内のすべてのフィーチャが近傍として含められます。値を指定しない場合、値は実行中に見積もられ、ジオプロセシング メッセージとして含められます。指定した距離に 1,000 以上の近傍が含まれる場合、最も近い 1,000 個のフィーチャのみが近傍として含められます。

Linear Unit
近傍数
(オプション)

各ローカル計算に対して含める近傍数。この数にフォーカル フィーチャは含まれません。フォーカル フィーチャが計算に含まれている場合、もう 1 つの近傍が使用されます。デフォルトは 8 です。

Long
ウェイト マトリックス ファイル
(オプション)

フィーチャ間の空間リレーションシップと潜在的に時系列のリレーションシップを定義する空間ウェイト マトリックス ファイルのパスとファイル名。

File
ローカル加重方式
(オプション)

ローカル統計を計算する際に近傍に適用する加重方式を指定します。

  • 加重なし近傍は加重されません。これがデフォルトです。
  • Bisquare近傍は、Bisquare カーネル方式を使用して加重されます。
  • Gaussian近傍は、Gaussian カーネル方式を使用して加重されます。
String
カーネル バンド幅
(オプション)

Bisquare または Gaussian ローカル加重方式のバンド幅。値を指定しない場合、値は実行中に見積もられ、ジオプロセシング メッセージとして含められます。

Linear Unit

arcpy.stats.NeighborhoodSummaryStatistics(in_features, output_features, {analysis_fields}, {local_summary_statistic}, {include_focal_feature}, {ignore_nulls}, {neighborhood_type}, {distance_band}, {number_of_neighbors}, {weights_matrix_file}, {local_weighting_scheme}, {kernel_bandwidth})
名前説明データ タイプ
in_features

ローカル統計の計算に使用するポイント フィーチャまたはポリゴン フィーチャ。

Feature Layer
output_features

ローカル統計をフィールドとして含む出力ポイント フィーチャクラス。各分析フィールドの統計は、個別のフィールドとして保存されます。

Feature Class
analysis_fields
[analysis_fields,...]
(オプション)

ローカル統計を計算する 1 つ以上のフィールド。分析フィールドが指定されていない場合、近傍までの距離に基づくローカル統計のみが計算されます。

Field
local_summary_statistic
(オプション)

各分析フィールドに対して計算するローカル要約統計量を指定します。

  • ALLすべてのローカル統計が計算されます。これがデフォルトです。
  • MEANローカル平均値が計算されます。
  • MEDIAN ローカル中央値が計算されます。
  • STD_DEVローカル標準偏差が計算されます。
  • IQR ローカル四分位範囲が計算されます。
  • SKEWNESS ローカル歪度が計算されます。
  • QUANTILE_IMBALANCE ローカル四位分位不均衡が計算されます。
String
include_focal_feature
(オプション)

各フィーチャのローカル統計を計算する際に、フォーカル フィーチャを含めるかどうかを指定します。

  • INCLUDE_FOCALローカル統計を計算する際に、フォーカル フィーチャとそのすべての近傍が含まれます。これがデフォルトです。
  • EXCLUDE_FOCALローカル統計を計算する際に、フォーカル フィーチャを含めません。フォーカル フィーチャの近傍のみが含まれます。
Boolean
ignore_nulls
(オプション)

分析フィールドの NULL 値を計算に含めるか無視するかを指定します。

  • IGNORE_NULLSローカル計算で NULL 値を無視します。
  • INCLUDE_NULLSローカル計算に NULL 値を含めます。
Boolean
neighborhood_type
(オプション)

各入力フィーチャに対する近傍の選択方法を指定します。ローカル統計を計算するには、各入力フィーチャに対して近傍フィーチャを特定する必要があり、これらの近傍フィーチャは各フィーチャのローカル統計の計算に使用されます。ポイント フィーチャの場合、デフォルトは [ドローネ三角形分割] です。ポリゴン フィーチャの場合、デフォルトは [隣接エッジ コーナー] です。

  • DISTANCE_BAND指定された各フィーチャの臨界距離内にあるフィーチャが近傍として含められます。
  • NUMBER_OF_NEIGHBORS 最も近いフィーチャが近傍として含められます。
  • CONTIGUITY_EDGES_ONLY エッジを共有するポリゴン フィーチャが近傍として含められます。
  • CONTIGUITY_EDGES_CORNERS エッジまたはコーナーを共有するポリゴン フィーチャが近傍として含められます。ポリゴン フィーチャに対するデフォルトの設定です。
  • DELAUNAY_TRIANGULATIONドローネ三角形分割でエッジを共有するフィーチャが近傍として含められます。これは、ポイント フィーチャに対するデフォルトの設定です。
  • GET_SPATIAL_WEIGHTS_FROM_FILE 近傍およびウェイトは、指定した空間ウェイト ファイルによって定義されます。
String
distance_band
(オプション)

この距離内のすべてのフィーチャが近傍として含められます。値を指定しない場合、値は実行中に見積もられ、ジオプロセシング メッセージとして含められます。指定した距離に 1,000 以上の近傍が含まれる場合、最も近い 1,000 個のフィーチャのみが近傍として含められます。

Linear Unit
number_of_neighbors
(オプション)

各ローカル計算に対して含める近傍数。この数にフォーカル フィーチャは含まれません。フォーカル フィーチャが計算に含まれている場合、もう 1 つの近傍が使用されます。デフォルトは 8 です。

Long
weights_matrix_file
(オプション)

フィーチャ間の空間リレーションシップと潜在的に時系列のリレーションシップを定義する空間ウェイト マトリックス ファイルのパスとファイル名。

File
local_weighting_scheme
(オプション)

ローカル統計を計算する際に近傍に適用する加重方式を指定します。

  • UNWEIGHTED近傍は加重されません。これがデフォルトです。
  • BISQUARE近傍は、Bisquare カーネル方式を使用して加重されます。
  • GAUSSIAN近傍は、Gaussian カーネル方式を使用して加重されます。
String
kernel_bandwidth
(オプション)

Bisquare または Gaussian ローカル加重方式のバンド幅。値を指定しない場合、値は実行中に見積もられ、ジオプロセシング メッセージとして含められます。

Linear Unit

コードのサンプル

NeighborhoodSummaryStatistics (近傍の要約統計量) の例 1 (Python ウィンドウ)

次の Python ウィンドウ スクリプトは、NeighborhoodSummaryStatisticsツールの使用方法を示しています。

import arcpy
arcpy.env.workspace = r"c:\data\project_data.gdb"
arcpy.stats.NeighborhoodSummaryStatistics("USCounties", 
      "USCounties_NeighborhoodSummaryStatistics", "POP2018;POP2019", 
      "ALL", "INCLUDE_FOCAL", "IGNORE_NULLS", "NUMBER_OF_NEIGHBORS", None, 
      8, None, "UNWEIGHTED")
NeighborhoodSummaryStatistics (近傍の要約統計量) の例 2 (スタンドアロン スクリプト)

次のスタンドアロン スクリプトは、NeighborhoodSummaryStatistics ツールの使用方法を示します。

# Calculate a focal mean for the population and income of US cities.  
import arcpy 
# Set the current workspace
arcpy.env.workspace = r"c:\data\project_data.gdb" 
# Calculate the local mean of POP2020 and MedIncome2020 fields
# using 8 nearest neighbors.
arcpy.stats.NeighborhoodSummaryStatistics("USCities", "USCities_Mean", 
      "POP2020;MedIncome2020", "MEAN", "EXCLUDE_FOCAL", "IGNORE_NULLS", 
      "NUMBER_OF_NEIGHBORS", None, 8, None, "GAUSSIAN", "50 Miles")

環境

特殊なケース

ライセンス情報

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes

関連トピック