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

サマリー

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

使用法

  • イベントを変換すると、あるルート参照に基づくイベントを、含まれるルート識別子またはメジャー、もしくはその両方が異なる別のルート参照と共に使用できます。

  • 新しいイベント テーブルには、ターゲット ルートに交差するイベントの全体または一部が書き出されます。

  • ソース ルートとターゲット ルートが厳密にオーバーレイしている場合に、最良の結果を得ることができます。

    注意:

    ソース ルートとターゲット ルートの間の相違点を克服するために [クラスター許容値] パラメーター値を大きくすると、予期せぬ結果となることがあります。

  • [イベント タイプ] の値 ([ポイント] または [ライン]) は入力イベント タイプと一致していなければなりません。

  • このツールを使用する前に [テーブル ビューの作成 (Create Table View)] ツールを使用して、処理の対象となるイベントの数を効果的に減らしてください。

  • 出力テーブルは、[ルート イベント レイヤーの作成 (Make Route Event Layer)] ツールを使用してマップに表示できます。

パラメーター

ラベル説明データ タイプ
入力イベント テーブル

入力イベント テーブル。

Table View
イベント テーブル プロパティ

入力イベント テーブルのルート ロケーション フィールドとイベント タイプ。

  • [ルート識別フィールド]: 各イベントがあるルートを示す値が格納されるフィールド。 このフィールドには、数値、テキスト、または GUID フィールドを使用できます。
  • [イベント タイプ]: 入力イベント テーブルのイベントのタイプ ([ポイント] または [ライン])。
    • [ポイント]: ポイント イベントは、ルート沿いの正確な位置で発生します。 始点メジャーだけを指定する必要があります。
    • [ライン]: ライン イベントでは、ルートの一部分を定義します。 始点メジャーと終点メジャーの両方のフィールドを指定する必要があります。
  • [始点メジャー フィールド]: メジャー値を格納したフィールド。 このフィールドは数値でなければならず、イベント タイプが [ポイント] または [ライン] の場合は必須です。 [イベント タイプ] の値が [ポイント] の場合、このパラメーターのラベルは [メジャー フィールド] になります。
  • [終点メジャー フィールド]: メジャー値を格納したフィールド。 このフィールドは数値でなければならず、イベント タイプが [ライン] の場合は必須です。
Route Measure Event Properties
ソース ルート フィーチャ

入力ルート フィーチャ。

Feature Layer
ソース ルート識別フィールド

各入力ルートを一意に識別する値を格納したフィールド。 このフィールドには、数値、テキスト、または GUID フィールドを使用できます。

Field
ターゲット ルート フィーチャ

入力イベントの変換先となるルート フィーチャ。

Feature Layer
ターゲット ルート識別フィールド

各ターゲット ルートを一意に識別する値を格納したフィールド。 このフィールドには、数値、テキスト、または GUID フィールドを使用できます。

Field
出力イベント テーブル

作成されるテーブル。

Table
出力イベント テーブル プロパティ

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

  • [ルート識別フィールド]: 各イベントがあるルートを示す値が格納されるフィールド。 このフィールドには、数値、テキスト、または GUID フィールドを使用できます。
  • [イベント タイプ]: 出力イベント テーブルに格納されるイベントのタイプ ([ポイント] または [ライン])。
    • [ポイント]: ポイント イベントは、ルート沿いの正確な位置で発生します。 メジャーを 1 つだけ指定する必要があります。
    • [ライン]: ライン イベントでは、ルートの一部分を定義します。 始点メジャーと終点メジャーの両方のフィールドを指定する必要があります。
  • [始点メジャー フィールド]: メジャー値が格納されるフィールド。 このフィールドは、イベント タイプが [ポイント] または [ライン] の場合に必須です。 [イベント タイプ] の値が [ポイント] の場合、このパラメーターのラベルは [メジャー フィールド] になります。
  • [終点メジャー フィールド]: メジャー値が格納されるフィールド。 このフィールドは、イベント タイプが [ライン] の場合に必須です。
Route Measure Event Properties
クラスター許容値

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

