ルート イベントの変換（Transform Route Events） (リニア リファレンス)

ライセンス レベル:BasicStandardAdvanced

サマリ

このツールは、イベントのメジャーをある参照ルートから別の参照ルートに変換して新しいイベント テーブルに書き出します。

使用法

構文

TransformRouteEvents_lr (in_table, in_event_properties, in_routes, route_id_field, target_routes, target_route_id_field, out_table, out_event_properties, cluster_tolerance, {in_fields})
パラメータ説明データ タイプ
in_table

入力イベント テーブル。

Table View
in_event_properties

入力イベント テーブルのルート ロケーション フィールドとイベント タイプで構成されるパラメータ。

  • ルート識別フィールド: どのルート沿いに各イベントがあるのかを示す値を格納したフィールド。このフィールドには数値または文字を使用できます。
  • イベント タイプ: 入力イベント テーブルのイベントのタイプ（POINT または LINE）。
    • POINT: ポイント イベントは、ルート沿いの正確な位置で発生します。始点メジャーだけを指定する必要があります。
    • LINE: ライン イベントでは、ルートの一部分を定義します。始点メジャーと終点メジャーの両方のフィールドを指定する必要があります。
  • 始点メジャー値フィールド: メジャー値を格納したフィールド。このフィールドは数値でなければならず、イベント タイプが POINT または LINE の場合は必須です。イベント タイプが POINT の場合は、このパラメータのラベルが [メジャー値フィールド] になることに注意してください。
  • 終点メジャー値フィールド: メジャー値を格納したフィールド。このフィールドは数値でなければならず、イベント タイプが LINE の場合は必須です。
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

出力イベント テーブルに書き出されるルート ロケーション フィールドとイベント タイプで構成されるパラメータ。

  • ルート識別フィールド: どのルート沿いに各イベントがあるのかを示す値が格納されるフィールド。
  • イベント タイプ: 出力イベント テーブルに格納されるイベントのタイプ（POINT または LINE）。
    • POINT: ポイント イベントは、ルート沿いの正確な位置で発生します。メジャーを 1 つだけ指定する必要があります。
    • LINE: ライン イベントでは、ルートの一部分を定義します。始点メジャーと終点メジャーの両方のフィールドを指定する必要があります。
  • 始点メジャー値フィールド: メジャー値が格納されるフィールド。イベント タイプが POINT または LINE の場合は必須です。イベント タイプが POINT の場合は、このパラメータのラベルが [メジャー値フィールド] になることに注意してください。
  • 終点メジャー値フィールド: メジャー値が格納されるフィールド。イベント タイプが LINE の場合は必須です。
Route Measure Event Properties
cluster_tolerance

入力イベントとターゲット ルート間の最大許容距離。

Linear Unit
in_fields
(オプション)

出力イベント テーブルに、ルート ロケーション フィールドと、入力イベントからのすべての属性を格納するかどうかを指定します。

  • FIELDS —出力イベント テーブルに、ルート ロケーション フィールドと、入力イベントからのすべての属性を格納します。これがデフォルトです。
  • NO_FIELDS —出力イベント テーブルに、ルート ロケーション フィールドと、入力イベントからの ObjectID フィールドだけを格納します。
Boolean

コードのサンプル

TransformRouteEvents（ルート イベントの変換）の例（Python ウィンドウ） 
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"  )
TransformRouteEvents（ルート イベントの変換）の例 2（スタンドアロン Python スクリプト）

次は、スタンドアロン 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)
TransformRouteEvents（ルート イベントの変換）の例 3（スタンドアロン Python スクリプト）

次は、スタンドアロン 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)
TransformRouteEvents（ルート イベントの変換）の例 4（スタンドアロン Python スクリプト）

次は、スタンドアロン 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)

環境

関連トピック

リニア リファレンス ツールボックスの概要
イベント メジャーの変換について

ライセンス情報

ArcGIS for Desktop Basic: ○
ArcGIS for Desktop Standard: ○
ArcGIS for Desktop Advanced: ○
Copyright © 1995-2014 Esri. All rights reserved.
5/10/2014