ポリゴンのスムージング (Smooth Polygon) (カートグラフィ)

概要

ポリゴンのアウトラインの鋭角を滑らかにして、見た目の品質やカートグラフィック品質を向上させます。

ラインのスムージング (Smooth Line) ツールとポリゴンのスムージング (Smooth Polygon) ツールの詳細

ポリゴンのスムージング (Smooth Polygon) の図

使用法

  • 次の 2 つのスムージング方法があります。

    • [PAEK (Polynomial Approximation with Exponential Kernel)] (Python では PAEK) による方法は、スムージング許容値に基づいてポリゴンを滑らかにします。滑らかになったポリゴンは、元のポリゴンよりも頂点が多くなる可能性があります。[スムージングの許容値] パラメーターは、新しい頂点の計算に使用する「移動」経路の長さを制御します。長さが短いほど詳細が維持されますが、処理時間は長くなります。
    • [ベジェ挿入] による方法 (Python では BEZIER_INTERPOLATION) は、入力ラインに適合させる近似のベジェ曲線を作成することにより、許容値を使用しないでポリゴンを滑らかにします。
  • [入力バリア レイヤー] パラメーターは、滑らかになったポリゴンが横切ることを許可されないフィーチャを識別するために使用します。バリア フィーチャには、ポイント、ライン、ポリゴンのいずれかを指定できます。

  • 大きなデータセットを処理する場合は、メモリの制限を超えることがあります。このような場合、[カートグラフィック パーティション] 環境設定で関連するポリゴン フィーチャクラスを特定することにより、パーティション単位で入力データを処理することを検討します。パーティションの境界によって定義されたデータの一部が順次処理されます。結果のフィーチャクラスは、パーティション エッジにおいてシームレスで一致した形状になります。詳細については、「パーティションを使用した大きなデータセットのジェネラライズ」をご参照ください。

    注意:

    [トポロジ エラーの処理] パラメーターが [トポロジ エラーをチェックしない] (Python では NO_CHECK) または [トポロジ エラーをフラグ付けする] (Python では FLAG_ERRORS) に設定されている場合、[カートグラフィック パーティション] 環境設定は無視されます。

  • フィールド ドメイン、サブタイプ、属性ルールの転送環境がオフの場合でも、ドメインとサブタイプは出力にコピーされます。

  • 出力ライン フィーチャクラスはトポロジ的に正確であるため、 入力データに含まれるトポロジ エラーはすべて、出力ライン フィーチャクラスでフラグが付けられます。出力フィーチャクラスには、入力フィーチャ ID と入力のトポロジ エラーがそれぞれ格納される InPoly_FIDSmoPgnFlag という 2 つのフィールドが追加されます。SmoPgnFlag の値が 1 であればトポロジ エラーが存在することを示し、0 (ゼロ) であればエラーは存在しないことを示します。

    レガシー:

    ArcGIS Pro 2.2 以前のバージョンでは、このツールの [リングの終点を保持] (Python の場合はendpoint_option) パラメーターを使用して、孤立したポリゴン リングの終点を維持するかどうかを指定していました。このパラメーターは、スクリプトとモデルでの互換性を保つために引き続きこのツールの構文に含まれていますが、ツールのダイアログ ボックスでは無視され、非表示になっています。

構文

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

スムージング アルゴリズムを指定します。

  • PAEKPolynomial Approximation with Exponential Kernel の略です。スムージング後のポリゴンが入力ポリゴンの頂点を通らないように計算します。これがデフォルトです。
  • BEZIER_INTERPOLATION頂点と頂点の間にベジェ曲線を適合させます。スムージング後のポリゴンは、入力ポリゴンの頂点を通ります。このアルゴリズムは許容値を必要としません。近似のベジェ曲線が出力されます。
String
tolerance

PAEK アルゴリズムで使用する許容値を設定します。許容値には、0 (ゼロ) より大きい値を指定する必要があります。優先的に適用される単位を選択することができます。デフォルトはフィーチャ単位です。スムージング アルゴリズムに [BEZIER_INTERPOLATION] を使用するときは、プレースホルダーとして 0 を入力する必要があります。

Linear Unit
endpoint_option
(オプション)

これは、現在使用されていない従来のパラメーターです。以前は、孤立したポリゴン リングの端点を維持するかどうかを指定するために使用されていました。このパラメーターは、スクリプトとモデルでの互換性を保つために引き続きこのツールの構文に含まれていますが、ツールのダイアログ ボックスでは非表示になっています。

孤立したポリゴン リングの端点を維持するかどうかを指定します。このオプションは、PAEK アルゴリズムでのみ機能します。

  • FIXED_ENDPOINT孤立したポリゴン リングの端点を維持します。これがデフォルトです。
  • NO_FIXED孤立したポリゴン リングの端点を使用してスムージングします。
Boolean
error_option
(オプション)

ラインの交差や重なりなど、プロセスで発生する可能性があるトポロジ エラーの処理方法を指定します。

  • NO_CHECKトポロジ エラーをチェックしません。これがデフォルトです。
  • FLAG_ERRORSトポロジ エラーが見つかった場合はフラグを付けます。
  • RESOLVE_ERRORSトポロジ エラーが見つかった場合は解決します。
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: はい

関連トピック