ラインの単純化 (Simplify Line) (カートグラフィ)

概要

基本的な形状を維持しながら、相対的に不要な頂点を取り除くことによってラインを単純化します。

[ラインの単純化 (Simplify Line)] ツールで使用する 4 つの単純化アルゴリズムの比較

使用法

  • このツールでは、次のように、それぞれの目的に応じた異なる単純化アルゴリズムを使用します。このアルゴリズムの詳細については、「ラインの単純化 (Simplify Line) とポリゴンの単純化 (Simplify Polygon) の詳細」をご参照ください。

    • [重要なポイントを保持 (Douglas-Peucker)] アルゴリズム (Python の algorithm='POINT_REMOVE') は、相対的に不要な頂点を識別して削除し、より小さな縮尺で表示できるようにデータを単純化する仕組みになっています。これは、このツールの単純化アルゴリズムのうちで最も高速です。このアルゴリズムは、多くの場合、データ圧縮または大まかな単純化のために使用されます。結果として生成されるラインの鋭角は、許容値が大きくなるにつれ大幅に鋭くなります。このアルゴリズムは、David Douglas と Thomas Peucker 共著「Algorithms for the reduction of the number of points required to represent a digitized line or its caricature」(『The Canadian Cartographer』10(2)、112–22 (1973)) による Douglas-Peucker アルゴリズムをベースとしています。
    • [重要な屈曲を保持 (Wang-Müller)] アルゴリズム (Python の algorithm='BEND_SIMPLIFY') は、相対的に意味のない屈曲を識別して削除し、より小さな縮尺で表示できるようにデータを単純化する仕組みになっています。これは、一般に、[重要なポイントを保持 (Douglas-Peucker)] アルゴリズムと比べて、入力ジオメトリにより忠実な結果を生成しますが、処理により多くの時間がかかることがあります。このアルゴリムは、Zeshen Wang と Jean-Claude Müller 共著「Line Generalization Based on Analysis of Shape Characteristics」(『Cartography and Geographic Information Systems』25(1)、3–15 (1998)) で定義されたアルゴリズムをベースとしています。
    • [加重エリアを保持 (Zhou-Jones)] アルゴリズム (Python の algorithm='WEIGHTED_AREA') は、最初に各頂点の有効エリアである三角形を識別する仕組みになっています。次に、各エリアの平坦度、歪度、凸性を比較するために、それらの三角形が一連のメトリクスによって重み付けされます。加重エリアを参考にしてそれらに対応する頂点を削除することで、可能な限り特徴を維持しながら、ラインを単純化します。このアルゴリズムは、Sheng Zhou と Christopher B. Jones 共著「Shape-Aware Line Generalisation with Weighted Effective Area」(Fisher, Peter F. (Ed.)『Developments in Spatial Handling 11th International Symposium on Spatial Handling』369–80 (2005)) で定義されたアルゴリズムをベースとしています。
    • [有効エリアを保持 (Visvalingam-Whyatt)] アルゴリズム (Python ではalgorithm='EFFECTIVE_AREA') は、頂点を削除することで、可能な限り特徴を維持しながら、ラインを単純化するために、各頂点の有効エリアである三角形を識別する仕組みになっています。このアルゴリズムは、M. Visvalingam と J. D. Whyatt 共著「Line Generalisation by Repeated Elimination of the Smallest Area」(『Cartographic Information Systems Research Group (CISRG) Discussion Paper 10』The University of Hull (1992)) で定義されたアルゴリズムをベースとしています。

  • [単純化の許容値] パラメーターの値は、単純化の度合いを決定します。許容値が大きくなるほど、生成されるジオメトリが粗大化します。許容値が小さくなるほど、入力により忠実なジオメトリが生成されます。MinSimpTol フィールドと MaxSimpTol フィールドの両方が、使用された許容値を格納するために出力に追加されます。

    レガシー:

    ArcGIS Pro 1.4 より前のこのツールのバージョンでは、トポロジの解決過程で、フィーチャ単位で許容値が変更され、それらの値が MinSimpTol フィールドと MaxSimpTol フィールドに格納されていました。現在、これらのフィールドの値は、[単純化の許容値] パラメーターに指定された許容値と同じままになります。これらのフィールドのいずれかに依存する既存のモデルまたはスクリプトを必ず変更してください。

    • [重要なポイントを保持 (Douglas-Peucker)] アルゴリズムの場合、許容値は、各頂点と新規作成されたラインとの間の最大許容垂直距離を示します。
    • [重要な屈曲を保持 (Wang-Müller)] アルゴリズムの場合、許容値は、有意な屈曲に近似する円の半径を示します。
    • [加重エリアを保持 (Zhou-Jones)] アルゴリズムの場合、許容値の二乗は、3 つの隣接する頂点によって定義される有意な三角形の面積を示します。三角形が正三角形から逸脱するほど、与えられる重み付けが大きくなり、削除される可能性が低くなります。
    • [有効エリアを保持 (Visvalingam-Whyatt)] アルゴリズムの場合、許容値の二乗は、3 つの隣接する頂点によって定義される有意な三角形の面積を示します。

  • [長さゼロのラインをポイントとして保持] パラメーター (Python の collapsed_point_option) を使用すると、データの空間的許容値よりも小さいすべてのラインのエンドポイントを格納するための出力ポイント フィーチャクラスを作成できます。[出力フィーチャクラス] (Python の out_feature_class) と同じ名前と場所を接尾辞 _Pnt とともに使用して、出力ポイントが生成されます。出力ライン フィーチャクラスには、入力フィーチャクラスにあるすべてのフィールドが含まれています。出力ポイント フィーチャクラスには、これらのフィールドは含まれません。

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

    レガシー:

    このツールの ArcGIS Pro 1.4 より前のバージョンでは、処理中にトポロジ エラーが生成されることがありました。これらのエラーを特定し、必要に応じて解決するために、[トポロジ エラーの確認] (Python の error_checking_option) パラメーターと [トポロジ エラーの解決] (Python の error_resolving_option) パラメーターが含まれていました。これらのパラメーターは、スクリプトとモデルでの互換性を保つために引き続きこのツールの構文に含まれていますが、現在では無視され、ツールのダイアログ ボックスでは非表示になっています。SimLnFlag フィールドは、処理中にこのツールによって生成されたトポロジ エラーにフラグを付けるために使用されていました。現在、このフィールドは、入力内に存在するエラーにフラグを付けるために使用されます。

  • [入力バリア レイヤー] パラメーターは、単純化されたラインが横切ることを許可されないフィーチャを識別するために使用します。バリア フィーチャには、ポイント、ライン、ポリゴンのいずれかを指定できます。

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

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

