ルートイベントレイヤーの作成 (Make Route Event Layer) (リニアリファレンスツール)

サマリー

ルートとルートイベントを使ってテンポラリーフィーチャレイヤーを作成します。

テンポラリーレイヤーを使用する場合は (マップに表示する場合や別のジオプロセシングツールで使用する場合)、ダイナミックセグメンテーションが行われます。

使用法

ArcGIS が対応している種類のテーブルはどれでも入力テーブルとして使用できます。
このツールを実行する前に、ルートに対して フィーチャレイヤーの作成 ツールを実行するか、イベントに対して テーブルビューの作成 ツールを実行するか、両方のツールを実行して、処理対象となるルートとイベントの数を減らします。
一部のタイプのテーブルには Object ID フィールドが含まれていません。 Object ID フィールドが含まれていないテーブルをこのツールで使用すると、結果レイヤーの選択ができなくなるため、特定のジオプロセシング操作で結果レイヤーを効果的に使用することができません。このツールを実行する前に、クエリーテーブルの作成 ツールを使用して仮想 Object ID フィールドを追加することができます。

ラベル	説明	データタイプ
入力ルートフィーチャ	イベントを配置する対象となるルートフィーチャ。	Feature Layer
ルート識別フィールド	各ルートを一意に識別する値を格納したフィールド。このフィールドには、数値、テキスト、または GUID フィールドを使用できます。	Field
入力イベントテーブル	ルート沿いに配置する行が含まれているテーブル。	Table View
イベントテーブルプロパティ	入力イベントテーブルのルートロケーションフィールドとイベントタイプ。ルート識別フィールド— 各イベントがあるルートを示す値が格納されるフィールド。このフィールドには、数値、テキスト、または GUID フィールドを使用できます。イベントタイプ— 入力イベントテーブルのイベントのタイプ (ポイントまたはライン)。ポイント— ポイントイベントは、ルート沿いの正確な位置で発生します。始点メジャーだけを指定する必要があります。ライン— ラインイベントでは、ルートの一部分を定義します。始点メジャーと終点メジャーの両方のフィールドを指定する必要があります。始点メジャーフィールド— メジャー値を格納したフィールド。このフィールドは数値でなければならず、イベントタイプがポイントまたはラインの場合は必須です。イベントタイプの値がポイントの場合、このパラメーターのラベルはメジャーフィールドになります。終点メジャーフィールド— メジャー値を格納したフィールド。このフィールドは数値でなければならず、イベントタイプがラインの場合は必須です。	Route Measure Event Properties
レイヤー名、またはテーブルビュー	作成されるレイヤー。このレイヤーはメモリーに格納されるため、パスは不要です。	Feature Layer
オフセットフィールド (オプション)	イベントをその基になるルートからオフセットする場合に使用される値を含むフィールド。このフィールドの値は数値でなければなりません。	Field
配置エラーフィールドを作成 (オプション)	作成するテンポラリーレイヤーに `LOC_ERROR` フィールドを追加するかどうかを指定します。オン—配置エラーを格納するためのフィールドが追加されます。オフ—配置エラーを格納するためのフィールドが追加されません。これがデフォルトです。	Boolean
角度フィールドの生成 (オプション)	作成するテンポラリーレイヤーに `LOC_ANGLE` フィールドを追加するかどうかを指定します。このパラメーターはイベントタイプがポイントの場合にのみ有効です。オン—配置角度を格納するためのフィールドが追加されます。オフ—配置角度を格納するためのフィールドが追加されません。これがデフォルトです。	Boolean
算出される角度のタイプ (オプション)	計算する配置角度の種類を指定します。このパラメーターは、角度フィールドの生成パラメーターがオンの場合のみ有効です。正規—垂直 (直交) 角度が計算されます。これがデフォルトです。正接—正接角度が計算されます。	String
角度フィールドに余角を作成 (オプション)	配置角度の余角を作成するかどうかを指定します。このパラメーターは、角度フィールドの生成パラメーターがオンの場合のみ有効です。オン—余角が作成されます。オフ—余角が作成されません。計算後の角度のみが作成されます。これがデフォルトです。	Boolean
正の値のオフセットがあるイベントをルートの右側に配置 (オプション)	正の値のオフセットがあるルートイベントをどちらの側に表示するかを指定します。このパラメーターはオフセットフィールドを指定している場合にのみ有効です。オン—正の値のオフセットがあるイベントがルートの右側に表示されます。ルートのこちら側はデジタイズされた方向によって決まります。オフ—正の値のオフセットがあるイベントがルートの左側に表示されます。ルートの側はメジャーによって決まり、必ずしもデジタイズされた方向によって決まるわけではありません。これがデフォルトです。	Boolean
ポイントイベントをマルチポイントフィーチャとして生成 (オプション)	ポイントイベントをポイントフィーチャとして扱うか、マルチポイントフィーチャとして扱うかを指定します。オン—ポイントイベントはマルチポイントフィーチャとして扱われます。オフ—ポイントイベントがポイントフィーチャとして扱われます。これがデフォルトです。	Boolean

arcpy.lr.MakeRouteEventLayer(in_routes, route_id_field, in_table, in_event_properties, out_layer, {offset_field}, {add_error_field}, {add_angle_field}, {angle_type}, {complement_angle}, {offset_direction}, {point_event_type})

