ペアワイズポリゴン近接 (Pairwise Polygon Neighbors) (解析)—ArcGIS Pro

サマリー

ポリゴン隣接 (オーバーラップ、一致エッジ、またはノード) に基づいて統計のテーブルを作成します。

ポリゴン近接ツールとペアワイズポリゴン近接ツールの詳細

図

ソースポリゴンと隣接ポリゴンの図を示します。

使用法

このツールはポリゴン隣接を解析し、ソースポリゴンと隣接ポリゴン間の以下の情報を要約します。
- オーバーラップの面積 (オーバーラップ隣接 - オプション)
- 一致エッジの長さ (エッジ隣接)
- 境界が 1 つのポイントで交差または接触する回数 (ノード隣接)
サマリー情報は出力テーブルに書き出されます。 1 つのソースポリゴンに対して隣接ポリゴンが 1 つだけの場合もあれば複数ある場合もあります。隣接ポリゴンは上記に説明する方法のいずれかまたは組み合わせによってソースポリゴンと空間的に関連しています。
このツールは一次隣接のみを解析して報告します。それ以外のリレーションシップ、つまり隣接の隣接 (二次隣接) は検証しません。
一意のポリゴンまたはポリゴングループを識別し、ポリゴンまたはポリゴングループ別に隣接情報を報告するには、[フィールドごとにレポート] パラメーターを使用します。入力の個々のポリゴンの隣接リレーションシップを検出するには、ポリゴンごとに一意の値 (複数のフィールドを使用する場合は値セット) を格納する 1 つ以上の入力フィールドを指定します。
指定したフィールドによって一意のポリゴングループが識別されると、グループ別に隣接情報が要約され、報告されます。
このパラメーターの使用方法の詳細については、「ポリゴン近接とペアワイズポリゴン近接の仕組み」をご参照ください。
オーバーラップエリアリレーションシップを解析する場合は、[エリアのオーバーラップを含める] パラメーターを使用できます。 [エリアのオーバーラップを含める] をオンにすると、解析対象のオーバーラップ隣接のオーバーラップの面積を格納する AREA フィールドが出力テーブルに含まれます。オーバーラップしていない場合、AREA フィールドは 0 になります。
ヒント:
オーバーラップエリアリレーションシップの計算処理は、多くのリソースを消費するため、一致エッジおよびノード隣接リレーションシップの決定に比べて非常に性能が低下する可能性があります。データにオーバーラップフィーチャがないことがわかっている場合、またはオーバーラップ隣接を解析する必要がない場合は、[エリアのオーバーラップを含める] パラメーターをオフにしてください。
注意:
完全にソースポリゴンに含まれている隣接フィーチャのレコードを取得するには、[エリアのオーバーラップを含める] パラメーターをオンにする必要があります。 [エリアのオーバーラップを含める] パラメーターがオフになっていると、ソースポリゴンに完全に含まれている隣接フィーチャのレコードが出力テーブルに含まれません。
隣接フィーチャではないフィーチャについては、出力テーブルに情報は出力されません。
[隣接リレーションシップの両側を含める] パラメーターは、出力に含まれるリレーションシップを制御するために使用します。相互リレーションシップを含むすべての隣接リレーションシップを報告するには、[隣接リレーションシップの両側を含める] チェックボックスをオンにします。たとえば、OID1 の隣接フィーチャに OID2 がある場合、出力テーブルの OID1 には隣接フィーチャとして OID2 が書き出され、同様に OID2 には OID1 が書き出されます。前者のリレーションシップのみで足りる場合は、[隣接リレーションシップの両側を含める] チェックボックスをオフにします。上記の例で [隣接リレーションシップの両側を含める] チェックボックスをオフにすると、OID1 の隣接フィーチャに OID2 があるという情報のみが、出力テーブルに含まれます。
[出力距離の単位] パラメーターは、隣接フィーチャ間で共有される境界線の長さに使用するための単位を指定します。デフォルトでは、入力フィーチャの座標系で定義されているものと同じ単位が使用されます。
[出力面積の単位] パラメーターは、[エリアのオーバーラップを含める] パラメーターをオンにしている場合にのみ使用します。 [エリアのオーバーラップを含める] を有効にした場合は、隣接フィーチャとオーバーラップする面積の計算に使用する単位を、[出力面積の単位] パラメーターで指定します。デフォルトでは、入力フィーチャの座標系で定義されているものと同じ単位が使用されます。
[出力テーブル] パラメーター値には、ファイルジオデータベーステーブルまたは .dbf テーブルを使用できます。
[フィールドごとにレポート] パラメーターで指定される各フィールドについて、出力テーブルには src_<field> と nbr_<field> の命名規則を使用する 2 つのフィールドが含まれます。フィールドは、入力のソースと隣接フィールド値を表します。
出力テーブルには、以下のテーブルも含まれます。
- AREA - このフィールドには、ソースポリゴンと隣接ポリゴン (オーバーラップ隣接) 間のオーバーラップ面積の合計が格納されます。このフィールドは、[エリアのオーバーラップを含める] パラメーターがオンになっている場合にのみ出力テーブルに含まれます。
- LENGTH - このフィールドには、ソースポリゴンと隣接ポリゴン間の一致エッジの長さの合計が格納されます。
- NODE_COUNT - このフィールドには、ソースポリゴンと隣接ポリゴンが 1 つの点で交差または接触する回数が格納されます。
入力フィーチャに選択セットがある場合は、選択フィーチャのみが解析されます。