構文

arcpy.cartography.SimplifyLine(in_features, out_feature_class, algorithm, tolerance, {error_resolving_option}, {collapsed_point_option}, {error_checking_option}, {in_barriers})
パラメーター説明データ タイプ
in_features

単純化する入力ライン フィーチャ。

Feature Layer
out_feature_class

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

Feature Class
algorithm

ラインの単純化アルゴリズムを指定します。

  • POINT_REMOVE ラインの基本的な形状を保つ重要なポイントを保持し、他のすべてのポイントを削除します (Douglas-Peucker)。これがデフォルトです。
  • BEND_SIMPLIFY 重要な屈曲を保持し、不要な屈曲をラインから削除します (Wang-Müller)。
  • WEIGHTED_AREA三角形で重み付けされた有効エリアである三角形を形成する頂点を保持します (Zhou-Jones)。
  • EFFECTIVE_AREA 有効エリアである三角形を形成する頂点を保持します (Visvalingam-Whyatt)。
String
tolerance

この許容値は単純化の度合いを決定します。単位は自由に選択できます。選択しない場合、入力の単位が使用されます。MinSimpTol フィールドと MaxSimpTol フィールドの両方が、処理が行われたときに使用された許容値を格納するために出力に追加されます。

  • POINT_REMOVE アルゴリズムの場合、許容値は、各頂点と新規作成されたラインとの間の最大許容垂直距離を示します。
  • BEND_SIMPLIFY アルゴリズムの場合、許容値は、有意な屈曲に近似する円の半径を意味します。
  • WEIGHTED_AREA アルゴリズムの場合、許容値の二乗は、3 つの隣接する頂点によって定義される有意な三角形の面積を示します。三角形が正三角形から逸脱するほど、与えられる重み付けが大きくなり、削除される可能性が低くなります。
  • EFFECTIVE_AREA アルゴリズムの場合、許容値の二乗は、3 つの隣接する頂点によって定義される有意な三角形の面積を示します。
Linear Unit
error_resolving_option
(オプション)
レガシー:

