概要
ポリゴンのアウトラインの鋭角を滑らかにして、見た目の品質やカートグラフィック品質を向上させます。
図
![[ポリゴンのスムージング (Smooth Polygon)] ツールのアルゴリズム オプションの例](GUID-B4894A0E-09EC-4C23-B1DD-2B5F519F8481-web.jpg "[ポリゴンのスムージング (Smooth Polygon)] ツールのアルゴリズム オプションの例")
使用法
次の 2 つのスムージング方法があります。
- [PAEK (Polynomial Approximation with Exponential Kernel)] (Python では PAEK) による方法は、スムージング許容値に基づいてポリゴンを滑らかにします。 滑らかになったポリゴンは、元のポリゴンよりも頂点が多くなる可能性があります。 [スムージングの許容値] パラメーターは、新しい頂点の計算に使用する移動経路の長さを制御します。 長さが短いほど詳細が維持されますが、処理時間は長くなります。
- [ベジェ内挿] による方法 (Python では BEZIER_INTERPOLATION) は、入力ラインに適合させる近似のベジェ曲線を作成することにより、許容値を使用しないでポリゴンを滑らかにします。
[入力バリア レイヤー] パラメーターは、滑らかになったポリゴンが横切ることを許可されないフィーチャを識別するために使用します。 バリア フィーチャには、ポイント、ライン、ポリゴンのいずれかを指定できます。
大きなデータセットを処理する場合は、メモリの制限を超えることがあります。 このような場合、[カートグラフィック パーティション] 環境設定で関連するポリゴン フィーチャクラスを特定することにより、パーティション単位で入力データを処理することを検討してください。 パーティションの境界によって定義されたデータの一部が順次処理されます。 結果のフィーチャクラスは、パーティション エッジにおいてシームレスで一致した形状になります。 詳細については、「パーティションを使用した大きなデータセットのジェネラライズ」をご参照ください。
出力ポリゴン フィーチャクラスはトポロジ的に正確であるため、 入力データに含まれるトポロジ エラーはすべて、出力ポリゴン フィーチャクラスでフラグ付けされます。 出力フィーチャクラスには、入力フィーチャ ID と入力のトポロジ エラーがそれぞれ格納される InPoly_FID と SmoPgnFlag という 2 つのフィールドが追加されます。 SmoPgnFlag の値が 1 であればトポロジ エラーが存在することを示し、値が 0 (ゼロ) であればエラーは存在しないことを示します。
構文
arcpy.cartography.SmoothPolygon(in_features, out_feature_class, algorithm, tolerance, {endpoint_option}, {error_option}, {in_barriers})| パラメーター | 説明 | データ タイプ |
in_features | スムージングの対象となるポリゴン フィーチャ。 | Feature Layer |
out_feature_class | 作成される出力ポリゴン フィーチャクラス。 | Feature Class |
algorithm | スムージング アルゴリズムを指定します。
| String |
tolerance | PAEK アルゴリズムで使用する許容値。 許容値には、0 (ゼロ) より大きい値を指定する必要があります。 単位は自由に指定できます。デフォルトはフィーチャの単位です。 スムージング アルゴリズムに [ベジェ内挿] を使用するときは、プレースホルダーとして 0 を入力する必要があります。 | Linear Unit |
endpoint_option (オプション) | これは、現在使用されていない従来のパラメーターです。 以前は、孤立したポリゴン リングの端点を維持するかどうかを指定するために使用されていました。 このパラメーターは、スクリプトとモデルでの互換性を保つために引き続きこのツールの構文に含まれていますが、ツールのダイアログ ボックスでは非表示になっています。 孤立したポリゴン リングの端点を維持するかどうかを指定します。 このオプションは、PAEK アルゴリズムでのみ機能します。
| Boolean |
error_option (オプション) | ラインの交差や重なりなど、プロセスで発生する可能性があるトポロジ エラーの処理方法を指定します。
| String |
in_barriers [in_barriers,...] (オプション) | スムージングの際にバリアとしての役割を果たすフィーチャを含む入力。 滑らかになった結果のポリゴンはバリア フィーチャに接したり、バリア フィーチャを横切ったりしません。 | Feature Layer |
コードのサンプル
SmoothPolygon (ポリゴンのスムージング) の例 (Python ウィンドウ)
次の Python ウィンドウ スクリプトは、イミディエイト モードで SmoothPolygon 関数を使用する方法を示しています。
import arcpy
import arcpy.cartography as CA
arcpy.env.workspace = "C:/data"
CA.SmoothPolygon("soils.shp", "C:/output/output.gdb/smoothed_soils", "PAEK", 100)
SmoothPolygon (ポリゴンのスムージング) の例 2 (スタンドアロン スクリプト)
次のスタンドアロン スクリプトで、SmoothPolygon 関数を使用する方法を示します。
# Name: SmoothPolygon_Example2.py
# Description: Eliminate small islands before simplifying and smoothing lake boundaries
# Import system modules
import arcpy
import arcpy.cartography as CA
import arcpy.management as DM
# Set environment settings
arcpy.env.workspace = "C:/data/Portland.gdb/Hydrography"
# Set local variables
inLakeFeatures = "lakes"
barriers = "C:/data/Portland.gdb/Structures/buildings"
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", barriers)
# Smooth lake polygons.
CA.SmoothPolygon(simplifiedFeatures, smoothedFeatures, "PAEK", 100, "",
"FLAG_ERRORS", barriers)
環境
ライセンス情報
- Basic: いいえ
- Standard: はい
- Advanced: はい