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

サマリー

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

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

使用法

  • ArcGIS が対応している種類のテーブルはどれでも入力テーブルとして使用できます。

  • このツールを使用する前に、ルートに対して [フィーチャ レイヤーの作成 (Make Feature Layer)] ツールを実行するか、イベントに対して [テーブル ビューの作成 (Make Table View)] ツールを実行するか、両方のツールを実行して、処理対象となるルートとイベントの数を減らします。

  • 一部のタイプのテーブルには ObjectID フィールドが含まれていません。 このようなテーブルをこのツールで使用すると、結果レイヤーの選択ができなくなるため、特定のジオプロセシング操作で結果レイヤーを効果的に使用することができません。 このツールを使用する前に [クエリ テーブルの作成 (Make Query Table)] ツールで仮想 ObjectID フィールドを追加することを検討してください。

パラメーター

ラベル説明データ タイプ
入力ルート フィーチャ

イベントを配置する対象となるルート フィーチャ。

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

各ルートを一意に識別する値を格納したフィールド。

Field
入力イベント テーブル

ルート沿いに配置する行が含まれているテーブル。

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

入力イベント テーブルのルート ロケーション フィールドとイベント タイプで構成されるパラメーター。

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

作成するレイヤー。 このレイヤーはメモリに格納されるため、パスは不要です。

Feature Layer
オフセット フィールド
(オプション)

イベントをその基になるルートからオフセットする場合に使用される値を含むフィールド。 このフィールドの値は数値でなければなりません。

Field
配置エラー フィールドを作成
(オプション)

作成するテンポラリ レイヤーに LOC_ERROR という名前のフィールドを追加するかどうかを指定します。

  • オフ - 配置エラーを格納するためのフィールドが追加されません。 これがデフォルトです。
  • オン: 配置エラーを格納するためのフィールドが追加されます。
Boolean
角度フィールドの生成
(オプション)

作成するテンポラリ レイヤーに LOC_ANGLE という名前のフィールドを追加するかどうかを指定します。 このパラメーターはイベント タイプが POINT の場合にのみ有効です。

  • オフ - 配置角度を格納するためのフィールドが追加されません。 これがデフォルトです。
  • オン: 配置角度を格納するためのフィールドが追加されます。
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

各ルートを一意に識別する値を格納したフィールド。

Field
in_table

ルート沿いに配置する行が含まれているテーブル。

Table View
in_event_properties

入力イベント テーブルのルート ロケーション フィールドとイベント タイプで構成されるパラメーター。

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

作成するレイヤー。 このレイヤーはメモリに格納されるため、パスは不要です。

Feature Layer
offset_field
(オプション)

イベントをその基になるルートからオフセットする場合に使用される値を含むフィールド。 このフィールドの値は数値でなければなりません。

Field
add_error_field
(オプション)

作成するテンポラリ レイヤーに LOC_ERROR という名前のフィールドを追加するかどうかを指定します。

  • NO_ERROR_FIELD配置エラーを格納するためのフィールドが追加されません。 これがデフォルトです。
  • ERROR_FIELD配置エラーを格納するためのフィールドが追加されます。
Boolean
add_angle_field
(オプション)

作成するテンポラリ レイヤーに LOC_ANGLE という名前のフィールドを追加するかどうかを指定します。 このパラメーターはイベント タイプが POINT の場合にのみ有効です。

  • NO_ANGLE_FIELD配置角度を格納するためのフィールドが追加されません。 これがデフォルトです。
  • ANGLE_FIELD配置角度を格納するためのフィールドが追加されます。
Boolean
angle_type
(オプション)

計算する配置角度の種類を指定します。 このパラメーターは、add_angle_field = "ANGLE_FIELD" の場合にのみ有効です。

  • NORMAL垂直 (直交) 角度が計算されます。 これがデフォルトです。
  • TANGENT正接角度が計算されます。
String
complement_angle
(オプション)

配置角度の余角を計算するかどうかを指定します。 このパラメーターは、add_angle_field = "ANGLE_FIELD" の場合にのみ有効です。

  • ANGLE角度の余角が書き出されません。 計算後の角度だけが書き出されます。 これがデフォルトです。
  • COMPLEMENT角度の余角が書き出されます。
Boolean
offset_direction
(オプション)

正の値のオフセットがあるルート イベントをどちらの側に表示するかを指定します。 このパラメーターはオフセット フィールドを指定している場合にのみ有効です。

  • LEFT正の値のオフセットがあるイベントがルートの左側に表示されます。 ルートの側はメジャーによって決まり、必ずしもデジタイズされた方向によって決まるわけではありません。 これがデフォルトです。
  • RIGHT正の値のオフセットがあるイベントがルートの右側に表示されます。 ルートのこちら側はデジタイズされた方向によって決まります。
Boolean
point_event_type
(オプション)

ポイント イベントをポイント フィーチャとして扱うか、マルチポイント フィーチャとして扱うかを指定します。

  • POINTポイント イベントがポイント フィーチャとして扱われます。 これがデフォルトです。
  • MULTIPOINTポイント イベントはマルチポイント フィーチャとして扱われます。
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: Yes
  • Standard: Yes
  • Advanced: Yes

関連トピック