イレース (Erase) (解析)

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

サマリー

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

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

イレース ツールの図

使用法

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

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

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

    注意:

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

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

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

パラメーター

ラベル説明データ タイプ
入力フィーチャ

入力フィーチャクラスまたはレイヤー。

Feature Layer
イレース フィーチャ

入力内の重なるフィーチャ部分を削除するために使用されるフィーチャ。

Feature Layer
出力フィーチャクラス

イレース フィーチャと重ならない入力フィーチャだけを含むフィーチャクラス。

Feature Class
XY 許容値
(オプション)

すべてのフィーチャ座標 (ノードと頂点) の最短距離、および X 方向、Y 方向、XY 方向に座標を移動できる距離。

注意:

このパラメーターの値を変更すると、失敗または予期しない結果が発生する可能性があります。 このパラメーターは変更しないことをお勧めします。 ツール ダイアログ ボックスのビューからは削除されています。 デフォルトでは、入力フィーチャクラスの空間参照の [XY許容値] プロパティが使用されます。

Linear Unit

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.analysis.Erase(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.analysis.Select(veg, suitableVeg, whereClause)

# Buffer areas of impact around major roads
roads = "majorrds"
roadsBuffer = "C:/output/Output.gdb/buffer_output"
distanceField = "Distance"
dissolveField = "Distance"
arcpy.analysis.Buffer(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.analysis.Erase(suitableVeg, roadsBuffer, eraseOutput)

環境

特殊なケース

並列処理ファクター

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

並列処理は現在、ポリゴンに対するポリゴン、ポリゴンに対するライン、およびポリゴンに対するポイントのオーバーレイ操作でサポートされています。

ライセンス情報

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

関連トピック