パラメーター

ラベル	説明	データタイプ
入力フィーチャ	入力ポリゴンフィーチャ。	Feature Layer
出力テーブル	出力テーブル。	Table
フィールドごとにレポート (オプション)	一意のポリゴンまたはポリゴングループを識別して出力に報告するために使用する 1 つ以上の入力属性フィールド。	Field
エリアのオーバーラップを含める (オプション)	オーバーラップエリアリレーションシップを解析し、出力に含めるかどうかを指定します。オフ - オーバーラップエリアリレーションシップは解析されず、出力に含まれません。これがデフォルトです。オン - オーバーラップエリアリレーションシップは解析され、出力に含まれます。	Boolean
隣接リレーションシップの両側を含める (オプション)	出力に隣接リレーションシップの両側を含めるかどうかを指定します。オン - 2 つのポリゴンが (1 対 1 で) 隣接している場合に、両側の隣接情報がどちらもお互いのソースおよび隣接フィーチャとして報告され、相互リレーションシップが含まれます。これがデフォルトです。オフ - 2 つのポリゴンが (1 対 1 で) 隣接している場合に、両側の隣接情報が 1 つはソース、もう 1 つは隣接フィーチャとしてのみ報告され、相互リレーションシップは含まれません。	Boolean
XY 許容値 (オプション)	座標が等しいと見なされる前の座標間の最小距離。デフォルトでは、これが入力フィーチャの X,Y 許容値になります。注意: このパラメーターの値を変更すると、失敗または予期しない結果が発生する可能性があります。このパラメーターは変更しないことをお勧めします。ツールダイアログボックスのビューからは削除されています。デフォルトでは、入力フィーチャクラスの空間参照の [XY許容値] プロパティが使用されます。	Linear Unit
出力距離の単位 (オプション)	隣接するポリゴン間の一致エッジの長さの合計を報告するために使用する単位を指定します。デフォルトは入力フィーチャの単位です。不明—長さの単位は不明。キロメートル—長さの単位はキロメートル。メートル—長さの単位はメートル。デシメートル—長さの単位はデシメートル。センチメートル—長さの単位はセンチメートル。ミリメートル—長さの単位はミリメートル。法定マイル—長さの単位は法定マイル。国際海里—長さの単位は国際海里。国際ヤード—長さの単位は国際ヤード。国際フィート—長さの単位は国際フィート。国際インチ—長さの単位は国際インチ。米国測量マイル—長さの単位は米国測量マイル。米国測量海里—長さの単位は米国測量海里。米国測量ヤード—長さの単位は米国測量ヤード。米国測量フィート—長さの単位は米国測量フィート。米国測量インチ—長さの単位はインチ。度 (10 進)—長さの単位は度 (10 進)。ポイント—長さの単位はポイント。	String
出力面積の単位 (オプション)	隣接するポリゴン間のエリアのオーバーラップを報告するために使用する単位を指定します。デフォルトは入力フィーチャの単位です。このパラメーターは、[エリアのオーバーラップを含める] パラメーターがオンになっている場合にのみ有効になります。不明—面積単位は不明。平方キロメートル—面積単位は平方キロメートル。平方メートル—面積単位は平方メートル。平方デシメートル—面積単位は平方デシメートル。平方センチメートル—面積単位は平方センチメートル。平方ミリメートル—面積単位は平方ミリメートル。平方法定マイル—面積単位は平方マイル。平方国際海里—面積単位は平方国際海里。平方国際ヤード—面積単位は平方国際ヤード。平方国際フィート—面積単位は平方国際フィート。平方国際インチ—面積単位は平方国際ヤード。平方米国測量マイル—面積は平方米国測量マイル。平方米国測量海里—面積単位は平方米国測量海里。平方米国測量ヤード—面積単位は平方米国測量ヤード。平方米国測量フィート—面積単位は平方米国測量フィート。平方米国測量インチ—面積単位は平方米国測量インチ。米国測量エーカー—面積単位は米国測量エーカー。ヘクタール—面積単位はヘクタール。エーカー—面積単位は国際エーカー。アール—面積単位はアール。	String
最大精度を使用 (オプション)	使用される精度のレベルを指定します。ポイント出力を決定する際、ツールが入力空間参照のデフォルトよりも大きい精度レベルを適用する場合に、このパラメーターをオンにします。オン - 最大の精度を使用します。オフ - 最初の入力フィーチャクラスの精度を使用します。これがデフォルトです。	Boolean

