エッジマッチリンクの生成 (編集ツール)

サマリー

ソースデータの領域と隣接データの領域のエッジに沿って、一致しているが切断されているラインフィーチャを検索し、ソースラインと一致する隣接ラインとの間にエッジマッチリンクを生成します。

エッジマッチの詳細

図

エッジマッチリンクの生成ツールの図

使用法

隣接する国の道路など、隣接する別々のデータセットのラインフィーチャには、データコレクションの不一致などの理由により、それらが接続するエッジに沿ってギャップやずれが存在する場合があります。 2 つのデータセット間のエッジマッチ問題を一度に解決するには、このツールを使用してエッジマッチリンクを生成します。その後、エッジマッチフィーチャツールを使用して、各フィーチャが接続されるように調整します。ラインフィーチャの 2 つのセットは、ソースフィーチャおよび隣接フィーチャと呼ばれます。このツールは、分離しているが、指定された検索距離の範囲内で対応しているソースラインと隣接ラインを検索し、それらのライン間にエッジマッチリンク (移動リンクとも呼ぶ) を表すラインを生成します。

エッジ領域に沿って切断された 2 つのフィーチャが検索距離の範囲内で対応している場合でも、それらの端点が検索距離よりも離れている場合は、エッジマッチとは見なされません。
注意:

すべての入力は、同じ座標系に存在する必要があります。

出力フィーチャクラスは、入力と同じ座標系を使用します。
出力フィーチャクラスには、エッジマッチリンクを表す以下のフィールドを持つラインフィーチャが格納されます。
- SRC_FID—リンクの始点になるソースフィーチャ ID。
- ADJ_FID—リンクの終点になる隣接フィーチャ ID。
- EM_CONF—エッジマッチの信頼度を表す値。これらの値は、検索距離の範囲内で検出された候補の数、属性の一致状況、およびソースフィーチャと隣接フィーチャ間の連続性から求められます。この値は、0 よりも大きい 100 以下の値になります。ここで 100 は、最高の信頼度を表します。 EM_CONF 値が大きいほど、正しいリンクが得られる可能性が高くなります。例については、エッジマッチについてをご参照ください。
検索距離 パラメーターは、一致候補の検索で使用されます。対応するフィーチャ間のずれの大部分を捉えることができるほど十分な大きさの距離を使用しますが、候補が多くなって不必要な処理が発生し、不正な一致が得られる場合があるため、この値を大きくし過ぎないでください。
一致候補が検出されたら、それらの形状の特徴が分析されます。連続性が最も高くなるソースフィーチャと隣接フィーチャ間で、一致が決定されます。エッジマッチリンクを表すラインが、ソースラインの端点から一致する隣接ラインの端点まで生成されます。

これらのリンクを、他のラインフィーチャと同様に、マップ上に表示できます。ラインの各端に矢印を付けて描画し、上の図に示すようなマップを作成できます。
照合フィールド パラメーターで 1 つ以上のフィールドのペアを指定した場合、空間的に一致するフィーチャが、これらのフィールド値と比較されます。たとえば、道路名が格納された STREET_NAME フィールドが、ソースフィーチャと隣接フィーチャの両方に存在するとします。 1 つのソースフィーチャが 2 つの隣接フィーチャに空間的に一致していて、1 つの隣接フィーチャのみがソースフィーチャと同じ STREET_NAME 値を持っている場合、この隣接フィーチャの方が一致度が高くなります。テキスト文字列の比較では、大文字と小文字が区別されません。つまり、First St は、first st と同じと見なされます。

属性の一致条件は、上で説明したように、EM_CONF フィールドの値に影響を与えます。
エッジマッチの精度は、データの品質および 2 つの入力データのエッジに沿った複雑さに依存します。

前処理でデータエラーを最小化し、関連するフィーチャを入力として選択します。一般に、入力データセット内のフィーチャがトポロジ的に正しく、有効なジオメトリを有しており、シングルパートであって重複していないのは有効です。そうでない場合は、予期しない結果が発生するおそれがあります。
結果を確認し、必要に応じて修正することをお勧めします。実行後に検査と編集を行うときに、既存の編集ツールを使用してリンクを編集できます。たとえば、リンクを削除したり、リンクの始点または終点を移動して変更したり、新しいリンクを追加したりできます。それに応じて、SRC_FID および TGT_FID フィールドを更新します。

