サマリー
基本的な形状を維持しながら不要な屈曲を取り除くことによってポリゴンを単純化します。
図
使用法
単純化する方法には 2 つあります。
- POINT_REMOVE は、2 つのうち、より高速なアルゴリズムです。これは、余分な頂点を取り除きます。この方法は、とりわけデータが既知の場合に、データ圧縮またはより粗い単純化のために使用します。結果として生成されるポリゴンの鋭角 (鋭いコーナー) は、許容値が大きくなるにつれ大幅に鋭くなるため、ポリゴンの見栄えが入力より悪くなることがあります。
- BEND_SIMPLIFY は時間がかかる方法ですが、一般的に、元の形状に忠実な見栄えの良い結果が生成されます。これは、ポリゴンのアウトラインの不要な屈曲を取り除きます。この方法は、精密に単純化したい場合に使用します。
[最小エリア] パラメーターは、単純化されたポリゴンに対してのみ適用されます。単純化プロセスの完了後に最小領域より小さいサイズに縮小されたポリゴンはすべて、出力フィーチャクラスから除去されます。これは、共通のエッジを共有する一連の隣接するポリゴンの場合は、そのすべてのポリゴンの合計面積に適用されます。
このツールは、2 つの出力フィーチャクラスを生成します。1 つは単純化されたポリゴンを格納するためのライン フィーチャクラスであり、もう 1 つは面積ゼロに単純化されたポリゴンを表すポイントを格納するためのポイント フィーチャクラスです。出力ポイントの名前および場所は、_Pnt という接尾辞の付いた出力ポリゴン名から自動的に生成されます。出力ポリゴンにはすべての入力フィールドが含まれ、出力ポイントには入力フィールドは一切含まれません。
マルチパート ポリゴンは、個別のパートとして単純化することができます。
出力のトポロジ エラーを処理するためのオプションは 3 つあります。
- [トポロジ エラーをチェックしない] (Python では error_option = 'NO_CHECK'): 単純化プロセスによって発生したトポロジ エラーはチェックされません。処理はより速く行われます。データのトポロジの観点からの正確性に自信がある場合にのみ、このオプションを使用します。これがデフォルトです。
- [フラグ エラー] (Python では error_option = 'FLAG_ERRORS'): 単純化プロセスの結果に対して、トポロジ エラーがチェックされ、トポロジ エラーのあるフィーチャにはフラグが付けられます。トポロジ エラーを識別することのほうがエラーを解決することよりも重要である場合に、このオプションを使用します。このオプションは、編集セッションでは使用できません。
- 出力ポリゴンには、フィーチャにトポロジ エラーがあるかどうかを示す 2 つの新しいフィールドが含まれます。[InPoly_FID] には入力フィーチャの ID が含まれ、[SimPlyFlag] にはトポロジ エラーが含まれます。
- [InPoly_FID] フィールドは、単純化されたポイントをそれぞれの入力ポリゴンに関連付けます。
- [SimPlyFlag] フィールドの値が 1 であればエラーが発生したことを示し、0 であればエラーは発生しなかったことを示します。
- フラグの値は、トポロジ エラーが解決された後も保持されます。[SimPlyFlag] フィールドを使用して、トポロジ エラーが発生したフィーチャを調べます。
- [トポロジ エラーを解決] (Python では error_option = 'RESOLVE_ERRORS'): 単純化プロセスによって発生したトポロジ エラーを修復します。処理時間は長くなります。このオプションは、編集セッションでは使用できません。
- 指定した許容値が大半のポリゴンについて適切であっても、すべてのポリゴンについて適切であるとは限りません (特に密集したエリアの場合)。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 | ポリゴンの単純化アルゴリズムを指定します。
| String |
tolerance | 単純化の度合いを決定する許容値。許容値には、0 (ゼロ) より大きい値を指定する必要があります。優先的に適用される単位を選択することができます。デフォルトはフィーチャ単位です。
| Linear unit |
minimum_area (オプション) | 単純化されたポリゴンのために保持される最小領域を設定します。デフォルト値は 0 であり、すべてのポリゴンが保持されます。指定する値の単位は自由に選択できます。デフォルトはフィーチャの単位です。 | Areal unit |
error_option (オプション) | ラインの交差、ラインの重なり、単純化された長さゼロのラインなどのプロセスで発生する可能性があるトポロジ エラーの処理方法を指定します。
| String |
collapsed_point_option (オプション) | プロセスで単純化された面積ゼロのポリゴンが検出された場合に、ポイントとして保持するかどうかを指定します。このオプションが適用されるのは、NO_CHECK または FLAG_ERRORS が指定されている場合のみです。
| 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")
環境
ライセンス情報
- ArcGIS Desktop Basic: いいえ
- ArcGIS Desktop Standard: はい
- ArcGIS Desktop Advanced: はい