ペアワイズ インターセクト (Pairwise Intersect) (解析)

サマリー

入力フィーチャのペアワイズ交差を計算します。 入力フィーチャ レイヤーまたはフィーチャクラス間でオーバーラップするフィーチャまたはフィーチャ部分が出力フィーチャクラスに書き出されます。 ペアワイズ交差とは、最初の入力から 1 つのフィーチャを選択し、オーバーラップする 2 番目の入力内のすべてのフィーチャと交差させることを意味します。

インターセクト操作には、代替ツールが利用できます。 詳細については、[インターセクト (Intersect)] ツールのドキュメントをご参照ください。

[ペアワイズ インターセクト (Pairwise Intersect)] ツールは、交差部分が計算される点では [インターセクト (Intersect)] ツールと同様ですが、フィーチャのすべての組み合わせではなく、フィーチャのペアに対して交差部分が計算される点で異なります。

ペアワイズ インターセクト ツールの詳細

ペアワイズ インターセクト ツールの図

使用法

  • 入力フィーチャクラスは 2 つのみサポートされています。

  • 入力は、ポイント、マルチポイント、ライン、ポリゴンなどのシンプル フィーチャである必要があります。 アノテーション フィーチャ、ディメンション フィーチャ、ネットワーク フィーチャなどのコンプレックス フィーチャは使用できません。

  • 入力のジオメトリ タイプが異なる場合、出力のジオメトリ タイプは、入力で最も低い次元のジオメトリのタイプがデフォルトになります。

    • 入力がポイント フィーチャの場合、デフォルトの出力はポイント フィーチャになります。
    • 入力がライン フィーチャで、ポイント フィーチャの入力がない場合、デフォルトの出力はライン フィーチャになります。
    • すべての入力がポリゴン フィーチャの場合、デフォルトの出力はポリゴン フィーチャになります。

  • [出力タイプ] パラメーター値は、最も低い次元のジオメトリまたはより低い次元であるジオメトリの [入力フィーチャ] パラメーター値のものになります。 たとえば、すべての入力がポリゴンの場合、出力はポリゴン、ライン、またはポイントのいずれかである可能性があります。 入力の 1 つのタイプがラインであり、ポイントの入力がない場合は、出力はラインまたはポイントにできます。 入力のいずれかがポイントである場合、[出力タイプ] の値はポイントのみになります。

  • [インターセクト (Intersect)] ツールとは異なり、ランクはサポートされていません。

  • デフォルトでは、入力の曲線フィーチャが密集化して出力されます。 出力で曲線をサポートするには、[曲線セグメントの維持] 環境を使用します。

  • すべての入力に空間インデックスが必要です。 インデックスが誤っている可能性がある場合は、[空間インデックスの追加 (Add Spatial Index)] ツールを使用して、インデックス (特にシェープファイル) を作成するか、既存のインデックスを再構築します。

  • 入力フィーチャに M 値または Z 値が存在する場合は、最初のフィーチャクラスの M 値および Z 値のみが出力フィーチャに転送されます。 最初のフィーチャクラスに M 値または Z 値が存在しない場合、出力に M 値または Z 値は含まれません。

  • 出力フィーチャクラスの空間参照は、[入力フィーチャ] パラメーターの最初のフィーチャクラスの空間参照になります。 詳細については、「空間参照とジオプロセシング」をご参照ください。

  • このツールは、並列処理ファクター環境を優先します。 この環境が設定されていない場合 (デフォルト) や 100 に設定されている場合、フル並列処理が有効になり、ツールはコンピューター上のすべての論理コアに作業を分配しようとします。 この環境を 0 に設定した場合、並列処理は有効になりません。 ファクターを 1 ~ 99 に指定すると、ツールは数式 (並列処理ファクター / 100 * 論理コア) の小数部を切り上げた整数を適用して、使用する論理コアの割合を特定します。 この数式の結果が 0 または 1 の場合、並列処理は有効化されません。

パラメーター

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

