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

サマリー

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

使用法

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

注意:

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

ラベル	説明	データタイプ
入力イベントテーブル	入力イベントテーブル。	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	入力イベントテーブルのルートロケーションフィールドとイベントタイプ。 Route identifier field—各イベントがあるルートを示す値が格納されるフィールド。このフィールドには、数値、テキスト、または GUID フィールドを使用できます。 Event type—入力イベントテーブルのイベントのタイプ (ポイントまたは `LINE`)。 `POINT`—ポイントイベントは、ルート沿いの正確な位置で発生します。始点メジャーだけを指定する必要があります。 `LINE`—ラインイベントでは、ルートの一部分を定義します。始点メジャーと終点メジャーの両方のフィールドを指定する必要があります。 From-measure field—メジャー値を格納したフィールド。このフィールドは数値でなければならず、イベントタイプが `POINT` または `LINE` の場合は必須です。 To-measure field—メジャー値を格納したフィールド。このフィールドは数値でなければならず、イベントタイプが `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	出力イベントテーブルに書き出されるルートロケーションフィールドとイベントタイプ。 Route identifier field—各イベントがあるルートを示す値が格納されるフィールド。このフィールドには、数値、テキスト、または GUID フィールドを使用できます。 Event type—出力イベントテーブルに格納されるイベントのタイプ (ポイントまたは `LINE`)。 `POINT`—ポイントイベントは、ルート沿いの正確な位置で発生します。メジャーを 1 つだけ指定する必要があります。 `LINE`—ラインイベントでは、ルートの一部分を定義します。始点メジャーと終点メジャーの両方のフィールドを指定する必要があります。 From-measure field—メジャー値が格納されるフィールド。このフィールドは、イベントタイプが `POINT` または `LINE` の場合に必須です。 To-measure field—メジャー値が格納されるフィールド。このフィールドは、イベントタイプが `LINE` の場合に必須です。	Route Measure Event Properties
cluster_tolerance	入力イベントとターゲットルート間の最大許容距離。	Linear Unit
in_fields (オプション)	`out_table` パラメーター値に、ルートロケーションフィールドと、入力イベントのすべての属性を格納するかどうかを指定します。 `FIELDS`—`out_table` パラメーター値に、ルートロケーションフィールドと、入力イベントのすべての属性を格納します。これがデフォルトです。 `NO_FIELDS`—`out_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: はい
Standard: はい
Advanced: はい

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

サマリー

使用法

注意:

パラメーター

環境

ライセンス情報

関連トピック

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