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

サマリー

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

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

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

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

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

使用法

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

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

  • [インターセクト (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

関連トピック