ラベル | 説明 | データ タイプ |
入力イベント テーブル | 入力イベント テーブル。 | Table View |
イベント テーブル プロパティ | 入力イベント テーブルのルート ロケーション フィールドとイベント タイプ。
| Route Measure Event Properties |
ソース ルート フィーチャ | 入力ルート フィーチャ。 | Feature Layer |
ソース ルート識別フィールド | 各入力ルートを一意に識別する値を格納したフィールド。 このフィールドには、数値、テキスト、または GUID フィールドを使用できます。 | Field |
ターゲット ルート フィーチャ | 入力イベントの変換先となるルート フィーチャ。 | Feature Layer |
ターゲット ルート識別フィールド | 各ターゲット ルートを一意に識別する値を格納したフィールド。 このフィールドには、数値、テキスト、または GUID フィールドを使用できます。 | Field |
出力イベント テーブル | 作成されるテーブル。 | Table |
出力イベント テーブル プロパティ | 出力イベント テーブルに書き出されるルート ロケーション フィールドとイベント タイプ。
| Route Measure Event Properties |
クラスター許容値 | 入力イベントとターゲット ルート間の最大許容距離。 | Linear Unit |
入力のすべてのフィールドを含める (オプション) | [出力イベント テーブル] パラメーター値に、ルート ロケーション フィールドと、入力イベントのすべての属性を格納するかどうかを指定します。
| Boolean |
サマリー
イベントのメジャーをある参照ルートから別の参照ルートに変換して新しいイベント テーブルに書き出します。
使用法
イベントを変換すると、あるルート参照に基づくイベントを、含まれるルート識別子またはメジャー、もしくはその両方が異なる別のルート参照と共に使用できます。
新しいイベント テーブルには、ターゲット ルートに交差するイベントの全体または一部が書き出されます。
ソース ルートとターゲット ルートが厳密にオーバーレイしている場合に、最良の結果を得ることができます。
注意:
ソース ルートとターゲット ルートの間の相違点を克服するために [クラスター許容値] パラメーター値を大きくすると、予期せぬ結果となることがあります。
[イベント タイプ] の値 ([ポイント] または [ライン]) は入力イベント タイプと一致していなければなりません。
このツールを使用する前に [テーブル ビューの作成 (Create Table View)] ツールを使用して、処理の対象となるイベントの数を効果的に減らしてください。
-
出力テーブルは、[ルート イベント レイヤーの作成 (Make Route Event Layer)] ツールを使用してマップに表示できます。
パラメーター
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 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 Measure Event Properties |
cluster_tolerance | 入力イベントとターゲット ルート間の最大許容距離。 | Linear Unit |
in_fields (オプション) | out_table パラメーター値に、ルート ロケーション フィールドと、入力イベントのすべての属性を格納するかどうかを指定します。
| Boolean |
コードのサンプル
次の 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")
次は、スタンドアロン 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)
次は、スタンドアロン 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