ラバーシートリンクの生成 (Generate Rubbersheet Links) (編集)—ArcMap

概要
図
使用法
構文
コードのサンプル
環境
ライセンス情報

概要

ソースラインフィーチャがターゲットラインフィーチャと空間的に一致する場所を検索し、ソースの位置からそれに対応するターゲットの位置に向けて、ラバーシートを行うためのリンクを表すラインを生成します。

図

ラバーシートリンクの生成 (Generate Rubbersheet Links)

使用法

異なるデータソースのラインフィーチャが同じ領域内に広がっている場合 (たとえば、市の行政機関が管理する道路と、商用データプロバイダーが提供する同じ市の道路)、それらのラインフィーチャは、データコレクションの不一致などの理由により、完全な 1 列にならない場合があります。対応するフィーチャ間に生じる空間的なずれは、多くの場合、均一ではありません。あるソースのデータの精度が他のソースよりも低いことがわかっている場合、ラバーシートアジャストによって、そのデータの精度を改善できます。ラバーシートアジャストは、このツールを使用してラバーシートリンクを生成してから、[ラバーシートフィーチャ (Rubbersheet Features)] ツールを使用して調整することで行います。ラインフィーチャの 2 つのセットは、ソースフィーチャおよび (通常はより精度の高い) ターゲットフィーチャと呼ばれます。このツールは、指定された検索距離の範囲内で対応するソースラインとターゲットラインを検索し、それらのライン間にラバーシートリンク (移動リンクとも呼ぶ) を生成します。

入力データのすべての領域の範囲が、処理範囲として使用されます。使用されるソースフィーチャとターゲットフィーチャの数は、処理メッセージにレポートされます。
出力フィーチャクラスには、[ラバーシートフィーチャ (Rubbersheet Features)] ツールに入力する標準のラバーシートリンクを表すラインが格納されます。標準のリンクは、ソースの位置を、一致するが同一ではないターゲットの位置に接続します。
これらのリンクを、他のラインフィーチャと同様に、マップ上に表示できます。ラインの端に矢印を付けて描画し、上の図に示すようなマップを作成できます。
このツールは、出力ラインフィーチャクラスの他に、固定リンクが格納されたポイントフィーチャクラスを作成します。固定リンクは、ソースの位置を、一致する同一のターゲットの位置に接続します。固定リンクの位置は、ラバーシートで移動されません。一致する同一のソースおよびターゲットの位置が存在しない場合、固定リンクは生成されません。その場合、出力ポイントフィーチャクラスは空になります。ポイントフィーチャクラスが空でない場合にのみ、それを [ラバーシートフィーチャ (Rubbersheet Features)] ツールの入力として指定する必要があります。出力ポイントフィーチャクラスは出力フィーチャクラスと同じ位置にあり、出力フィーチャクラスと同じ名前を持ちますが、_pnt という接尾辞が付きます。たとえば、出力フィーチャクラスの名前が outputLinks である場合、出力ポイントフィーチャクラスの名前は outputLinks_pnt になります。
2 つの出力 (標準のラバーシートリンクと固定リンク) には、以下のフィールドが存在します。
- SRC_FID - リンクの始点になるソースフィーチャ ID。この位置が複数のソースフィーチャで共有される場合 (たとえば、道路の交差点)、この値は -1 になります。
- TGT_FID - リンクの終点になるターゲットフィーチャ ID。この位置が複数のターゲットフィーチャで共有される場合 (たとえば、道路の交差点)、この値は -1 になります。
[検索距離] パラメーターは、一致候補の検索で使用されます。対応するフィーチャ間のずれの大部分を捉えることができるほど十分な大きさの距離を使用しますが、候補が多くなって不必要な処理が発生し、不正な一致が得られる場合があるため、この値を大きくし過ぎないでください。
フィーチャの照合は、ラインのトポロジ、パターン、および地理的な特徴を分析することによって実行されます。フィーチャが空間的に一致すると、ソースの位置からそれに対応するターゲットの位置までラバーシートリンクが生成されます。ソースフィーチャがパラメトリックカーブ (トゥルーカーブ) である場合、カーブ沿いの密度の高い場所でリンクが生成されます。
[照合フィールド] パラメーターに 1 つまたは複数のフィールドペアを指定すると、空間的にマッチすると思われる候補がこれらのフィールド値に対してチェックされるため、正しい適合の特定に役立ちます。たとえば、道路名が格納された STREET_NAME フィールドが、ソースフィーチャとターゲットフィーチャの両方に存在するとします。1 つのソースフィーチャが 2 つのターゲットフィーチャに空間的に一致していて、1 つのターゲットフィーチャのみがソースフィーチャと同じ STREET_NAME 値を持っている場合、このターゲットフィーチャの方が一致度が高くなります。テキスト文字列の比較では、大文字と小文字が区別されません。つまり、「First St」は、「first st」と同じであると見なされます。
[出力照合テーブル] の指定は任意です。この照合テーブルには、ソース FID とターゲット FID、一致グループ、一致関係、空間と属性の一致条件から得られた一致の信頼度など、フィーチャの完全な一致情報が含まれています。この情報によって、一致状況を理解し、照合後の検査、編集、および解析を容易に行うことができます。詳細は、「フィーチャの照合と照合テーブルについて」をご参照ください。
フィーチャの照合の精度は、データの品質、複雑さ、および 2 つの入力の類似性に依存します。
前処理でデータエラーを最小化し、関連するフィーチャを入力として選択する必要があります。一般に、入力データセット内のフィーチャがトポロジ的に正しく、有効なジオメトリを有しており、シングルパートであって重複していないことは、常に役立ちます。そうでない場合、予期しない結果が発生するおそれがあります。
結果を確認し、必要に応じて修正することをお勧めします。実行後に検査と編集を行うときに、既存の編集ツールを使用してリンクを編集できます。たとえば、必要に応じて不要なリンクを削除したり、リンクの始点または終点を移動して変更したり、新しいリンクを追加したりできます。それに応じて、必ず SRC_FID と TGT_FID を更新してください。

