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

サマリー

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

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

使用法

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

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

  • 一部のタイプのテーブルには Object ID フィールドが含まれていません。 Object ID フィールドが含まれていないテーブルをこのツールで使用すると、結果レイヤーの選択ができなくなるため、特定のジオプロセシング操作で結果レイヤーを効果的に使用することができません。 このツールを実行する前に、[クエリ テーブルの作成 (Make Query Table)] ツールを使用して仮想 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

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

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

  • 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

関連トピック