Linear Unit
入力のすべてのフィールドを含める
(オプション)

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

  • オン - [出力イベント テーブル] パラメーター値に、ルート ロケーション フィールドと、入力イベントのすべての属性を格納します。 これがデフォルトです。
  • オフ - [出力イベント テーブル] パラメーター値に、ルート ロケーション フィールドと入力イベントの ObjectID フィールドのみを格納します。
Boolean

arcpy.lr.TransformRouteEvents(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

入力イベント テーブルのルート ロケーション フィールドとイベント タイプ。

  • ルート識別フィールド: 各イベントがあるルートを示す値が格納されるフィールド。 このフィールドには、数値、テキスト、または GUID フィールドを使用できます。
  • イベント タイプ: 入力イベント テーブルのイベントのタイプ (POINT または LINE)。
    • POINT: ポイント イベントは、ルート沿いの正確な位置で発生します。 始点メジャーだけを指定する必要があります。
    • LINE: ライン イベントでは、ルートの一部分を定義します。 始点メジャーと終点メジャーの両方のフィールドを指定する必要があります。
  • 始点メジャー フィールド - メジャー値を格納したフィールド。 このフィールドは数値でなければならず、イベント タイプが POINT または LINE の場合は必須です。
  • 終点メジャー フィールド - メジャー値を格納したフィールド。 このフィールドは数値でなければならず、イベント タイプが LINE の場合は必須です。
Route Measure Event Properties
in_routes

入力ルート フィーチャ。

Feature Layer
route_id_field

各入力ルートを一意に識別する値を格納したフィールド。 このフィールドには、数値、テキスト、または GUID フィールドを使用できます。

Field
target_routes

入力イベントの変換先となるルート フィーチャ。

Feature Layer
target_route_id_field

各ターゲット ルートを一意に識別する値を格納したフィールド。 このフィールドには、数値、テキスト、または GUID フィールドを使用できます。

Field
out_table

作成されるテーブル。

Table
out_event_properties

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

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

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

Linear Unit
in_fields
(オプション)

out_table パラメーター値に、ルート ロケーション フィールドと、入力イベントのすべての属性を格納するかどうかを指定します。

  • FIELDSout_table パラメーター値に、ルート ロケーション フィールドと、入力イベントのすべての属性を格納します。 これがデフォルトです。
  • NO_FIELDSout_table パラメーター値に、ルート ロケーション フィールドと入力イベントの ObjectID フィールドのみを格納します。
Boolean

コードのサンプル

TransformRouteEvents の例 1 (Python ウィンドウ)

次の Python ウィンドウ スクリプトは、TransformRouteEvents (ルート イベントの変換) 関数の使用方法を示しています。


import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.lr.TransformRouteEvents("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 スクリプトでファイル ジオデータベース データに TransformRouteEvents (ルート イベントの変換) 関数を使用する方法を示しています。

# Name: TransformRouteEvents_Example2.py
# Description: Transform point events (input table is in a file geodatabase)

# Import system modules
import arcpy

# Set workspace
arcpy.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"  

# Run TransformRouteEvents
arcpy.lr.TransformRouteEvents(in_tbl, in_props, in_rt, in_rid, target_rt, 
                              target_rid, out_tbl, out_props, tol)
TransformRouteEvents の例 3 (スタンドアロン スクリプト)

次は、スタンドアロン Python スクリプトでエンタープライズ ジオデータベース データに TransformRouteEvents (ルート イベントの変換) 関数を使用する方法を示しています。

# Name: TransformRouteEvents_Example3.py
# Description: Transform point events (input table is in an enterprise geodatabase)

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/MyProject/myConn.sde"

# Set local variables
in_tbl = arcpy.ValidateTableName("accident", wkspc) 
in_props = "route1 POINT measure"
in_rt = arcpy.ValidateTableName("hwy", wkspc) 
in_rid = "route1" 
target_rt = arcpy.ValidateTableName("hwy_new", wkspc) 
target_rid = "route1" 
out_tbl = "trans_out3"
out_props = "route1 POINT mp"
tol = "0.1 meters"  

# Run TransformRouteEvents
arcpy.lr.TransformRouteEvents(in_tbl, in_props, in_rt, in_rid, target_rt, 
                              target_rid, out_tbl, out_props, tol)

ライセンス情報

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes

関連トピック