名前	説明	データタイプ
in_routes	イベントを配置する対象となるルートフィーチャ。	Feature Layer
route_id_field	各ルートを一意に識別する値を格納したフィールド。このフィールドには、数値、テキスト、または GUID フィールドを使用できます。	Field
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
out_layer	作成されるレイヤー。このレイヤーはメモリーに格納されるため、パスは不要です。	Feature Layer
offset_field (オプション)	イベントをその基になるルートからオフセットする場合に使用される値を含むフィールド。このフィールドの値は数値でなければなりません。	Field
add_error_field (オプション)	作成するテンポラリーレイヤーに `LOC_ERROR` フィールドを追加するかどうかを指定します。 `ERROR_FIELD`—配置エラーを格納するためのフィールドが追加されます。 `NO_ERROR_FIELD`—配置エラーを格納するためのフィールドが追加されません。これがデフォルトです。	Boolean
add_angle_field (オプション)	作成するテンポラリーレイヤーに `LOC_ANGLE` フィールドを追加するかどうかを指定します。このパラメーターはイベントタイプがポイントの場合にのみ有効です。 `ANGLE_FIELD`—配置角度を格納するためのフィールドが追加されます。 `NO_ANGLE_FIELD`—配置角度を格納するためのフィールドが追加されません。これがデフォルトです。	Boolean
angle_type (オプション)	計算する配置角度の種類を指定します。このパラメーターは、`add_angle_field` パラメーターが `ANGLE_FIELD` に設定されている場合にのみ有効です。 `NORMAL`—垂直 (直交) 角度が計算されます。これがデフォルトです。 `TANGENT`—正接角度が計算されます。	String
complement_angle (オプション)	配置角度の余角を作成するかどうかを指定します。このパラメーターは、`add_angle_field` パラメーターが `ANGLE_FIELD` に設定されている場合にのみ有効です。 `COMPLEMENT`—余角が作成されます。 `ANGLE`—余角が作成されません。計算後の角度のみが作成されます。これがデフォルトです。	Boolean
offset_direction (オプション)	正の値のオフセットがあるルートイベントをどちらの側に表示するかを指定します。このパラメーターはオフセットフィールドを指定している場合にのみ有効です。 `RIGHT`—正の値のオフセットがあるイベントがルートの右側に表示されます。ルートのこちら側はデジタイズされた方向によって決まります。 `LEFT`—正の値のオフセットがあるイベントがルートの左側に表示されます。ルートの側はメジャーによって決まり、必ずしもデジタイズされた方向によって決まるわけではありません。これがデフォルトです。	Boolean
point_event_type (オプション)	ポイントイベントをポイントフィーチャとして扱うか、マルチポイントフィーチャとして扱うかを指定します。 `MULTIPOINT`—ポイントイベントはマルチポイントフィーチャとして扱われます。 `POINT`—ポイントイベントがポイントフィーチャとして扱われます。これがデフォルトです。	Boolean

コードのサンプル

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

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.lr.MakeRouteEventLayer("route_hwy.shp", "rkey", "accident.dbf",
                             "rkey POINT mile", "accident_events", "#",
                             "ERROR_FIELD", "ANGLE_FIELD")

MakeRouteEventLayer の例 2 (スタンドアロンスクリプト)

次の Python スクリプトは、スタンドアロン Python スクリプトで MakeRouteEventLayer 関数を使用する方法を示しています。

# Name: MakeRouteEventLayer_Example2.py
# Description:  Make a POINT event layer. Routes and events are in a shapefile workspace.
# An error field and an angle field are added to the new layer. The new layer can be used
# by other geoprocessing functions.

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/Data"

# Set local variables
rt = "route_hwy.shp"
rid = "rkey"
tbl = "accident.dbf"
props = "rkey POINT mile"
lyr = "accident_events"

# Run MakeRouteEventLayer
arcpy.lr.MakeRouteEventLayer(rt, rid, tbl, props, lyr, "#", "ERROR_FIELD",
                             "ANGLE_FIELD")

MakeRouteEventLayer の例 3 (スタンドアロンスクリプト)

次の Python スクリプトは、スタンドアロン Python スクリプトで MakeRouteEventLayer 関数を使用する方法を示しています。

# Name: MakeRouteEventLayer_Example3.py
# Description:  Make a LINE event layer. Routes and events are in a file geodatabase.
# An error field is added to the new layer. The new layer can be used by other
# geoprocessing functions.

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/Data/pitt.gdb"

# Set local variables
rt = "roads/hwy"  # the 'hwy' feature class is in the 'roads' feature dataset
rid = "rkey"
tbl = "pavecond"
props = "rkey LINE fmp tmp"
lyr = "pave_events"

# Run MakeRouteEventLayer
arcpy.lr.MakeRouteEventLayer(rt, rid, tbl, props, lyr, "#", "ERROR_FIELD")

MakeRouteEventLayer の例 4 (スタンドアロンスクリプト)

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

# Name: MakeRouteEventLayer_Example4.py
# Description: Make a POINT event layer. Routes and events are in an enterprise geodatabase.
# The new layer can be used by other geoprocessing functions.

# Import system modules
import arcpy

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

# Set local variables
ds = arcpy.ValidateTableName("roads", wkspc)  # the 'roads' feature dataset
fc = arcpy.ValidateTableName("hwy", wkspc)  # the 'hwy' feature class
rt = ds + "/" + fc  # the 'hwy' feature class is in the 'roads' feature dataset
rid = "rkey"
tbl = "accident"
props = "rkey POINT mile"
lyr = "accident_events2"

# Run MakeRouteEventLayer
arcpy.lr.MakeRouteEventLayer(rt, rid, tbl, props, lyr)

環境

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

ライセンス情報

Basic: はい
Standard: はい
Advanced: はい

ルート イベント レイヤーの作成 (Make Route Event Layer) (リニア リファレンス ツール)

サマリー

使用法

パラメーター

環境

ライセンス情報

関連トピック

ルートイベントレイヤーの作成 (Make Route Event Layer) (リニアリファレンスツール)