エッジマッチフィーチャ (Edgematch Features) (編集)—ArcGIS Pro

サマリー

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

エッジマッチの詳細

図

使用法

注意:

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

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

注意:

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

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

パラメーター

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

コードのサンプル

EdgematchFeatures (フィーチャのエッジマッチ) の例 1 (Python ウィンドウ)

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.EdgematchFeatures_edit("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
#              might not be desired; they are finally used to adjust input features 
#              (a copy is made) to connect with the matched adjacent feautures.
# Author:      Esri
# -----------------------------------------------------------------------

# Import system modules
import arcpy
from arcpy import env

# Set environment settings
env.overwriteOutput = True
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.GenerateEdgematchLinks_edit(inFeatures, adjFeatures, gelOutput, search_distance, match_fields)

# ====================================================================================
# Note 1:  The result of GenerateEdgematchLinks may contain errors; see tool reference.
#          Inspection and editing may be necessary to ensure correct links before using
#          them for edgematching.
#
#          One of the possible errors are undesired 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.Intersect_analysis(gelOutput, qaLocations, "", "", "POINT")

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

# ====================================================================================
# Note 2:  At this point you can manually inspect locations in qaLocations; delete or
#          modify links as needed.
# ====================================================================================

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

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

サマリー

図

使用法

注意:

注意:

パラメーター

派生した出力

派生した出力

コードのサンプル

環境

特殊なケース

ライセンス情報

関連トピック

このトピックの内容