属性の割り当て (Transfer Attributes)—ヘルプ

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

サマリー

ソースラインフィーチャが空間的にターゲットラインフィーチャと一致している場所を検索し、指定された属性をソースフィーチャから一致するターゲットフィーチャに割り当てます。

[属性の割り当て (Transfer Attributes)] は、通常は、あるデータセット内のフィーチャの属性を別のデータセット内の対応するフィーチャにコピーするために使用されます。たとえば、道路フィーチャの名前を、以前にデジタイズして保持しているデータセットから、新たに収集した精度の高い新しいデータセット内のフィーチャに割り当てる場合に使用されます。これら 2 つのデータセットは、通常、ソースフィーチャおよびターゲットフィーチャと呼ばれます。このツールは、指定された検索距離の範囲内で対応するソースラインフィーチャとターゲットラインフィーチャを検索し、指定された属性をソースラインからターゲットラインに割り当てます。

図

使用法

入力データのすべての領域の範囲が、処理範囲として使用されます。使用されるソースフィーチャとターゲットフィーチャの数は、処理メッセージにレポートされます。
[割り当てフィールド] パラメーターで、1 つ以上のフィールドを指定する必要があります。割り当てフィールドの名前がターゲットフィーチャテーブルのフィールドと同じである場合、割り当てフィールドの名前が他と重複することのないように、名前の末尾に _1(あるいは _2、_3、... など) が付加されます。
複数のソースフィーチャが 1 つ以上のターゲットフィーチャと一致した場合、ソースフィーチャのうちの 1 つのフィールド値のみがターゲットフィーチャに割り当てられます。ソースフィールドに値がない場合、属性の割り当ては行われません。
[検索距離] パラメーターは、一致候補の検索で使用されます。対応するフィーチャ間のずれの大部分を捉えることができるほど十分な大きさの距離を使用しますが、候補が多くなって不必要な処理が発生し、不正な一致が得られる場合があるため、この値を大きくし過ぎないでください。
[出力照合テーブル] の指定は任意です。この照合テーブルには、ソース FID とターゲット FID、一致グループ、一致関係、空間と属性の一致条件から得られた一致の信頼度など、フィーチャの完全な一致情報が含まれています。この情報によって、一致状況を理解し、照合後の検査、編集、および解析を容易に行うことができます。詳細は、「フィーチャの照合と照合テーブルについて」をご参照ください。

[割り当てルールフィールド] パラメーターは、複数のソースフィーチャが 1 つ以上のターゲットフィーチャと一致した場合に、m:n の一致における属性の割り当て方法を制御するルールを設定します。ルールが設定されていない場合、一致した最も長いソースフィーチャから属性が割り当てられます。ただし、割り当てが適切に行われるように、属性ベースのルールを使用できます。それぞれのルールは、フィールド名と値で定義されます。

次のフィールドタイプとルール値がサポートされています。


フィールドタイプ	ルール値
テキスト	ソースフィーチャ内に存在する可能性がある文字列値。
Integer (整数)	ソースフィーチャ内に存在する可能性がある整数、または最大値と最小値を表す MAX と MIN。
日付	最も新しい日付と古い日付を表す MAX と MIN。

フィールドとルール値の組は、必要な数だけ指定できます。ルールは、リストされた順序で適用されます。

m:n の一致が見つかった場合、ツールは指定されたフィールドとルール値を確認して、次の方法で属性の割り当て元を決定します。

m ソースフィーチャの 1 つだけがルールリストの最初のフィールドにあるルール値を持つ場合、そのソースフィーチャが割り当てに使用されます。
m ソースフィーチャの複数がルール値を持つ場合や、ルール値を持つソースフィーチャがない場合は、このルールで割り当て元は決まりません。他のルールが指定されていない場合、最も長いソースフィーチャが割り当てに使用されます。他のルールが指定されている場合、リスト内の次のルールが確認され、割り当て元が決定されます。
すべてのルールが評価されるまで、このプロセスが続けられます。割り当てに使用するソースフィーチャを決定できない場合、最も長いソースフィーチャが使用されます。

次の例では、このプロセスの仕組みについて説明します。ソースとターゲットは 3:1 の一致で、ROAD_NAME フィールドをソースからターゲットに割り当てる必要があります。デフォルトでは、ソースフィーチャ 3 が 3 つのソースフィーチャの中で最も長いため、割り当てに使用されます。以下の表に示すように、ターゲットフィーチャには ROAD_NAME の値として West Ave が割り当てられます。