交差する入力フィーチャクラスまたはレイヤーです。 入力できるのは 2 つのみです。

Value Table
出力フィーチャクラス

出力フィーチャクラス。

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

入力フィーチャのどの属性を出力フィーチャクラスへ渡すかを指定します。

  • すべての属性入力フィーチャのすべての属性を出力フィーチャクラスへ渡します。 これがデフォルトです。
  • フィーチャ ID を除くすべての属性入力フィーチャの FID を除いたすべての属性を出力フィーチャクラスへ渡します。
  • フィーチャ ID のみ入力フィーチャの FID フィールドのみを出力フィーチャクラスへ渡します。
String
XY 許容値
(オプション)

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

注意:

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

Linear Unit
出力タイプ
(オプション)

返される交差のタイプを指定します。

  • 入力と同様返される交差は、最も低い次元のジオメトリである入力フィーチャのジオメトリ タイプと同一になります。 すべての入力がポリゴンである場合、出力フィーチャクラスにはポリゴンが含まれます。 1 つ以上の入力がラインであり、ポイントの入力がない場合は、出力はラインになります。 1 つ以上の入力がポイントである場合、出力フィーチャクラスにはポイントが含まれます。 これがデフォルトです。
  • ライン返される交差はラインになります。 ポイントの入力がない場合のみ有効です。
  • ポイント返される交差はポイントになります。 入力がラインまたはポリゴンである場合、出力はマルチポイント フィーチャクラスになります。
String

arcpy.analysis.PairwiseIntersect(in_features, out_feature_class, {join_attributes}, {cluster_tolerance}, {output_type})
名前説明データ タイプ
in_features
[in_features,...]

交差する入力フィーチャクラスまたはレイヤーです。 入力できるのは 2 つのみです。

Value Table
out_feature_class

出力フィーチャクラス。

Feature Class
join_attributes
(オプション)

入力フィーチャのどの属性を出力フィーチャクラスへ渡すかを指定します。

  • ALL入力フィーチャのすべての属性を出力フィーチャクラスへ渡します。 これがデフォルトです。
  • NO_FID入力フィーチャの FID を除いたすべての属性を出力フィーチャクラスへ渡します。
  • ONLY_FID入力フィーチャの FID フィールドのみを出力フィーチャクラスへ渡します。
String
cluster_tolerance
(オプション)

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

注意:

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

Linear Unit
output_type
(オプション)

返される交差のタイプを指定します。

  • INPUT返される交差は、最も低い次元のジオメトリである入力フィーチャのジオメトリ タイプと同一になります。 すべての入力がポリゴンである場合、出力フィーチャクラスにはポリゴンが含まれます。 1 つ以上の入力がラインであり、ポイントの入力がない場合は、出力はラインになります。 1 つ以上の入力がポイントである場合、出力フィーチャクラスにはポイントが含まれます。 これがデフォルトです。
  • LINE返される交差はラインになります。 ポイントの入力がない場合のみ有効です。
  • POINT返される交差はポイントになります。 入力がラインまたはポリゴンである場合、出力はマルチポイント フィーチャクラスになります。
String

コードのサンプル

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

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

import arcpy
arcpy.env.workspace = "C:/data/RedRiver_basin.gdb"
arcpy.analysis.PairwiseIntersect(["vegetation_stands", "road_buffer200m", "water_buffer100"], 
                                 "mysites", "ALL")
PairwiseIntersect の例 2 (スタンドアロン スクリプト)

河川が流れている植生タイプを検索します。

# Name: StreamsInVegetationIntersect.py
# Purpose: Determine the vegetation type streams are traveling through.

# Import system modules
import arcpy

# Set the workspace (to avoid having to type in the full path to the data every time)
arcpy.env.workspace = "c:/data/data.gdb"    

# Process: Find all streams in each vegetation type
inFeatures = ["vegetation", "streams"]
intersectOutput = "streams_in_vegtype"

arcpy.analysis.PairwiseIntersect(inFeatures, intersectOutput)

ライセンス情報

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

関連トピック