クリップ(Clip) (解析)
サマリ
クリップ フィーチャと重なり合う入力フィーチャ部分を抽出します。
このツールを使用すると、フィーチャクラスの 1 つ以上のフィーチャをクッキーの抜き型のように使用して、別のフィーチャクラスの一部分を切り抜くことができます。これは、別のより大きなフィーチャクラスのフィーチャの地理サブセットを含む新しいフィーチャクラス(調査領域または対象領域(AOI)とも呼ばれる)を作成する場合には特に便利です。
図
使用法
-
[クリップ フィーチャ] には、[入力フィーチャ] のタイプに応じてポイント、ライン、およびポリゴンを指定できます。
- [入力フィーチャ] がポリゴンの場合、[クリップ フィーチャ] もポリゴンにする必要があります。
- [入力フィーチャ] がラインの場合、[クリップ フィーチャ] にはラインまたはポリゴンを指定できます。ライン フィーチャをライン フィーチャでクリップする場合は、以下の図に示すように、一致するラインまたは線分だけが出力に書き込まれます。
- [入力フィーチャ] がポイントの場合、[クリップ フィーチャ] にはポイント、ライン、またはポリゴンを指定できます。ポイント フィーチャをポイント フィーチャでクリップする場合は、以下の図に示すように、一致するポイントだけが出力に書き込まれます。ポイント フィーチャをライン フィーチャでクリップする場合は、ライン フィーチャに重なるポイントだけが出力に書き込まれます。
-
出力フィーチャクラスには入力フィーチャのすべての属性が含まれます。
-
このツールは非常に大きなデータセットをタイル化し、パフォーマンスとスケーラビリティを向上します。詳細については、「大きなデータセットのジオプロセシング」をご参照ください。
-
ポリゴン フィーチャでクリップされたライン フィーチャ
-
ポリゴン フィーチャでクリップされたポイント フィーチャ
ライン フィーチャでクリップされたライン フィーチャ
ポイント フィーチャでクリップされたポイント フィーチャ
-
入力フィーチャクラスの属性値が出力フィーチャクラスにコピーされます。ただし、[フィーチャ レイヤの作成(Make Feature Layer)] ツールで作成した 1 つ以上のレイヤを入力として使用し、フィールドの [比率ポリシーの使用] をオンにしている場合は、入力属性値の比率が計算され、出力属性値に適用されます。[比率ポリシーの使用] が有効な場合、オーバーレイ操作でフィーチャが分割されると、入力フィーチャの属性値の比率が出力フィーチャの属性に適用されます。入力フィーチャ ジオメトリが分割された比率に基づいて、出力値が決定されます。たとえば、入力ジオメトリが等分割された場合、入力フィーチャの属性値の 2 分の 1 が新しいフィーチャの属性値となります。[比率ポリシーの使用] は数値フィールドにのみ適用されます。
注意:ジオプロセシング ツールは、ジオデータベース フィーチャクラスまたはテーブル フィールドのスプリット ポリシーに従いません。
構文
パラメータ | 説明 | データ タイプ |
in_features |
クリップ対象のフィーチャ。 | Feature Layer |
clip_features |
入力フィーチャのクリップに使用されるフィーチャ。 | Feature Layer |
out_feature_class |
作成されるフィーチャクラス。 | Feature Class |
cluster_tolerance (オプション) |
すべてのフィーチャ座標の最短距離、および X 方向、Y 方向、XY 方向に座標を移動できる距離。座標の精度が低いデータには高い値を設定し、きわめて精度の高いデータには低い値を設定します。 | Linear unit |
コードのサンプル
次の Python ウィンドウ スクリプトは、イミディエイト モードで Clip(クリップ)関数を使用する方法を示しています。
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.Clip_analysis("majorrds.shp", "study_quads.shp", "C:/output/studyarea.shp")
次の Python スクリプトは、スタンドアロン スクリプトでクリップ関数を使用する方法を示しています。
# Name: Clip_Example2.py
# Description: Clip major roads that fall within the study area.
# Import system modules
import arcpy
from arcpy import env
# Set workspace
env.workspace = "C:/data"
# Set local variables
in_features = "majorrds.shp"
clip_features = "study_quads.shp"
out_feature_class = "C:/output/studyarea.shp"
xy_tolerance = ""
# Execute Clip
arcpy.Clip_analysis(in_features, clip_features, out_feature_class, xy_tolerance)