ポリゴンの単純化 (Simplify Polygon)

サマリ

基本的な形状を維持しながら不要な屈曲を取り除くことによってポリゴンを単純化します。

図

使用法

• 単純化する方法には 2 つあります。

  • [重要なポイントを保持](Python では POINT_REMOVE) は、2 つの方法のうち、より高速な方法です。これは、余分な頂点を取り除きます。この方法は、とりわけデータが既知の場合に、データ圧縮またはより粗い単純化のために使用します。結果として生成されるポリゴンの鋭角 (鋭いコーナー) は、許容値が大きくなるにつれ、大幅に鋭くなるため、ポリゴンの見栄えが悪くなることがあります。
  • [重要な屈曲を保持](Python ではBEND_SIMPLIFY) は時間がかかる方法ですが、一般的に、元のフィーチャに忠実な見栄えの良い結果が生成されます。これは、ポリゴンの不要な屈曲を取り除きます。この方法は、単純化の度合いを抑え、より精密にしたい場合に使用します。

• [最小エリア] パラメーターは、単純化されたポリゴンに対してのみ適用されます。単純化プロセスの完了後に最小領域より小さいサイズに縮小されたポリゴンはすべて、出力フィーチャクラスから除去されます。これは、共通のエッジを共有する一連の隣接するポリゴンの場合は、そのすべてのポリゴンの合計面積に適用されます。

• このツールは、2 つの出力フィーチャクラスを生成します。1 つは単純化されたポリゴンを格納するためのライン フィーチャクラスであり、もう 1 つは面積ゼロに単純化されたポリゴンを表すポイントを格納するためのポイント フィーチャクラスです。出力ポイントの名前および場所は、_Pnt という接尾辞の付いた出力ポリゴン名から自動的に生成されます。出力ポリゴンにはすべての入力フィールドが含まれ、出力ポイントには入力フィールドは一切含まれません。

• マルチパート ポリゴンは、個別のパートとして単純化することができます。

• 出力のトポロジ エラーを処理するためのオプションは 3 つあります。

  • [トポロジ エラーをチェックしない](Python では NO_CHECK) : 単純化プロセスによって発生したトポロジ エラーはチェックされません。処理はより速く行われます。データのトポロジの観点からの正確性に自信がある場合にのみ、このオプションを使用します。
  • [フラグ エラー](Python では FLAG_ERRORS) : 単純化プロセスの結果に対して、トポロジ エラーがチェックされます。トポロジ エラーのあるフィーチャにはフラグが付けられます。トポロジ エラーを識別することのほうがエラーを解決することよりも重要である場合に、このオプションを使用します。このオプションは、編集セッションでは使用できません。
    • 出力ポリゴンには、フィーチャにトポロジ エラーがあるかどうかを示す 2 つの新しいフィールドが含まれます。[InPoly_FID] には入力フィーチャの ID が含まれ、[SimPlyFlag] にはトポロジ エラーが含まれます。
    • [InPoly_FID] フィールドは、単純化されたポイントをそれぞれの入力ポリゴンに関連付けます。
    • [SimPlyFlag] フィールドの値が 1 であればエラーが発生したことを示し、0 であればエラーは発生しなかったことを示します。
    • フラグの値は、トポロジ エラーが解決された後も保持されます。[SimPlyFlag] フィールドを使用して、トポロジ エラーが発生したフィーチャを調べます。
  • [トポロジ エラーを解決](Python では RESOLVE_ERRORS) : 単純化プロセスによって発生したトポロジ エラーを修復します。処理時間は長くなります。このオプションは、編集セッションでは使用できません。
    • 指定した許容値が大半のポリゴンについて適切であっても、すべてのポリゴンについて適切であるとは限りません (特に密集したエリアの場合)。1 回目の単純化の後にトポロジ エラーが検出された場合は、関連する境界線分が特定され (すべてのポリゴンではなく)、より小さい許容値が使用されます。
    • 1 回目に使用された許容値の 50% の値が、新しい許容値として使用されます。この新しい許容値は、これらの線分を再度単純化するときに使用されます。この操作は、トポロジ エラーが検出されなくなるまで反復されます。
    • 出力ポリゴン フィーチャクラスには、入力と同じ数のポリゴンが含まれ、反復によって各ポリゴンが単純化されるときに実際に使用された最大許容値を格納する [MaxSimpTol] と最小許容値を格納する [MinSimpTol] の 2 つの新しいフィールドが含まれます。エラーが発生しなかった場合、[MaxSimpTol] および [MinSimpTol] の値は、指定された単純化の許容値と同じになります。
    • [単純化の許容値] の値が比較的大きい値であれば、大きいポリゴンの近くにある小さいポリゴンが大きいポリゴンの中に含められることがあります。この空間リレーションシップ エラーは、プログラムによって検出されません。
  • [NO_CHECK] オプションと [FLAG_ERRORS] オプションを使用する場合、単純化プロセスの間に自己交差ジオメトリが作成されることがあり、それが作成された場合は、自動的に修復されます。たとえば、ポリゴンが自己交差する場合、そのポリゴンは、どのパートも交差しないように修復されてマルチパート ポリゴンになりますが、そのポリゴンはまだ自己交差しているように見えます。

