アイデンティティ (Identity)—ヘルプ

サマリー
図
使用法
構文
コードのサンプル
環境
ライセンス情報

サマリー

入力フィーチャとアイデンティティフィーチャの交差部分を求めます。アイデンティティフィーチャと重なり合う入力フィーチャまたは入力フィーチャの部分には、そのアイデンティティフィーチャの属性が適用されます。

図

使用法

入力フィーチャは、ポイント、マルチポイント、ライン、またはポリゴンである必要があります。入力にアノテーションフィーチャ、ディメンションフィーチャ、またはネットワークフィーチャは使用できません。
アイデンティティフィーチャはポリゴンであるか、入力フィーチャと同じジオメトリタイプである必要があります。
このツールをポイント入力とポリゴンのアイデンティティフィーチャに使用する場合、ポリゴンの境界線上のポイントは、出力に 2 回 (境界線の一部であるポリゴンについて 1 回) 追加されます。この例の出力に [インターセクト (Intersect)] ツールを実行すると、重複するポイントが特定されて、どちらを保持するかを決定できます。
[入力フィーチャ] がラインで [アイデンティティフィーチャ] がポリゴンの場合に、[リレーションシップを保持] パラメーターをオンに (Python では relationship を KEEP_RELATIONSHIPS に設定) すると、出力ラインフィーチャクラスには LEFT_poly と RIGHT_poly の 2 つのフィールドが追加されます。これらのフィールドには、ラインフィーチャの左側および右側にある [アイデンティティフィーチャ] のフィーチャ ID が格納されます。
入力フィーチャクラスの属性値が出力フィーチャクラスにコピーされます。ただし、[フィーチャレイヤーの作成 (Make Feature Layer)] ツールで作成した 1 つ以上のレイヤーを入力として使用し、フィールドの [比率ポリシーの使用] をオンにしている場合は、入力属性値の比率が計算され、出力属性値に適用されます。[比率ポリシーの使用] が有効な場合、オーバーレイ操作でフィーチャが分割されると、入力フィーチャの属性値の比率が出力フィーチャの属性に適用されます。入力フィーチャジオメトリが分割された比率に基づいて、出力値が決定されます。たとえば、入力ジオメトリが等分割された場合は、入力フィーチャの属性値の 1/2 が、新しい各フィーチャの属性値として割り当てられます。[比率ポリシーの使用] は数値フィールドにのみ適用されます。
注意:
ジオプロセシングツールは、ジオデータベースフィーチャクラスまたはテーブルフィールドのスプリットポリシーに従いません。
このツールは非常に大きなデータセットをタイル化し、パフォーマンスとスケーラビリティを向上します。詳細については、「大きなデータセットのジオプロセシング」をご参照ください。
このツールは、すべての入力がシングルパートの場合でも、出力としてマルチパートフィーチャを作成します。マルチパートフィーチャが望ましくない場合は、出力フィーチャクラスで [マルチパート → シングルパート (Multipart to Singlepart)] ツールを使用します。

構文

Identity_analysis (in_features, identity_features, out_feature_class, {join_attributes}, {cluster_tolerance}, {relationship})

パラメーター	説明	データタイプ
in_features	入力フィーチャクラスまたはレイヤー。	Feature Layer
identity_features	アイデンティティフィーチャクラスまたはレイヤー。ポリゴンであるか、入力フィーチャと同じジオメトリタイプである必要があります。	Feature Layer
out_feature_class	作成されて、結果が書き込まれるフィーチャクラス。	Feature Class
join_attributes (オプション)	どの属性を出力フィーチャクラスへ渡すかを指定します。 ALL —入力フィーチャのすべての属性 (FID を含む) とアイデンティティフィーチャを出力フィーチャへ渡します。交差部分がない場合、アイデンティティフィーチャの値は出力に転送されず (これらの値は、空の文字列または 0 に設定されます)、アイデンティティフィーチャは -1 になります。これがデフォルトです。 NO_FID —入力フィーチャの FID を除いたすべての属性とアイデンティティフィーチャを出力フィーチャへ渡します。交差部分がない場合、アイデンティティフィーチャの値は出力に転送されません (これらの値は、空の文字列または 0 に設定されます)。 ONLY_FID —入力フィーチャのすべての属性と、アイデンティティフィーチャの FID のみを出力フィーチャへ渡します。交差部分がない場合、アイデンティティフィーチャ FID 属性値は -1 になります。	String
cluster_tolerance (オプション)	すべてのフィーチャ座標 (ノードと頂点) の最短距離、および X 方向、Y 方向、XY 方向に座標を移動できる距離。	Linear unit
relationship (オプション)	in_features と identity_features 間のその他の空間リレーションシップを、出力に書き込むかどうかを決定します。このパラメーターは、in_features がラインで identity_features がポリゴンの場合にのみ適用されます。 NO_RELATIONSHIPS —空間リレーションシップが決定されません。 KEEP_RELATIONSHIPS —出力ラインフィーチャに LEFT_poly と RIGHT_poly の 2 つのフィールドが追加されます。これらのフィールドには、ラインフィーチャの左側および右側にある identity_features のフィーチャ ID が格納されます。	Boolean

コードのサンプル

Identity (アイデンティティ) の例 1 (Python ウィンドウ)

次の Python ウィンドウスクリプトは、イミディエイトモードでアイデンティティ関数を使用する方法を示しています。

import arcpy
from arcpy import env
env.workspace = "c:/data/data.gdb"
arcpy.Identity_analysis("wells", "counties", "wells_w_county_info")

Identity (アイデンティティ) の例 2 (スタンドアロン Python スクリプト)

次のスタンドアロン Python スクリプトは、Identity (アイデンティティ) 関数をスクリプティングに適用する単純な例を示しています。

# IdentityWells.py
# Description: Simple example showing use of Identity tool
 
# 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)

環境

ライセンス情報

ArcGIS Desktop Basic: いいえ
ArcGIS Desktop Standard: いいえ
ArcGIS Desktop Advanced: はい

ArcMap

アイデンティティ (Identity)