イレース(Erase) (解析)
サマリ
イレース フィーチャのポリゴンを入力フィーチャに重ねることによって、新しいフィーチャクラスを作成します。入力フィーチャにイレース フィーチャを重ね合わせ、イレース フィーチャ以外の部分だけが出力フィーチャクラスにコピーされます。
図
使用法
-
[イレース フィーチャ] ジオメトリと 重なる [入力フィーチャ] ジオメトリは削除されます。
-
入力フィーチャがイレース フィーチャと同じかそれよりも次元の低いフィーチャ タイプである場合、イレース フィーチャはポイント、ライン、またはポリゴンのいずれでも構いません。ポリゴン イレース フィーチャは、入力フィーチャからポリゴン、ライン、またはポイントを削除するために使用できます。ライン イレース フィーチャは入力フィーチャからラインまたはポイントを削除するために使用できます。ポイント イレース フィーチャは、入力フィーチャからポイントを削除するために使用できます。
-
入力フィーチャクラスの属性値が出力フィーチャクラスにコピーされます。ただし、[フィーチャ レイヤの作成(Make Feature Layer)] ツールで作成した 1 つ以上のレイヤを入力として使用し、フィールドの [比率ポリシーの使用] をオンにしている場合は、入力属性値の比率が計算され、出力属性値に適用されます。[比率ポリシーの使用] が有効な場合、オーバーレイ操作でフィーチャが分割されると、入力フィーチャの属性値の比率が出力フィーチャの属性に適用されます。入力フィーチャ ジオメトリが分割された比率に基づいて、出力値が決定されます。たとえば、入力ジオメトリが等分割された場合、入力フィーチャの属性値の 2 分の 1 が新しいフィーチャの属性値となります。[比率ポリシーの使用] は数値フィールドにのみ適用されます。
注意:ジオプロセシング ツールは、ジオデータベース フィーチャクラスまたはテーブル フィールドのスプリット ポリシーに従いません。
-
このツールは非常に大きなデータセットをタイル化し、パフォーマンスとスケーラビリティを向上します。詳細については、「大きなデータセットのジオプロセシング」をご参照ください。
-
このツールは、すべての入力がシングルパートの場合でも、出力としてマルチパート フィーチャを作成します。マルチパート フィーチャが望ましくない場合は、出力フィーチャクラスで [マルチパート → シングルパート(Multipart to Singlepart)] ツールを使用します。
構文
パラメータ | 説明 | データ タイプ |
in_features |
入力フィーチャクラスまたはレイヤ。 | Feature Layer |
erase_features |
入力内の重なるフィーチャ部分を削除するために使用されるフィーチャ。 | Feature Layer |
out_feature_class |
イレース フィーチャと重ならない入力フィーチャだけを含むフィーチャクラス。 | Feature Class |
cluster_tolerance (オプション) |
すべてのフィーチャ座標(ノードと頂点)の最短距離、および X 方向、Y 方向、XY 方向に座標を移動できる距離。 | Linear unit |
コードのサンプル
次の Python ウィンドウ スクリプトは、イミディエイト モードでイレース関数を使用する方法を示しています。
import arcpy
from arcpy import env
env.workspace = "C:/data/data/gdb"
arcpy.Erase_analysis(r'redlands.gdb\rdlswells\well',r'redlands.gdb\rdlsfloodzones\flood',r'redlands.gdb\wellsoutside_flood','#')
幹線道路から大きな影響を受けている領域を除外した、植生の領域を検出します。
# Name: Erase.py
# Description: Find areas of suitable vegetation which exclude areas heavily impacted by major roads
# Author: ESRI
# import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data/Habitat_Analysis.gdb"
# Select suitable vegetation patches from all vegetation
veg = "vegtype"
suitableVeg = "C:/output/Output.gdb/suitable_vegetation"
whereClause = "HABITAT = 1"
arcpy.Select_analysis(veg, suitableVeg, whereClause)
# Buffer areas of impact around major roads
roads = "majorrds"
roadsBuffer = "C:/output/Output.gdb/buffer_output"
distanceField = "Distance"
dissolveField = "Distance"
arcpy.Buffer_analysis(roads, roadsBuffer, distanceField, "FULL", "ROUND", "LIST", dissolveField)
# Erase areas of impact around major roads from the suitable vegetation patches
eraseOutput = "C:/output/Output.gdb/suitable_vegetation_minus_roads"
xyTol = "1 Meters"
arcpy.Erase_analysis(suitableVeg, roadsBuffer, eraseOutput, xyTol)