| ラベル | 説明 | データ タイプ |
入力フィーチャ | 交差する入力フィーチャクラスまたはレイヤーです。 サポートされている入力は 2 つのみです。 | Value Table |
出力フィーチャクラス | 出力フィーチャクラス。 | Feature Class |
結合する属性 (オプション) | 入力フィーチャのどの属性を出力フィーチャクラスへ渡すかを指定します。
| String |
XY 許容値 (オプション) | すべてのフィーチャ座標 (ノードと頂点) の最短距離、および X 方向、Y 方向、XY 方向に座標を移動できる距離。 注意:このパラメーターの値を変更すると、失敗または予期しない結果が発生する可能性があります。 このパラメーターは変更しないことをお勧めします。 ツール ダイアログ ボックスのビューからは削除されています。 デフォルトでは、入力フィーチャクラスの空間参照の [XY許容値] プロパティが使用されます。 | Linear Unit |
出力タイプ (オプション) | 返される交差のタイプを指定します。
| String |
最大精度を使用 (オプション) | [出力タイプ] パラメーター値が [ポイント] である場合に使用される精度のレベルを指定します。 このパラメーターは、[出力タイプ] パラメーター値が [入力と同様] か [ライン] の場合はサポートされません。 ポイント出力を決定する際、ツールが入力空間参照のデフォルトよりも大きい精度レベルを適用する場合に、このパラメーターをオンにします。
| Boolean |
サマリー
入力フィーチャのペアワイズ交差を計算します。 入力フィーチャ レイヤーまたはフィーチャクラス間でオーバーラップするフィーチャまたはフィーチャ部分が出力フィーチャクラスに書き出されます。 ペアワイズ交差とは、最初の入力から 1 つのフィーチャを選択し、オーバーラップする 2 番目の入力内のすべてのフィーチャと交差させることを意味します。
インターセクト操作には、代替ツールが利用できます。 詳細については、[インターセクト (Intersect)] ツールのドキュメントをご参照ください。
[ペアワイズ インターセクト (Pairwise Intersect)] ツールは、ジオメトリの交差部分が計算される点では [インターセクト (Intersect)] ツールと同様ですが、フィーチャのすべての組み合わせではなく、フィーチャのペアに対して交差部分が計算される点で異なります。
図
使用法
入力フィーチャクラスは 2 つのみサポートされています。
入力は、ポイント、マルチポイント、ライン、ポリゴンなどのシンプル フィーチャである必要があります。 アノテーション フィーチャ、ディメンション フィーチャ、ネットワーク フィーチャなどのコンプレックス フィーチャは使用できません。
入力のジオメトリ タイプが異なる場合、出力のジオメトリ タイプは、入力で最も低い次元のジオメトリのタイプがデフォルトになります。
- 入力がポイント フィーチャの場合、デフォルトの出力はポイント フィーチャになります。
- 入力がライン フィーチャで、ポイント フィーチャの入力がない場合、デフォルトの出力はライン フィーチャになります。
- すべての入力がポリゴン フィーチャの場合、デフォルトの出力はポリゴン フィーチャになります。
[出力タイプ] パラメーター値は、最も低い次元のジオメトリまたはより低い次元であるジオメトリの [入力フィーチャ] パラメーター値のものになります。 たとえば、すべての入力がポリゴンの場合、出力はポリゴン、ライン、またはポイントのいずれかである可能性があります。 入力の 1 つのタイプがラインであり、ポイントの入力がない場合は、出力はラインまたはポイントにできます。 入力のいずれかがポイントである場合、[出力タイプ] の値はポイントのみになります。
[最大精度の使用] パラメーターは、[出力タイプ] パラメーター値が [ポイント] の場合にのみ適用されます。 精度は、x,y 解像度と、処理の際に使用される x,y 許容値の組み合わせです。 デフォルトでは、最初の [入力フィーチャ] フィーチャクラスの空間参照のプロパティを使用します。
[精度] パラメーターがオンになっている場合、ポイント出力に対して可能な最大の精度値が使用されます。 このツールは、ツールで使用可能な最大精度を使用します。これは、ジオメトリ座標の絶対値と、ハードウェアの浮動小数点の精度に依存します。 デフォルトは 1 ミリメートルであるのに対し、使用される最大許容値の概算値は 0.002 ミリメートルです。
出力を書き出すと空間参照の解像度が適用されるため、ポイントが少し移動することがあります。
入力データに非線形セグメント (曲線) が含まれる場合、最良の結果を得るには「曲線セグメントの維持」環境を有効にし、「曲線処理方法」環境を [正確] に設定します。
[インターセクト (Intersect)] ツールとは異なり、ランクはサポートされていません。
デフォルトでは、入力の曲線フィーチャが密集化して出力されます。 出力で曲線をサポートするには、曲線セグメントの維持環境を使用します。
すべての入力に空間インデックスが必要です。 インデックスが誤っている可能性がある場合は、[空間インデックスの追加 (Add Spatial Index)] ツールを使用して、インデックス (特にシェープファイル) を作成するか、既存のインデックスを再構築します。
入力フィーチャに M 値または Z 値が存在する場合は、最初のフィーチャクラスの M 値および Z 値のみが出力フィーチャに転送されます。 最初のフィーチャクラスに M 値または Z 値が存在しない場合、出力に M 値または Z 値は含まれません。
出力フィーチャクラスの空間参照は、[入力フィーチャ] パラメーターの最初のフィーチャクラスの空間参照になります。 詳細については、「空間参照とジオプロセシング」をご参照ください。
このツールは、並列処理ファクター環境を優先します。 この環境が設定されていない場合 (デフォルト) や 100 に設定されている場合、フル並列処理が有効になり、ツールはコンピューター上のすべての論理コアに作業を分配しようとします。 この環境を 0 に設定した場合、並列処理は有効になりません。 ファクターを 1 ～ 99 に指定すると、ツールは数式 (並列処理ファクター / 100 * 論理コア) の小数部を切り上げた整数を適用して、使用する論理コアの割合を特定します。 この数式の結果が 0 または 1 の場合、並列処理は有効化されません。
パラメーター
arcpy.analysis.PairwiseIntersect(in_features, out_feature_class, {join_attributes}, {cluster_tolerance}, {output_type}, {precision})| 名前 | 説明 | データ タイプ |
in_features [in_features,...] | 交差する入力フィーチャクラスまたはレイヤーです。 サポートされている入力は 2 つのみです。 | Value Table |
out_feature_class | 出力フィーチャクラス。 | Feature Class |
join_attributes (オプション) | 入力フィーチャのどの属性を出力フィーチャクラスへ渡すかを指定します。
| String |
cluster_tolerance (オプション) | すべてのフィーチャ座標 (ノードと頂点) の最短距離、および X 方向、Y 方向、XY 方向に座標を移動できる距離。 注意:このパラメーターの値を変更すると、失敗または予期しない結果が発生する可能性があります。 このパラメーターは変更しないことをお勧めします。 ツール ダイアログ ボックスのビューからは削除されています。 デフォルトでは、入力フィーチャクラスの空間参照の [XY許容値] プロパティが使用されます。 | Linear Unit |
output_type (オプション) | 返される交差のタイプを指定します。
| String |
precision (オプション) | output_type パラメーター値が POINT である場合に使用される精度のレベルを指定します。 output_type パラメーター値が INPUT または LINE の場合、このパラメーターはサポートされません。 ポイント出力を決定する際、ツールが入力空間参照のデフォルトよりも大きい精度レベルを適用する場合に、MAX_PRECISION オプションを使用します。
| Boolean |
コードのサンプル
次の Python ウィンドウ スクリプトは、即時モードで PairwiseIntersect 関数を使用する方法を示しています。
import arcpy
arcpy.env.workspace = "C:/data/RedRiver_basin.gdb"
arcpy.analysis.PairwiseIntersect(["vegetation_stands", "road_buffer200m", "water_buffer100"],
"mysites", "ALL")河川が流れている植生タイプを検索します。
# 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 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