ペアワイズ クリップ (Pairwise Clip) (解析)

サマリー

クリップ フィーチャと重なり合う入力フィーチャ部分を抽出します。

このツールを使用すると、別のフィーチャクラスの 1 つ以上のフィーチャをクッキーの抜き型のように使用して、1 つのフィーチャクラスを切り取ることができます。これは、別のより大きなフィーチャクラスのフィーチャの地理サブセットを含む新しいフィーチャクラス (調査領域または対象領域 (AOI) とも呼ばれる) を作成する場合には特に便利です。

ベクター データのクリップ操作には、代替ツールを使用できます。詳細については、[クリップ (Clip)] ツールをご参照ください。

図

使用法

• [クリップ フィーチャ] パラメーターの値には、[入力フィーチャ] パラメーターのタイプに応じてポイント、ライン、およびポリゴンを指定できます。

  • [入力フィーチャ] がポリゴンの場合、[クリップ フィーチャ] もポリゴンにする必要があります。
  • [入力フィーチャ] がラインの場合、[クリップ フィーチャ] にはラインまたはポリゴンを指定できます。ライン フィーチャをライン フィーチャでクリップする場合は、以下の図に示すように、一致するラインまたは線分だけが出力に書き込まれます。
  • [入力フィーチャ] がポイントの場合、[クリップ フィーチャ] にはポイント、ライン、またはポリゴンを指定できます。ポイント フィーチャをポイント フィーチャでクリップする場合は、以下の図に示すように、一致するポイントだけが出力に書き込まれます。ポイント フィーチャをライン フィーチャでクリップする場合は、ライン フィーチャに重なるポイントだけが出力に書き込まれます。

• [出力フィーチャクラス] パラメーターには、[入力フィーチャ] パラメーターのすべての属性が含まれます。

• ポリゴン フィーチャでクリップされたライン フィーチャ:

  

• ポリゴン フィーチャでクリップされたポイント フィーチャ:

  

• ライン フィーチャでクリップされたライン フィーチャ:

  

• ポイント フィーチャでクリップされたポイント フィーチャ:

  

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

パラメーター

ダイアログ

ラベル	説明	データ タイプ
入力フィーチャ	クリップ対象のフィーチャ。	Feature Layer
クリップ フィーチャ	入力フィーチャのクリップに使用するフィーチャ。	Feature Layer
出力フィーチャクラス	作成されるフィーチャクラス。	Feature Class
XY 許容値 (オプション)	すべてのフィーチャ座標の最短距離、および X 方向、Y 方向、XY 方向に座標を移動できる距離。座標の精度が低いデータには高い値を設定し、極めて精度の高いデータには低い値を設定します。 注意: このパラメーターの値を変更すると、失敗または予期しない結果が発生する可能性があります。このパラメーターを変更しないことをお勧めします。ツール ダイアログのビューからは削除されています。デフォルトでは、入力フィーチャクラスの空間参照の [XY許容値] プロパティが使用されます。	Linear Unit

Python

arcpy.analysis.PairwiseClip(in_features, clip_features, out_feature_class, {cluster_tolerance})

名前	説明	データ タイプ
in_features	クリップ対象のフィーチャ。	Feature Layer
clip_features	入力フィーチャのクリップに使用するフィーチャ。	Feature Layer
out_feature_class	作成されるフィーチャクラス。	Feature Class
cluster_tolerance (オプション)	すべてのフィーチャ座標の最短距離、および X 方向、Y 方向、XY 方向に座標を移動できる距離。座標の精度が低いデータには高い値を設定し、極めて精度の高いデータには低い値を設定します。 注意: このパラメーターの値を変更すると、失敗または予期しない結果が発生する可能性があります。このパラメーターを変更しないことをお勧めします。ツール ダイアログのビューからは削除されています。デフォルトでは、入力フィーチャクラスの空間参照の [XY許容値] プロパティが使用されます。	Linear Unit

コードのサンプル

PairwiseClip (ペアワイズ クリップ) の例 1 (Python ウィンドウ)

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.PairwiseClip_analysis("majorrds.shp", "study_quads.shp", 
                            "C:/output/studyarea.shp")

PairwiseClip (ペアワイズ クリップ) の例 2 (スタンドアロン スクリプト)

次の Python スクリプトは、スタンドアロン スクリプトで PairwiseClip 関数を使用する方法を示しています。

# Name: PairwiseClip_Example2.py
# Description: Clip major roads that fall within the study area. 
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/data"
# Set local variables
in_features = "majorrds.shp"
clip_features = "study_quads.shp"
out_feature_class = "C:/output/studyarea.shp"
# Execute Pairwise Clip
arcpy.PairwiseClip_analysis(in_features, clip_features, out_feature_class)

環境

出力データのデフォルト Z 値, M 座標精度, M 許容値, 出力データのコンフィグレーション キーワード, 出力データの M ドメイン, 出力データの XY ドメイン, 出力データの Z ドメイン, 出力座標系, 範囲, 出力に M 値がある, 出力に Z 値がある, XY 座標精度, XY 許容値, Z 座標精度, Z 許容値, 並列処理ファクター, 曲線セグメントの維持

特殊なケース

ライセンス情報

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