次に、フィールド TRAVEL_DIRECTION にルール One way、フィールド SPEED_LIMIT にルール MAX というルールが設定されていると仮定します。割り当て元になるソースフィーチャを決定するために、ツールは最初に 3 つすべてのソースフィーチャの TRAVEL_DIRECTION の値を評価し、2 つが One way と一致していることを見つけます。次にツールは、これら 2 つのフィーチャの SPEED_LIMIT の値を確認し、最大値が 40 である OBJECTID 1 に決定します。そのため、以下の表に示すように、このフィーチャから ROAD_NAME として East Ave がターゲットフィーチャに割り当てられます。

フィーチャの照合の精度は、データの品質、複雑さ、および 2 つの入力の類似性に依存します。
前処理でデータエラーを最小化し、関連するフィーチャを入力として選択する必要があります。一般に、入力データセット内のフィーチャがトポロジ的に正しく、有効なジオメトリを有しており、シングルパートであって重複していないことは、常に役立ちます。そうでない場合、予期しない結果が発生するおそれがあります。

構文

TransferAttributes_edit (source_features, target_features, transfer_fields, search_distance, {match_fields}, {out_match_table}, {transfer_rule_fields})

パラメーター	説明	データタイプ
source_features	属性の割り当て元のラインフィーチャ。	Feature Layer
target_features	属性の割り当て先のラインフィーチャ。指定した割り当てフィールドが、ターゲットフィーチャに追加されます。	Feature Layer
transfer_fields [field,...]	ターゲットフィーチャに割り当てられるソースフィールドのリスト。1 つ以上のフィールドを指定する必要があります。	Field
search_distance	一致候補の検索に使用される距離。ゼロより大きい距離を指定する必要があります。優先的に適用される単位を選択することができます。デフォルトはフィーチャ単位です。	Linear unit
match_fields [[source_field, target_field],...] (オプション)	ソースフィーチャおよびターゲットフィーチャのフィールドのリスト。これを指定すると、照合候補に対して各フィールドペアがチェックされるため、正しい適合を特定するために役立ちます。	Value Table
out_match_table (オプション)	完全なフィーチャ照合情報を含む出力テーブル。	Table
transfer_rule_fields [[field, rule],...] (オプション)	複数のソースフィーチャがターゲットフィーチャと一致する場合に、属性の割り当てに使用するソースフィーチャを制御するルールを設定します。割り当てに使用するソースフィーチャは、指定したルールフィールドとルール値によって決定されます。これらは、指定されたリストに表示される順序で、優先度が高から低にランク付けされます。ルールが指定されていない場合、一致した複数のソースフィーチャの中で最も長いものが割り当てに使用されます。使用できるルールタイプは次のとおりです。最小 - 整数または日付フィールドの最小値。日付フィールドの場合は、最も新しい日付。最大 - 整数または日付フィールドの最大値。日付フィールドの場合は、最も古い日付。ソースフィーチャ内に存在する可能性があるテキストまたは整数値。	Value Table

派生した出力

名前	説明	データタイプ
out_feature_class		フィーチャクラス

コードのサンプル

TransferAttributes (属性の割り当て) の例 1 (Python ウィンドウ)

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.TransferAttributes_edit("source_Roads.shp",
                              "target_Roads.shp", ["RoadName", "PaveType"],
                              "25 Feet")

TransferAttributes (属性の割り当て) の例 2 (スタンドアロンスクリプト)

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

# Name:        TransferAttributes_example_script2.py
# Description: Performs attribute transfer from newly updated roads (source) to existing
#              base roads (target). Where the source and target features are matched in
#              many-to-one or many-to-many (m:n) relationships, attributes are transferred 
#              from only one of the m source features to the n target features. This script
#              includes a post-process that flags resulting target features with the m:n
#              match relationships. You can inspect the flagged features and retrieve the
#              attributes from the desired source features if necessary.
# 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 = "updateRoads"
targetFeatures = "baseRoads"
transfer_fields = "RD_NAME; RD_ID"

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

outMatchTable = "ta_mtbl"

# Make a copy of the targetFeatures for attribute transfer
targetCopy = targetFeatures + "_Copy"
arcpy.CopyFeatures_management(targetFeatures, targetCopy)