ラベル	説明	データタイプ
ソースフィーチャ	エッジマッチのソースフィーチャとして使用されるラインフィーチャ。すべてのエッジマッチリンクは、ソースフィーチャから始まります。	Feature Layer
隣接フィーチャ	ソースフィーチャに隣接するラインフィーチャ。すべてのエッジリンクは、一致する隣接フィーチャで終わります。	Feature Layer
出力フィーチャクラス	エッジマッチリンクを表すラインが格納される出力フィーチャクラス。	Feature Class
検索距離	一致候補の検索に使用される距離。ゼロより大きい距離を指定する必要があります。優先的に適用される単位を選択できます。デフォルトはフィーチャの単位です。	Linear Unit
フィールドの照合 (オプション)	ソースフィーチャとターゲットフィーチャのフィールド。ここで、ターゲットフィールドは、隣接フィーチャのフィールドです。これを入力すると、照合候補に関して各フィールドペアがチェックされるため、正しい照合の特定に役立ちます。値テーブル列: Source Fields—Fields from source features Target Fields—Fields from adjacent features	Value Table

arcpy.edit.GenerateEdgematchLinks(source_features, adjacent_features, out_feature_class, search_distance, {match_fields})

名前	説明	データタイプ
source_features	エッジマッチのソースフィーチャとして使用されるラインフィーチャ。すべてのエッジマッチリンクは、ソースフィーチャから始まります。	Feature Layer
adjacent_features	ソースフィーチャに隣接するラインフィーチャ。すべてのエッジリンクは、一致する隣接フィーチャで終わります。	Feature Layer
out_feature_class	エッジマッチリンクを表すラインが格納される出力フィーチャクラス。	Feature Class
search_distance	一致候補の検索に使用される距離。ゼロより大きい距離を指定する必要があります。優先的に適用される単位を選択できます。デフォルトはフィーチャの単位です。	Linear Unit
match_fields [[source_field, target_field],...] (オプション)	ソースフィーチャとターゲットフィーチャのフィールド。ここで、ターゲットフィールドは、隣接フィーチャのフィールドです。これを入力すると、照合候補に関して各フィールドペアがチェックされるため、正しい照合の特定に役立ちます。値テーブル列: `Source Fields`—Fields from source features `Target Fields`—Fields from adjacent features	Value Table

コードのサンプル

GenerateEdgematchLinks の例 1 (Python ウィンドウ)

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.edit.GenerateEdgematchLinks("countyA_Roads.shp",
                                  "countyB_Roads.shp", "em_Links.shp"
                                  "25 Feet")

GenerateEdgematchLinks の例 2 (スタンドアロンスクリプト)

次のスタンドアロンスクリプトは、GenerateEdgematchLinks 関数をスクリプティング環境で適用する方法を示した単純な例です。

"""
Name:        EdgematchFeatures_example_script2.py
Description: Performs edgematching spatial adjustment using links produced by
             GenerateEdgematchLinks. The links go from input features to adjacent
             features. The links are then checked for intersecting conditions, which
             may not be desired. They are then used to adjust input features
             (a copy is made) to connect to the matched adjacent features.
"""

# Import system modules.
import arcpy

# Set environment settings.
arcpy.env.overwriteOutput = True
arcpy.env.workspace = r"D:\conflationTools\ScriptExamples\data.gdb"

# Set local variables.
inFeatures = "roads1"
adjFeatures = "roads2"
gelOutput = "gelinks_out"

search_distance = "200 Feet"
match_fields = "NAME ROAD_NAME"

qaLocations = "qa_locations"

# Generate rubbersheet links.
arcpy.edit.GenerateEdgematchLinks(inFeatures, adjFeatures, gelOutput, search_distance, match_fields)

"""
Note 1:  The result of GenerateEdgematchLinks may contain errors; see the tool reference.
         Inspection and editing may be necessary to ensure correct links before using
         them for edgematching.

         One of the possible errors is intersecting or touching links.
         Their locations can be found by the process below.
"""

# Find locations where links intersect or touch. The result contains coincident points.
arcpy.analysis.Intersect(gelOutput, qaLocations, "", "", "POINT")

# Delete coincident points.
arcpy.management.DeleteIdentical(qaLocations, "Shape")

"""
Note 2:  You can manually inspect locations in qaLocations and delete or
         modify links as needed.
"""

# Make a copy of the inFeatures for edgematching.
inFeature_Copy = inFeatures + "_Copy"
arcpy.management.CopyFeatures(inFeatures, inFeature_Copy)

# Use the links to adjust the copy of the input features.
arcpy.edit.EdgematchFeatures(inFeature_Copy, gelOutput, "MOVE_ENDPOINT")

環境

現在のワークスペース, スクラッチワークスペース, 範囲

ライセンス情報

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

エッジマッチ リンクの生成 (編集ツール)

サマリー

図

使用法

注意:

パラメーター

環境

ライセンス情報

関連トピック

エッジマッチリンクの生成 (編集ツール)