アイデンティティ（Identity） (解析)
サマリ
入力フィーチャとアイデンティティ フィーチャの交差部分を求めます。アイデンティティ フィーチャと重なり合う入力フィーチャまたは入力フィーチャの部分には、そのアイデンティティ フィーチャの属性が適用されます。
図
 |
使用法
-
入力フィーチャは、ポイント、マルチポイント、ライン、またはポリゴンである必要があります。入力にアノテーション フィーチャ、ディメンション フィーチャ、またはネットワーク フィーチャは使用できません。
-
アイデンティティフィーチャはポリゴンであるか、入力フィーチャと同じジオメトリ タイプである必要があります。
-
このツールをポイント入力とポリゴンのアイデンティティ フィーチャに使用する場合、ポリゴンの境界線上のポイントは、出力に 2 回（境界線の一部であるポリゴンについて 1 回）追加されます。この例の出力に[インターセクト（Intersect）] ツールを実行すると、重複するポイントが特定されて、どちらを保持するかを決定できます。
-
[リレーションシップを保持する] パラメータをオンにするか [KEEP_RELATIONSHIPS] に設定すると、入力フィーチャとアイデンティティフィーチャとの空間リレーションシップが出力に書き出されます。入力がラインでアイデンティティフィーチャがポリゴンである場合、LEFT_poly および RIGHT_poly の 2 つのフィールドが追加されます。これらの新しいフィールドには、各入力ライン フィーチャの右側と左側のポリゴン アイデンティティ フィーチャの FID が含まれます。
-
入力フィーチャクラスの属性値が出力フィーチャクラスにコピーされます。ただし、[フィーチャ レイヤの作成（Make Feature Layer）] ツールで作成したレイヤを入力として使用し、フィールドの [比率ポリシーの使用] をチェックしている場合は、入力属性値の比率が計算され、出力属性値に適用されます。[比率ポリシーの使用] が有効な場合、オーバーレイ操作でフィーチャが分割されるときは、入力フィーチャの属性値の比率が出力フィーチャの属性に適用されます。入力フィーチャ ジオメトリが分割された比率に基づいて、出力値が決定されます。たとえば、入力ジオメトリが等分割された場合、入力フィーチャの属性値の 2 分の 1 が新しいフィーチャの属性値となります。[比率ポリシーの使用] は数値フィールドにのみ適用されます。
注意:ジオプロセシング ツールは、ジオデータベース フィーチャクラスまたはテーブル フィールドのスプリット ポリシーに従いません。
-
このツールは非常に大きなデータセットをタイル化し、パフォーマンスとスケーラビリティを向上します。詳細については、「大きなデータセットのジオプロセシング」をご参照ください。
-
このツールは、すべての入力がシングルパートの場合でも、出力としてマルチパート フィーチャを作成します。マルチパート フィーチャが望ましくない場合は、出力フィーチャクラスで [マルチパート → シングルパート（Multipart to Singlepart）] ツールを使用します。
構文
| パラメータ | 説明 | データ タイプ |
in_features |
入力フィーチャクラスまたはレイヤ。 | Feature Layer |
identity_features |
アイデンティティ フィーチャクラスまたはレイヤ。ポリゴンであるか、入力フィーチャと同じジオメトリ タイプである必要があります。 | Feature Layer |
out_feature_class |
作成されて、結果が書き込まれるフィーチャクラス。 | Feature Class |
join_attributes （オプション） |
どの属性を出力フィーチャクラスへ渡すかを指定します。
| String |
cluster_tolerance （オプション） |
すべてのフィーチャ座標（ノードと頂点）の最短距離、および X方向、Y 方向、XY 方向に座標を移動できる距離。 | Linear unit |
relationship （オプション） |
入力フィーチャとアイデンティティ フィーチャとの空間リレーションシップを出力に書き出すかどうかを選択します。この設定は、入力フィーチャがラインであり、アイデンティティ フィーチャがポリゴンの場合のみ適用されます。
| Boolean |
コードのサンプル
次の Python ウィンドウ スクリプトは、イミディエイト モードでアイデンティティ関数を使用する方法を示しています。
import arcpy
from arcpy import env
env.workspace = "c:/data/data.gdb"
arcpy.Identity_analysis("wells", "counties", "wells_w_county_info")
次のスタンドアロン スクリプトは、アイデンティティ関数をスクリプティングに適用する単純な例を示しています。
# IdentityWells.py # Description: Simple example showing use of Identity tool # Author: ESRI # Import system modules import arcpy from arcpy import env # Set the workspace env.workspace = "C:/data/data.gdb" # Set local parameters inFeatures = "wells" idFeatures = "counties" outFeatures = "wells_w_county_info" # Process: Use the Identity function arcpy.Identity_analysis (inFeatures, idFeatures, outFeatures)