アイデンティティ (Identity) (解析)

サマリー

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

アイデンティティ ツールの図

使用法

  • [入力フィーチャ] パラメーター値には、ポイント、マルチポイント、ライン、またはポリゴンを指定できます。 入力にアノテーション フィーチャ、ディメンション フィーチャ、またはネットワーク フィーチャは使用できません。

  • [アイデンティティ フィーチャ] パラメーター値はポリゴンであるか、[入力フィーチャ] パラメーター値と同じジオメトリ タイプである必要があります。

  • このツールをポイント入力とポリゴンの [アイデンティティ フィーチャ] 値に使用する場合、ポリゴンの境界線上のポイントは、出力に 2 回 (境界線の一部であるポリゴンについて 1 回) 追加されます。 この例の出力に [インターセクト (Intersect)] ツールを実行すると、重複するポイントが特定されて、どちらを保持するかを決定できます。

  • [入力フィーチャ] パラメーター値のジオメトリがラインで、[アイデンティティ フィーチャ] パラメーター値のジオメトリがポリゴンの場合に、[リレーションシップを保持] パラメーターをオンにすると、出力ライン フィーチャクラスには LEFT_polyRIGHT_poly の 2 つのフィールドが追加されます。 これらのフィールドには、ライン フィーチャの左側および右側にある [アイデンティティ フィーチャ] パラメーター値のフィーチャ ID が格納されます。

  • 入力フィーチャクラスの属性値が出力フィーチャクラスにコピーされます。 ただし、[フィーチャ レイヤーの作成 (Make Feature Layer)] ツールで作成した 1 つ以上のレイヤーを入力として使用し、フィールドの [比率ポリシーの使用] をオンにしている場合は、入力属性値の比率が計算され、出力属性値に適用されます。 [比率ポリシーの使用] が有効な場合、オーバーレイ操作でフィーチャが分割されると、入力フィーチャの属性値の比率が出力フィーチャの属性に適用されます。 入力フィーチャ ジオメトリが分割された比率に基づいて、出力値が決定されます。 たとえば、入力ジオメトリが等分割された場合は、入力フィーチャの属性値の 1/2 が、新しい各フィーチャの属性値として割り当てられます。 [比率ポリシーの使用] は数値フィールドにのみ適用されます。

    注意:

    ジオプロセシング ツールは、ジオデータベース フィーチャクラスまたはテーブル フィールドの「スプリット ポリシー」に従いません。

  • パフォーマンスとスケーラビリティの向上のため、このツールは、タイル プロセスを使用して非常に大きなデータセットを処理します。 詳細については、「大きいデータセットのタイル化処理」をご参照ください。

  • このツールは、すべての入力がシングルパートの場合でも、出力としてマルチパート フィーチャを作成します。 マルチパート フィーチャが望ましくない場合は、出力フィーチャクラスで [マルチパート → シングルパート (Multipart to Singlepart)] ツールを使用します。

パラメーター

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

入力フィーチャクラスまたはレイヤー。

Feature Layer
アイデンティティ フィーチャ

アイデンティティ フィーチャクラスまたはレイヤー。 ポリゴンであるか、入力フィーチャと同じジオメトリ タイプである必要があります。

Feature Layer
出力フィーチャクラス

作成されて、結果が書き込まれるフィーチャクラス。

Feature Class
結合する属性
(オプション)

出力フィーチャクラスへ属性を渡す方法を指定します。

  • すべての属性入力フィーチャのすべての属性 (FID を含む) とアイデンティティ フィーチャを出力フィーチャへ渡します。 交差部分がない場合、アイデンティティ フィーチャの値は出力に転送されず (これらの値は、空の文字列または 0 に設定されます)、アイデンティティ フィーチャ FID は -1 になります。 これがデフォルトです。
  • フィーチャ ID を除くすべての属性入力フィーチャの FID を除いたすべての属性とアイデンティティ フィーチャを出力フィーチャへ渡します。 交差部分がない場合、アイデンティティ フィーチャの値は出力に転送されません (これらの値は、空の文字列または 0 に設定されます)。
  • フィーチャ ID のみ入力フィーチャのすべての属性と、アイデンティティ フィーチャの FID のみを出力フィーチャへ渡します。 交差部分がない場合、出力におけるアイデンティティ フィーチャの FID 属性値は -1 になります。
