イレース (Erase) (解析)

Advanced のライセンスで利用可能。

サマリー

イレース フィーチャを入力フィーチャに重ねることによって、新しいフィーチャクラスを作成します。入力フィーチャにイレース フィーチャを重ね合わせ、イレース フィーチャ以外の部分だけが出力フィーチャクラスにコピーされます。

イレース操作には、代替ツールが利用できます。詳細については、[ペアワイズ イレース (Pairwise Erase)] ツールのドキュメントをご参照ください。

図

使用法

• [イレース フィーチャ] ジオメトリと重なる [入力フィーチャ] ジオメトリは削除されます。

• [入力フィーチャ] の値がイレース フィーチャと同じかそれよりも次元の低いフィーチャ タイプである場合、[イレース フィーチャ] はポイント、ライン、またはポリゴンのいずれでもかまいません。ポリゴン イレース フィーチャは、入力フィーチャからポリゴン、ライン、またはポイントを削除するために使用できます。ライン イレース フィーチャは入力フィーチャからラインまたはポイントを削除するために使用できます。ポイント イレース フィーチャは、入力フィーチャからポイントを削除するために使用できます。

• 入力フィーチャクラスの属性値が出力フィーチャクラスにコピーされます。ただし、[フィーチャ レイヤーの作成 (Make Feature Layer)] ツールで作成した 1 つ以上のレイヤーを入力として使用し、フィールドの [比率ポリシーの使用] をオンにしている場合は、入力属性値の比率が計算され、出力属性値に適用されます。[比率ポリシーの使用] が有効な場合、オーバーレイ操作でフィーチャが分割されると、入力フィーチャの属性値の比率が出力フィーチャの属性に適用されます。入力フィーチャ ジオメトリが分割された比率に基づいて、出力値が決定されます。たとえば、入力ジオメトリが等分割された場合は、入力フィーチャの属性値の 1/2 が、新しい各フィーチャの属性値として割り当てられます。[比率ポリシーの使用] は数値フィールドにのみ適用されます。

  注意:

  ジオプロセシング ツールは、ジオデータベース フィーチャクラスまたはテーブル フィールドのスプリット ポリシーに従いません。

• このツールは非常に大きなデータセットをタイル化し、パフォーマンスとスケーラビリティを向上します。詳細については、「大きなデータセットのジオプロセシング」をご参照ください。

• このツールは、すべての入力がシングルパートの場合でも、出力としてマルチパート フィーチャを作成します。マルチパート フィーチャが望ましくない場合は、出力フィーチャクラスで [マルチパート → シングルパート (Multipart to Singlepart)] ツールを使用します。

• このツールは、並列処理ファクター環境を優先します。 環境が設定されていない場合 (デフォルト) または 0 に設定されている場合、並列処理は無効になります。 環境を 100 に設定すると並列処理が有効になります。 並列処理を有効にすると、最大 10 個のコアが使用されます。

パラメーター

ダイアログ

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

Python

arcpy.analysis.Erase(in_features, erase_features, out_feature_class, {cluster_tolerance})

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

コードのサンプル

Erase (イレース) の例 1 (Python ウィンドウ)

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

import arcpy
arcpy.env.workspace = 'C:/data/gdb'
arcpy.Erase_analysis(r'redlands.gdb\rdlswells\well', 
                     r'redlands.gdb\rdlsfloodzones\flood', 
                     r'redlands.gdb\wellsoutside_flood')

Erase (イレース) の例 2 (スタンドアロン スクリプト)

幹線道路から大きな影響を受けている領域を除外した、植生の領域を検出します。

# Name: Erase.py
# Description: Find areas of suitable vegetation that exclude areas heavily 
#              impacted by major roads
# import system modules 
import arcpy
# Set environment settings
arcpy.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"
arcpy.Erase_analysis(suitableVeg, roadsBuffer, eraseOutput)

環境

自動コミット, 修飾されたフィールド名, 出力データのデフォルト Z 値, M 座標精度, M 許容値, 出力データのコンフィグレーション キーワード, 出力データの M ドメイン, 出力データの XY ドメイン, 出力データの Z ドメイン, 出力座標系, 範囲, 出力に M 値がある, 出力に Z 値がある, XY 座標精度, XY 許容値, Z 座標精度, Z 許容値, 並列処理ファクター

特殊なケース

ライセンス情報

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