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

Summary

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

Usage

イベントを変換すれば、1 つの参照ルートのイベントを、別のルート識別子やメジャーをもつ他の参照ルートにも使用できます。
新しいイベントテーブルには、ターゲットルートに交差するイベントの全体または一部が書き出されます。
ソースルートとターゲットルートが厳密にオーバーレイしている場合に、最良の結果を得ることができます。

Caution:

ソースルートとターゲットルートの間の相違点を克服するためにクラスタ許容値を大きくすると、予期せぬ結果となることがあります。
出力イベントタイプ（POINT または LINE）は入力イベントタイプと一致していなければなりません。
このツールを使用する前に [テーブルビューの作成（Create Table View）] ツールを使用して、処理の対象となるイベントの数を効果的に減らしてください。
ArcMap で出力テーブルを表示するには、[ルートイベントレイヤの作成] ツールを使用するか、ArcMap で [ルートイベントレイヤの作成] コマンドを使用します。

Syntax

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})

Parameter	Explanation	Data Type
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 (Optional)	出力イベントテーブルに、ルートロケーションフィールドと、入力イベントからのすべての属性を格納するかどうかを指定します。 FIELDS —出力イベントテーブルに、ルートロケーションフィールドと、入力イベントからのすべての属性を格納します。これがデフォルトです。 NO_FIELDS —出力イベントテーブルに、ルートロケーションフィールドと、入力イベントからの ObjectID フィールドだけを格納します。	Boolean

Code Sample

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)

Environments

現在のワークスペース, 出力データのコンフィグレーションキーワード, テンポラリワークスペース

Licensing Information

ArcGIS for Desktop Basic: Yes

ArcGIS for Desktop Standard: Yes

ArcGIS for Desktop Advanced: Yes

9/24/2013

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