# Performs attribute transfer
arcpy.TransferAttributes_edit(sourceFeatures, targetCopy, transfer_fields, search_distance, match_fields, outMatchTable)

# ====================================================================================
# Note 1:  The result of TransferAttributes may contain errors; see tool reference.
#          Additional analysis steps may be necessary to check the results; these steps
#          are not included in this script.
#
#          The following process identifies m:n matches between source and target features 
#          and flag features in targetCopy for inspection.
# ====================================================================================

# Add a field srcM_inMN to the match table to store the m count of source features in m:n relationship
field_srcM_inMN = "srcM_inMN"
arcpy.AddField_management(outMatchTable, field_srcM_inMN)

codeblock = """
def getM(fld):
    x = fld.split(\":\")[0]
    if x.isnumeric():
        if int(x) > 0:
            return int(x)
    return -1
"""

# Calculate values for srcM_inMN
arcpy.CalculateField_management(outMatchTable, field_srcM_inMN, "getM(!FM_MN!)", "PYTHON_9.3", codeblock)

# Make a table view of the match table, selecting srcM_inMN values greater than 1 
# (excluding 1:n relationships which don't need to be inspected)
arcpy.MakeTableView_management(outMatchTable, "mtable_view", field_srcM_inMN + "> 1")

# For the selected records, transfer srcM_inMN and SRC_FID fields and values to the targetCopy
arcpy.JoinField_management(targetCopy, "OBJECTID", "mtable_view", "TGT_FID", field_srcM_inMN + "; SRC_FID")

# ====================================================================================
# Note 2:  Now the fields srcM_inMN and SRC_FID are in the copy of the target features.
#          The srcM_inMN values are the counts of matched source features; the SRC_FID
#          values indicate the source feature IDs from which the transferred attributes
#          come from.
#
#          At this point you can interactively review the transferred attributes for the
#          flagged features. If you want to replace any of them by those from a different
#          source feature, you would need to make the edits as needed.
# ====================================================================================

TransferAttributes (属性の割り当て) の例 3 (スタンドアロンスクリプト)

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

# Name:        TransferAttributes_example_script3.py
# Description: Performs attribute transfer from newly updated roads (source) to existing
#              base roads (target). Where the source and target features are matched in
#              many-to-one or many-to-many (m:n) relationships, attributes can be transferred 
#              based on transfer rules. This script shows how transfer rules are set.
#              
# 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"

try:
    # Set local variables
    sourceFeatures = "updateRoads"
    targetFeatures = "baseRoads"
    transfer_fields = "RD_NAME"

    search_distance = "300 Feet"
    match_fields = ""
    outMatchTable = ""
    transfer_rules = ["TRAVEL_DIRECTION One-Way", "SPEED_LIMIT MAX"]

    # Make a copy of the targetFeatures for attribute transfer
    targetCopy = targetFeatures + "_Copy"
    arcpy.CopyFeatures_management(targetFeatures, targetCopy)

    # Performs attribute transfer
    arcpy.TransferAttributes_edit(sourceFeatures, targetCopy, transfer_fields, search_distance, match_fields, outMatchTable, transfer_rules)

except arcpy.ExecuteError as aex:
    print(arcpy.GetMessages(2))
    
except Exception as ex:
    print(ex.args[0])

環境

ライセンス情報

ArcGIS Desktop Basic: いいえ
ArcGIS Desktop Standard: いいえ
ArcGIS Desktop Advanced: はい

ArcMap

属性の割り当て (Transfer Attributes)

サマリー

図

使用法

構文

派生した出力

コードのサンプル

TransferAttributes (属性の割り当て) の例 1 (Python ウィンドウ)

TransferAttributes (属性の割り当て) の例 2 (スタンドアロンスクリプト)

TransferAttributes (属性の割り当て) の例 3 (スタンドアロンスクリプト)

環境

ライセンス情報

関連トピック

サマリー

図

使用法

構文

派生した出力

コードのサンプル

TransferAttributes (属性の割り当て) の例 1 (Python ウィンドウ)

TransferAttributes (属性の割り当て) の例 2 (スタンドアロン スクリプト)

TransferAttributes (属性の割り当て) の例 3 (スタンドアロン スクリプト)

環境

ライセンス情報

関連トピック

TransferAttributes (属性の割り当て) の例 2 (スタンドアロンスクリプト)

TransferAttributes (属性の割り当て) の例 3 (スタンドアロンスクリプト)