String
XY 許容値
(オプション)

すべてのフィーチャ座標 (ノードと頂点) の最短距離、および X 方向、Y 方向、XY 方向に座標を移動できる距離。

注意:

このパラメーターの値を変更すると、失敗または予期しない結果が発生する可能性があります。 このパラメーターは変更しないことをお勧めします。 ツール ダイアログ ボックスのビューからは削除されています。 デフォルトでは、入力フィーチャクラスの空間参照の [XY許容値] プロパティが使用されます。

Linear Unit
リレーションシップを保持
(オプション)

[入力フィーチャ] パラメーター値と [アイデンティティ フィーチャ] パラメーター値との追加の空間リレーションシップを、出力に書き出すかどうかを指定します。 これは、[入力フィーチャ] パラメーター値のジオメトリ タイプがラインで、[アイデンティティ フィーチャ] パラメーター値のジオメトリ タイプがポリゴンである場合にのみ適用されます。

  • オフ - 追加の空間リレーションシップは出力に書き出されません。
  • オン - 出力ライン フィーチャには、LEFT_polyRIGHT_poly の 2 つのフィールドが追加されます。 これらのフィールドには、ライン フィーチャの左側および右側にある [アイデンティティ フィーチャ] パラメーター値のフィーチャ ID が格納されます。
Boolean

arcpy.analysis.Identity(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 に設定されます)、アイデンティティ フィーチャ FID は -1 になります。 これがデフォルトです。
  • NO_FID入力フィーチャの FID を除いたすべての属性とアイデンティティ フィーチャを出力フィーチャへ渡します。 交差部分がない場合、アイデンティティ フィーチャの値は出力に転送されません (これらの値は、空の文字列または 0 に設定されます)。
  • ONLY_FID入力フィーチャのすべての属性と、アイデンティティ フィーチャの FID のみを出力フィーチャへ渡します。 交差部分がない場合、出力におけるアイデンティティ フィーチャの FID 属性値は -1 になります。
String
cluster_tolerance
(オプション)

すべてのフィーチャ座標 (ノードと頂点) の最短距離、および X 方向、Y 方向、XY 方向に座標を移動できる距離。

注意:

このパラメーターの値を変更すると、失敗または予期しない結果が発生する可能性があります。 このパラメーターは変更しないことをお勧めします。 ツール ダイアログ ボックスのビューからは削除されています。 デフォルトでは、入力フィーチャクラスの空間参照の [XY許容値] プロパティが使用されます。

Linear Unit
relationship
(オプション)

in_features パラメーター値と identity_features パラメーター値との追加の空間リレーションシップを、出力に書き出すかどうかを指定します。 これは、in_features パラメーター値のジオメトリ タイプがラインで、identity_features パラメーター値のジオメトリ タイプがポリゴンである場合にのみ適用されます。

  • NO_RELATIONSHIPS追加の空間リレーションシップは出力に書き出されません。
  • KEEP_RELATIONSHIPS出力ライン フィーチャには、LEFT_polyRIGHT_poly の 2 つのフィールドが追加されます。 これらのフィールドには、ライン フィーチャの左側および右側にある identity_features パラメーター値のフィーチャ ID が格納されます。
Boolean

コードのサンプル

Identity の例 1 (Python ウィンドウ)

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

import arcpy
arcpy.env.workspace = "c:/data/data.gdb"
arcpy.analysis.Identity("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

# Set the workspace
arcpy.env.workspace = "C:/data/data.gdb"

# Set local parameters
inFeatures = "wells"
idFeatures = "counties"
outFeatures = "wells_w_county_info"

# Process: Use the Identity function
arcpy.analysis.Identity(inFeatures, idFeatures, outFeatures)

環境

特殊なケース

並列処理ファクター

このツールは、並列処理ファクター環境を優先します。 環境が設定されていない場合 (デフォルト) または 0 に設定されている場合、並列処理は無効になります。並列処理は使用されず、処理は順番に実行されます。 環境を 100 に設定すると並列処理が有効になります。並列処理が使用され、処理は並列で実行されます。 並列処理を有効にすると、最大 10 個のコアが使用されます。

並列処理は現在、ポリゴンに対するポリゴン、ポリゴンに対するライン、およびポリゴンに対するポイントのオーバーレイ操作でサポートされています。