ペアワイズ クリップ (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

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.analysis.PairwiseClip("majorrds.shp", "study_quads.shp", 
                            "C:/output/studyarea.shp")
PairwiseClip の例 2 (スタンドアロン スクリプト)

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

# 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"

# Run Pairwise Clip
arcpy.analysis.PairwiseClip(in_features, clip_features, out_feature_class)

ライセンス情報

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

関連トピック