これは、現在使用されていない従来のパラメーターです。以前は、処理中に生成された可能性のあるトポロジ エラーの処理方法を決定するために使用されていました。このパラメーターは、スクリプトとモデルでの互換性を保つために引き続きこのツールの構文に含まれていますが、ツールのダイアログ ボックスでは非表示になっています。

Boolean
collapsed_point_option
(オプション)

空間的許容値よりも小さいすべてのラインのエンドポイントを格納するための出力ポイント フィーチャクラスを作成するかどうかを決定します。out_feature_class と同じ名前と場所を接尾辞 _Pnt とともに使用して、出力ポイントが生成されます。

  • KEEP_COLLAPSED_POINTS派生した出力ポイント フィーチャクラスで、長さゼロのラインのエンドポイントを記録します。これがデフォルトです。
  • NO_KEEP派生した出力ポイント フィーチャクラスを作成しません。
Boolean
error_checking_option
(オプション)
メモ:

これは、現在使用されていない従来のパラメーターです。以前は、処理中に生成された可能性のあるトポロジ エラーの処理方法を決定するために使用されていました。このパラメーターは、スクリプトとモデルでの互換性を保つために引き続きこのツールの構文に含まれていますが、ツールのダイアログ ボックスでは非表示になっています。

Boolean
in_barriers
[in_barriers,...]
(オプション)

単純化の際にバリアとしての役割を果たすフィーチャを含む入力。単純化された結果のラインはバリア フィーチャに接したり、バリア フィーチャを横切ったりしません。たとえば、コンター ラインを単純化する場合、スポット標高フィーチャ入力をバリアとして使用すると、単純化されたコンター ラインによって、これらのポイント間が単純化されないようにすることができます。出力は、計測されたスポット標高によって示された標高に従います。

Feature Layer

派生した出力

名前説明データ タイプ
out_point_feature_class

[長さゼロのラインをポイントとして保持] パラメーター (Python の collapsed_point_option) を使用すると、データの空間的許容値よりも小さいすべてのラインのエンドポイントを格納するための出力ポイント フィーチャクラスが作成されます。

フィーチャクラス

コードのサンプル

SimplifyLine (ラインの単純化) の例 (Python ウィンドウ)

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

import arcpy
import arcpy.cartography as CA
arcpy.env.workspace = "C:/data"
CA.SimplifyLine("roads.shp", 
                "C:/output/output.gdb/simplified_roads", 
                "POINT_REMOVE", 
                20)
SimplifyLine (ラインの単純化) の例 2 (スタンドアロン スクリプト)

次のスタンドアロン スクリプトで、この SimplifyLine ツールの使用方法を示します。

# Name: SimplifyLine_Example2.py
# Description: Simplify line features from two feature classes, rivers and coastlines,
# while maintaining their connections
# Import system modules
import arcpy
import arcpy.management as DM
import arcpy.cartography as CA
 
# Set environment settings
arcpy.env.workspace = "C:/data/Portland.gdb/Hydrography"
 
# Set local variables
inRiverFeatures = "rivers"
inCoastlineFeatures = "coastlines"
mergedFeatures = "C:/data/PortlandOutput.gdb/merged_lines"
simplifiedFeatures = "C:/data/PortlandOutput.gdb/merged_lines_simplified"
tempLayer = "tempLyr"
outRiverFeatureClass = "C:/data/PortlandOutput.gdb/rivers_final"
outCoastlineFeatureClass = "C:/data/PortlandOutput.gdb/coastlines_final"
# Merge rivers and coastlines into one feature class, 
# assuming that they have a common f-code field 
# with value 40 for rivers and 80 for coastlines.
DM.Merge(inRiverFeatures, inCoastlineFeatures, mergedFeatures)
# Simplify all lines.
CA.SimplifyLine(mergedFeatures, 
                simplifiedFeatures, 
                "BEND_SIMPLIFY", 
                100, 
                "KEEP_COLLAPSED_POINTS")
 
# Select rivers and coastlines by their f-code values 
# and put them in separate feature classes.
DM.MakeFeatureLayer(simplifiedFeatures, tempLayer, "f-code = 40")
DM.CopyFeatures(tempLayer, outRiverFeatureClass)
DM.MakeFeatureLayer(simplifiedFeatures, tempLayer, "f-code = 80")
DM.CopyFeatures(tempLayer, outCoastlineFeatureClass)

ライセンス情報

  • Basic: いいえ
  • Standard: はい
  • Advanced: はい

関連トピック