エッジマッチフィーチャ (編集ツール)

サマリー

指定したエッジマッチリンクをガイドとして入力ラインフィーチャの形状を空間的に調整し、それらのラインフィーチャが隣接するデータセットのラインと接続されるように変更します。

エッジマッチの詳細

図

エッジマッチフィーチャツールの図

使用法

注意:

このツールを実行すると、入力データが変更されます。詳細と不要なデータの変更を回避するための方法については、「入力データを変更または更新するツール」をご参照ください。

このツールは、エッジマッチリンクの生成]ツールの実行後に使用することを目的としています。このツールは、エッジマッチリンクの生成 ツールが作成した入力リンクフィーチャで導くことによって、入力ラインの形状を空間的に調整します。それによって入力ラインは、エッジエリアに沿って隣接するラインフィーチャと正しく接続されます。入力リンクフィーチャには、SRC_FID フィールドと ADJ_FID フィールドが存在する必要があります。

注意:

すべての入力は、同じ座標系に存在する必要があります。
このツールは、エッジマッチリンクから新しい接続位置を取得し、その新しい位置に端点を接続するように、対応するフィーチャを変更します。どの入力パラメーター (入力フィーチャ、隣接フィーチャ、境界線フィーチャ) を指定したかに応じて新しい接続位置が決定され、それに従って関連するフィーチャが調整されます。この調整によって、以下で説明するように、必ず一致するフィーチャが接続されます。
- 入力フィーチャ パラメーターを指定した場合、エッジマッチリンクの端点が新しい接続位置として使用されます。エッジマッチリンクと関連付けられた (つまり、フィーチャ ID がリンクの SRC_FID 値と一致する) 入力ラインが、リンクの端点で終わるように調整されます。その結果、入力ラインは、エッジマッチリンクの生成で使用された目的の隣接フィーチャと確実に接続されます。
- 入力フィーチャ パラメーターと 隣接フィーチャ パラメーターの両方を指定した場合、エッジマッチリンクの中点が新しい接続位置として使用されます。関連する入力ラインおよび隣接ライン (つまり、フィーチャ ID がリンクの ADJ_FID 値に一致するライン) の両方の端点が、リンクの中点に接続されるように調整されます。
- 境界線フィーチャ パラメーターを指定する場合、ツールは、エッジマッチリンクの中点に最も近い境界線上の位置を、新しい接続位置として使用します。 入力フィーチャ パラメーター値と 隣接フィーチャ パラメーター値 (指定した場合) は、計算された境界線上の位置に端点が接続されるように調整されます。
方法パラメーターには、フィーチャを調整するための、次のエッジマッチオプションがあります。各オプションは、上で説明したように、入力フィーチャのみ、または入力フィーチャと隣接フィーチャの両方に適用されます。
- 端点の移動— 入力ラインの端点を新しい接続位置に移動します。
- セグメントの追加— 新しい接続位置で終わるように、入力ラインの端点に直線セグメントを追加します。
- 頂点の調整— ラインの端点を新しい接続位置に調整します。他の頂点も、ラインの反対側の端点に向かって位置の変化が徐々に減少するように調整されます。

ラベル	説明	データタイプ
入力フィーチャ	調整対象の入力ラインフィーチャ。	Feature Layer
入力リンクフィーチャ	エッジマッチリンクを表す入力ラインフィーチャ。	Feature Layer
方法 (オプション)	入力フィーチャのみ、または入力フィーチャと隣接フィーチャの両方を新しい接続位置に調整するエッジマッチ方法を指定します。端点の移動—ラインの端点を新しい接続位置に移動します。これがデフォルトです。セグメントの追加—ラインが新しい接続位置で終わるように、ラインの端点に直線セグメントを追加します。頂点の調整—ラインの端点を新しい接続位置に移動します。他の頂点も、ラインの反対側の端点に向かって位置の変化が徐々に減少するように調整されます。	String
隣接フィーチャ (オプション)	入力フィーチャに隣接するラインフィーチャ。これを指定した場合、入力フィーチャと隣接フィーチャの両方が、新しい接続位置 (エッジマッチリンクの中点、またはリンクの中点に最も近い境界線フィーチャ (指定した場合) 上の位置のいずれか) で接続されるように調整されます。	Feature Layer
境界線フィーチャ (オプション)	入力フィーチャと隣接フィーチャ間の境界線を表すラインフィーチャまたはポリゴンフィーチャ。境界線フィーチャを指定した場合、入力フィーチャと隣接フィーチャの両方が、リンクの中点に最も近い境界線フィーチャ上の新しい接続位置で接続されるように調整されます。	Feature Layer

派生した出力

ラベル	説明	データタイプ
更新された入力フィーチャ	更新された入力フィーチャ。	Feature Layer

arcpy.edit.EdgematchFeatures(in_features, in_link_features, {method}, {adjacent_features}, {border_features})

名前	説明	データタイプ
in_features	調整対象の入力ラインフィーチャ。	Feature Layer
in_link_features	エッジマッチリンクを表す入力ラインフィーチャ。	Feature Layer
method (オプション)	入力フィーチャのみ、または入力フィーチャと隣接フィーチャの両方を新しい接続位置に調整するエッジマッチ方法を指定します。 `MOVE_ENDPOINT`—ラインの端点を新しい接続位置に移動します。これがデフォルトです。 `ADD_SEGMENT`—ラインが新しい接続位置で終わるように、ラインの端点に直線セグメントを追加します。 `ADJUST_VERTICES`—ラインの端点を新しい接続位置に移動します。他の頂点も、ラインの反対側の端点に向かって位置の変化が徐々に減少するように調整されます。	String
adjacent_features (オプション)	入力フィーチャに隣接するラインフィーチャ。これを指定した場合、入力フィーチャと隣接フィーチャの両方が、新しい接続位置 (エッジマッチリンクの中点、またはリンクの中点に最も近い境界線フィーチャ (指定した場合) 上の位置のいずれか) で接続されるように調整されます。	Feature Layer
border_features (オプション)	入力フィーチャと隣接フィーチャ間の境界線を表すラインフィーチャまたはポリゴンフィーチャ。境界線フィーチャを指定した場合、入力フィーチャと隣接フィーチャの両方が、リンクの中点に最も近い境界線フィーチャ上の新しい接続位置で接続されるように調整されます。	Feature Layer

派生した出力

名前	説明	データタイプ
out_feature_class	更新された入力フィーチャ。	Feature Layer

コードのサンプル

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

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.edit.EdgematchFeatures("cityA_Roads.shp", "em_Links.shp"
                             "MOVE_ENDPOINT")

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

次のスタンドアロン Python スクリプトは、EdgematchFeatures 関数をスクリプティング環境で適用する方法の例を示しています。

"""
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: はい

エッジマッチ フィーチャ (編集ツール)

サマリー

図

使用法

注意:

注意:

パラメーター

派生した出力

環境

ライセンス情報

関連トピック

エッジマッチフィーチャ (編集ツール)