• 出力ポイントは、[NO_CHECK] または [FLAG_ERRORS] が使用される場合、または [長さゼロのラインをポイントとして保持] チェックボックスがオンになっている場合に設定されます。入力ポリゴンに複数のパートが含まれており、その 1 つが単純化されたポイントになった場合は、そのパートを表すポイントも出力ポイントに含められます。

構文

SimplifyPolygon_cartography (in_features, out_feature_class, algorithm, tolerance, {minimum_area}, {error_option}, {collapsed_point_option})

パラメータ	説明	データ タイプ
in_features	単純化するポリゴン フィーチャ。	Feature Layer
out_feature_class	作成される出力ポリゴン フィーチャクラス。	Feature Class
algorithm	ポリゴンの単純化アルゴリズムを指定します。 POINT_REMOVE —ポリゴンの基本的な形状を表す「重要ポイント」を保持し、その他すべてのポイントを取り除きます。これがデフォルトです。 BEND_SIMPLIFY —ポリゴンの主要な形状を保持し、境界の不要な屈曲を取り除きます。	String
tolerance	単純化の度合いを決定する許容値。許容値には、0 (ゼロ) より大きい値を指定する必要があります。優先的に適用される単位を選択することができます。デフォルトはフィーチャ単位です。 POINT_REMOVE アルゴリズムの場合は、許容できる最大オフセットを指定します。 BEND_SIMPLIFY アルゴリズムの場合は、屈曲の参照ベースラインの長さを指定します。	Linear unit
minimum_area (オプション)	単純化されたポリゴンのために保持される最小領域を設定します。デフォルト値は 0 であり、すべてのポリゴンが保持されます。指定する値の単位は自由に選択できます。デフォルトはフィーチャの単位です。	Areal unit
error_option (オプション)	ラインの交差、ラインの重なり、単純化された長さゼロのラインなどのプロセスで発生する可能性があるトポロジ エラーの処理方法を指定します。 NO_CHECK —トポロジ エラーをチェックしません。これがデフォルトです。 FLAG_ERRORS —トポロジ エラーが見つかった場合はフラグを付けます。 RESOLVE_ERRORS —トポロジ エラーが見つかった場合は解決します。	String
collapsed_point_option (オプション)	プロセスで単純化された面積ゼロのポリゴンが検出された場合に、ポイントとして保持するかどうかを指定します。このオプションが適用されるのは、[NO_CHECK] または [FLAG_ERRORS] が指定されている場合のみです。 KEEP_COLLAPSED_POINTS —単純化された面積ゼロのポリゴンをポイントとして保持します。単純化されたポリゴン境界の端点は、出力フィーチャクラスの場所にあるポイント フィーチャクラスに格納され、出力フィーチャクラス名に _Pnt という接尾辞が付いた名前になります。これがデフォルトです。 NO_KEEP —単純化された面積ゼロのポリゴンがプロセスで検出されても、ポイントとして保持しません。したがって、ポイント フィーチャクラスは空になります。	Boolean

コードのサンプル

SimplifyPolygon (ポリゴンの単純化) の例 (Python ウィンドウ)

次の Python ウィンドウ スクリプトは、SimplifyPolygon (ポリゴンの単純化) ツールをイミディエイト モードで使用する方法を示しています。

import arcpy
from arcpy import env
import arcpy.cartography as CA
env.workspace = "C:/data"
CA.SimplifyPolygon("soils.shp", "C:/output/output.gdb/simplified_soils", "POINT_REMOVE", 100)

SimplifyPolygon (ポリゴンの単純化) の例 2 (スタンドアロン スクリプト)

次のスタンドアロン スクリプトは、SimplifyPolygon (ポリゴンの単純化) ツールの使用方法を示しています。

# Name: SimplifyPolygon_Example2.py
# Description: Eliminate small islands before simplifying and smoothing lake boundaries
# Author: ESRI
 
# Import system modules
import arcpy
from arcpy import env
import arcpy.management as DM
import arcpy.cartography as CA
 
# Set environment settings
env.workspace = "C:/data/Portland.gdb/Hydrography"
 
# Set local variables
inLakeFeatures = "lakes"
eliminatedFeatures = "C:/data/PortlandOutput.gdb/lakes_eliminated"
simplifiedFeatures = "C:/data/PortlandOutput.gdb/lakes_simplified"
smoothedFeatures = "C:/data/PortlandOutput.gdb/lakes_smoothed"

# Eliminate small islands in lake polygons.
DM.EliminatePolygonPart(inLakeFeatures, eliminatedFeatures, 100, "OR", 0, "CONTAINED_ONLY")
 
# Simplify lake polygons.
CA.SimplifyPolygon(eliminatedFeatures, simplifiedFeatures, "POINT_REMOVE", 50, 200, "RESOLVE_ERRORS", "KEEP_COLLAPSED_POINTS", "CHECK")
 
# Smooth lake polygons.
CA.SmoothPolygon(simplifiedFeatures, smoothedFeatures, "PAEK", 100, "FLAG_ERRORS")

環境

• 現在のワークスペース
• 出力データのデフォルト Z 値
• 出力データの M ドメイン
• 出力データの XY ドメイン
• 出力データの座標系
• 範囲
• 出力データに M 値を含む
• 出力データに Z 値を含む
• テンポラリ ワークスペース
• XY 許容値

ライセンス情報

• ArcGIS for Desktop Basic: ×
• ArcGIS for Desktop Standard: ○
• ArcGIS for Desktop Advanced: ○

このトピックへのフィードバック