構文

arcpy.edit.GenerateRubbersheetLinks(source_features, target_features, out_feature_class, search_distance, {match_fields}, {out_match_table})

パラメーター	説明	データタイプ
source_features	ラバーシートリンクを生成するためのソースフィーチャになるラインフィーチャ。すべてのリンクは、ソースフィーチャから始まります。	Feature Layer
target_features	ラバーシートリンクを生成するためのターゲットフィーチャになるラインフィーチャ。すべてのリンクは、一致するターゲットフィーチャで終わります。	Feature Layer
out_feature_class	標準のラバーシートリンクを表すラインが格納される出力フィーチャクラス。	Feature Class
search_distance	一致候補の検索に使用される距離。ゼロより大きい距離を指定する必要があります。優先的に適用される単位を選択することができます。デフォルトはフィーチャ単位です。	Linear Unit
match_fields [[source_field, target_field],...] (オプション)	ソースフィーチャおよびターゲットフィーチャのフィールドのリスト。これを指定すると、照合候補に対して各フィールドペアがチェックされるため、正しい適合を特定するために役立ちます。	Value Table
out_match_table (オプション)	完全なフィーチャ照合情報を含む出力テーブル。	Table

派生した出力

名前	説明	データタイプ
out_point_feature_class	アイデンティティリンクを含むフィーチャクラス。	フィーチャクラス

コードのサンプル

GenerateRubbersheetLinks (ラバーシートリンクの生成) の例 1 (Python ウィンドウ)

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.GenerateRubbersheetLinks_edit("source_Roads.shp", "target_Roads.shp", 
                                    "rubbersheet_Links.shp", "25 Feet")

GenerateRubbersheetLinks (ラバーシートリンクの生成) の例 2 (スタンドアロンスクリプト)

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

# Name:        GenerateRubbersheetLinks_example_script2.py
# Description: Generates links for rubbersheeting spatial adjustment. The links go
#              from base road data to newly updated road data. The links are then
#              analyzed for potential errors; they are finally used to adjust the
#              base roads (a copy is made) to better align with the updated roads.
# 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
sourceFeatures = "baseRoads"
targetFeatures = "updateRoads"
grlOutput = "grlinks_out"
grlOutputPts = "grlinks_out_pnt"

search_distance = "300 Feet"
match_fields = "FULLNAME RD_NAME"

qaLocations = "qa_locations"

# Generate rubbersheet links
arcpy.GenerateRubbersheetLinks_edit(sourceFeatures, targetFeatures, grlOutput, search_distance, match_fields)

# ====================================================================================
# Note 1:  The result of GenerateRubbersheetLinks may contain errors; see tool reference.
#          Inspection and editing may be necessary to ensure correct links before using
#          them for rubbersheeting.
#
#          One of the common errors are 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(grlOutput, 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 sourceFeatures for rubbersheeting
arcpy.CopyFeatures_management(sourceFeatures, "sourceFeatures_Copy")


# Use the links for rubbersheeting
arcpy.RubbersheetFeatures_edit("sourceFeatures_Copy", grlOutput, grlOutputPts, "LINEAR")

環境

ライセンス情報

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

概要

図

使用法

構文

派生した出力

コードのサンプル

GenerateRubbersheetLinks (ラバーシート リンクの生成) の例 1 (Python ウィンドウ)

GenerateRubbersheetLinks (ラバーシート リンクの生成) の例 2 (スタンドアロン スクリプト)

環境

ライセンス情報

関連トピック

GenerateRubbersheetLinks (ラバーシートリンクの生成) の例 1 (Python ウィンドウ)

GenerateRubbersheetLinks (ラバーシートリンクの生成) の例 2 (スタンドアロンスクリプト)