ルート イベントの変換（Transform Route Events） (リニア リファレンス)
サマリ
このツールは、イベントのメジャーをある参照ルートから別の参照ルートに変換して新しいイベント テーブルに書き出します。
使用法
-
イベントを変換すれば、1 つの参照ルートのイベントを、別のルート識別子やメジャーをもつ他の参照ルートにも使用できます。
-
新しいイベント テーブルには、ターゲット ルートに交差するイベントの全体または一部が書き出されます。
-
ソース ルートとターゲット ルートが厳密にオーバーレイしている場合に、最良の結果を得ることができます。
注意:ソース ルートとターゲット ルートの間の相違点を克服するためにクラスタ許容値を大きくすると、予期せぬ結果となることがあります。
-
出力イベント タイプ（POINT または LINE）は入力イベント タイプと一致していなければなりません。
-
このツールを使用する前に [テーブル ビューの作成（Create Table View）] ツールを使用して、処理の対象となるイベントの数を効果的に減らしてください。
-
ArcMap で出力テーブルを表示するには、[ルート イベント レイヤの作成] ツールを使用するか、ArcMap で [ルート イベント レイヤの作成] コマンドを使用します。
構文
| パラメータ | 説明 | データ タイプ |
in_table |
入力イベント テーブル。 | Table view |
in_event_properties |
入力イベント テーブルのルート ロケーション フィールドとイベント タイプで構成されるパラメータ。
| Route Measure Event properties |
in_routes |
入力ルート フィーチャ。 | Feature layer |
route_id_field |
各入力ルートを一意に識別する値を格納したフィールド。 | Field |
target_routes |
入力イベントの変換先となるルート フィーチャ。 | Feature layer |
target_route_id_field |
各ターゲット ルートを一意に識別する値を格納したフィールド。 | Field |
out_table |
作成するテーブル。 | Table |
out_event_properties |
出力イベント テーブルに書き出されるルート ロケーション フィールドとイベント タイプで構成されるパラメータ。
| Route Measure Event properties |
cluster_tolerance |
入力イベントとターゲット ルート間の最大許容距離。 | Linear unit |
in_fields （オプション） |
出力イベント テーブルに、ルート ロケーション フィールドと、入力イベントからのすべての属性を格納するかどうかを指定します。
| Boolean |
コードのサンプル
import arcpy
from arcpy import env
env.workspace = "C:/Data"
arcpy.TransformRouteEvents_lr("pavement.dbf", "route1 LINE begin_mp end_mp", "hwy.shp", "route1", "hwy_new.shp", "route1", "trans_out1.dbf", "route1 LINE fmp tmp", "0.1 meters" )
次は、スタンドアロン Python スクリプトでファイル ジオデータベース データにTransformRouteEvents（ルート イベントの変換）関数を使用する方法を示しています。
# Name: TransformRouteEvents_Example2.py # Description: Transform point events (input table is in a file geodatabase) # Author: ESRI # Import system modules import arcpy from arcpy import env # Set workspace env.workspace = "C:/Data/pitt.gdb" # Set local variables in_tbl = "accident" in_props = "route1 POINT measure" in_rt = "roads/hwy" # hwy exists in the roads feature dataset in_rid = "route1" target_rt = "roads/hwy_new" # hwy_new exists in the roads feature dataset target_rid = "route1" out_tbl = "trans_out2" out_props = "route1 POINT mp" tol = "0.1 meters" # Execute TransformRouteEvents arcpy.TransformRouteEvents_lr(in_tbl, in_props, in_rt, in_rid, target_rt, target_rid, out_tbl, out_props, tol)
次は、スタンドアロン Python スクリプトでパーソナル ジオデータベース データに TransformRouteEvents（ルート イベントの変換）関数を使用する方法を示しています。
# Name: TransformRouteEvents_Example3.py # Description: Transform point events (input table is in a personal geodatabase) # Author: ESRI # Import system modules import arcpy from arcpy import env # Set workspace env.workspace = "C:/Data/pitt.mdb" # Set local variables in_tbl = "accident" in_props = "route1 POINT measure" in_rt = "roads/hwy" # hwy exists in the roads feature dataset in_rid = "route1" target_rt = "roads/hwy_new" # hwy_new exists in the roads feature dataset target_rid = "route1" out_tbl = "trans_out2" out_props = "route1 POINT mp" tol = "0.1 meters" # Execute TransformRouteEvents arcpy.TransformRouteEvents_lr(in_tbl, in_props, in_rt, in_rid, target_rt, target_rid, out_tbl, out_props, tol)
次は、スタンドアロン Python スクリプトで ArcSDE データに TransformRouteEvents（ルート イベントの変換）関数を使用する方法を示しています。
# Name: TransformRouteEvents_Example4.py
# Description: Transform point events (input table is in an enterprise geodatabase)
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set workspace
env.workspace = "Database Connections/Connection to Jerry.sde"
# Set local variables
in_tbl = gp.QualifyTableName("accident", wkspc)
in_props = "route1 POINT measure"
in_rt = gp.QualifyTableName("hwy", wkspc)
in_rid = "route1"
target_rt = gp.QualifyTableName("hwy_new", wkspc)
target_rid = "route1"
out_tbl = "trans_out3"
out_props = "route1 POINT mp"
tol = "0.1 meters"
# Execute TransformRouteEvents
arcpy.TransformRouteEvents_lr(in_tbl, in_props, in_rt, in_rid, target_rt, target_rid, out_tbl, out_props, tol)