arcpy.analysis.PairwisePolygonNeighbors(in_features, out_table, {in_fields}, {area_overlap}, {both_sides}, {cluster_tolerance}, {out_linear_units}, {out_area_units}, {precision})

名前	説明	データタイプ
in_features	入力ポリゴンフィーチャ。	Feature Layer
out_table	出力テーブル。	Table
in_fields [in_fields,...] (オプション)	一意のポリゴンまたはポリゴングループを識別して出力に報告するために使用する 1 つ以上の入力属性フィールド。	Field
area_overlap (オプション)	オーバーラップエリアリレーションシップを解析し、出力に含めるかどうかを指定します。 NO_AREA_OVERLAP—オーバーラップエリアリレーションシップは解析されず、出力に含まれません。これがデフォルトです。 AREA_OVERLAP—オーバーラップエリアリレーションシップは解析され、出力に含まれます。	Boolean
both_sides (オプション)	出力に隣接リレーションシップの両側を含めるかどうかを指定します。 BOTH_SIDES—2 つのポリゴンが (1 対 1 で) 隣接している場合に、両側の隣接情報がどちらもお互いのソースおよび隣接フィーチャとして報告され、相互リレーションシップが含まれます。これがデフォルトです。 NO_BOTH_SIDES—2 つのポリゴンが (1 対 1 で) 隣接している場合に、ポリゴンの隣接情報が 1 つはソース、もう 1 つは隣接フィーチャとしてのみ含まれます。相互リレーションシップは含まれません。	Boolean
cluster_tolerance (オプション)	座標が等しいと見なされる前の座標間の最小距離。デフォルトでは、これが入力フィーチャの X,Y 許容値になります。注意: このパラメーターの値を変更すると、失敗または予期しない結果が発生する可能性があります。このパラメーターは変更しないことをお勧めします。ツールダイアログボックスのビューからは削除されています。デフォルトでは、入力フィーチャクラスの空間参照の [XY許容値] プロパティが使用されます。	Linear Unit
out_linear_units (オプション)	隣接するポリゴン間の一致エッジの長さの合計を報告するために使用する単位を指定します。デフォルトは入力フィーチャの単位です。 UNKNOWN—長さの単位は不明。 KILOMETERS—長さの単位はキロメートル。 METERS—長さの単位はメートル。 DECIMETERS—長さの単位はデシメートル。 CENTIMETERS—長さの単位はセンチメートル。 MILLIMETERS—長さの単位はミリメートル。 MILES_INTERNATIONAL—長さの単位は法定マイル。 NAUTICAL_MILES_INTERNATIONAL—長さの単位は国際海里。 YARDS_INTERNATIONAL—長さの単位は国際ヤード。 FEET_INTERNATIONAL—長さの単位は国際フィート。 INCHES_INTERNATIONAL—長さの単位は国際インチ。 MILES—長さの単位は米国測量マイル。 NAUTICAL_MILES—長さの単位は米国測量海里。 YARDS—長さの単位は米国測量ヤード。 FEET—長さの単位は米国測量フィート。 INCHES—長さの単位はインチ。 DECIMAL_DEGREES—長さの単位は度 (10 進)。 POINTS—長さの単位はポイント。	String
out_area_units (オプション)	隣接するポリゴン間のエリアのオーバーラップを報告するために使用する単位を指定します。デフォルトは入力フィーチャの単位です。このパラメーターは、area_overlap パラメーターが、AREA_OVERLAP に設定されている場合のみ有効です。 UNKNOWN—面積単位は不明。 SQUARE_KILOMETERS—面積単位は平方キロメートル。 SQUARE_METERS—面積単位は平方メートル。 SQUARE_DECIMETERS—面積単位は平方デシメートル。 SQUARE_CENTIMETERS—面積単位は平方センチメートル。 SQUARE_MILLIMETERS—面積単位は平方ミリメートル。 SQUARE_MILES—面積単位は平方マイル。 SQUARE_NAUTICAL_MILES—面積単位は平方国際海里。 SQUARE_YARDS—面積単位は平方国際ヤード。 SQUARE_FEET—面積単位は平方国際フィート。 SQUARE_INCHES—面積単位は平方国際ヤード。 SQUARE_MILES_US—面積は平方米国測量マイル。 SQUARE_NAUTICAL_MILES_US—面積単位は平方米国測量海里。 SQUARE_YARDS_US—面積単位は平方米国測量ヤード。 SQUARE_FEET_US—面積単位は平方米国測量フィート。 SQUARE_INCHES_US—面積単位は平方米国測量インチ。 ACRES_US—面積単位は米国測量エーカー。 HECTARES—面積単位はヘクタール。 ACRES—面積単位は国際エーカー。 ARES—面積単位はアール。	String
precision (オプション)	使用される精度のレベルを指定します。ポイント出力を決定する際、ツールが入力空間参照のデフォルトよりも大きい精度レベルを適用する場合に、MAX_PRECISION オプションを使用します。 MAX_PRECISION—最大の精度を使用します。 DEFAULT_PRECISION—最初の入力フィーチャクラスの精度を使用します。これがデフォルトです。	Boolean

コードのサンプル

PairwisePolygonNeighbors の例 (Python ウィンドウ)

カナダ、ノバスコシア州の各選挙区に隣接する選挙区を検出します。

import arcpy

arcpy.management.MakeFeatureLayer(r"C:\Data\Canada\CanadaElecDist.shp", 
                                  "Canada_ElectoralDist")

arcpy.management.SelectLayerByAttribute("Canada_ElectoralDist", "NEW_SELECTION", 
                                        "\"PROVCODE\" = 'NS'")
count = arcpy.management.GetCount("Canada_ElectoralDist")[0]
print("Selected feature count: {}".format(count))

arcpy.analysis.PairwisePolygonNeighbors("Canada_ElectoralDist", 
                                r"C:\Data\Output\NS_elec_neigh.dbf", "ENNAME")
print(arcpy.GetMessages())

ライセンス情報

Basic: Yes
Standard: Yes
Advanced: Yes

サマリー

図

使用法

ヒント:

注意:

パラメーター

注意:

注意:

コードのサンプル

環境

ライセンス情報

関連トピック

このトピックの内容